- scripts/psb/brep.py: B-rep esatto da VisibGeom/ActDatums riscritto in STEP; coincide faccia per faccia con lo STEP di Creo su due campioni. - scripts/psb/mesh.py: STEP sfaccettato dalla mesh di SolidPrimdata, per i file Wildfire in cui VisibGeom e' cifrata. - psb.py: tabella dei double corretta (modi a 3/6 byte, prefissi con buchi, costanti 04 e 0d, tag ee); tabella dei float a 81 voci, i tag ignoti non ricevono piu' un valore inventato; struct dichiarate sotto due id. - tagfit.py, fltfit.py, stepread.py: verifica delle tabelle con vincoli geometrici e confronto con lo STEP di Creo. - docs: nuovo formato-prt-brep.md e lettura-prt-asm.md; correzioni in formato-psb.md (3.4) e formato-prt-geometria.md (assi di local_sys = colonne); history.md con regressioni e punti aperti. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.7 KiB
3.7 KiB
Documentazione di PrepStep
Indice dei doc, organizzati secondo Diátaxis: ogni file ha uno scopo, e cambia solo quando cambia il programma.
Tutorial — imparare facendo
tutorial-primo-giro.md— il primo giro completo con una distinta vera.
How-to — svolgere un compito
guida-utente.md— i passi dell'utente fino a Creo Distributed Batch.risoluzione-problemi.md— sintomo → causa → cosa fare.sviluppo.md— build, test, script e regole per scrivere i doc.rilascio.md— pubblicare e generare il setup di una nuova versione.
Reference — consultare
architettura.md— il processo delle 5 fasi e la mappa file-per-file.db-cad-index.md— schema, vista e query dicad_index.db.formato-asm-record.md— parser esatto dei record.asm, casi limite (§7).formato-asm.md— euristica testuale di fallback.lettura-prt-asm.md— sintesi di come si legge un.prt/.asme di tutti i dati estraibili, con rimandi ai doc di formato.formato-prt-feature.md— come leggere l'albero delle feature di un.prt(reverse engineering, non ancora nel codice).formato-prt-brep.md— il solido di un.prt: B-rep, mesh di visualizzazione ed esportazione STEP senza Creo, verificati contro STEP di Creo.formato-prt-geometria.md— numeri, quote e geometria degli schizzi di un.prt, con la tabella di cosa manca per determinarlo per intero.formato-psb.md— il formato di serializzazione di tutte le sezioni (.prte.asm): contenitore, grammatica, numeri, cosa c'è in ogni sezione, con un parser di riferimento inscripts/psb/.history.md— stato del reverse engineering dei file Creo: cosa è provato, cosa manca, da dove ripartire.glossario.md— i termini usati nei doc e nell'app.../CHANGELOG.md— storico delle versioni.
Explanation — capire il perché
decisioni/— registro delle scelte di progetto (ADR).copia-raw-parallela.md— perché e come la copia inraw/è parallela.
Fonte unica (SSOT)
Ogni informazione vive in un posto; altrove si mette un link, non una copia.
| Informazione | Fonte |
|---|---|
| Versione e nome prodotto | PrepStep/PrepStep.csproj (<Version>, <Product>) |
| Schema e vista del DB | db-cad-index.md |
Formato dei record .asm e casi limite |
formato-asm-record.md |
Albero delle feature di un .prt |
formato-prt-feature.md |
Forma del solido di un .prt ed esportazione STEP |
formato-prt-brep.md |
Quote, coordinate e geometria degli schizzi di un .prt |
formato-prt-geometria.md |
Come è scritta una sezione qualsiasi di un .prt/.asm |
formato-psb.md |
| Processo delle 5 fasi, mappa dei file | architettura.md |
| Passi dell'utente | guida-utente.md |
| Build, test, regole sui doc | sviluppo.md |
| Procedura di rilascio e setup | rilascio.md |
| Perché una scelta è fatta così | decisioni/ |
| Storico release | ../CHANGELOG.md |
CLAUDE.md e README.md riassumono soltanto e rimandano a questi file.
Verifica
dotnet run scripts/CheckDocs.cs
npx markdownlint-cli2