# Struttura del progetto

> Organizzazione delle cartelle del repository. Convenzioni di codice in `PROJECT DOCS/architettura.md`: nomi in italiano, file e cartelle in snake_case.

| Cartella | Contenuto |
|---|---|
| `pubblico/` | Unica cartella esposta dal web server (document root): un punto di ingresso PHP per funzione (`registrazione.php`, `accesso.php`, `area_riservata.php`, …) e risorse statiche in `risorse/` (`css/`, `js/`, `immagini/`, `vendor/bootstrap/`). |
| `sorgenti/` | Funzioni PHP procedurali, una sottocartella per modulo. Non accessibile dal web. |
| `sorgenti/comune/` | Funzioni condivise: `avvio.php` (incluso da ogni punto di ingresso), configurazione `.env`, connessione al database, sessione e CSRF, viste, email, log, audit, validazione, migrazioni. |
| `sorgenti/acquisizione/` | Intake: upload, cartella sorvegliata, email; deduplicazione e provenienza. |
| `sorgenti/archivio/` | Document Vault: conservazione cifrata degli originali e SHA‑256. |
| `sorgenti/estrazione/` | Parser FatturaPA (XML, `.p7m`), PDF con coordinate e OCR selettivo. |
| `sorgenti/associazioni/` | Chiave Amministratore (`DSA-…`), Binding Registry, Binding Token, chiave fiscale canonica, sigillo. |
| `sorgenti/riconciliazione/` | Lettura del consuntivo e Matching Engine (livelli A–E). |
| `sorgenti/stampa/` | Print Layer: PDF arricchito con QR e richiami. |
| `sorgenti/revisione/` | Review Console: eccezioni, conferme, rettifiche. |
| `sorgenti/verifica/` | Resolver pubblico, Secure Viewer, scheda spesa. |
| `sorgenti/accessi/` | Registrazione e conferma email, autenticazione e limitazione dei tentativi, password, token monouso; in seguito inviti e autorizzazioni per studio/condominio/documento. |
| `sorgenti/viste/` | Template HTML (Bootstrap) delle pagine e, in `email/`, dei messaggi in testo semplice. Non accessibile dal web. |
| `lavori/` | Worker PHP a riga di comando eseguiti da cron (coda dei job, D9). |
| `database/migrazioni/` | Script SQL numerati (`NNN_nome.sql`) per MariaDB, applicati in ordine da `strumenti/migra.php` e registrati nella tabella `migrazioni`. |
| `configurazione/` | Modello del file `.env` e configurazioni non segrete. |
| `strumenti/` | Script di manutenzione: verifica dell'ambiente, migrazioni (`migra.php`), backup, ripristino. |
| `test/` | Test automatici: script bash `test_*.sh` e, in `test/php/`, i test dell'applicazione con un runner in PHP puro. |
| `prototipi/` | Prototipi usa e getta della Fase 0. Non fanno parte del prodotto. |
| `documentazione/` | Documentazione tecnica da consegnare: installazione, ambienti, backup, API. |

Cartelle **escluse dal repository** (`.gitignore`):
- `dati/`: Vault locale e file di esercizio;
- `corpus/`: corpus pilota;
- `backup/`;
- `vendor/` (dipendenze Composer, ricreate con `composer install`);
- `.env`;
- `PROJECT DOCS/`, `DEVELOPMENT DOCS/`, `GRAPHICS/`, `DESIGN_SYSTEM/`.
