Aggiungi "Elimina CSV delle distinte" e allinea le guide alla cartella di installazione

Nuova voce "File → Elimina CSV delle distinte..." (EliminaCsv): elimina
i *.csv al primo livello della cartella di lavoro, che altrimenti si
accumulano uno per distinta importata. Chiede conferma mostrando
l'elenco dei file; gli .xls del gestionale e raw/step non sono toccati.

Guida utente e guida in-app: nuova sezione "Dove finiscono i file"
(DB sempre nella cartella di installazione, CSV/raw/step nella cartella
di lavoro, comandi di pulizia, come aprire la cartella nascosta in
AppData), fase 1 allineata al DB fisso e ad "Apri DB..." solo per la
sessione. Tolta dalla guida utente la sezione di installazione: chi la
legge ha già il programma installato (resta nel README).

Doc aggiornati nello stesso commit: CLAUDE.md, docs/architettura.md,
docs/guida-utente.md, CHANGELOG.md.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
davideandClaude Opus 5.5 committed 2026-09-23 08:39:58 +02:00
1 parent 64ff1d8770
commit 4ae3d0e087
6 files changed
+126 -31

No files matched your search

+28 -21
View File
@@ -7,22 +7,29 @@ fase vedi [`architettura.md`](architettura.md); questa guida si ferma a cosa cli
cosa vede l'utente. La stessa sintesi è disponibile anche dentro l'app da **Aiuto → Guida**
(F1).
## Installazione
## Dove finiscono i file
1. Lancia `PrepStep-Setup-<versione>.exe` (non servono i diritti di amministratore).
2. Alla fine lascia spuntato "Avvia PrepStep - Cevolani", oppure aprilo dal menu Start.
Tutto sta nella **cartella di lavoro**, che di default è la cartella di installazione
`%LOCALAPPDATA%\Programs\PrepStep`:
Il programma si installa in `%LOCALAPPDATA%\Programs\PrepStep`. Il database `cad_index.db` sta sempre in questa cartella.
| Cosa | Dove |
|---|---|
| database `cad_index.db` | sempre nella cartella di installazione |
| CSV di ogni distinta importata | cartella di lavoro |
| `raw/` — file CAD copiati nelle fasi 3-4 | cartella di lavoro |
| `step/` — file STEP esportati da Creo | cartella di lavoro (la indichi tu a Creo) |
Se il programma è già installato, il setup chiede cosa fare:
Il file `.xls` del gestionale resta dove l'hai preso: l'app lo legge soltanto.
- **Sì** — lo aggiorna (o reinstalla): database e cartella di lavoro restano quelli di prima;
- **No** — lo disinstalla;
- **Annulla** — esce senza fare nulla.
Per **disinstallarlo** si può anche usare menu Start → "Disinstalla PrepStep - Cevolani", oppure
Impostazioni → App installate → PrepStep - Cevolani → Disinstalla (il
database `cad_index.db` e le impostazioni non vengono cancellati, vedi sotto).
- **Cambiare la cartella di lavoro**: **File → Scegli cartella di lavoro...** (viene ricordata
agli avvii successivi). Il database resta comunque nella cartella di installazione.
- **Aprire la cartella**: `AppData` è nascosta in Esplora file; scrivi
`%LOCALAPPDATA%\Programs\PrepStep` nella barra degli indirizzi (vale anche per scegliere
`step/` in Creo). Dalla fase 4 si apre `raw/` con **Apri cartella raw**.
- **Fare pulizia** (menu **File**): **Pulisci raw e step...** svuota `raw/` e `step/`;
**Elimina CSV delle distinte...** elimina i CSV, che altrimenti si accumulano uno per
distinta. Nessuno dei due tocca il database. Entrambi chiedono conferma.
- **Disinstallando** il programma questi file restano: cancellali a mano se non servono più.
## Prima di iniziare
@@ -36,9 +43,9 @@ database `cad_index.db` e le impostazioni non vengono cancellati, vedi sotto).
- Se il file segue la convenzione di nome del gestionale (`DBP_<codice>_<timestamp>`),
l'app aggiunge da sola l'assieme generale come componente in più — non serve fare
nulla di diverso.
- Conviene definire la **cartella di lavoro** giusta (fase 1, o "File → Scegli cartella
di lavoro...") prima di importare la distinta: è lì che finiscono CSV, `raw/` e, dopo
l'esportazione con Creo, `step/`.
- Se non vuoi usare la cartella di installazione, scegli la **cartella di lavoro**
("File → Scegli cartella di lavoro...") prima di importare la distinta: è lì che
finiscono CSV, `raw/` e, dopo l'esportazione con Creo, `step/`.
- Se la cartella di lavoro è già stata usata per un'altra distinta, conviene **pulire
`raw/` e `step/`** prima di ripartire ("File → Pulisci raw e step..."): evita di
confondere i file CAD/STEP della copia precedente con quelli della nuova distinta (il
@@ -47,8 +54,8 @@ database `cad_index.db` e le impostazioni non vengono cancellati, vedi sotto).
## 1. Database
Alla prima apertura, se un database (`cad_index.db`) è già stato creato in precedenza,
l'app lo ricarica da sola: si vede il pallino verde accanto a "Database", il percorso del
Se nella cartella di installazione c'è già un database (`cad_index.db`), l'app lo carica
da sola all'avvio: si vede il pallino verde accanto a "Database", il percorso del
file e la data dell'ultimo aggiornamento.
- **Se il pallino è rosso** (nessun database trovato): premi **Aggiorna indice** per
@@ -59,10 +66,7 @@ file e la data dell'ultimo aggiornamento.
selezionalo a mano. Vale solo finché non chiudi il programma: al prossimo avvio si riparte
dal database nella cartella di installazione. Per usarlo sempre, copialo in
`%LOCALAPPDATA%\Programs\PrepStep` come `cad_index.db`.
- La **cartella di lavoro** (dove l'app scrive il CSV della distinta e la cartella
`raw/`) è ricordata tra un avvio e l'altro; la prima volta è la cartella di installazione
(`%LOCALAPPDATA%\Programs\PrepStep`); per cambiarla usa
**File → Scegli cartella di lavoro...**.
- La **cartella di lavoro** non si imposta qui: vedi [Dove finiscono i file](#dove-finiscono-i-file).
Premi **Avanti** quando il database è caricato.
@@ -143,3 +147,6 @@ la cartella di lavoro (restano quelli già impostati in fase 1).
Per ripulire le cartelle `raw/` e `step/` della cartella di lavoro prima di un nuovo giro
(senza toccare l'indice), usa **File → Pulisci raw e step...**.
Ogni distinta importata lascia un CSV nella cartella di lavoro: per eliminarli tutti usa
**File → Elimina CSV delle distinte...** (i file `.xls` del gestionale non vengono toccati).