Analisi dei requisiti v0.2

Documenti di progetto (richiesta, sintesi, domande, workflow, indice),
fonti del cliente del 25/09/2026 e CLAUDE.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

richiesta-sintesi.md

@@ -0,0 +1,200 @@
+# Richiesta del cliente: sintesi
+**Progetto:** Gestionale per enti del Terzo Settore
+**Documento:** `richiesta-sintesi.md` (sintesi di `richiesta.md`)
+**Versione:** 0.2 · **Data:** 25/09/2026 · **Stato:** Bozza, da validare con il cliente
+**Allineato a:** `richiesta.md` v0.2 · **Schema di versione:** vedi `indice-documenti.md`
+**Fonti:** **[D]** `funzioni software.docx` · **[X]** `Software.xlsx`
+**Documenti collegati:** `richiesta.md` (versione estesa) · `domande-cliente.md` (domande e dubbi progettuali)
+**Legenda:** ✅ deciso · ⏳ aperto, da chiedere al cliente · 🔸 ipotesi da confermare
+
+---
+
+## 1. Cos'è il software
+
+✅ Una **piattaforma web multi-ente**: uno **studio professionale** gestisce molti **enti del Terzo Settore** suoi clienti. Ogni ente vede solo i propri dati, lo studio li vede tutti. Circa **100 utenti** (⏳ numero di enti: Q1; ripartizione degli utenti: Q2).
+
+**Attori** (✅ **interno = studio**, **esterno = ente**, come in [X]):
+- **Studio:** offerte, anagrafiche enti, imputazione contabile, circolari, time sheet; controlla e approva i documenti degli enti.
+- **Ente:** inserisce le persone, compila i libri sociali, carica i documenti contabili.
+- **Interessati** (non sono utenti): soci, volontari, dipendenti, collaboratori, sostenitori.
+
+**Flusso:** offerta e firma → attivazione dell'ente → l'ente inserisce e carica, lo studio controlla e imputa → alert, proforma e circolari alle scadenze → output annuali (Modello D, relazione illustrativa, bilancio sociale, progetti).
+
+---
+
+## 2. Moduli
+
+| # | Modulo | Fase | Chi inserisce | Chi controlla / usa | Stato |
+|---|---|---|---|---|---|
+| M1 | Gestione cliente | 1 | Studio | Ente (firma, riceve proforma) | Definito |
+| M2 | Anagrafica enti | 1 | Studio | Studio | Definito |
+| M3 | Persone dell'ente | 1 | Ente | Ente; alimenta M4 e M7 | Definito (dettagli Q8) |
+| M4 | Libri sociali | 1 | Ente | Studio approva, poi archiviazione | Definito |
+| M5 | Contabilità | 1 | Ente | Studio imputa | Definito |
+| M6 | Progettazione | 1 | Ente e studio | Ente e studio | ⏳ Q13, Q19 |
+| M7 | Bilancio sociale | 2 | Ente e studio | Ente e studio | ⏳ Q14, Q19 |
+| M8 | Circolari | 1 | Studio | Ente | Definito |
+| M9 | Valutazione volontariato | 2 | Studio | Studio | Definito (dettagli Q15) |
+
+La fase viene da [D] ("di base" = fase 1, "aggiuntive" = fase 2), tranne M8, che segue [X].
+**Fase 1:** M1–M6, M8 · **Fase 2:** M7, M9.
+
+---
+
+## 3. Requisiti per modulo
+
+**M1: Gestione cliente**
+- Catalogo di servizi vendibili singolarmente o a pacchetto (⏳ Q3). Preventivi e offerte composti dal catalogo, con modalità di pagamento e scadenze.
+- Invio all'ente e firma digitale (⏳ Q4) di offerta, informativa privacy (presa visione) e dati antiriciclaggio.
+- Scadenziario dei pagamenti, proforma alle scadenze (⏳ Q5: anche fattura elettronica?), alert allo studio.
+
+**M2: Anagrafica enti** (la compila lo studio). Campi:
+- denominazione, sede, codice fiscale, partita IVA (facoltativa), data di costituzione;
+- n°, data e sezione di iscrizione al RUNTS;
+- qualifica (ODV, APS, ETS, impresa sociale, SOMS, rete, ente filantropico);
+- attività di interesse generale (art. 5 CTS) e attività diverse (art. 6 CTS);
+- raccolta fondi continuativa commerciale e ordinaria (sì/no);
+- n° soci e n° volontari. 🔸 Inseriti a mano (Q7); si mostra accanto il conteggio calcolato dalle anagrafiche, come controllo.
+
+**M3: Persone dell'ente** (le inserisce l'ente)
+- Anagrafica e contatti per ogni persona.
+- Categorie citate nei due documenti: soci, aderenti, tesserati, volontari, volontari occasionali, dipendenti/lavoratori, collaboratori, sostenitori, partecipanti.
+- ⏳ Q8: quali categorie servono davvero, quali dati per ciascuna, se una persona può avere più ruoli.
+
+**M4: Libri sociali**
+- **Libro soci:** data della delibera di ammissione, anagrafica, contatti, data di cessazione, note, firma dell'operatore.
+- **Registro volontari:** data di inizio, anagrafica, contatti, data di fine, note, firma dell'operatore.
+- Libri dei verbali dell'assemblea dei soci e dell'organo di amministrazione.
+- Marca temporale e conservazione digitale (⏳ Q9).
+- Flusso: l'ente compila → lo studio controlla → stampa e archiviazione definitiva.
+
+**M5: Contabilità**
+- Alert all'ente per caricare i documenti. ✅ Calendario uguale per tutti gli enti, ma modificabile. ⏳ Q12: si modifica solo il calendario comune o anche quello del singolo ente?
+- Caricamento di: estratti conto trimestrali in Excel o PDF (⏳ Q10), prima nota cassa trimestrale in Excel, rendiconti delle raccolte fondi occasionali.
+- ✅ Lo studio imputa ogni movimento **direttamente sulle voci del Modello D**. Le voci stanno in una tabella configurabile, così un cambio di legge non richiede modifiche al codice.
+- Output: rendiconto per cassa su Modello D; relazione illustrativa guidata su modelli preimpostati (attività, progetti), scritta dall'ente.
+
+**M6: Progettazione**
+- Procedura guidata per sezioni: contesto, bisogni, idea, obiettivi, attività, risorse, cronoprogramma, costi, piano economico-finanziario.
+- Modello standard adattabile ai formulari dei bandi.
+- ⏳ Q13: lo schema di dettaglio **non esiste ancora**. Chi lo prepara, in che formato si esporta, l'adattamento ai formulari è manuale o automatico?
+
+**M7: Bilancio sociale** (fase 2)
+- Procedura guidata che riusa in automatico i dati già presenti nel sistema.
+- Sezioni: lettera del presidente, dati standard, identità dell'ente, stakeholder, utenti, obiettivi e attività, situazione economico-finanziaria, relazione dell'organo di controllo.
+- ⏳ Q14: nell'Excel la descrizione è copiata da M6. Vanno confermati le sezioni e l'uso delle linee guida ministeriali.
+
+**M6 e M7, divisione del lavoro (⏳ Q19).** "Entrambi" può voler dire tre cose, dalla più semplice alla più costosa:
+- (a) l'ente scrive, lo studio rivede;
+- (b) sezioni divise tra ente e studio;
+- (c) modifica contemporanea dello stesso documento.
+
+Senza risposta, si stima su (a) come assunzione dichiarata; (b) e (c) si quotano come varianti.
+
+**M8: Circolari**
+- Circolari agli enti su scadenze amministrative, contabili e fiscali.
+- ✅ Invio **via email e nell'app**. Costa più di un solo canale, ma non il doppio: il servizio email serve già per gli alert. In più lo studio vede quali circolari l'ente ha letto.
+
+**M9: Valutazione volontariato** (fase 2)
+- ✅ Lo studio inserisce il time sheet di volontari e dipendenti: attività, ore, ruolo, valore economico di ogni ora.
+- ⏳ Q15: chi fissa le tariffe orarie e in che forma l'ente manda le ore allo studio.
+
+---
+
+## 4. Requisiti trasversali
+
+| Area | Requisito |
+|---|---|
+| Accessi | Dati separati per ente; ruoli e permessi distinti per studio ed ente |
+| Processi | Un unico flusso di approvazione (bozza → revisione → approvato → archiviato); notifiche via email e nell'app |
+| Documenti | Generazione di PDF/Word da modelli; importazione di Excel/PDF; firma elettronica (⏳ Q4); marca temporale e conservazione (⏳ Q9) |
+| Tracciabilità | Registro di chi ha fatto cosa e quando (valore probatorio + GDPR) |
+| Piattaforma | ✅ Web, da computer: nessun requisito per smartphone o accessibilità (va scritto nel preventivo) · ✅ nessuna preferenza di hosting, si raccomanda l'UE per il GDPR · ✅ nessuna migrazione: gli enti inseriscono a mano i dati esistenti (da dire al cliente, import da Excel quotabile come opzione) |
+
+---
+
+## 5. Dati personali
+
+- **Chi è coinvolto:** anagrafiche di soci, volontari, dipendenti, collaboratori e sostenitori; dati antiriciclaggio dei legali rappresentanti (D.Lgs. 231/2007); ore di lavoro; movimenti bancari.
+- **Dati particolari (art. 9 GDPR):** l'iscrizione ad alcuni enti (religiosi, politici, sindacali, di pazienti) può rivelarli.
+- **Ipotesi sui ruoli:**
+  - lo studio è titolare per i propri clienti e per l'antiriciclaggio, e responsabile del trattamento (art. 28) per i dati degli enti;
+  - gli enti sono titolari dei dati delle proprie persone;
+  - chi sviluppa il software e l'hosting sono sub-responsabili.
+- ⚖️ Da far verificare a un **legale** e a un **commercialista**: ruoli privacy, conservazione dei dati antiriciclaggio, valore legale di firma, marca temporale e conservazione dei libri, rendicontazione del bando.
+
+---
+
+## 6. Differenze tra [D] e [X]
+
+| Punto | Come si risolve |
+|---|---|
+| Circolari: fase 2 in [D], dentro Gestione cliente in [X] | ✅ Si segue [X]: fase 1 |
+| Scadenziario e proforma: solo in [X] | ✅ Inclusi (perimetro: Q5) |
+| Time sheet: chi inserisce non è indicato in [D], operatore interno in [X] | ✅ Si segue [X]: lo studio |
+| Categorie di persone diverse nei due documenti | ⏳ Q8 |
+| Bilancio sociale: sezioni diverse, descrizione copiata in [X] | ⏳ Q14 |
+| Campi di anagrafica ente, libri sociali, contabilità, sezioni della progettazione, valorizzazione oraria | 🔸 Unione dei due documenti (conferma: Q20) |
+
+---
+
+## 7. Decisioni prese
+
+| # | Decisione |
+|---|---|
+| D1 | Interno = studio, esterno = ente |
+| D2 | Piattaforma multi-ente |
+| D3 | Circolari in fase 1 |
+| D4 | Il time sheet lo inserisce lo studio |
+| D5 | Circolari via email e nell'app |
+| D6 | Imputazione sulle voci del Modello D |
+| D7 | Scadenze uguali per tutti, modificabili |
+| D8 | Nessuna migrazione di dati |
+| D9 | Nessun requisito su smartphone, accessibilità, hosting |
+
+Le decisioni vengono da Davide e vanno approvate dal cliente con la v1.0 (Q18).
+🔸 **Ipotesi da confermare:** n° soci e volontari inseriti a mano (Q7); unione dei requisiti dei due documenti (Q20).
+
+---
+
+## 8. Punti aperti
+
+Il testo completo delle domande è in `domande-cliente.md`.
+
+- **Prioritari per la stima:**
+  - Q1 n° di enti · Q2 ripartizione degli utenti · Q4 tipo di firma · Q5 proforma o fattura elettronica;
+  - Q9 conservazione dei libri · Q10 estratti conto PDF · Q19 divisione del lavoro in M6 e M7.
+- **Contenuto dei moduli:**
+  - Q3 catalogo dei servizi · Q7 conteggi manuali · Q8 categorie di persone e ruoli · Q12 scadenze per singolo ente;
+  - Q13 schema del progetto · Q14 bilancio sociale · Q15 tariffe orarie e invio delle ore.
+- **Organizzazione:** Q18 approvazione e gestione delle modifiche · Q20 unione dei requisiti.
+
+---
+
+## 9. Rischi
+
+| Rischio | Mitigazione |
+|---|---|
+| Scope creep su M6 (schema inesistente, divisione del lavoro non definita) e su M7 (descritto solo per titoli) | Assunzioni dichiarate nel preventivo, schema consegnato prima dello sviluppo, fase 2 stimata a parte, procedura per le modifiche (Q18) |
+| Dipendenza dal cliente (schema, modelli di verbale e circolare, estratti conto di esempio, tariffe orarie) | Elenco dei materiali con date di consegna nel preventivo |
+| Richiesta di importazione dati a progetto avviato | Dirlo subito; import da Excel come voce opzionale |
+| Privacy e sicurezza (molte persone, possibili dati art. 9, antiriciclaggio) | Privacy by design, DPA, hosting UE, verifica legale |
+| Valore legale dei documenti | Fornitori qualificati per firma, marca temporale e conservazione |
+| Estratti conto in PDF di formati diversi | Fase 1: import Excel/CSV e archivio del PDF; lettura automatica come evoluzione |
+| Norme che cambiano (Modello D, bilancio sociale, RUNTS) | Voci e modelli configurabili |
+| Rendicontazione del bando | Voci chiare e verificabili, validate dal commercialista |
+
+---
+
+## Registro delle modifiche
+
+| Versione | Data | Allineato a | Modifiche |
+|---|---|---|---|
+| 0.2 | 25/09/2026 | `richiesta.md` v0.2 | Prima stesura: sintesi completa di `richiesta.md` v0.2 |
+
+---
+
+## Stato
+- **Fase corrente:** analisi dei requisiti (v0.2).
+- **Decisioni prese:** D1–D9.
+- **Prossimo passo:** incontro con il cliente sulle domande prioritarie, poi v1.0 dei requisiti, architettura e stima.