pa-data-vault

Vault centrale dei dati identificativi per la compilazione di portali PA italiani. Fornisce un data bundle strutturato alle skill pa-form-filler e pa-legal-clause-analyzer.

I dati vivono in file Markdown sotto references/. Lo schema usa il segnaposto [da completare] per i campi non ancora inseriti: grep-able, auto-documentante, non rompe il workflow.

Struttura References

pa-data-vault/references/
├── personal/
│   └── glody.md                    profilo personale (CF, PEC, codici; mai password: il login ai portali lo fa Glody a mano)
└── bnb-property/
    └── structure.md                dati struttura (CIN, codici, capacità, certificazioni)

Aggiungere una seconda struttura: crea references/bnb-struttura2/structure.md copiando lo schema da bnb-property/structure.md e sostituendo i valori. Nessuna altra modifica richiesta.

Workflow

1. Caricamento Profilo

INPUT: tipo profilo (personal/glody, bnb-property/structure, ...)

- Leggi il file references/{tipo}.md
- Parsa i blocchi code-fence con formato key: value
- Restituisce data bundle come mappa chiave→valore

2. Detection Campi Mancanti

- Filtra il bundle per valori == "[da completare]"
- Restituisce lista campi_mancanti con chiave e sezione
- Esempio output:
  CAMPI MANCANTI in bnb-property/structure.md:
  - [Identificazione] cin
  - [Identificazione] codice_struttura_milano
  - [Gestore] codice_fiscale_gestore

Se campi_mancanti è vuoto, il vault considera il profilo completo e restituisce il bundle senza avvisi.

3. Salvataggio Nuovo Valore

INPUT: tipo profilo, chiave campo, valore

- Leggi references/{tipo}.md
- Trova la riga "chiave: [da completare]"
- Sostituisce "[da completare]" con il valore fornito
- Riscrive il file (sed in-place, BSD compatible: sed -i '' -e 's/...' file)
- Aggiorna il bundle in memoria

4. Restituzione Data Bundle

OUTPUT JSON:
{
  "profile": "bnb-property/structure",
  "data": {
    "cin": "[da completare]",
    "nome_struttura": "..."
  },
  "missing": ["cin", "codice_struttura_milano"]
}

Ricerca Documenti su Filesystem

Per trovare documenti di identità, CIN, DIA o altri file PDF/DOCX collegati a una struttura, usa la skill document-collector invece di reimplementare la ricerca:

/document-collector cerca "CIN struttura appartamento"

document-collector gestisce la ricerca su filesystem, Finder tags, e cartelle Documenti. pa-data-vault gestisce i dati strutturati nei reference file — non fa ricerca su filesystem.

Dedup scansioni: tieni solo il completo (consolidato dal brain 2026-07-15)

Quando esiste sia il file *_completo*.pdf (fronte+retro insieme) sia i pezzi separati (*_retro, *_verso, *_fronte), tieni solo il completo. I form PA spesso vogliono retro/verso separati (a volte in JPG/JPEG, a volte PDF) → si estraggono on-demand dal completo (via pdfseparate o screenshot della pagina), non vale tenerli pre-calcolati.

• Durante audit/dedup di cartelle PA: scarta *_retro*/*_verso*/*_fronte* quando esiste il *_completo* (o il file senza suffisso direzionale).
• Documenti distinti della stessa categoria (CF + carta identità + permesso soggiorno) NON sono duplicati: tienili tutti.
• Quando un form PA chiede retro/verso separati a run-time, generarli allora dal completo.

Esempio (2026-05-26): un familiare, 7 PDF in ID/ → ridotti a 3 distinti, scartati 4 retro/verso. Pattern "meno è meglio" applicato al dedup: ogni file in più è debito di gestione, l'estrazione on-demand è lavoro reversibile di 2 minuti.

Error Handling