Files
prep-step/docs/README.md
T
davideandClaude Opus 5.5 3396df6be0 Leggi il solido dei .prt ed esportalo in STEP senza Creo
- 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>
2026-11-17 09:00:51 +01:00

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

How-to — svolgere un compito

Reference — consultare

  • architettura.md — il processo delle 5 fasi e la mappa file-per-file.
  • db-cad-index.md — schema, vista e query di cad_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/.asm e 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 (.prt e .asm): contenitore, grammatica, numeri, cosa c'è in ogni sezione, con un parser di riferimento in scripts/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é

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