# CadRoute — Documentazione

# CadRoute — Guida utente

CadRoute 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.

### Formati supportati

Estensione | Tipo | Descrizione
--- | --- | ---
.prt | Part | File di componente singolo Creo
.asm | Assembly | File di assemblaggio Creo
.drw | Drawing | File di disegno Creo
altri | — | Copiati in `__SALTATI` (PDF, immagini, documenti, ecc.)

## Requisiti

Prima di iniziare, assicurati che la cartella di destinazione sia quella corretta.

## Configurare la destinazione

La destinazione è la cartella radice dove CadRoute copierà i file CAD smistati. Va impostata una volta sola e viene ricordata tra le sessioni.

1. Individua la sezione Destinazione file CAD nella finestra principale.
2. Clicca Sfoglia per aprire il selettore cartelle, oppure digita il percorso direttamente nel campo di testo.
3. Clicca Salva. La destinazione viene memorizzata e sarà attiva anche alla prossima apertura dell'app.

Tip: il percorso di default è `X:\`. Assicurati che sia quello corretto prima di avviare lo smistamento.

## Smistare i file

È possibile smistare una cartella (anche con sottocartelle annidate) o un archivio .zip, tramite i pulsanti o trascinando direttamente nell'area apposita.

1. Clicca Process Folder per selezionare una cartella, oppure Process ZIP per selezionare un archivio. In alternativa, trascina la cartella o il file `.zip` nell'area tratteggiata.
2. L'app scansiona tutti i file e identifica automaticamente quelli CAD.
3. I file CAD vengono copiati nella sottocartella di destinazione corrispondente. I file non CAD vengono copiati in `__SALTATI`.
4. Al termine vengono mostrate le statistiche nell'area di output.

Nota: i file originali non vengono mai modificati né cancellati.

## Leggere i risultati

Al termine di ogni operazione l'area di output mostra un riepilogo. Ecco il significato di ogni voce.

Scansionati
Totale file analizzati (CAD e non).
Copiati
File effettivamente scritti su disco (destinazione, non smistati o duplicati).
Saltati
File non CAD copiati in `__SALTATI` (PDF, immagini, ecc.).
Non smistati
File CAD per cui non è stata trovata una destinazione valida.
Duplicati
File CAD già presenti nella destinazione al momento dello smistamento.

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.

## Convenzione nomi file CAD

CadRoute determina automaticamente la sottocartella di destinazione leggendo il nome del file. È fondamentale che i file seguano la convenzione corretta.

### Struttura del nome

    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

### Gestione versioni

Se sono presenti più versioni dello stesso file nella sorgente (es. `ABC12345.prt.8` e `ABC12345.prt.9`), CadRoute mantiene solo la versione più alta e scarta le inferiori.

Scenario | Comportamento
--- | ---
File non presente in destinazione | Copia diretta nella sottocartella corretta
File già presente in destinazione | Copiato in `__DUPLICATI` per revisione
Versione inferiore presente nella sorgente | Saltata — la versione più alta prende precedenza

## File non smistati

Un file CAD finisce in non smistati quando CadRoute non riesce a determinare una destinazione valida. Le cause più comuni sono:

Causa | Messaggio
--- | ---
Codice con meno di 5 cifre | "Nome file non conforme: servono almeno 5 cifre…"
Sottocartella non trovata in destinazione | "Sottocartella XXX non trovata nella destinazione"
Sottocartella trovata in più percorsi (ambiguo) | "Sottocartella XXX trovata in N percorsi diversi"

### Dove si trovano

I file non smistati vengono copiati nella cartella `__NON_SMISTATI`:

- Windows: `C:\cadroute\__NON_SMISTATI\`
- Linux: `~/.cadroute/__NON_SMISTATI/`

### Visualizzare e pulire

1. Clicca Anteprima non smistati per aprire la lista dei file presenti.
2. Verifica i file, controlla il motivo dell'esclusione nell'area di output.
3. Se vuoi svuotare la cartella, clicca Pulisci cartella (rosso) e conferma. L'operazione è irreversibile.

Suggerimento: prima di pulire, sposta manualmente i file che vuoi conservare. La pulizia elimina tutto il contenuto della cartella.

## File duplicati

Un file CAD viene classificato come duplicato quando la sua chiave (`CODICE.tipo`, senza versione) è già presente nella cartella di destinazione al momento dello smistamento.

I duplicati non sovrascrivono i file già presenti in destinazione: vengono messi da parte nella cartella `__DUPLICATI` per permettere una revisione manuale.

### Dove si trovano

- Windows: `C:\cadroute\__DUPLICATI\`
- Linux: `~/.cadroute/__DUPLICATI/`

### Gestione versioni nei duplicati

Anche all'interno della cartella `__DUPLICATI` 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.

### Visualizzare e pulire

1. Clicca Anteprima duplicati per aprire la lista dei file presenti.
2. Verifica se i duplicati sono effettivamente superati o se richiedono un intervento manuale.
3. Se vuoi svuotare la cartella, clicca Pulisci cartella (rosso) e conferma.

Attenzione: la pulizia è definitiva. Assicurati di non aver bisogno dei file prima di procedere.

## File saltati

Un file viene classificato come saltato quando non è riconosciuto come file CAD, cioè non ha estensione `.prt`, `.asm` o `.drw`. Rientrano in questa categoria PDF, immagini, documenti Word e qualsiasi altro formato non CAD.

I file saltati non vengono ignorati completamente: vengono copiati nella cartella `__SALTATI` per permettere una verifica manuale.

### Dove si trovano

- Windows: `C:\cadroute\__SALTATI\`
- Linux: `~/.cadroute/__SALTATI/`

### Visualizzare e pulire

1. Clicca Anteprima saltati per aprire la lista dei file presenti.
2. Verifica che nessun file CAD sia finito qui per errore di denominazione.
3. Se vuoi svuotare la cartella, clicca Pulisci cartella (rosso) e conferma.

Nota: la cartella `__SALTATI` è utile per individuare file CAD rinominati erroneamente o con estensione mancante.