# DOMUSCAN — Step manuali per chiudere la Fase 0

> Elenco completo delle attività **che richiedono una persona** (acquisti, accessi, riunioni, firme, verifiche sul gestionale, etichettatura, approvazioni) per superare il gate di uscita della Fase 0. Il lavoro di sviluppo che ogni blocco sblocca è indicato in fondo al blocco, solo per riferimento.
>
> Riferimenti: [PIANO_FASE_0.md](PIANI_DI_IMPLEMENTAZIONE/PIANO_FASE_0.md) · [DECISIONI.md](DECISIONI.md) · [METRICHE.md](METRICHE.md) · [CRITERI_COLLAUDO.md](CRITERI_COLLAUDO.md) · `TODO.md`
>
> **Aggiornato al:** 07/10/2026 · **Riservato** (contiene riferimenti al metodo oggetto di brevetto).

---

## Come leggere il documento

Le attività sono raggruppate per **dipendenza**: ogni blocco si apre con ciò che serve per iniziarlo (*Prerequisiti*) e contiene tutto quello che si fa una volta ottenuto. Un blocco non va iniziato finché i suoi prerequisiti non sono soddisfatti.

**Chi:**

| Sigla | Persona |
|---|---|
| **COMM** | Committente (Ing. Christian Canino) |
| **DAM** | Damiano (sviluppo) |
| **TEAM** | Damiano + Dott.ssa Franca Basilotta |
| **STUDIO** | Operatore dello studio pilota |
| **LEG** | Consulente legale/privacy |
| **BREV** | Consulente brevettuale |

### Mappa delle dipendenze

```
 BLOCCO 0  Riunione col committente ─┬─▶ BLOCCO 1  Account OVH + pannello Register.it ─▶ staging, domini, email
 (nessun prerequisito)               │
                                     ├─▶ BLOCCO 2  Consulenti legale e brevettuale
                                     │        │
                                     │        ▼
                                     └─▶ BLOCCO 3  Studi pilota (accordi firmati) ─┬─▶ BLOCCO 5  Ground truth
                                                       │                           │
 BLOCCO A  Postazione di sviluppo ──▶ token di prova ──┴─▶ BLOCCO 4  Sessione Danea ─┴─▶ BLOCCO 6  Esiti prototipi
 (nessun prerequisito)                                                                        │
                                                                                              ▼
 BLOCCO B  Verifiche documentali (nessun prerequisito)  ─────────────────────────────▶ BLOCCO 7  Gate di uscita
```

**Percorso critico:** Blocco 0 → Blocco 2 → Blocco 3 → Blocco 4 → Blocco 6 → Blocco 7. Ogni giorno di ritardo sugli accordi con gli studi sposta la chiusura della Fase 0.

---

## BLOCCO 0 — Riunione con il committente

**Prerequisiti:** nessuno. **Da fare subito**: quasi tutti gli altri blocchi partono da qui.
**Chi:** COMM + TEAM. Conviene un'unica riunione con quest'ordine del giorno e un verbale scritto.

**Ordine del giorno:**

1. **Contratto e budget**
   - [ ] Ottenere l'accettazione scritta dello **scostamento di stack** rispetto all'offerta (PHP + MariaDB su VPS invece di "Cloud‑Native"/microservizi): è una conseguenza dichiarata di D1 e i criteri di collaudo dei SAL ne dipendono.
2. **Infrastruttura** (sblocca il Blocco 1)
   - [ ] Approvare il dimensionamento e il costo mensile della VPS OVH e dello spazio di backup esterno (oggi non c'è una stima scritta: vedi Incongruenza 6).
   - [ ] Decidere chi acquista e chi amministra: account OVH del committente con accesso delegato a DAM, oppure account dedicato.
   - [ ] Decidere come DAM opera sui DNS: credenziali delegate sul pannello Register.it, oppure il committente inserisce i record su indicazione.
   - [ ] Decidere i nomi dei sottodomini: applicazione (es. `app.domuscan.it`), staging (es. `staging.domuscan.it`), resolver `verify.domuscan.it`.
   - [ ] Decidere il ruolo di `domuscan.org`: redirect su `domuscan.it`, riserva difensiva o altro uso.
   - [ ] Decidere il servizio email per la casella di acquisizione fatture (IMAP), per l'invio degli inviti ai condomini (SMTP, D7) e se attivare una PEC.
3. **Consulenti** (sblocca il Blocco 2)
   - [ ] Incaricare il consulente legale/privacy.
   - [ ] Incaricare il consulente brevettuale.
4. **Studi pilota** (sblocca il Blocco 3)
   - [ ] Nominare 1–3 studi candidati: almeno uno con Danea Domustudio, idealmente uno con un altro gestionale.
   - [ ] Stabilire chi li contatta e con quale messaggio. Prima del parere brevettuale si parla solo del servizio, non del metodo (vedi Blocco 2).
   - [ ] In alternativa o in aggiunta: valutare l'acquisto di una licenza di prova di Danea Domustudio (sblocca il Blocco 4 senza aspettare gli studi).
5. **Dati reali**
   - [ ] Scegliere dove conservare il corpus cifrato: servizio o supporto approvato, con l'accesso limitato al team.
   - [ ] Decidere se il corpus reale può essere elaborato sui PC di sviluppo (servono prototipi e ground truth) o solo su un ambiente controllato (vedi Incongruenza 9).
6. **Metriche, collaudo, backup**
   - [ ] Prima lettura di [METRICHE.md](METRICHE.md) e [CRITERI_COLLAUDO.md](CRITERI_COLLAUDO.md): approvare subito struttura, soglie assolute (M1, M5, M7, M8, M9, M10) e regole del collaudo; le soglie di M2, M3, M4 si approvano nel Blocco 6 (vedi Incongruenza 4).
   - [ ] Concordare la definizione della baseline M6, cioè cosa si cronometra presso lo studio (vedi Incongruenza 5).
   - [ ] Rivedere RPO 24 h, RTO 4 h e retention 7/4/12 di `documentazione/backup.md` (chiude il test manuale corrispondente nel TODO).
7. **Riservatezza e ruoli**
   - [ ] Condividere con tutto il team il vincolo: nessuna demo, pagina web o presentazione del metodo prima del deposito. Registrare a verbale chi ne ha preso visione.
   - [ ] Confermare la tabella *Attori* di PIANO_FASE_0.md, indicando anche chi fa la doppia verifica della ground truth (Blocco 5).

**Uscita:** verbale della riunione. Ogni decisione nuova va riportata in DECISIONI.md (es. sottodomini, conservazione del corpus).

---

## BLOCCO A — Postazione di sviluppo Windows

**Prerequisiti:** nessuno. **In parallelo al Blocco 0.**
**Chi:** DAM. Guida passo per passo in `documentazione/ambienti.md` § *Sviluppo locale*.

Installare e configurare:

- [ ] **PHP ≥ 8.3**, abilitando in `php.ini` le estensioni `pdo_mysql`, `sodium`, `openssl`, `dom`, `simplexml`, `libxml`, `mbstring`, `fileinfo`, `zlib`, `gd`, `iconv`.
- [x] **MariaDB** per Windows (server + `mariadb` + `mariadb-dump`); creare i database `domuscan` e `domuscan_test` e un utente dedicato (D12, fatto il 15/10/2026).
- [ ] **Poppler**, con la cartella `bin` nel `PATH` **prima** di quella di Git: oggi `pdftotext` risolve su quello di Xpdf incluso in Git, che non supporta `-bbox`.
- [ ] **qpdf**, aggiunto al `PATH`.
- [ ] **Tesseract** con i dati della lingua `ita`, aggiunto al `PATH`.
- [ ] Copiare `configurazione/.env.esempio` in `.env` e compilarlo per lo sviluppo. Generare una chiave del Vault e una coppia di chiavi Ed25519 di prova, solo locali.

Verificare:

- [ ] `bash strumenti/verifica_ambiente.sh` termina con **0 requisiti mancanti** (chiude i 5 bug della BUGLIST).
- [ ] `bash test/esegui_test.sh` termina con 0 test falliti.
- [ ] Test manuale del TODO: la guida `documentazione/ambienti.md` è risultata completa seguendola su questa macchina. Annotare i passi mancanti o sbagliati e correggerla.

**Sblocca (lavoro di sviluppo):**
- prototipo **P4** (generatore di token): serve **prima** della sessione Danea (Blocco 4);
- **P5** (sigillo) e **P3** (overlay su PDF generati in proprio);
- `strumenti/backup.sh`, `strumenti/ripristino.sh` e la prima prova di ripristino su MariaDB locale;
- formato CSV della ground truth e modello di inventario del corpus.

---

## BLOCCO B — Verifiche documentali

**Prerequisiti:** nessuno. Si possono fare in qualsiasi momento prima del gate.
**Chi:** TEAM (sono i test manuali del TODO).

- [ ] **Coerenza dei documenti:** leggere in parallelo progetto.md (§6.6, §7.2, §8, §10, §11), PIANO_PILOTA.md e PIANO_FASE_0.md rispetto a DECISIONI.md. Controllare che Node.js/Python, Docker, Cloud Run, OTP e il sigillo HMAC non compaiano più come scelte adottate e che ogni link apra il file giusto nell'anteprima Markdown. *Attenzione:* alcune frasi superate sono già elencate nella sezione Incongruenze.
- [ ] **Metriche calcolabili:** per ogni metrica di METRICHE.md, verificare che ogni dato necessario esista nel formato della ground truth o nei campi previsti per l'audit log.
- [ ] **Copertura dei test di collaudo:** confrontare ogni ID di CRITERI_COLLAUDO.md con i PDF originali (`DOMUSCAN_Specifica_Tecnica_Associazione_Indipendente.pdf` §17 per T01–T12 e `Domuscan_Capitolato_Layer_Stampa_Intelligente.pdf` §10 per T01–T07, escluso T05).

---

## BLOCCO 1 — Ottieni l'account OVH e l'accesso al pannello Register.it

**Prerequisiti:** Blocco 0, punto 2 (costi approvati, ruoli sull'account, nomi dei sottodomini).

### 1.1 Con l'account OVH (COMM acquista, DAM configura)

- [ ] **COMM** — Acquistare la VPS OVH in un data center UE secondo il dimensionamento approvato.
- [ ] **COMM** — Acquistare lo spazio di backup esterno (OVH Backup Storage oppure Object Storage S3‑compatibile) in un data center UE **diverso** da quello della VPS.
- [ ] **COMM** — Dare a DAM l'accesso: utente delegato sul pannello OVH e, sulla VPS, accesso SSH **solo con chiave** (DAM fornisce la sua chiave pubblica).
- [ ] **DAM** — Scegliere la distribuzione (Debian o Ubuntu LTS) e annotarla in `documentazione/ambienti.md`.
- [ ] **DAM** — Decidere se staging e produzione stanno sulla stessa VPS (utenti, database e cartelle separati) o su due VPS, e registrarlo.

### 1.2 Con il pannello DNS di Register.it (COMM o DAM con delega)

Al 07/10/2026 `domuscan.it` e `domuscan.org` **risolvono già** (nameserver `ns1/ns2.register.it`, indirizzo di parcheggio `195.110.124.133`). Lo stato *dnsHold* citato nei documenti non è più attuale (vedi Incongruenza 7). `verify.domuscan.it` non esiste ancora.

- [ ] Creare i record A/AAAA verso l'IP della VPS per: `verify.domuscan.it`, il sottodominio dell'applicazione e il sottodominio di staging scelti nel Blocco 0.
- [ ] Applicare a `domuscan.org` il ruolo deciso (es. redirect).
- [ ] Inserire i record della posta del servizio scelto (MX, SPF, DKIM, DMARC), senza i quali gli inviti ai condomini rischiano di finire nello spam.
- [ ] In alternativa a tutto quanto sopra: delegare i nameserver a OVH e gestire lì i record. Va deciso una volta sola.

### 1.3 Con il servizio email scelto (COMM attiva, DAM configura)

- [ ] Creare la casella dedicata all'acquisizione delle fatture (IMAP) e, se decisa, la PEC.
- [ ] Creare l'account SMTP per l'invio degli inviti (`SMTP_MITTENTE`, es. `noreply@domuscan.it`).
- [ ] Inviare a DAM le credenziali tramite un canale sicuro, non per email in chiaro. Vanno solo nel `.env` dei server.

### 1.4 Verifiche manuali dopo la configurazione (DAM)

- [ ] Aprire da browser (anche da smartphone) applicazione, staging e `verify.domuscan.it`: certificato valido e redirect da HTTP a HTTPS.
- [ ] Mandare un'email di prova alla casella di acquisizione e riceverne una dall'SMTP su un indirizzo esterno (Gmail), controllando che non finisca nello spam.
- [ ] Eseguire la **prova di ripristino** su staging secondo `documentazione/backup.md` e registrare data, backup usato, tempo impiegato ed esito.

**Sblocca (lavoro di sviluppo):** predisposizione di staging e produzione secondo `documentazione/ambienti.md` (pacchetti, utente di servizio, cartelle dei dati, segreti, cron, Let's Encrypt, monitoraggio minimo).

---

## BLOCCO 2 — Ottieni i consulenti legale/privacy e brevettuale

**Prerequisiti:** Blocco 0, punto 3 (consulenti incaricati).
**Nota:** i documenti di questo blocco servono **prima** di contattare in modo operativo gli studi pilota (Blocco 3).

### 2.1 Con il consulente legale/privacy (LEG, con COMM)

- [ ] Confermare i ruoli GDPR: studio titolare, DOMUSCAN responsabile del trattamento (anche per la conservazione nel Vault, conseguenza di D3).
- [ ] Ottenere il **modello di accordo ex art. 28** e un **accordo di riservatezza (NDA)** da far firmare agli studi pilota prima di ricevere qualsiasi file.
- [ ] Ottenere l'**informativa per i condomini** sull'accesso ai documenti tramite QR e account su invito (D7).
- [ ] Decidere se serve una **DPIA** e, se sì, chi la redige.
- [ ] Fissare i **tempi di conservazione** di documenti, log e backup, poi allineare la retention di `documentazione/backup.md`.
- [ ] Ottenere un parere scritto sulla **licenza di Danea**: stampare e rielaborare i PDF del consuntivo non deve violarla.
- [ ] Ottenere un parere scritto sulle **licenze GPL/LGPL** (Poppler eseguito come programma esterno; `smalot/pdfparser` e `tc-lib-pdf` in LGPL). È richiesto da DECISIONI.md prima di approvare D10.
- [ ] Ottenere la checklist privacy approvata (uscita di 0.9 nel piano).

### 2.2 Con il consulente brevettuale (BREV, con COMM)

- [ ] Allineare la scelta del sigillo **D5** (firma asimmetrica Ed25519 con timestamp). Se il consulente chiede un'altra variante, si apre una nuova decisione che sostituisce D5, perché le decisioni approvate non si modificano.
- [ ] Definire **cosa si può mostrare agli studi pilota** e a quali condizioni: lo studio deve vedere il flusso (token in causale) per partecipare, e questo è una forma di divulgazione.
- [ ] Ottenere una data stimata di deposito, che fissa la durata del vincolo di riservatezza.

**Uscita:** modelli firmabili (art. 28, NDA), informativa, parere su retention, licenza Danea e licenze software, posizione sul sigillo e regole di divulgazione.

---

## BLOCCO 3 — Ottieni gli studi pilota

**Prerequisiti:** Blocco 0, punto 4 (studi candidati) + Blocco 2.1 (accordi pronti) + Blocco 2.2 (regole di divulgazione).
**Chi:** COMM gestisce il rapporto; STUDIO fornisce; TEAM riceve e controlla.

### 3.1 Formalizzazione (COMM + STUDIO)

- [ ] Far firmare a ogni studio **NDA e accordo ex art. 28 prima di ricevere qualsiasi file**.
- [ ] Annotare per ogni studio: gestionale e versione, referente operativo, disponibilità per la sessione sul gestionale (Blocco 4) e per chiarire le discordanze della ground truth (Blocco 5).

### 3.2 Raccolta del corpus (STUDIO consegna, TEAM controlla)

- [ ] Ottenere, per **2–3 condomini** e almeno un esercizio chiuso ciascuno:
  - consuntivo/rendiconto in PDF, esportato dal gestionale (non scansionato);
  - preventivo e riparto, se disponibili;
  - **tutte** le fatture dell'esercizio in XML (meglio anche il PDF di cortesia), per 100–200 documenti in totale.
- [ ] Verificare che ci siano i **casi difficili** e richiedere quelli mancanti:
  - [ ] fatture con lo stesso importo;
  - [ ] note di credito;
  - [ ] acconto e saldo;
  - [ ] fattura ripartita su più voci o scale;
  - [ ] più fatture in una voce aggregata;
  - [ ] fatture firmate `.p7m`;
  - [ ] documenti scansionati;
  - [ ] utenze (bollette).
- [ ] Trasferire i file su un canale sicuro e salvarli **solo** nell'archivio cifrato scelto nel Blocco 0, mai nel repository, su email o in cloud non approvati.

### 3.3 Baseline del tempo operatore M6 (TEAM + STUDIO)

- [ ] Cronometrare presso lo studio l'attività concordata nel Blocco 0 (vedi Incongruenza 5) su un lotto reale e registrare minuti, numero di documenti e chi l'ha svolta.

**Sblocca (lavoro di sviluppo):** inventario completo del corpus (origine, data, studio, condominio, tipo, SHA‑256), set sintetico/anonimizzato per i test, prototipo **P2** (lettura FatturaPA) e parte di **P1** sui consuntivi storici.

---

## BLOCCO 4 — Ottieni l'accesso a un'installazione di Danea Domustudio

**Prerequisiti:**
- un'installazione reale: presso uno studio del Blocco 3 (con accordi firmati) oppure una licenza di prova acquistata dal committente;
- i **token di prova validi** generati dal prototipo P4 (Blocco A), così che il test di ritrovamento sia significativo; servono token diversi per ogni campo provato;
- un **condominio/esercizio di prova** nel gestionale: non si registrano movimenti fittizi nella contabilità reale dello studio.

**Chi:** STUDIO (o COMM con licenza di prova) opera sul gestionale; DAM assiste, prende nota e raccoglie i file. Si può fare in un'unica sessione di 2–3 ore seguendo questa checklist.

Nella sessione, per fare:

- [ ] **A. Versione:** annotare versione ed edizione di Danea Domustudio.
- [ ] **B. Campi in stampa:** registrare movimenti di prova mettendo un token diverso in ciascun campo (causale, descrizione, note, protocollo, riferimento) e verificare quali compaiono nelle stampe di:
  - [ ] consuntivo;
  - [ ] rendiconto per voce;
  - [ ] partitario.
- [ ] **C. Limiti dei campi:** provare una stringa lunga, i caratteri `[`, `]`, `-` e il formato `[DSN-XXXX-XXXX]`; annotare lunghezza massima, caratteri rifiutati e troncamenti in stampa.
- [ ] **D. PDF:** esportare in PDF le tre stampe, annotando **come** si ottiene il PDF (esportazione nativa o stampante virtuale: incide sul testo estraibile). Salvare i file con un nome che indichi stampa e campo provato.
- [ ] **E. Esportazioni:** verificare se esistono esportazioni Excel/CSV del consuntivo e se riportano la causale; salvarne un esempio.
- [ ] **F. Import delle fatture elettroniche (modalità C):** importare una fattura XML e verificare se nome del file o altri riferimenti finiscono nelle stampe.
- [ ] **G. Campo protocollo (modalità D):** verificare se esiste un protocollo utilizzabile e se compare nelle stampe.
- [ ] **H. Screenshot** delle maschere di registrazione, dei campi e delle opzioni di stampa usate.

Subito dopo:
- [ ] **TEAM** — Chiudere **D8** (modalità di aggancio) sulla base di `SCHEDA_GESTIONALE_DANEA.md` e registrarla in DECISIONI.md.
- [ ] **TEAM** — Se uno studio usa un altro gestionale, ripetere in forma ridotta i punti B, C e D.

**Sblocca (lavoro di sviluppo):** verifica del testo estraibile e del ritrovamento dei token (P1/P4, metrica M5), redazione di `SCHEDA_GESTIONALE_DANEA.md`, P3 sui PDF reali di Danea.

---

## BLOCCO 5 — Ground truth

**Prerequisiti:** corpus consegnato (Blocco 3) + formato CSV di etichettatura pronto (sviluppo, Blocco A) + decisione su dove si conserva il file (vedi Incongruenza 10).
**Chi:** TEAM; STUDIO per le discordanze.

- [ ] Etichettare **tutte** le righe di almeno un consuntivo completo **per studio** (`id_riga`, `condominio`, `esercizio`, `pagina`, `testo_voce`, `importo_voce`, `id_documenti`, `importo_allocato`, `tipo_relazione`, `certezza`, `note`).
- [ ] Segnare le righe **senza documento fiscale** (quote, giroconti…): sono casi legittimi, non errori.
- [ ] Separare la **porzione di verifica** del corpus, da non usare per tarare le regole (regola generale di METRICHE.md).
- [ ] **Doppia verifica:** una seconda persona controlla un campione; elencare le discordanze.
- [ ] Risolvere le discordanze con lo studio e fissare una versione datata della ground truth.

**Sblocca:** misura di M1–M4 nei prototipi e test di regressione dal SAL 1.

---

## BLOCCO 6 — Esiti dei prototipi e decisioni finali

**Prerequisiti:** report dei prototipi P1–P5 in `DEVELOPMENT DOCS/` (richiedono i Blocchi A, 3 e 4) + parere legale sulle licenze (Blocco 2.1) + baseline M6 (Blocco 3.3) + ground truth (Blocco 5).

- [ ] **TEAM** — Leggere i 5 report. Per ogni prototipo con esito negativo, verificare che i limiti siano documentati con un piano alternativo (es. FPDI gratuito con xref compressi → normalizzazione `qpdf`).
- [ ] **TEAM** — Test manuale del TODO: ricontrollare su Packagist e sui repository la tabella licenze/manutenzione di DECISIONI.md › *Candidate* (dati rilevati il 06/10/2026).
- [ ] **TEAM** — Chiudere **D10** compilando *Librerie approvate* (libreria, uso, licenza, motivazione).
- [ ] **TEAM** — Proporre le soglie di **M4** (dopo P1/P2) e di **M2/M3** (dopo baseline e ground truth).
- [ ] **COMM** — Approvare le soglie mancanti e firmare la tabella *Approvazione* di CRITERI_COLLAUDO.md.

---

## BLOCCO 7 — Gate di uscita

**Prerequisiti:** tutti i blocchi precedenti.

- [ ] **TEAM** — Spuntare la checklist *Gate di uscita* di PIANO_FASE_0.md, voce per voce, con il riferimento all'evidenza:

  | Voce del gate | Evidenza | Blocco |
  |---|---|---|
  | D1–D10 chiuse e approvate | DECISIONI.md (D8, D10 chiuse) | 4, 6 |
  | Documenti allineati alle decisioni | Verifica documentale | B |
  | Token presente nella stampa ed estraibile | SCHEDA_GESTIONALE_DANEA.md, M5 | 4 |
  | Corpus autorizzato, cifrato, inventariato + set anonimizzato | Accordi firmati, inventario | 3 |
  | Ground truth etichettata e verificata | File versionato e datato | 5 |
  | Metriche, baseline e criteri approvati | CRITERI_COLLAUDO.md firmato | 0, 3.3, 6 |
  | P1–P4 positivi o limiti documentati | Report in DEVELOPMENT DOCS | 6 |
  | Repository, staging, domini HTTPS, backup operativi; costi approvati | Verifiche 1.4, verbale costi | 1 |
  | Accordi privacy firmati; riservatezza condivisa | Accordi, verbale | 0, 3 |

- [ ] **TEAM** — Aggiornare TODO.md, PROJECT_STATE.md e README.md (stato della Fase 0).
- [ ] **COMM** — Approvare per iscritto la chiusura della Fase 0 e l'avvio del SAL 1.

---

## Riepilogo per persona

| Chi | Blocchi in cui è coinvolto | Attività bloccanti per gli altri |
|---|---|---|
| **COMM** | 0, 1, 2, 3, 6, 7 | Riunione (Blocco 0), acquisto VPS e accessi (1), incarico consulenti (2), studi pilota (3), eventuale licenza Danea (4) |
| **DAM** | A, B, 1, 4, 5, 6, 7 | Postazione e token P4 (A) prima della sessione Danea |
| **TEAM** | 0, B, 3, 4, 5, 6, 7 | Chiusura D8 e D10, ground truth |
| **STUDIO** | 3, 4, 5 | Corpus e sessione sul gestionale |
| **LEG** | 2 | Accordi art. 28 e NDA (senza, niente dati reali) |
| **BREV** | 2 | Regole di divulgazione verso gli studi |

---

## Incongruenze rilevate

Problemi trovati confrontando TODO.md, PIANO_FASE_0.md, DECISIONI.md, METRICHE.md, CRITERI_COLLAUDO.md, PROJECT_STATE.md, la documentazione tecnica e lo stato reale (DNS verificati il 07/10/2026). Per ognuno c'è una proposta di soluzione.

### Decisioni e TODO

1. **D5 risulta chiusa prima dei suoi prerequisiti.**
   - *Dove:* il TODO 0.1 segna `[x]` "Chiudere D5 dopo il prototipo P5 e il parere del consulente brevettuale", ma P5 non è stato fatto e il consulente non è stato sentito (TODO 0.9 aperto). DECISIONI.md la riporta APPROVATA, pur scrivendo "resta da allineare con il consulente brevettuale".
   - *Problema:* se il consulente chiede un'altra variante, per le regole del registro D5 non si può correggere e va sostituita.
   - *Proposta:* lasciarla APPROVATA con riserva esplicita "soggetta a parere BREV", oppure riportarla a PROPOSTA fino al Blocco 2.2.
2. **D7 risulta chiusa prima della checklist privacy.** Il TODO dice "Chiudere D7 dopo la checklist privacy (0.9)", ma tutta la 0.9 è aperta. *Proposta:* far confermare D7 dal consulente privacy nel Blocco 2.1.
3. **D10 è marcata `[next]` ma non è eseguibile.** Dipende da P1–P5 (nessuno avviato) e dal parere legale su GPL/LGPL. *Proposta:* spostare `[next]` sull'installazione della postazione (Blocco A) o sul prototipo P4.
4. **Si chiede l'approvazione di metriche e criteri prima che le soglie esistano.** Il TODO 0.6 chiede al committente di approvare "metriche, soglie e CRITERI_COLLAUDO.md", ma le soglie di M2, M3 e M4 sono "da fissare" dopo baseline e prototipi. *Proposta:* approvazione in due tempi (Blocco 0 e Blocco 6).
5. **La baseline M6 è definita in tre modi diversi.**
   - PIANO_FASE_0 §0.6: "minuti per gestire un lotto di 100 fatture";
   - TODO 0.6: "tempo per gestire un lotto di fatture con il processo attuale";
   - METRICHE.md M6: "tempo per rispondere alle richieste di chiarimento e ricostruire a mano il legame voce‑fattura".
   - Inoltre M6 a regime misura attività che oggi non esistono (copia del token, Review Console), quindi il confronto "inferiore alla baseline" non è omogeneo.
   - *Proposta:* scegliere una definizione nel Blocco 0 e allineare i tre documenti.
6. **Costi di hosting "approvati" senza una stima scritta.**
   - Il TODO 0.8 segna `[x]` sia "Confrontare i provider (Hetzner, DigitalOcean) e stimare i costi mensili" sia "Approvare provider e costi", ma il confronto non è stato fatto (OVH scelto direttamente) e nessun documento riporta dimensionamento o costo. D11 dice "dimensionamento da confermare all'acquisto".
   - Il gate richiede "costi di hosting approvati".
   - *Proposta:* riformulare la voce del TODO e far approvare un preventivo scritto nel Blocco 0.

### Stato reale diverso dai documenti

7. **Lo stato del dominio `domuscan.it` non è più attuale.** PIANO_FASE_0, PIANO_PILOTA, PROJECT_STATE e TODO lo descrivono *inactive/dnsHold*. Al 07/10/2026 `domuscan.it` e `domuscan.org` risolvono (nameserver Register.it, IP di parcheggio `195.110.124.133`). Il lavoro reale non è "attivare il dominio" ma "creare i record". *Proposta:* aggiornare i quattro documenti.
8. **PIANO_FASE_0 §0.8 dice "oggi la cartella non è un repository".** Il repository esiste dal commit `83313a4`. *Proposta:* aggiornare il testo.

### Dati reali e privacy

9. **Il corpus reale finirebbe sui PC di sviluppo, contro la regola sugli ambienti.**
   - `documentazione/ambienti.md` stabilisce che in sviluppo si usa solo il set sintetico/anonimizzato.
   - I prototipi P1/P2 e la ground truth però lavorano sul corpus reale, e PIANO_FASE_0 vieta i "servizi cloud non approvati" senza indicare quelli approvati.
   - *Proposta:* decidere nel Blocco 0 dove si elabora il corpus (es. cartella cifrata locale coperta dall'accordo art. 28, oppure solo su staging) e scriverlo in ambienti.md.
10. **Una ground truth "versionata" contrasta con l'esclusione dei dati reali dal repository.** PIANO_FASE_0 §0.5 e il TODO chiedono di versionare il file come base dei test di regressione, ma contiene testi delle voci, condomini e riferimenti a documenti reali, mentre `corpus/` e i dati sono esclusi dal repository. *Proposta:* versionare nel repository solo la ground truth del set anonimizzato e tenere quella reale, datata, nell'archivio cifrato del corpus.

### Dipendenze e responsabilità non dichiarate

11. **P1 non può ritrovare i token nei consuntivi storici.** Il TODO chiede di ricostruire le righe "dai PDF reali di Danea e ritrovare i token", ma i consuntivi storici degli studi non contengono token. I token esistono solo nei PDF prodotti nella sessione Danea (Blocco 4), che a sua volta richiede i token validi di P4. Anche M5 "misurata in Fase 0 (P1/P4)" dipende da questo. *Proposta:* nel TODO indicare P4 → sessione Danea → P1 (parte token).
12. **La casella email è assegnata solo allo sviluppo e manca l'SMTP.**
    - Il TODO assegna a DEV "Creare la casella email", ma serve un servizio email sul dominio del committente, cioè un acquisto o un accesso di COMM.
    - Il `.env.esempio` prevede anche l'SMTP per gli inviti ai condomini (D7), assente dal TODO.
    - *Proposta:* dividere la voce in COMM (attivazione) e DEV (configurazione) e aggiungere l'SMTP.
13. **Composer è "facoltativo" ma servirà con ogni probabilità.** README e `verifica_ambiente.sh` lo trattano come facoltativo, ma la proposta preliminare di D10 include `chillerlan/php-qrcode` e FPDI, che si installano tramite Composer. *Proposta:* alla chiusura di D10 renderlo obbligatorio nello script di verifica (o documentare l'installazione manuale delle librerie).
14. **La comunicazione dello scostamento di stack non è tracciata.**
    - Le conseguenze di D1 prevedono di "comunicare al committente lo scostamento rispetto all'offerta", ma nessuna voce del TODO lo traccia.
    - D1 risulta approvata dal committente, ma l'offerta è scaduta.
    - *Proposta:* chiuderlo con un'accettazione scritta nel Blocco 0, punto 1.
