0 Fork 0

Files

T

davideandClaude Sonnet 5.5 ccfa00ff52 Aggiungi docs-as-code: indice Diátaxis, nuovi doc e controllo automatico

Nuovi doc: tutorial-primo-giro, risoluzione-problemi, sviluppo, rilascio,
glossario e registro delle decisioni (docs/decisioni, 6 ADR). docs/README.md
e' l'indice per categoria e la tabella delle fonti uniche; il README di
root rimanda a sviluppo/rilascio invece di duplicarli.

scripts/CheckDocs.cs verifica link e ancore, <Version> contro CHANGELOG,
copertura di architettura.md e presenza di ogni doc nell'indice;
.markdownlint-cli2.jsonc configura il lint Markdown.

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

2026-10-02 08:05:10 +02:00

3.1 KiB

Raw Blame History

Risoluzione dei problemi

Sintomo → causa probabile → cosa fare. I messaggi di Creo non nominano il file né la causa, per questo il sintomo è il punto di partenza.

Dentro l'app

Sintomo	Causa probabile	Cosa fare
Pallino rosso in fase 1, "Database non trovato"	non c'è `cad_index.db` nella cartella di installazione	Aggiorna indice (lo crea lì), oppure Apri DB... per usarne un altro solo per la sessione
"Disco non raggiungibile: X:"	la share non è montata o non hai accesso	monta `X:\` e riprova; la radice è fissa in `Form1.RadiceDiscoDefault`
Componente rosso in "Verifica presenza"	il codice non è nell'indice: indice vecchio, oppure il nome su disco ha una lettera di revisione in più o in meno	Aggiorna indice; poi cerca il codice con `LIKE` (vedi sotto)
"Avanti" resta grigio in fase 2	manca il passo Verifica presenza	premila: non basta l'import
Alcuni file non compaiono in `raw/` dopo fase 3/4	la copia salta in silenzio i file irraggiungibili (share offline, permessi)	controlla l'accesso alla share e ripeti la fase
In fase 4 compaiono codici "non trovati"	disegni, componenti davvero assenti dalla share o falsi positivi della scansione	controllali a mano; non bloccano il lavoro
Risultati incoerenti in sviluppo	l'app sta usando il DB della cartella di build, non quello che credi	guarda il percorso mostrato in fase 1; apri il DB giusto con Apri DB...

Per capire se un codice è nell'indice:

dotnet run scripts/Query.cs -- cad_index.db "SELECT codice, tipo_file, percorso_completo FROM files_ultima_versione WHERE codice LIKE '925%' LIMIT 20"

Nessuna riga nemmeno con LIKE → il file non è indicizzato. Una riga con codice leggermente diverso → revisione, maiuscole o spazi.

In Creo Distributed Batch

Sintomo	Causa probabile	Cosa fare
`[-4] Dati di input non completi`	nell'albero manca un file che Creo deve caricare, ma non dice quale	rifai la fase 4 e leggi l'elenco dei "non trovati"; poi vedi sotto
L'assieme non si apre, nessun messaggio chiaro	in `raw/` c'è una copia sbagliata di un componente (lo stesso codice esiste in più cartelle, 13% dei casi)	l'app sceglie la copia nella cartella dell'assieme: `formato-asm-record.md` §7.4
Assieme con un componente soppresso che non si apre	il file del soppresso non era in `raw/`	§7.3; oggi la fase 4 lo copia
Assieme con feature di assembly o datum copiati che non si apre	manca il modello citato per riferimento esterno	§7.5; oggi la fase 4 lo copia con il suo albero

Da sviluppatore

Sintomo	Causa	Cosa fare
`dotnet run` apre la GUI e si blocca	lanciato dentro `PrepStep/`	lanciare gli script dalla root del repo
`dotnet publish` fallisce con file in uso	l'app è aperta	chiudila e ripeti
`CheckDocs.cs` segnala un file non descritto	nuovo `.cs` o doc non documentato	aggiungilo a `architettura.md` o a `docs/README.md`

Dopo la disinstallazione

Restano cad_index.db, raw/, step/, i CSV e %AppData%\PrepStep\: vanno cancellati a mano.

3.1 KiB Raw Blame History