# DOMUSCAN — Stato del progetto

> **Riservato.** Documento per committente, stakeholder e studi pilota. Contiene informazioni su un metodo oggetto di brevetto in preparazione: non diffonderlo all'esterno senza autorizzazione.
>
> **Aggiornato al:** 15/10/2026 · **Fase corrente:** sviluppo avviato (piano pilota v2, Fase 1 completata); le attività preparatorie della Fase 0 proseguono in parallelo

---

## Che cos'è DOMUSCAN

DOMUSCAN è un **"timbro digitale"** per i bilanci di condominio.

Oggi un rendiconto elenca le spese, ma un condomino non può verificare da solo che una riga corrisponda davvero a una certa fattura: deve chiamare lo studio. Con DOMUSCAN **ogni voce di spesa del bilancio ha un QR Code**. Inquadrandolo con lo smartphone, il condomino autorizzato vede la fattura originale, con la garanzia che il documento non è stato modificato.

DOMUSCAN **non è un nuovo gestionale** e non lo sostituisce. Lavora accanto al software che lo studio usa già (ad esempio Danea Domustudio), senza modificarlo e senza bisogno di accordi con chi lo produce.

### A chi serve

| Chi | Cosa ottiene |
|---|---|
| **Amministratore** | La certezza che ogni importo rendicontato è legato a un documento originale non modificabile; meno telefonate di chiarimento; un servizio che lo distingue dalla concorrenza |
| **Condomino / revisore** | Verifica autonoma delle spese, in qualsiasi momento, dallo smartphone |

### Come funzionerà per lo studio

1. **Le fatture arrivano** (fatturazione elettronica, email, cartella) e DOMUSCAN le archivia in automatico, assegnando a ciascuna un codice breve (es. `DSN-K7M4-P9Q2`).
2. **Durante la registrazione** nel gestionale, l'operatore incolla quel codice nella causale. È l'unico gesto in più richiesto.
3. **A fine periodo** lo studio stampa il bilancio in PDF come sempre e lo passa a DOMUSCAN, che aggiunge i QR accanto alle voci senza cambiare nessun numero.
4. **I condomini** inquadrano il QR e consultano la fattura dopo aver fatto l'accesso.

**Principio di prudenza:** se DOMUSCAN non è sicuro al 100% dell'abbinamento tra voce e fattura, il QR non viene generato e lo studio viene avvisato. Meglio una voce senza QR che una voce con un QR sbagliato.

---

## Scelte già fatte

| Tema | Scelta | Perché conta |
|---|---|---|
| **Tecnologia** | Applicazione web in PHP con database MariaDB | Tecnologie diffuse e costi di gestione contenuti |
| **Server** | VPS OVH in Europa (da acquistare; costi a carico del committente) | Dati in Europa, conformità GDPR |
| **Dove stanno le fatture** | In un archivio DOMUSCAN cifrato | Permette di controllare in ogni momento che il documento non sia stato alterato |
| **Abbinamenti automatici** | Solo quando c'è il codice in causale o una corrispondenza fiscale univoca; gli altri casi li conferma una persona | Zero errori pubblicati, anche a costo di più casi da confermare |
| **Sigillo di garanzia** | Firma digitale con data e ora, verificabile da chiunque con una chiave pubblica | Dimostra l'integrità senza dover accedere al gestionale |
| **Accesso dei condomini** | Account creato su invito dello studio; predisposto per SPID e CIE in futuro | Lo studio decide chi vede cosa |
| **Perimetro della prima versione** | Solo quanto previsto dall'offerta (3 SAL) | Rispetto di budget e tempi |
| **Chiave Amministratore** | Ogni amministratore ha un codice personale (es. `DSA-K7M4-P9Q2-XW31`) da inserire nelle registrazioni; si può rigenerare, e le chiavi vecchie restano valide per i documenti già emessi | Collega con certezza le fatture allo studio, senza rivelare dati personali |
| **Attivazione degli account** | Automatica quando l'amministratore conferma la propria email | Nessun passaggio manuale da parte di DOMUSCAN |

**Rimandato alla versione successiva (V1):**
- spiegazione delle fatture con intelligenza artificiale;
- classificazione delle spese;
- confronto dei prezzi con i prezzari (congruità);
- stampante virtuale Windows;
- collegamento diretto allo SdI.

**Da decidere:**
- **Come il codice viaggia nel gestionale:** dipende da una verifica pratica su Danea, cioè da quali campi compaiono nella stampa del bilancio.
- **Librerie software da adottare:** per l'invio delle email e l'interfaccia sono già approvate (PHPMailer, Bootstrap); per PDF e QR si decide dopo i prototipi tecnici. Le candidate sono state già verificate su licenze e manutenzione.

---

## A che punto siamo

### Avanzamento per fase

| Fase | Contenuto | Pagamento | Stato |
|---|---|---|---|
| **0 — Preparazione** | Decisioni, raccolta di bilanci e fatture reali, prove tecniche, server, privacy | — | 🟡 In corso |
| **1 — Fondamenta** | Registrazione degli studi e Chiave Amministratore, archivio delle fatture, acquisizione, lettura dei dati, codici | SAL 1 · 2.500 € | 🟡 In corso |
| **2–3 — Abbinamento e QR** | Abbinamento voci‑fatture, bilancio con QR, console delle eccezioni | SAL 2 · 3.000 € | ⚪ Da iniziare |
| **4 — Messa in produzione** | Verifica pubblica dei QR, accessi dei condomini, collaudo con uno studio reale | SAL 3 · 2.000 € | ⚪ Da iniziare |

Durata stimata delle fasi 1–4: 10–12 settimane dall'avvio del SAL 1.

### Fatto finora (Fase 0)

- ✅ Analisi di tutti i documenti di progetto e descrizione unificata del sistema
- ✅ Piano di implementazione complessivo e piano dettagliato della Fase 0
- ✅ Registro delle decisioni, con 9 decisioni approvate
- ✅ Scelta del server (VPS OVH)
- ✅ Verifica di licenze e manutenzione dei componenti software candidati
- ✅ Definizione delle **metriche di qualità** con cui si misurerà il sistema (es. zero abbinamenti automatici errati, zero accessi non autorizzati)
- ✅ **Criteri di collaudo** dei 3 SAL: cosa deve funzionare perché ogni pagamento sia dovuto (bozza da approvare)
- ✅ Predisposizione dello spazio di lavoro del codice, del modello di configurazione e dei primi controlli automatici
- ✅ Strategia di backup: copia giornaliera fuori dal server, ripristino entro 4 ore, al massimo 24 ore di dati a rischio

### Fatto nello sviluppo (piano pilota v2, Fase 1)

- ✅ **Registrazione degli studi**: l'amministratore si registra, conferma l'email e riceve subito la sua **Chiave Amministratore**
- ✅ **Area riservata**: la chiave si vede e si copia con un clic, anche da smartphone, con le istruzioni su dove inserirla e lo storico delle chiavi
- ✅ **Rigenerazione della chiave** protetta dalla password, con email di avviso; le chiavi precedenti restano valide per i documenti già emessi
- ✅ **Accesso sicuro**: recupero della password, blocco dopo troppi tentativi sbagliati, nessuna informazione su quali email sono registrate
- ✅ **Registro delle operazioni** non modificabile, attivo dal primo giorno
- ✅ Ambiente di sviluppo completo e controlli automatici che verificano l'intero percorso

### In corso / prossimi passi

- **Fase 2 dello sviluppo:** caricamento delle fatture, archivio cifrato e codice per ogni documento
- Prove tecniche (prototipi) su lettura dei PDF, lettura delle fatture elettroniche, inserimento dei QR e firma digitale
- Testi di informativa privacy e condizioni del servizio per le pagine di registrazione (oggi segnaposto)
- Prova di ripristino dei backup, ora che il database è disponibile

---

## Cosa serve dal committente

Queste attività bloccano l'avanzamento e richiedono un intervento del committente:

| # | Richiesta | Perché è necessaria |
|---|---|---|
| 1 | **Individuare 1–3 studi pilota**, almeno uno con Danea Domustudio | Servono bilanci e fatture reali per sviluppare e collaudare |
| 2 | **Accesso a un'installazione Danea** (studio pilota o licenza di prova) | Verificare che il codice incollato in causale compaia nella stampa del bilancio: è il presupposto del metodo |
| 3 | **Acquistare la VPS OVH** e lo spazio di backup esterno | Serve per gli ambienti di prova e di produzione |
| 4 | **Configurare i domini** `domuscan.it` (alla registrazione risultava non attivo) e decidere l'uso di `domuscan.org` | Indirizzo pubblico per la verifica dei QR (`verify.domuscan.it`) |
| 5 | **Approvare metriche e criteri di collaudo** | Rendono oggettivi i collaudi e quindi i pagamenti dei SAL |
| 6 | **Chiarire se la Fase 0 rientra nel SAL 1** o va concordata a parte, e confermare lo stato del contratto (l'offerta del 21/07/2026 era valida 30 giorni) | Copertura economica della fase in corso |
| 7 | **Coinvolgere il consulente privacy** (accordi con gli studi, informativa ai condomini) e **il consulente brevettuale** (conferma del sigillo scelto) | Necessari prima di trattare dati reali e prima di qualsiasi presentazione pubblica |

---

## Punti di attenzione

- **Riservatezza fino al deposito del brevetto:** nessuna demo pubblica, pagina web o presentazione del metodo prima del deposito, per non comprometterne la novità.
- **Dipendenza dal gestionale:** se Danea non riportasse la causale nella stampa del bilancio, servirà una modalità alternativa (ad esempio un campo protocollo o l'abbinamento tramite i dati fiscali). Per questo la verifica su Danea è la prima attività tecnica.
- **Scostamento rispetto all'offerta:** l'offerta citava un'architettura "Cloud‑Native" con microservizi. Si è scelto un impianto più semplice ed economico (PHP + MariaDB su VPS). Il perimetro funzionale resta invariato.
- **Dati personali:** fatture e bilanci contengono dati personali. Nessun dato reale verrà usato prima della firma degli accordi privacy con gli studi pilota.

---

## Riferimenti

- Dettagli tecnici per gli sviluppatori: [README.md](README.md)
- Documentazione completa (descrizione, decisioni, piani, metriche, criteri di collaudo): disponibile su richiesta presso il team di sviluppo
