- 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>
65 lines
3.7 KiB
Markdown
65 lines
3.7 KiB
Markdown
# Documentazione di PrepStep
|
|
|
|
Indice dei doc, organizzati secondo [Diátaxis](https://diataxis.fr/): ogni file ha **uno** scopo,
|
|
e cambia solo quando cambia il programma.
|
|
|
|
## Tutorial — imparare facendo
|
|
|
|
- [`tutorial-primo-giro.md`](tutorial-primo-giro.md) — il primo giro completo con una distinta vera.
|
|
|
|
## How-to — svolgere un compito
|
|
|
|
- [`guida-utente.md`](guida-utente.md) — i passi dell'utente fino a Creo Distributed Batch.
|
|
- [`risoluzione-problemi.md`](risoluzione-problemi.md) — sintomo → causa → cosa fare.
|
|
- [`sviluppo.md`](sviluppo.md) — build, test, script e regole per scrivere i doc.
|
|
- [`rilascio.md`](rilascio.md) — pubblicare e generare il setup di una nuova versione.
|
|
|
|
## Reference — consultare
|
|
|
|
- [`architettura.md`](architettura.md) — il processo delle 5 fasi e la mappa file-per-file.
|
|
- [`db-cad-index.md`](db-cad-index.md) — schema, vista e query di `cad_index.db`.
|
|
- [`formato-asm-record.md`](formato-asm-record.md) — parser esatto dei record `.asm`, casi limite (§7).
|
|
- [`formato-asm.md`](formato-asm.md) — euristica testuale di fallback.
|
|
- [`lettura-prt-asm.md`](lettura-prt-asm.md) — sintesi di come si legge un `.prt`/`.asm` e di tutti i dati estraibili, con rimandi ai doc di formato.
|
|
- [`formato-prt-feature.md`](formato-prt-feature.md) — come leggere l'albero delle feature di un `.prt` (reverse engineering, non ancora nel codice).
|
|
- [`formato-prt-brep.md`](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`](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`](formato-psb.md) — il formato di serializzazione di tutte le sezioni (`.prt` e `.asm`): contenitore, grammatica, numeri, cosa c'è in ogni sezione, con un parser di riferimento in `scripts/psb/`.
|
|
- [`history.md`](history.md) — stato del reverse engineering dei file Creo: cosa è provato, cosa manca, da dove ripartire.
|
|
- [`glossario.md`](glossario.md) — i termini usati nei doc e nell'app.
|
|
- [`../CHANGELOG.md`](../CHANGELOG.md) — storico delle versioni.
|
|
|
|
## Explanation — capire il perché
|
|
|
|
- [`decisioni/`](decisioni/README.md) — registro delle scelte di progetto (ADR).
|
|
- [`copia-raw-parallela.md`](copia-raw-parallela.md) — perché e come la copia in `raw/` è 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`](db-cad-index.md) |
|
|
| Formato dei record `.asm` e casi limite | [`formato-asm-record.md`](formato-asm-record.md) |
|
|
| Albero delle feature di un `.prt` | [`formato-prt-feature.md`](formato-prt-feature.md) |
|
|
| Forma del solido di un `.prt` ed esportazione STEP | [`formato-prt-brep.md`](formato-prt-brep.md) |
|
|
| Quote, coordinate e geometria degli schizzi di un `.prt` | [`formato-prt-geometria.md`](formato-prt-geometria.md) |
|
|
| Come è scritta una sezione qualsiasi di un `.prt`/`.asm` | [`formato-psb.md`](formato-psb.md) |
|
|
| Processo delle 5 fasi, mappa dei file | [`architettura.md`](architettura.md) |
|
|
| Passi dell'utente | [`guida-utente.md`](guida-utente.md) |
|
|
| Build, test, regole sui doc | [`sviluppo.md`](sviluppo.md) |
|
|
| Procedura di rilascio e setup | [`rilascio.md`](rilascio.md) |
|
|
| Perché una scelta è fatta così | [`decisioni/`](decisioni/README.md) |
|
|
| Storico release | [`../CHANGELOG.md`](../CHANGELOG.md) |
|
|
|
|
`CLAUDE.md` e `README.md` riassumono soltanto e rimandano a questi file.
|
|
|
|
## Verifica
|
|
|
|
```powershell
|
|
dotnet run scripts/CheckDocs.cs
|
|
npx markdownlint-cli2
|
|
```
|