# DOMUSCAN — Criteri di collaudo dei SAL

> Condizioni per considerare superato ciascun SAL dell'offerta del 21/07/2026. Riferimenti: [METRICHE.md](METRICHE.md), [PIANO_PILOTA.md](PIANI_DI_IMPLEMENTAZIONE/PIANO_PILOTA.md), [DECISIONI.md](DECISIONI.md).
>
> **Stato:** bozza da approvare dal committente (TODO 0.6).

## Regole generali del collaudo

1. **Dove:** in ambiente di **staging**, con la stessa configurazione della produzione.
2. **Su cosa:** sul corpus pilota autorizzato (porzione di verifica) e sui set di prova costruiti apposta: documenti alterati, casi limite sintetici.
3. **Esito per test:** ogni test è *superato* o *non superato*. I test marcati **[B]** sono **bloccanti**: uno solo non superato fa fallire il SAL. Gli altri, se non superati, richiedono un piano di correzione concordato e firmato dal committente.
4. **Metriche:** le soglie assolute di [METRICHE.md](METRICHE.md) (M1, M5, M7, M8, M9, M10) sono sempre bloccanti.
5. **Evidenze:** per ogni test si conservano input, output e log, così da poter ripetere il test.
6. **Verbale:** il collaudo si chiude con un verbale firmato (data, versione del software, esiti, eventuali riserve). La fattura del SAL si emette dopo il verbale positivo.
7. **Fuori perimetro (D6):** spiegazione IA, tassonomia, benchmark di congruità e stampante virtuale non sono oggetto di collaudo nei SAL 1–3. Il test T05 del Capitolato (benchmark) è quindi escluso.

**Legenda delle origini dei test:** `DIBP‑Txx` = Specifica tecnica DIBP §17; `CAP‑Txx` = Capitolato §10; `DS‑xx` = test aggiunti in questo documento.

---

## SAL 1 — Fondamenta e acquisizione (2.500 €)

**Perimetro:**
- ambienti e database;
- acquisizione da upload e cartella sorvegliata;
- Document Vault con SHA‑256 e provenienza;
- estrazione FatturaPA (XML e `.p7m`) e PDF con OCR selettivo;
- Document ID, chiave fiscale canonica e Binding Token;
- pipeline a job idempotente.

**Precondizioni:** staging operativo su VPS OVH; corpus pilota caricabile; ground truth delle fatture disponibile.

| ID | Origine | Scenario | Esito richiesto |
|---|---|---|---|
| S1‑01 [B] | DS | Import dell'intero lotto di fatture del corpus via upload | Ogni file ha Document ID, SHA‑256, data, canale e utente di acquisizione; l'originale è conservato immutato e cifrato |
| S1‑02 [B] | CAP‑T06, DS | Stesso file importato via upload e via cartella sorvegliata | Un solo documento con due provenienze (M10 = 0) |
| S1‑03 [B] | CAP‑T06 | Riavvio di un job interrotto a metà lotto | Nessun duplicato; il job riprende solo sugli elementi non completati |
| S1‑04 | CAP‑T01 | XML con più aliquote, ritenuta, nota di credito, più righe | Campi estratti corretti; ogni campo riporta la provenienza (riga XML); nessun valore desunto in silenzio da campi mancanti |
| S1‑05 | DS | Fattura firmata `.xml.p7m` | Contenuto XML estratto e letto; firma originale conservata |
| S1‑06 | CAP‑T01 | PDF nativo e PDF scansionato della stessa tipologia | Testo e coordinate dal PDF nativo; OCR solo sulle pagine scansionate; campi incerti in revisione, non presentati come certi |
| S1‑07 [B] | DIBP‑T08 | File modificato dopo l'acquisizione (set di alterazioni M8) | L'alterazione è rilevata dal confronto dell'hash (M8 = 100%) |
| S1‑08 [B] | DIBP‑T02 | Generazione di 10.000 token e verifica di token con un carattere sbagliato o due caratteri scambiati | Token tutti univoci, nel formato `DSN-XXXX-XXXX`, senza dati personali; il checksum rifiuta il 100% degli errori di prova |
| S1‑09 | DS | Calcolo della chiave fiscale canonica sul corpus | Chiavi uguali solo per documenti uguali; i duplicati e le collisioni vengono segnalati |
| S1‑10 [B] | DS | Utente di uno studio che prova ad accedere ai documenti di un altro studio | Accesso negato e registrato (M9 = 0) |

**Metriche al SAL 1:** M4 per le fatture (separata per formato), M8, M10. Le soglie di M4 si fissano dopo i prototipi P1/P2.

---

## SAL 2 — Registro, matching, Print Layer e Review Console (3.000 €)

**Perimetro:**
- Binding Registry con stati e versioni;
- copia del token in causale;
- parser del consuntivo;
- matching (livelli A–E);
- casi complessi;
- sigillo con firma (D5);
- PDF arricchito con QR;
- Review Console;
- preflight;
- migrazione dello storico.

**Precondizioni:** SAL 1 collaudato; consuntivi del corpus con token inseriti dallo studio pilota (o prodotti nell'indagine Danea); ground truth delle righe.

| ID | Origine | Scenario | Esito richiesto |
|---|---|---|---|
| S2‑01 [B] | DIBP‑T01 | Riga con token valido e dati coerenti | Associazione automatica (livello A) e QR corretto sulla riga |
| S2‑02 [B] | DIBP‑T02 | Riga con token digitato male | Bloccata dal checksum; nessun abbinamento automatico; eccezione in Review Console |
| S2‑03 [B] | DIBP‑T03 | Riga con token di un altro condominio | Blocco (livello E) e segnalazione |
| S2‑04 [B] | DIBP‑T04, CAP‑T02 | Due fatture con lo stesso importo, riga senza token | Nessun abbinamento automatico; entrambe proposte come alternative |
| S2‑05 [B] | DIBP‑T05 | Una fattura ripartita su due voci (es. scala A e B) | Un solo QR copiato su entrambe **solo** se la somma chiude al centesimo; altrimenti nessun QR su nessuna delle due |
| S2‑06 | DIBP‑T06 | Tre fatture su una voce aggregata | Associazione con allocazioni la cui somma coincide con la voce |
| S2‑07 [B] | DIBP‑T09 | Riga senza token ma con chiave fiscale univoca | Associazione automatica (livello B) registrata nell'audit con metodo `fiscal_key` |
| S2‑08 [B] | DIBP‑T10, CAP‑T02 | Riga ambigua: nota di credito, pagamento parziale, dati incompleti | In coda di revisione; nessun QR pubblicato |
| S2‑09 [B] | CAP‑T03 | Consuntivo con margini stretti e molte voci | QR o richiami numerati con pagina indice; testi e valori originali invariati (M7 = 100%) |
| S2‑10 | DS | Storno su una fattura già associata | Lo storno è una nuova entry che punta all'originale. Se la catena chiude, il sigillo resta valido; se non chiude, l'accesso viene negato |
| S2‑11 | DS | Operatore che conferma, rifiuta, divide (split), unisce (merge) e rettifica dalla Review Console | Ogni azione registrata con attore, data, valori prima/dopo e motivo; storico visibile |
| S2‑12 [B] | DIBP‑T12 | Ristampa dello stesso rendiconto | Risultato identico: stessi QR, nessun duplicato (M10 = 0) |
| S2‑13 | DS | Migrazione di un esercizio già contabilizzato senza token | Associati in automatico solo i casi univoci; gli altri vanno in revisione; pubblicazione solo dopo la quadratura |
| S2‑14 [B] | DS | Preflight su un rendiconto con un binding non confermato, un documento revocato e un hash alterato | Nessun QR emesso per quelle righe; il report delle eccezioni le elenca |

**Metriche al SAL 2:** M1 = 0 [B], M5 = 100% [B], M7 = 100% [B], M10 = 0 [B]; M2, M3 e M4 (righe del consuntivo) riportate e confrontate con le soglie approvate.

---

## SAL 3 — Resolver, accessi e messa in produzione (2.000 €)

**Perimetro:**
- resolver pubblico su `verify.domuscan.it`;
- Secure Viewer e scheda spesa;
- account dei condomini su invito (D7);
- revoca;
- sicurezza operativa;
- collaudo su flussi reali;
- consegna della documentazione.

**Precondizioni:** SAL 2 collaudato; produzione su VPS OVH con HTTPS; almeno uno studio pilota con dati reali e accordi privacy firmati.

| ID | Origine | Scenario | Esito richiesto |
|---|---|---|---|
| S3‑01 [B] | DS | Condomino invitato e autenticato che inquadra il QR di una sua spesa | Scheda spesa con documento in sola lettura, riga del bilancio, stato e versione |
| S3‑02 [B] | CAP‑T04, DIBP‑T11 | QR inquadrato da un utente anonimo o di un altro condominio | Nessun documento o dato sensibile esposto; tentativo registrato (M9 = 0) |
| S3‑03 [B] | DS | Il QR contiene solo un URL con codice opaco | Nessun importo, nome, dato personale, Document ID interno o URL diretto del file; i codici non sono enumerabili |
| S3‑04 [B] | DIBP‑T08 | Documento alterato nel Vault dopo la pubblicazione | Il resolver rileva la differenza di hash, blocca la visualizzazione e avvisa |
| S3‑05 [B] | DIBP‑T07, CAP‑T06 | Binding revocato e sostituito da una nuova versione | Il QR stampato risolve la versione valida e mostra la rettifica; l'accesso revocato è negato senza ristampare |
| S3‑06 | DIBP‑T06 | QR di una voce aggregata | Pagina di riepilogo con elenco dei documenti e somma uguale alla voce |
| S3‑07 [B] | DS | Verifica del sigillo con la sola chiave pubblica | La verifica riesce sui sigilli validi e fallisce su quelli manomessi |
| S3‑08 [B] | CAP‑T07 | Gestionale e sue API non raggiungibili | L'intero flusso PDF/XML, dall'import alla pubblicazione, funziona |
| S3‑09 [B] | DS | Ripristino da backup su un ambiente pulito | Database e Vault ripristinati; hash verificati; tempo di ripristino registrato |
| S3‑10 | DS | Flusso reale end‑to‑end con lo studio pilota: arrivo delle fatture, registrazione con token, consuntivo, pubblicazione, consultazione | Completato dall'operatore dello studio con il manuale fornito; M6 misurato |
| S3‑11 [B] | DS | Consegna della documentazione | Presenti: istruzioni di installazione, migrazioni, backup/restore e deploy; diagramma architetturale; schema dati; contratti API; manuale operatore; piano di retention e incidenti |
| S3‑12 [B] | DS | Gate legale e privacy | Accordi ex art. 28 firmati, informativa ai condomini pubblicata, retention configurata |

**Metriche al SAL 3:** tutte le soglie assolute (M1, M5, M7, M8, M9, M10) sul flusso reale; M6 confrontato con la baseline della Fase 0.

---

## Approvazione

| Ruolo | Nome | Data | Firma |
|---|---|---|---|
| Committente | Ing. Christian Canino | | |
| Sviluppo | | | |
