0 Fork 0

T

davideandClaude Sonnet 5 948937ba75 Aggiungi la guida utente e allinea i testi rimasti indietro sulla fase 5

Nuova docs/guida-utente.md: tutti i passi in ordine che deve fare
l'utente, dalla distinta esportata da Fata (gestionale) fino
all'esportazione STEP con Creo Distributed Batch (passi generali presi
da documentazione/community PTC, con avviso che i nomi dei menu
variano per versione/configurazione aziendale). Include anche i
consigli pratici di impostare la cartella di lavoro e pulire raw/step
prima di ripartire con una distinta diversa.

GuidaForm.cs e README.md citavano ancora una "Verifica completezza
assiemi" e un bottone "Cambia cartella..." rimossi da tempo dal
codice, mai allineati nei testi: corretti nello stesso commit.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

2026-09-22 16:22:39 +02:00

docs

Aggiungi la guida utente e allinea i testi rimasti indietro sulla fase 5

2026-09-22 16:22:39 +02:00

PrepStep

Aggiungi la guida utente e allinea i testi rimasti indietro sulla fase 5

2026-09-22 16:22:39 +02:00

PrepStep.Tests

Copia in raw anche i modelli citati per riferimento esterno

2026-09-22 14:09:48 +02:00

scripts

Integra il parser esatto del .asm nella GUI (fase 4 e 5)

2026-09-21 16:14:00 +02:00

.gitignore

Redesign the final STEP phase to build a step_finali folder

2026-09-17 10:23:35 +02:00

CHANGELOG.md

Aggiungi CHANGELOG.md con la voce 0.1.0

2026-09-22 14:25:30 +02:00

CLAUDE.md

Aggiungi la guida utente e allinea i testi rimasti indietro sulla fase 5

2026-09-22 16:22:39 +02:00

README.md

Aggiungi la guida utente e allinea i testi rimasti indietro sulla fase 5

2026-09-22 16:22:39 +02:00

README.md

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à

Indice CAD — all'avvio carica automaticamente l'ultimo cad_index.db usato (ricordato tra un avvio e l'altro). 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. La cartella di lavoro (dove finiscono il CSV e la cartella raw/; gli STEP esportati con Creo vanno in step/, dentro la stessa cartella) è proposta automaticamente e ricordata tra un avvio e l'altro, modificabile in qualunque momento da File → Scegli cartella di lavoro....
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). Il bottone Verifica presenza (compare solo dopo un import riuscito) cerca i componenti nel database — è questo passo, non il solo import, a sbloccare la fase successiva.
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.
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/ (passo opzionale se la distinta contiene solo parti singole).
Trascina su Creo — mostra i file .asm della distinta già in raw/, trascinabili su Creo Distributed Batch per l'esportazione STEP (passo manuale, fuori da quest'app): scrive in step/, dentro la cartella di lavoro.

Guida utente passo-passo completa in docs/guida-utente.md (stessa sintesi anche in-app da Aiuto → Guida, F1).

Requisiti

Windows
.NET 10 SDK (per build/run da sorgente)
Accesso alla share di rete con i file CAD (X:\ di default) per l'indicizzazione

Build

cd PrepStep
dotnet build -c Release

Avvio

Da sorgente:

cd PrepStep
dotnet run -c Release

Oppure l'eseguibile già compilato:

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:

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:

cd PrepStep.Tests
dotnet test