# =====================================
# TODO
# =====================================

# Fase 0 — Decisioni e corpus pilota
# Riferimento: PIANO_FASE_0.md · Decisioni: DECISIONI.md
#
# Legenda stato:  [next] prossimo task · [ ] da fare · [x] completato
# Legenda chi:    (DEV) eseguibile dal team di sviluppo · (TEAM) richiede persone/riunioni
#                 (COMMITTENTE) richiede approvazione del committente · (STUDIO) richiede uno studio pilota
#                 (LEGALE) richiede consulente legale/privacy/brevettuale


## 0.1 Registro delle decisioni
- [x] (DEV) Creare DECISIONI.md con il modello di voce e le decisioni D1–D10
- [x] (COMMITTENTE) Approvare D1 (stack), D6 (perimetro MVP), D3 (dove risiede il file), D4 (auto‑associazione) 
  - Stack approvato come da architettura.md
- [x] (TEAM) Approvare D9 (job asincroni)
  - Va bene con un cron in php
- [x] (TEAM) Chiudere D2 (database) dopo la scelta dell'hosting (0.8)
  - PostreSQL
  - Sostituita da D12 (MariaDB, come da architettura.md) il 15/10/2026
- [ ] (TEAM) Chiudere D8 (aggancio del token) dopo l'indagine Danea (0.3)
- [x] (TEAM) Chiudere D5 (sigillo) dopo il prototipo P5 e il parere del consulente brevettuale
  - Firma asimmetrica con timestamp
- [x] (TEAM) Chiudere D7 (autenticazione del condomino) dopo la checklist privacy (0.9)
  - Account con invito. teniamoci pronti per spid e CIE
- [x] (DEV) Allineare PROGETTO.md §7.2 e PIANO_PILOTA.md alle decisioni approvate (in particolare lo stack PHP)

## 0.2 Stack e librerie
- [x] (DEV) Verificare la disponibilità degli strumenti a riga di comando sull'ambiente di sviluppo: PHP (versione, estensioni sodium/openssl/dom), Poppler (pdftotext), qpdf, Tesseract
- [x] (DEV) Verificare licenze e manutenzione delle librerie candidate (QR, FPDI/FPDF/TCPDF, pdfparser) e annotarle in DECISIONI.md › Candidate
- [ ] (TEAM) Chiudere D10 con l'elenco delle librerie approvate (dopo i prototipi P1–P5)
  - Già approvate per la Fase 1: PHPMailer (LGPL-2.1) e Bootstrap 5.3.8 (MIT)

## 0.3 Indagine sul gestionale (Danea Domustudio)
- [ ] (COMMITTENTE) Ottenere accesso a un'installazione reale di Danea Domustudio (studio pilota o licenza di prova)
- [ ] (STUDIO) Verificare quali campi del movimento (causale, descrizione, note, protocollo, riferimento) compaiono nelle stampe di consuntivo, rendiconto per voce e partitario
- [ ] (STUDIO) Verificare lunghezza massima, caratteri ammessi ([, ], -) e troncamenti in stampa di quei campi
- [ ] (STUDIO) Registrare movimenti di prova con token fittizi DSN-XXXX-XXXX e salvare i PDF prodotti
- [ ] (DEV) Verificare che i PDF di Danea contengano testo estraibile (non rasterizzato) e che i token di prova siano ritrovabili
- [ ] (STUDIO) Verificare le esportazioni Excel/CSV e se riportano la causale
- [ ] (STUDIO) Verificare l'import delle fatture elettroniche e l'esistenza di un campo protocollo (modalità C e D)
- [ ] (DEV) Redigere SCHEDA_GESTIONALE_DANEA.md con screenshot, PDF di esempio e modalità di aggancio raccomandata
- [ ] (TEAM) Ripetere una verifica ridotta su un secondo gestionale, se disponibile

## 0.4 Corpus pilota
- [ ] (COMMITTENTE) Individuare 1–3 studi pilota (almeno uno con Danea, idealmente uno con un altro gestionale)
- [ ] (DEV) Predisporre l'archivio cifrato del corpus, fuori dal repository, con accesso limitato al team
- [ ] (DEV) Predisporre il modello di inventario del corpus (origine, data, studio, condominio, tipo documento, hash SHA‑256)
- [ ] (STUDIO) Raccogliere per 2–3 condomini almeno un esercizio chiuso: consuntivo PDF (più preventivo e riparto se disponibili) e tutte le fatture in XML/PDF (100–200 documenti in totale)
- [ ] (TEAM) Verificare la presenza dei casi difficili: stesso importo, note di credito, acconto/saldo, fattura su più voci/scale, voce aggregata, .p7m, scansioni, bollette; richiedere i mancanti
- [ ] (DEV) Compilare l'inventario completo del corpus
- [ ] (DEV) Creare un set sintetico/anonimizzato per i test automatici e il repository

## 0.5 Ground truth
- [ ] (DEV) Definire il formato di etichettatura (CSV: id_riga, condominio, esercizio, pagina, testo_voce, importo_voce, id_documenti, importo_allocato, tipo_relazione, certezza, note)
- [ ] (TEAM) Etichettare tutte le righe di almeno un consuntivo completo per studio
- [ ] (TEAM) Doppia verifica a campione da parte di una seconda persona; risolvere le discordanze con lo studio
- [ ] (DEV) Versionare il file di ground truth come base dei test di regressione

## 0.6 Metriche e criteri di collaudo
- [x] (DEV) Scrivere le definizioni delle metriche (associazioni errate, copertura, accuratezza di estrazione, tempo operatore, integrità PDF, accessi cross‑tenant)
- [ ] (TEAM) Misurare a mano la baseline: tempo per gestire un lotto di fatture con il processo attuale
- [x] (DEV) Redigere CRITERI_COLLAUDO.md per i 3 SAL partendo da T01–T12 (Specifica DIBP) e T01–T07 (Capitolato)
- [ ] (COMMITTENTE) Approvare metriche, soglie e CRITERI_COLLAUDO.md

## 0.7 Prototipi di fattibilità (codice usa e getta, fuori dal codice di prodotto)
- [ ] (DEV) P4 — Formato token: generatore DSN-XXXX-XXXX Base32 con checksum, regex di riconoscimento, test di copia/incolla ed estrazione da PDF
- [ ] (DEV) P2 — Lettura FatturaPA: estrarre i campi della chiave fiscale da XML e .xml.p7m del corpus; elencare le eccezioni
- [ ] (DEV) P1 — Lettura consuntivo: ricostruire righe, importi e coordinate dai PDF reali di Danea e ritrovare i token
- [ ] (DEV) P3 — Overlay QR: aggiungere un QR accanto a una riga senza alterare il PDF; confronto del testo estratto prima/dopo; prova con FPDI gratuito e con normalizzazione qpdf
- [ ] (DEV) P5 — Sigillo: script di prova per le opzioni di D5 con i casi "la catena chiude" e "non chiude" (storni)
- [ ] (DEV) Redigere un report per ciascun prototipo in DEVELOPMENT DOCS/ (risultati, limiti, impatto sulle stime)

## 0.8 Ambienti, repository e domini
- [x] (DEV) Inizializzare il repository git con struttura cartelle in snake_case e il .gitignore esistente
- [x] (DEV) Confrontare i provider di hosting (VPS europea: Hetzner, DigitalOcean) e stimare i costi mensili
  - Già scelto vps OVH. Va acquistato
- [x] (COMMITTENTE) Approvare provider e costi di hosting (a carico del committente)
- [x] (DEV) Predisporre gli ambienti — parte documentale: modello configurazione/.env.esempio e guida documentazione/ambienti.md
- [ ] (DEV) Predisporre l'ambiente di sviluppo locale installando i requisiti mancanti (vedi BUGLIST) fino a esito positivo di strumenti/verifica_ambiente.sh
  - Requisiti della Fase 1 completi dal 15/10/2026 (`--fase 1`: 0 mancanti); restano Poppler, qpdf e Tesseract, necessari dalle fasi 4-5
- [ ] (COMMITTENTE) Acquistare la VPS OVH (e lo spazio di backup esterno)
- [plan 261113] (DEV) Predisporre staging e produzione sulla VPS OVH secondo documentazione/ambienti.md
- [ ] (COMMITTENTE) Configurare i DNS di domuscan.it (risultava inactive/dnsHold) e decidere il ruolo di domuscan.org
- [ ] (DEV) Attivare i sottodomini dell'applicazione e verify.domuscan.it con certificati TLS
- [ ] (DEV) Creare la casella email dedicata all'acquisizione delle fatture (valutare anche la PEC)
- [x] (DEV) Definire la strategia di backup (documentazione/backup.md)
- [plan 261113] (DEV) Scrivere strumenti/backup.sh e strumenti/ripristino.sh (mariadb-dump) ed eseguire la prima prova di ripristino

## 0.9 Legale, privacy e proprietà intellettuale
- [ ] (LEGALE) Definire i ruoli GDPR (studio titolare, DOMUSCAN responsabile) e preparare il modello di accordo ex art. 28
- [ ] (LEGALE) Preparare l'informativa per i condomini sull'accesso ai documenti tramite QR
- [ ] (LEGALE) Valutare la necessità di una DPIA
- [ ] (LEGALE) Definire i tempi di conservazione di documenti e log
- [ ] (TEAM) Condividere il vincolo di riservatezza: nessuna demo, pagina o presentazione pubblica del metodo prima del deposito del brevetto
- [ ] (LEGALE) Allineare la scelta del sigillo (D5) con il consulente brevettuale
- [ ] (LEGALE) Verificare che la rielaborazione dei PDF del consuntivo non violi la licenza del gestionale

## Gate di uscita Fase 0
- [ ] (TEAM) Verificare tutte le voci della checklist "Gate di uscita" in PIANO_FASE_0.md
- [ ] (COMMITTENTE) Approvare la chiusura della Fase 0 e l'avvio del SAL 1


# Fase 1 — Registrazione amministratore e Chiave Amministratore
# Riferimento: PIANO_PILOTA_v2.md §2 · Decisioni: D12 (MariaDB), D13 (chiave), D14 (attivazione), D10 (PHPMailer, Bootstrap)

- [x] (DEV) 1.1 Allineamento a MariaDB: D2 sostituita da D12 in DECISIONI.md; .env.esempio, ambienti.md, struttura_progetto.md, backup.md, verifica_ambiente.sh, README, PROJECT_STATE, progetto.md
- [x] (DEV) 1.2 Ambiente locale: PHP 8.4 (winget) con pdo_mysql/sodium/mbstring/openssl, MariaDB 12.3 LTS portabile, database domuscan e domuscan_test, Composer, .env compilato
- [x] (DEV) 1.3 Base comune: avvio.php, configurazione .env, PDO, sessione e CSRF, viste con escape, log, gestione errori (dettagli solo in sviluppo)
- [x] (DEV) 1.4 Migrazioni 001-004 e strumenti/migra.php idempotente
- [x] (DEV) 1.5 Chiave Amministratore: generazione, checksum Luhn mod 32, validazione, normalizzazione, riconoscimento nel testo, assegnazione, revoca, rigenerazione, ricerca
- [x] (DEV) 1.6 Registrazione e conferma email con assegnazione della chiave in transazione
- [x] (DEV) 1.7 Accesso, uscita, recupero password, limitazione dei tentativi
- [x] (DEV) 1.8 Area riservata responsive, copia negli appunti, istruzioni, storico, rigenerazione con password e notifica
- [x] (DEV) 1.9 Runner di test in PHP puro (test/php/), richiamato da test/esegui_test.sh, su database di test separato; test end-to-end via HTTP
- [x] (DEV) 1.10 Documentazione: README, documentazione/, TODO
- [ ] (LEGALE) Testi di informativa privacy e condizioni del servizio (oggi le pagine sono segnaposto)
- [ ] (DEV) Configurare SMTP di staging/produzione (EMAIL_MODALITA=smtp) quando sarà disponibile la casella (TODO 0.8)
- [next] (DEV) Avviare la Fase 2: acquisizione fatture, hash, Vault, token documento (prerequisito: set di fatture sintetiche)



# =====================================
# BUGLIST
# =====================================
- [x] [Verifica strumenti ambiente] — PHP >= 8.3 non installato: le estensioni richieste (pdo_pgsql, sodium, dom, …) non sono verificabili
  - Installato PHP 8.4.25 con winget e php.ini dedicato (15/10/2026). Nel PATH utente c'era già un PHP 8.2: la cartella dell'8.4 è stata messa prima
- [ ] [Verifica strumenti ambiente] — pdftotext nel PATH è quello di Xpdf (Git per Windows) senza -bbox: serve Poppler prima nel PATH (obbligatorio dalla Fase 4)
- [ ] [Verifica strumenti ambiente] — qpdf non installato: necessario per normalizzare i PDF prima dell'overlay con FPDI (obbligatorio dalla Fase 5)
- [ ] [Verifica strumenti ambiente] — Tesseract (con lingua ita) non installato: necessario per l'OCR selettivo (obbligatorio dalla Fase 4)
- [ ] [Ambiente locale] — MariaDB è installato come pacchetto portabile e non come servizio: dopo un riavvio del PC va riavviato a mano (`mariadbd.exe --defaults-file="%LOCALAPPDATA%\mariadb_dati\my.ini"`), oppure installato come servizio con l'MSI
- [x] [Verifica strumenti ambiente] — client PostgreSQL (psql, pg_dump) non installati: necessari per migrazioni e backup (D2)
  - Superato da D12: installati MariaDB 12.3.3 (server, mariadb, mariadb-dump) il 15/10/2026


## MANUAL TESTS
- [ ] [manual] Verificare che progetto.md (§6.6, §7.2, §8, §10, §11), PIANO_PILOTA.md e PIANO_FASE_0.md siano coerenti con DECISIONI.md leggendoli in parallelo e controllando 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 di VS Code
- [ ] [manual] Verificare che la tabella licenze/manutenzione in DECISIONI.md › Candidate sia ancora corretta aprendo la pagina Packagist e il repository di ogni libreria prima di approvare D10 (dati rilevati il 06/10/2026)
- [ ] [manual] Verificare che ogni metrica di METRICHE.md sia calcolabile controllando che ciascun dato necessario esista nel formato di ground truth del TODO 0.5 o nei campi previsti per l'audit log
- [ ] [manual] Verificare che CRITERI_COLLAUDO.md copra i test DIBP T01–T12 e Capitolato T01–T07 (escluso T05, fuori perimetro per D6) confrontando ogni ID con i PDF originali in "documenti per analisi"
- [ ] [manual] Verificare che documentazione/ambienti.md sia completa seguendo i passi "Sviluppo locale" su questa macchina Windows fino a ottenere 0 requisiti mancanti da bash strumenti/verifica_ambiente.sh
- [ ] [manual] Verificare che documentazione/backup.md corrisponda alle attese del committente rivedendo insieme RPO (24 h), RTO (4 h) e retention (7/4/12) prima della produzione
- [ ] [manual] Verificare la Fase 1 nel browser: avviare `php -S localhost:8000 -t pubblico`, registrare uno studio su /registrazione.php, aprire il link nel file .eml più recente in dati/log/email/, premere "Conferma", accedere e controllare che l'area riservata mostri una chiave DSA-XXXX-XXXX-XXXX
- [ ] [manual] Verificare l'area riservata da smartphone (o con gli strumenti per dispositivi mobili del browser, larghezza 375 px): la chiave è leggibile su una riga, il pulsante "Copia" mette la chiave negli appunti e mostra "Copiata!"
- [ ] [manual] Verificare la rigenerazione: da /chiave_rigenera.php con password errata compare "Password non corretta."; con la password giusta compare la nuova chiave, la vecchia è nello storico come revocata e in dati/log/email/ c'è l'email di notifica
- [ ] [manual] Verificare che i modelli di configurazione/server/ siano sintatticamente validi su AlmaLinux copiandoli sulla VPS come da configurazione/server/LEGGIMI.md (sostituendo __AMBIENTE__) ed eseguendo `apachectl configtest` e `php-fpm -t`, che devono rispondere "Syntax OK" / "test is successful"
- [ ] [manual] Verificare che la VPS serva solo pubblico/ aprendo https://<IP>/ (home, dopo aver accettato il certificato autofirmato), http://<IP>/ (redirect 301 a HTTPS) e https://<IP>/.env, /.git/config, /risorse/vendor/bootstrap/css/bootstrap.min.css.map (403 o 404)
- [ ] [manual] Verificare gli header della VPS con `curl -kI https://<IP>/` e `curl -kI https://<IP>/risorse/css/domuscan.css`: `Server: Apache` senza versione, nessun `X-Powered-By`, CSP sulla pagina, `X-Content-Type-Options: nosniff` e `Cache-Control: public, max-age=604800` sul CSS
- [ ] [manual] Verificare che SELinux non blocchi l'applicazione registrando uno studio su https://<IP>/registrazione.php e controllando che `ausearch -m avc -ts recent` non mostri dinieghi per httpd o php-fpm
- [ ] [manual] Verificare il backup sulla VPS con la chiave GPG vera: importare solo la chiave pubblica con l'utente di servizio, lanciare `bash strumenti/backup.sh --env /srv/domuscan/produzione/app/.env` e controllare che termini con 0, che in `backup/` ci sia la cartella con i 3 file `.gpg` e `SHA256SUMS`, e che `dati/log/backup.log` riporti `ESITO=ok` e l'avviso "backup solo locale"
- [ ] [manual] Verificare la prima prova di ripristino sulla VPS: importare temporaneamente la chiave privata (con `export GPG_TTY=$(tty)`), eseguire `ripristino.sh --database domuscan_ripristino --cartella-vault /tmp/vault_ripristino`, confrontare i conteggi con il database di origine, registrare la prova in documentazione/registro_prove_ripristino.md e poi cancellare la chiave privata dal server
- [ ] [manual] Verificare che il backup notturno parta da cron controllando la mattina dopo l'installazione che `dati/log/backup.log` abbia una riga `ESITO=ok` delle 03:15 UTC e che `dati/log/backup_cron.log` non contenga errori
- [ ] [manual] Verificare la passphrase della chiave privata dal PC del responsabile decifrando un `configurazione/env.gpg` scaricato dal server con `gpg --decrypt`: se la passphrase non è nota o la chiave è persa, i backup sono irrecuperabili
- [ ] [manual] Verificare l'invio SMTP reale in staging: con EMAIL_MODALITA=smtp e una casella di prova, registrarsi e controllare che l'email di conferma arrivi in casella (non in spam) con mittente e oggetto corretti
- [ ] [manual] Verificare la preparazione del pacchetto sul repository vero: dopo il commit di tutto il lavoro (albero di lavoro pulito), lanciare `bash strumenti/prepara_rilascio.sh` e controllare che in `rilasci/` ci siano `domuscan_<versione>.tar.gz` e il `.sha256`, e che `tar -tzf` del pacchetto mostri `vendor/` e `VERSIONE` ma non `PROJECT DOCS/`, `test/` e `documentazione/`
- [ ] [manual] Verificare il primo rilascio sulla VPS seguendo documentazione/installazione_vps.md (passo 8): `installa_rilascio.sh --env` termina con 0, `app/VERSIONE` riporta la versione caricata, `app/.env` ha permessi 600 e `dati/log/rilasci.log` ha una riga `esito=ok` con il percorso del backup preventivo
- [ ] [manual] Verificare un rilascio successivo e il ritorno indietro sulla VPS: caricare una seconda versione, installarla, controllare che il sito la mostri e che la precedente sia in `app_precedente/`, poi eseguire `--torna-precedente` e controllare che il sito torni alla versione prima senza dinieghi SELinux (`ausearch -m avc -ts recent`)
- [ ] [manual] Verificare che l'utente di servizio possa solo ricaricare PHP-FPM: `sudo -u domuscan-produzione sudo -n systemctl reload php-fpm` riesce, mentre `sudo -u domuscan-produzione sudo -n systemctl restart httpd` viene rifiutato
