prep-step/CHANGELOG.md

Changelog

Tutte le modifiche rilevanti di questo progetto sono documentate in questo file.

Il formato segue Keep a Changelog, e il progetto aderisce a Semantic Versioning.

[Non rilasciato]

[1.1.0] - 2026-10-07

Aggiunto

• Fase 2: modalità "Lista personalizzata" per inserire i codici a mano, uno alla volta, in alternativa al file del gestionale.
• Docs-as-code: scripts/CheckDocs.cs, markdownlint, docs/README.md (indice Diátaxis e fonte unica).
• Nuovi doc: tutorial-primo-giro, risoluzione-problemi, sviluppo, rilascio, glossario e registro delle decisioni docs/decisioni/ (6 ADR).

Modificato

• Il README rimanda a docs/sviluppo.md e docs/rilascio.md per build, test e setup, invece di duplicarli.
• Fase 2: dopo "Verifica presenza" la riga selezionata mantiene il verde/rosso dell'esito invece di diventare blu.

[1.0.0] - 2026-09-23

Prima versione distribuita agli utenti tramite setup di installazione.

Aggiunto

• Setup di installazione per-utente (installer/PrepStep.iss, Inno Setup 6): PrepStep-Setup-<versione>.exe installa in %LOCALAPPDATA%\Programs\PrepStep senza diritti di amministratore, crea nel menu Start i collegamenti al programma e al disinstallatore (quello sul desktop è facoltativo) e registra l'app in "Impostazioni → App installate".
• Il setup, se l'app è già installata, chiede se aggiornarla/reinstallarla, disinstallarla o uscire; con /VERYSILENT aggiorna senza chiedere. Aggiornando, database e impostazioni restano.
• "File → Elimina CSV delle distinte...": elimina i CSV generati dall'import, che altrimenti si accumulano nella cartella di lavoro (uno per distinta). Chiede conferma mostrando l'elenco dei file; non tocca gli .xls del gestionale né raw//step/.
• Guida utente e guida in-app: nuova sezione "Dove finiscono i file" (database, CSV, raw/, step/, comandi di pulizia, come aprire la cartella nascosta in AppData, file che restano dopo la disinstallazione).
• Licenza proprietaria (LICENSE, © 2026 Davide Grilli, tutti i diritti riservati), anche nei metadati dell'exe e del setup.
• README: sequenza completa di comandi per generare il setup a ogni release.

Modificato

• Nome dell'app mostrato all'utente: da "Cevolani StepPrep" a "PrepStep - Cevolani" (titolo finestra, guida, setup, menu Start, "App installate").
• Il database è sempre cad_index.db nella cartella di installazione: all'avvio si carica solo quello e "Aggiorna indice" lo crea lì se manca. "Apri DB..." carica un altro database solo per la sessione corrente.
• La cartella di lavoro predefinita (se non ne è stata scelta una con "File → Scegli cartella di lavoro...") è la cartella di installazione, invece della cartella del database.
• Guida utente: fase 1 riscritta per il database fisso; tolta la sezione di installazione (chi legge la guida ha già il programma; le istruzioni restano nel README.md).
• Finestra Guida più grande (1000×680) e testo non più "da editor": niente cursore lampeggiante, niente cursore a "I" e niente selezione col mouse.
• Documentazione riallineata al codice: nomi delle fasi come nella UI ("5. Verifica completezza"), "File → Nuovo" che non cancella file su disco, mappa dei file e test nel README, riferimenti a metodi non più esistenti (AssiemeCompleto) e ruolo di CaricaCodiciNoti/CaricaCandidati in fase 4.

Rimosso

• Memoria dell'ultimo database aperto (%AppData%\PrepStep\ultimo_db.txt) e ricerca di cad_index.db nella cartella corrente.

[0.9.0] - 2026-09-23

Aggiunto

• Guida utente docs/guida-utente.md: tutti i passi, dalla distinta esportata dal gestionale fino all'esportazione STEP con Creo Distributed Batch.
• Fase 2: bottone "Verifica presenza", visibile solo dopo un import riuscito; è lui (non il solo import) a sbloccare "Avanti". Etichette numerate accanto ai bottoni.
• Dialogo "Componenti referenziati trovati": bottone "Chiudi" (anche con Esc) e icona dell'app.

Modificato

• "Scegli cartella di lavoro..." e "Pulisci raw e step..." spostati dalla fase 1 al menu File, raggiungibili in qualunque momento; "File → Nuova estrazione" rinominato in "Nuovo".
• Fase 1 ridisegnata in una card di stato "Database" con indicatore verde/rosso; rimossa la card "Cartella di lavoro".
• Barra Avanti/Indietro trasformata in floatbar staccata dai bordi, con bottoni di dimensioni e stile uniformi (riusata anche nel dialogo dei componenti referenziati).
• Finestra Guida ridisegnata: sezioni con titolo, passi numerati e callout "Nota"/"Attenzione" colorati; sidebar con selezione nel blu dell'app.
• Testi delle fasi 3-4 semplificati.

Corretto

• "Avanti" restava disabilitato in fase 1 all'avvio anche con DB e cartella di lavoro già caricati.
• Guida in-app e README citavano ancora "Verifica completezza assiemi" e "Cambia cartella...", rimossi da tempo.

[0.1.0] - 2026-09-22

Aggiunto

• Wizard a 5 fasi (Database → Importa Distinta Base → Crea cartella raw → Trova componenti referenziati → Verifica completezza) per preparare i file raw/ da passare a Creo Distributed Batch per l'esportazione STEP.
• Indicizzazione dei file CAD Pro-ENGINEER/Creo di un disco/share di rete (radice di default X:\) in un DB SQLite locale (cad_index.db), con aggiornamento incrementale e barra di progresso.
• Import della distinta base dall'export del gestionale (.xls/.xml) in CSV componente;descrizione, incluso il riconoscimento della convenzione DBP_<codice>_<timestamp> per aggiungere l'assieme generale come riga.
• Creazione della cartella raw/ con copia parallela dei file CAD dei componenti trovati nell'indice.
• Risoluzione ricorsiva dell'albero componenti dai file .asm (sotto-assiemi, parti, componenti soppressi, riferimenti esterni), con parser esatto dei record binari (AsmRecordReader) e fallback euristico testuale (AssemblyComponentScanner) per i file fuori formato.
• Scelta automatica della copia corretta quando lo stesso codice esiste in più cartelle della share, preferendo quella della cartella dell'assieme che la referenzia.
• Anteprima trascinabile (drag&drop) dei file .asm della distinta già in raw/, pronti per Creo Distributed Batch.
• Menu "File → Nuova estrazione" (Ctrl+N) per ripartire con una nuova distinta senza ricaricare database e cartella di lavoro, e "Aiuto → Guida" (F1) con una sintesi interattiva delle 5 fasi.
• Script standalone C# file-based (scripts/): ExtractCreoStrings.cs, BomViaDb.cs, CreoBom.cs, per estrarre la distinta componenti da riga di comando.
• Pubblicazione come eseguibile standalone single-file self-contained (Windows x64).