Integra il parser esatto del .asm nella GUI (fase 4 e 5)
AsmRecordReader (spostato da scripts/CreoBom.cs nel progetto principale, unica fonte di verita' condivisa con lo script via #:project) sostituisce AssemblyComponentScanner in Form1.RisolviAlberoComponenti (fase "Trova componenti referenziati") e AssiemeCompleto (fase "Verifica completezza"): legge esattamente la sezione "members" del binario invece di contare occorrenze testuali, eliminando i falsi positivi/negativi noti dell'euristica (riferimenti fantasma, placement senza suffisso, ecc.). Se un file non rispetta il formato validato (InvalidDataException, coperto solo dagli 8 campioni usati per il reverse engineering) Form1 ripiega sull'euristica di AssemblyComponentScanner, che resta quindi come fallback e come fonte di verita' per gli script BomViaDb.cs/ExtractCreoStrings.cs. Aggiunti test per AsmRecordReader (fixture binarie costruite a mano: lettura membri, risoluzione ConfigName, conteggio disallineato, sezione assente). Aggiornata la documentazione (CLAUDE.md, docs/architettura.md, docs/formato-asm.md, docs/formato-asm-record.md) di conseguenza. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
60dfd26e8b
commit
cce377a091
8 files changed
+363
-163
No files matched your search
+21
-11
@@ -79,14 +79,26 @@ Distinta (.xls/.xml) → CSV (componente;descrizione) → raw/ (CAD copiati
|
||||
`ROW_NUMBER() OVER (...)`, non self-join+`GROUP BY` per evitare tempi quasi quadratici su
|
||||
~200k righe).
|
||||
|
||||
## Scansione binaria dei `.asm`
|
||||
## Lettura dei componenti referenziati in un `.asm`
|
||||
|
||||
`Form1.EstraiCodiciReferenziati` (usata da `RisolviAlberoComponenti`, fase 4, e da
|
||||
`AssiemeCompleto` dentro `VerificaCompletezzaAssiemi`, fase 5) prova prima
|
||||
`AsmRecordReader.EstraiCodiciReferenziati` e ripiega su
|
||||
`AssemblyComponentScanner.EstraiCodiciReferenziati` solo se il primo lancia
|
||||
`InvalidDataException` (file che non rispetta il formato validato dal reverse engineering).
|
||||
|
||||
- **AsmRecordReader.cs** — legge esattamente la sezione `members` del binario `.asm` (id/tipo/
|
||||
nome dei componenti diretti, con risoluzione del nome istanza di family table dal parametro
|
||||
`ConfigName`): nessuna euristica, struttura a record. Lancia `InvalidDataException` se il
|
||||
file non ha una sezione `members` o se il conteggio dichiarato non torna. Dettagli in
|
||||
`docs/formato-asm-record.md`. Condivisa con `scripts/CreoBom.cs` via `#:project`.
|
||||
- **AssemblyComponentScanner.cs** — estrae euristicamente i codici componente referenziati
|
||||
dentro un `.asm` (formato per lo più binario, codici come stringhe ASCII leggibili al suo
|
||||
interno). Due strategie: codici numerici Pro-E riconosciuti da soli via regex (come nei nomi
|
||||
file), e nomi alfabetici di parti commerciali tokenizzati genericamente e validati contro
|
||||
l'elenco di codici noti del DB (altrimenti il rumore binario sarebbe ingestibile). Dettagli
|
||||
sul formato, l'euristica e i falsi positivi noti in `docs/formato-asm.md`.
|
||||
contando le occorrenze di stringhe candidate nel testo binario. Due strategie: codici
|
||||
numerici Pro-E riconosciuti da soli via regex (come nei nomi file), e nomi alfabetici di
|
||||
parti commerciali tokenizzati genericamente e validati contro l'elenco di codici noti del DB
|
||||
(altrimenti il rumore binario sarebbe ingestibile). Dettagli sull'euristica e i falsi
|
||||
positivi noti in `docs/formato-asm.md`. Resta il fallback per i file che il parser esatto
|
||||
non copre, e la fonte di verità per `ExtractCreoStrings.cs`/`BomViaDb.cs`.
|
||||
|
||||
## Import distinta base
|
||||
|
||||
@@ -151,11 +163,9 @@ dipendenze extra con `#:package Nome@versione` in testa al file):
|
||||
Pro-E).
|
||||
- **BomViaDb.cs** — come sopra ma con la tokenizzazione generica validata contro il DB, per
|
||||
intercettare anche i nomi alfabetici delle parti commerciali.
|
||||
- **CreoBom.cs** — indipendente dagli altri: legge esattamente la struttura a record del
|
||||
binario `.asm` (sezione `members` + parametro `ConfigName`, vedi
|
||||
`docs/formato-asm-record.md`) invece di contare occorrenze di codici nel testo. Risolve i
|
||||
sottoassiemi cercandoli in cartelle locali (`-p`), non contro `cad_index.db`. Non sostituisce
|
||||
l'euristica di `AssemblyComponentScanner` nella GUI né negli altri script.
|
||||
- **CreoBom.cs** — usa `AsmRecordReader` (stesso lettore esatto della GUI, fase 4/5, via
|
||||
`#:project`) invece dell'euristica testuale. Risolve i sottoassiemi cercandoli in cartelle
|
||||
locali (`-p`), non contro `cad_index.db` come `ExtractCreoStrings.cs`/`BomViaDb.cs`.
|
||||
- **Analyze.cs** — dump del contesto testo/hex attorno a un pattern in un file binario, per
|
||||
investigare a mano nuovi falsi positivi prima di toccare la regex di
|
||||
`AssemblyComponentScanner`.
|
||||
|
||||
Reference in new issue
Block a user