davideandClaude Sonnet 5
13798ad47c
Working folder (phase 1): CSV/raw/step/step_finali all used to live split across two different implicit locations (CSV in the "repo root" found by walking up for CLAUDE.md, raw/step next to the input distinta file) with neither shown to the user. That repo-root lookup also silently breaks once the app runs as a standalone published exe on a machine with no repo/ CLAUDE.md at all. Replaced both with one explicit "cartella di lavoro", auto-suggested (last used, remembered the same way as the DB path) and changeable from phase 1, with no dependency on any repo marker file. Rename: CadSearchGui was the working name from before the app had a product identity; renamed folders, csproj files, namespace and the AppData settings folder to PrepStep throughout, matching the exe name already in use. Product-facing name stays "Cevolani StepPrep". Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
110 lines
4.1 KiB
Markdown
110 lines
4.1 KiB
Markdown
# Cevolani StepPrep
|
|
|
|
App Windows Forms (.NET 10, progetto `PrepStep`) per indicizzare, cercare e
|
|
recuperare i file CAD Pro-ENGINEER/Creo di un disco/share di rete, e per trasformare
|
|
l'estrazione "Distinta Base" del gestionale (file `.xls`/`.xml`) in un CSV con il
|
|
percorso CAD di ogni componente, fino a raccogliere in `raw/` tutto il necessario per
|
|
l'esportazione STEP con **Creo Distributed Batch**: è un pre-processo per quel
|
|
passaggio, non lo sostituisce.
|
|
|
|
## Funzionalità
|
|
|
|
1. **Indice CAD** — all'avvio carica automaticamente `cad_index.db` (se
|
|
presente accanto all'eseguibile). Se manca, si può selezionare un DB
|
|
esistente con **Apri DB...** o generarne uno nuovo con **Aggiorna
|
|
indice**, che scansiona il disco (di default `X:\`, tutte le cartelle di primo
|
|
livello che trova) e indicizza tutti i file. In questa fase si vede/cambia anche
|
|
la **cartella di lavoro**: dove finiscono il CSV e le cartelle `raw/`, `step/`,
|
|
`step_finali/`. Proposta automaticamente (ricordata da un avvio all'altro),
|
|
modificabile con **Cambia cartella...**.
|
|
2. **Importa Distinta Base** — trascina (o scegli da file) l'estrazione
|
|
`.xls`/`.xml` del gestionale (foglio "Distinta Base", colonne
|
|
Componente/Descrizione): viene generato un CSV nella cartella di lavoro, con
|
|
anteprima in griglia. Se il file segue la convenzione di nome
|
|
`DBP_<codice>_<timestamp>` del gestionale, l'assieme generale dell'estrazione
|
|
viene aggiunto come riga in più nel CSV (il foglio elenca solo i componenti
|
|
sotto l'assieme, non l'assieme stesso).
|
|
3. **Crea cartella raw** — cerca nell'indice il percorso CAD di ogni
|
|
componente importato (assieme generale incluso) e copia i file trovati
|
|
in una cartella `raw/` dentro la cartella di lavoro.
|
|
4. **Trova componenti referenziati** — legge i metadati dei file `.asm` in
|
|
`raw/` per trovare ricorsivamente i sotto-assiemi/parti che li
|
|
compongono, copiandoli a loro volta in `raw/`.
|
|
5. **Verifica completezza assiemi** / **Report STEP realizzati** — confronta
|
|
la distinta con l'indice (per capire se manca qualche sotto-componente)
|
|
e con la cartella `step/` (per capire quali STEP sono già stati
|
|
realizzati).
|
|
|
|
## Requisiti
|
|
|
|
- Windows
|
|
- [.NET 10 SDK](https://dotnet.microsoft.com/download) (per build/run da sorgente)
|
|
- Accesso alla share di rete con i file CAD (`X:\` di default) per
|
|
l'indicizzazione
|
|
|
|
## Build
|
|
|
|
```powershell
|
|
cd PrepStep
|
|
dotnet build -c Release
|
|
```
|
|
|
|
## Avvio
|
|
|
|
Da sorgente:
|
|
|
|
```powershell
|
|
cd PrepStep
|
|
dotnet run -c Release
|
|
```
|
|
|
|
Oppure l'eseguibile già compilato:
|
|
|
|
```powershell
|
|
cd PrepStep\bin\Release\net10.0-windows
|
|
.\PrepStep.exe
|
|
```
|
|
|
|
## Pubblicazione (eseguibile standalone)
|
|
|
|
Genera un `.exe` self-contained per Windows x64, senza bisogno del runtime
|
|
.NET installato sulla macchina di destinazione:
|
|
|
|
```powershell
|
|
cd PrepStep
|
|
dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -o publish
|
|
```
|
|
|
|
L'eseguibile risultante è in `PrepStep\publish\PrepStep.exe` — un unico
|
|
file, si copia e si lancia su un'altra macchina Windows senza bisogno di .NET
|
|
installato.
|
|
|
|
## Struttura del progetto
|
|
|
|
Tutto il codice è in `PrepStep/` (unico progetto nella solution, GUI e
|
|
indicizzazione integrate):
|
|
|
|
- `Program.cs` — entry point.
|
|
- `Form1.cs` — finestra principale (indice CAD, import Distinta Base, griglia
|
|
risultati); UI costruita interamente in codice, nessun designer visuale.
|
|
- `Indexer.cs` — scansione del disco e scrittura/aggiornamento del DB SQLite.
|
|
- `DistintaBaseImporter.cs` — parsing del file Distinta Base (SpreadsheetML
|
|
XML o Excel binario/OpenXML tramite ExcelDataReader) e generazione CSV.
|
|
- `ProgressForm.cs` — dialog di avanzamento durante l'aggiornamento indice.
|
|
|
|
Il database generato (`cad_index.db`), i file Excel/CSV della distinta
|
|
trascinati nella root e le cartelle `raw/`/`step/` sono rigenerabili e non
|
|
sono tracciati in git (vedi `.gitignore`).
|
|
|
|
## Test
|
|
|
|
`PrepStep.Tests/` contiene unit test (regex di estrazione dei componenti
|
|
dai `.asm`, parsing del nome file Pro-E) e integration test (schema/vista SQL
|
|
reale, con focus sui bug di case-sensitivity/duplicati già risolti). Da
|
|
eseguire:
|
|
|
|
```powershell
|
|
cd PrepStep.Tests
|
|
dotnet test
|
|
```
|