278 lines
12 KiB
HTML
278 lines
12 KiB
HTML
<!doctype html>
|
|
<html lang="it">
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<title>CadRoute — Documentazione</title>
|
|
<link rel="stylesheet" href="./style.css" />
|
|
</head>
|
|
<body>
|
|
|
|
<nav>
|
|
<div class="nav-brand">
|
|
<div class="logo">CadRoute</div>
|
|
<div class="version">Guida utente</div>
|
|
</div>
|
|
|
|
<span class="nav-section-label">Introduzione</span>
|
|
<a href="#intro">Cos'è CadRoute</a>
|
|
<a href="#requisiti">Requisiti</a>
|
|
|
|
<span class="nav-section-label">Utilizzo</span>
|
|
<a href="#destinazione">Configurare la destinazione</a>
|
|
<a href="#cartella">Smistare i file</a>
|
|
<a href="#risultati">Leggere i risultati</a>
|
|
|
|
<span class="nav-section-label">Approfondimenti</span>
|
|
<a href="#nomi">Convenzione nomi file</a>
|
|
<a href="#nonsmistati">File non smistati</a>
|
|
<a href="#duplicati">File duplicati</a>
|
|
</nav>
|
|
|
|
<main>
|
|
|
|
<!-- ── INTRODUZIONE ──────────────────────── -->
|
|
<section id="intro">
|
|
<h1>CadRoute — Guida utente</h1>
|
|
<div class="intro-card">
|
|
<p><strong>CadRoute</strong> automatizza lo smistamento di file CAD provenienti da Creo. Analizza una cartella o un archivio ZIP, riconosce i file CAD e li copia automaticamente nella sottocartella di destinazione corretta, basandosi sulla struttura numerica del nome file.</p>
|
|
</div>
|
|
|
|
<h3>Formati supportati</h3>
|
|
<table>
|
|
<thead>
|
|
<tr><th>Estensione</th><th>Tipo</th><th>Descrizione</th></tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="badge prt">.prt</span></td>
|
|
<td>Part</td>
|
|
<td>File di componente singolo Creo</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="badge asm">.asm</span></td>
|
|
<td>Assembly</td>
|
|
<td>File di assemblaggio Creo</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="badge dwr">.dwr</span></td>
|
|
<td>Drawing</td>
|
|
<td>File di disegno Creo</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="badge skip">altri</span></td>
|
|
<td>—</td>
|
|
<td>Ignorati (PDF, immagini, documenti, ecc.)</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</section>
|
|
|
|
<!-- ── REQUISITI ────────────────────────── -->
|
|
<section id="requisiti">
|
|
<h2>Requisiti</h2>
|
|
<p>Prima di iniziare, assicurati che la <strong>cartella di destinazione</strong> sia quella corretta.</p>
|
|
</section>
|
|
|
|
<hr />
|
|
|
|
<!-- ── CONFIGURARE DESTINAZIONE ─────────── -->
|
|
<section id="destinazione">
|
|
<h2>Configurare la destinazione</h2>
|
|
<p>La <strong>destinazione</strong> è la cartella radice dove CadRoute copierà i file CAD smistati. Va impostata una volta sola e viene ricordata tra le sessioni.</p>
|
|
|
|
<ol class="steps">
|
|
<li><span>Individua la sezione <strong>Destinazione file CAD</strong> nella finestra principale.</span></li>
|
|
<li><span>Clicca <strong>Sfoglia</strong> per aprire il selettore cartelle, oppure digita il percorso direttamente nel campo di testo.</span></li>
|
|
<li><span>Clicca <strong>Salva</strong>. La destinazione viene memorizzata e sarà attiva anche alla prossima apertura dell'app.</span></li>
|
|
</ol>
|
|
|
|
<div class="callout tip">
|
|
<strong>Tip:</strong> il percorso di default è <code>X:\</code>. Assicurati che sia quello corretto prima di avviare lo smistamento.
|
|
</div>
|
|
</section>
|
|
|
|
<!-- ── SMISTARE FILE ──────────────────────── -->
|
|
<section id="cartella">
|
|
<h2>Smistare i file</h2>
|
|
<p>È possibile smistare una <strong>cartella</strong> (anche con sottocartelle annidate) o un archivio <strong>.zip</strong>, tramite i pulsanti o trascinando direttamente nell'area apposita.</p>
|
|
|
|
<ol class="steps">
|
|
<li><span>Clicca <strong>Process Folder</strong> per selezionare una cartella, oppure <strong>Process ZIP</strong> per selezionare un archivio. In alternativa, trascina la cartella o il file <code>.zip</code> nell'area tratteggiata.</span></li>
|
|
<li><span>L'app scansiona tutti i file e identifica automaticamente quelli CAD.</span></li>
|
|
<li><span>I file CAD vengono copiati nella sottocartella di destinazione corrispondente. I file non CAD vengono saltati.</span></li>
|
|
<li><span>Al termine vengono mostrate le statistiche nell'area di output.</span></li>
|
|
</ol>
|
|
|
|
<div class="callout info">
|
|
<strong>Nota:</strong> i file originali non vengono mai modificati né cancellati.
|
|
</div>
|
|
</section>
|
|
|
|
<hr />
|
|
|
|
<!-- ── RISULTATI ─────────────────────────── -->
|
|
<section id="risultati">
|
|
<h2>Leggere i risultati</h2>
|
|
<p>Al termine di ogni operazione l'area di output mostra un riepilogo. Ecco il significato di ogni voce.</p>
|
|
|
|
<div class="stat-grid">
|
|
<div class="stat-item info">
|
|
<div class="stat-label">Scansionati</div>
|
|
<div class="stat-desc">Totale file analizzati (CAD e non).</div>
|
|
</div>
|
|
<div class="stat-item ok">
|
|
<div class="stat-label">Copiati</div>
|
|
<div class="stat-desc">File effettivamente scritti su disco (destinazione, non smistati o duplicati).</div>
|
|
</div>
|
|
<div class="stat-item muted">
|
|
<div class="stat-label">Saltati</div>
|
|
<div class="stat-desc">File ignorati perché non CAD (PDF, immagini, ecc.).</div>
|
|
</div>
|
|
<div class="stat-item warn">
|
|
<div class="stat-label">Non smistati</div>
|
|
<div class="stat-desc">File CAD per cui non è stata trovata una destinazione valida.</div>
|
|
</div>
|
|
<div class="stat-item warn">
|
|
<div class="stat-label">Duplicati</div>
|
|
<div class="stat-desc">File CAD già presenti nella destinazione al momento dello smistamento.</div>
|
|
</div>
|
|
</div>
|
|
|
|
<p>Sotto le statistiche sono elencati i dettagli di ogni file (massimo 20 voci) con il percorso di destinazione e la motivazione, nel caso di file non smistati o duplicati.</p>
|
|
</section>
|
|
|
|
<hr />
|
|
|
|
<!-- ── NOMI FILE ─────────────────────────── -->
|
|
<section id="nomi">
|
|
<h2>Convenzione nomi file CAD</h2>
|
|
<p>CadRoute determina automaticamente la sottocartella di destinazione leggendo il nome del file. È fondamentale che i file seguano la convenzione corretta.</p>
|
|
|
|
<h3>Struttura del nome</h3>
|
|
<pre class="code-block"><code>CODICE.tipo[.versione]
|
|
|
|
Esempi:
|
|
ABC12345.prt → Part, nessuna versione
|
|
ABC12345.prt.6 → Part, versione 6
|
|
XYZ67890.asm.10 → Assembly, versione 10
|
|
DEF11111.drw.15 → Drawing, versione 15</code></pre>
|
|
|
|
<h3>Gestione versioni</h3>
|
|
<p>Se sono presenti più versioni dello stesso file nella sorgente (es. <code>ABC12345.prt.8</code> e <code>ABC12345.prt.9</code>), CadRoute mantiene <strong>solo la versione più alta</strong> e scarta le inferiori.</p>
|
|
|
|
<table>
|
|
<thead>
|
|
<tr><th>Scenario</th><th>Comportamento</th></tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td>File non presente in destinazione</td>
|
|
<td>Copia diretta nella sottocartella corretta</td>
|
|
</tr>
|
|
<tr>
|
|
<td>File già presente in destinazione</td>
|
|
<td>Copiato in <code>duplicati/</code> per revisione</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Versione inferiore presente nella sorgente</td>
|
|
<td>Saltata — la versione più alta prende precedenza</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</section>
|
|
|
|
<!-- ── NON SMISTATI ──────────────────────── -->
|
|
<section id="nonsmistati">
|
|
<h2>File non smistati</h2>
|
|
<p>Un file CAD finisce in <strong>non smistati</strong> quando CadRoute non riesce a determinare una destinazione valida. Le cause più comuni sono:</p>
|
|
|
|
<table>
|
|
<thead>
|
|
<tr><th>Causa</th><th>Messaggio</th></tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td>Codice con meno di 5 cifre</td>
|
|
<td><em>"Nome file non conforme: servono almeno 5 cifre…"</em></td>
|
|
</tr>
|
|
<tr>
|
|
<td>Sottocartella non trovata in destinazione</td>
|
|
<td><em>"Sottocartella XXX non trovata nella destinazione"</em></td>
|
|
</tr>
|
|
<tr>
|
|
<td>Sottocartella trovata in più percorsi (ambiguo)</td>
|
|
<td><em>"Sottocartella XXX trovata in N percorsi diversi"</em></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<h3>Dove si trovano</h3>
|
|
<p>I file non smistati vengono copiati nella cartella <code>__NON_SMISTATI</code>:</p>
|
|
<ul style="margin: 8px 0 12px 20px; color: var(--muted);">
|
|
<li><strong>Linux:</strong> <code>~/.cadroute/__NON_SMISTATI/</code></li>
|
|
<li><strong>Windows:</strong> <code>%APPDATA%\CadRoute\__NON_SMISTATI\</code></li>
|
|
</ul>
|
|
|
|
<h3>Visualizzare e pulire</h3>
|
|
<ol class="steps">
|
|
<li><span>Clicca <strong>Anteprima non smistati</strong> per aprire la lista dei file presenti.</span></li>
|
|
<li><span>Verifica i file, controlla il motivo dell'esclusione nell'area di output.</span></li>
|
|
<li><span>Se vuoi svuotare la cartella, clicca <strong>Pulisci cartella</strong> (rosso) e conferma. L'operazione è irreversibile.</span></li>
|
|
</ol>
|
|
|
|
<div class="callout tip">
|
|
<strong>Suggerimento:</strong> prima di pulire, sposta manualmente i file che vuoi conservare. La pulizia elimina tutto il contenuto della cartella.
|
|
</div>
|
|
</section>
|
|
|
|
<!-- ── DUPLICATI ─────────────────────────── -->
|
|
<section id="duplicati">
|
|
<h2>File duplicati</h2>
|
|
<p>Un file CAD viene classificato come <strong>duplicato</strong> quando la sua chiave (<code>CODICE.tipo</code>, senza versione) è già presente nella cartella di destinazione al momento dello smistamento.</p>
|
|
|
|
<p>I duplicati non sovrascrivono i file già presenti in destinazione: vengono messi da parte nella cartella <code>duplicati/</code> per permettere una revisione manuale.</p>
|
|
|
|
<h3>Dove si trovano</h3>
|
|
<ul style="margin: 8px 0 12px 20px; color: var(--muted);">
|
|
<li><strong>Linux:</strong> <code>~/.cadroute/duplicati/</code></li>
|
|
<li><strong>Windows:</strong> <code>%APPDATA%\CadRoute\duplicati\</code></li>
|
|
</ul>
|
|
|
|
<h3>Gestione versioni nei duplicati</h3>
|
|
<p>Anche all'interno della cartella <code>duplicati/</code> viene applicata la logica delle versioni: se arriva una versione più alta di un file già presente nei duplicati, la versione vecchia viene eliminata e sostituita con quella nuova.</p>
|
|
|
|
<h3>Visualizzare e pulire</h3>
|
|
<ol class="steps">
|
|
<li><span>Clicca <strong>Anteprima duplicati</strong> per aprire la lista dei file presenti.</span></li>
|
|
<li><span>Verifica se i duplicati sono effettivamente superati o se richiedono un intervento manuale.</span></li>
|
|
<li><span>Se vuoi svuotare la cartella, clicca <strong>Pulisci cartella</strong> (rosso) e conferma.</span></li>
|
|
</ol>
|
|
|
|
<div class="callout warning">
|
|
<strong>Attenzione:</strong> la pulizia è definitiva. Assicurati di non aver bisogno dei file prima di procedere.
|
|
</div>
|
|
</section>
|
|
|
|
</main>
|
|
|
|
<script>
|
|
// Evidenzia il link attivo nella sidebar durante lo scroll
|
|
const sections = document.querySelectorAll('section[id]');
|
|
const links = document.querySelectorAll('nav a[href^="#"]');
|
|
|
|
const observer = new IntersectionObserver((entries) => {
|
|
entries.forEach(entry => {
|
|
if (entry.isIntersecting) {
|
|
links.forEach(l => l.classList.remove('active'));
|
|
const active = document.querySelector(`nav a[href="#${entry.target.id}"]`);
|
|
if (active) active.classList.add('active');
|
|
}
|
|
});
|
|
}, { rootMargin: '-20% 0px -70% 0px' });
|
|
|
|
sections.forEach(s => observer.observe(s));
|
|
</script>
|
|
</body>
|
|
</html>
|