richiesta-software/richiesta.md

Richiesta del cliente

Progetto: Gestionale per enti del Terzo Settore Documento: richiesta.md (documento base: gli altri documenti si allineano a questo) Versione: 0.4.2 · Data: 27/09/2026 · Stato: Bozza, da validare con il cliente Allineato a: fonti del cliente del 25/09/2026 · Schema di versione: vedi indice-documenti.md

Fonti:

• [D] fonti/2026-09-25/funzioni software.docx: funzioni richieste, divise in "di base indispensabili" e "aggiuntive" (originale ancora da copiare nella cartella; nel frattempo vale la trascrizione funzioni software - testo estratto.md)
• [X] fonti/2026-09-25/Software.xlsx: tabella Moduli / Funzioni / Contenuti / Operatore / Note

Cosa contiene: cosa deve fare il software e cosa è stato deciso. Dove trovare il resto: processi passo per passo in workflow.md · domande aperte, dubbi architetturali, rischi e verifiche legali in domande-cliente.md · costi in costi-ricorrenti.md.

Legenda: ✅ deciso · ⏳ aperto (domanda in domande-cliente.md) · 🔸 ipotesi da confermare

---

1. Quadro generale

1.1 Modello di business

✅ Piattaforma multi-ente (D2): uno studio professionale usa il software per gestire molti enti del Terzo Settore suoi clienti. Ogni ente vede solo i propri dati, lo studio li vede tutti (RT-1). ⏳ Numero di enti: Q1.

1.2 Attori

✅ Terminologia (D1): le due fonti usano "interno" con significati diversi. Qui, come in [X], interno = studio ed esterno = ente.

Attore	Chi è	Cosa fa
Studio (operatore interno)	Professionista dello studio committente	Offerte, anagrafiche enti, imputazione contabile, circolari, time sheet; controlla e approva i documenti degli enti
Ente (operatore esterno)	Referente dell'ente cliente	Inserisce soci, volontari e lavoratori, compila i libri sociali, carica i documenti contabili
Interessati (non utenti)	Soci, volontari, dipendenti, collaboratori, sostenitori…	Persone di cui si trattano i dati; non accedono al sistema

---

2. Moduli

Fase: fase 1 = funzioni che [D] chiama "di base indispensabili"; fase 2 = funzioni "aggiuntive". Eccezione: M8 in fase 1 (D3). Stato: Definito se nessun dubbio aperto ne cambia la struttura; altrimenti è indicata la domanda.

#	Modulo	Cosa fa	Fase	Chi inserisce i dati	Chi controlla / usa il risultato	Stato
M1	Gestione cliente e contrattualistica	Offerte, firme, scadenziario e proforma dello studio verso gli enti	1	Studio	Ente (firma l'offerta, riceve i proforma)	Definito (dettagli: Q4, Q5)
M2	Anagrafica enti	Scheda di ogni ente cliente	1	Studio	Studio	Definito
M3	Anagrafiche collegate	Registro di soci, volontari, dipendenti e altre persone dell'ente	1	Ente	Ente; i dati alimentano M4 e M7	Definito
M4	Libri sociali	Libro soci, registro volontari, verbali, con marca temporale	1	Ente	Studio controlla, poi stampa e archiviazione definitiva	Definito (dettagli: Q9)
M5	Contabilità	Documenti contabili, Modello D e relazione illustrativa	1	Ente (carica documenti, scrive la relazione)	Studio (imputa i movimenti sulle voci del Modello D)	Definito (dettagli: Q10)
M6	Progettazione	Stesura guidata di progetti per bandi	1	Ente e studio	Ente e studio	⏳ Q13, Q19
M7	Rendicontazione sociale	Stesura guidata del bilancio sociale	2	Ente e studio	Ente e studio	⏳ Q19; Q14 prima della fase 2
M8	Circolari	Comunicazioni dello studio agli enti su scadenze e adempimenti	1	Studio	Ente (via email e nell'app)	Definito
M9	Valutazione volontariato	Time sheet di volontari e dipendenti, con valorizzazione delle ore	2	Studio	Studio	Definito (Q15 prima della fase 2)

Fase 1: M1, M2, M3, M4, M5, M6, M8 · Fase 2: M7, M9.

---

3. Requisiti funzionali per modulo

RF = requisito funzionale · Fonte: [D], [X] o decisione (Dn, §7).

M1: Gestione cliente e contrattualistica (fase 1)

Gestire il rapporto commerciale tra studio ed ente, dall'offerta all'incasso.

ID	Requisito	Fonte
RF-1.1	Catalogo dei servizi dello studio, vendibili singolarmente o a pacchetto. 🔸 Gestito dallo studio: ogni servizio ha prezzo e aliquota IVA; un pacchetto è un insieme di servizi	D
RF-1.2	Composizione di preventivi/offerte a partire dal catalogo	D + X
RF-1.3	Nell'offerta vanno indicate modalità di pagamento e scadenze	D
RF-1.4	Invio dell'offerta all'ente e firma digitale per l'accettazione ⏳ Q4	D + X
RF-1.5	L'offerta comprende l'informativa privacy, con firma di presa visione	D + X
RF-1.6	L'offerta comprende la raccolta dati antiriciclaggio, con firma	D + X
RF-1.7	Scadenziario dei pagamenti, generato dalle condizioni dell'offerta	X
RF-1.8	Emissione di proforma alle scadenze ⏳ Q5	X
RF-1.9	Alert allo studio sulle scadenze	X
RF-1.10	Invio di circolari di aggiornamento ai clienti (dettaglio in M8)	X

M2: Anagrafica enti (fase 1)

Scheda completa di ciascun ente cliente, compilata dallo studio.

ID	Campo	Fonte	Note
RF-2.1	Denominazione sociale	D + X
RF-2.2	Sede	X
RF-2.3	Codice fiscale	D + X
RF-2.4	Partita IVA (se presente)	D + X	Facoltativa
RF-2.5	Data di costituzione	D
RF-2.6	Numero e data di iscrizione al RUNTS	D + X
RF-2.7	Sezione di iscrizione al RUNTS	X	Lista chiusa
RF-2.8	Qualifica: ODV, APS, ETS, Impresa sociale, SOMS, Rete, Ente filantropico	D	Lista chiusa
RF-2.9	Attività di interesse generale (art. 5 CTS) previste da statuto e svolte	D + X	Selezione multipla dall'elenco di legge
RF-2.10	Eventuali attività diverse (art. 6 CTS)	D + X	Selezione multipla / testo
RF-2.11	Raccolta fondi continuativa con modalità commerciali (sì/no)	D
RF-2.12	Raccolta fondi continuativa ordinaria (sì/no)	D
RF-2.13	Numero soci	D + X	🔸 Inserito a mano; accanto si mostra il conteggio calcolato da M3
RF-2.14	Numero volontari	D + X	🔸 Inserito a mano; accanto si mostra il conteggio calcolato da M3

M3: Anagrafiche collegate (fase 1)

Registro delle persone legate a ciascun ente, compilato dall'ente.

ID	Requisito	Fonte
RF-3.1	Inserimento dei dati anagrafici delle persone collegate all'ente	D + X
RF-3.2	Categorie di persona: tutte quelle citate nelle fonti (tabella sotto, D13). Nuove categorie o dati specifici per categoria si aggiungono con una migrazione (D12)	D + X
RF-3.3	🔸 Una persona può appartenere a più categorie: una scheda per persona, con più ruoli; libro soci e registro volontari prendono i dati da qui	🔸

Categorie citate nelle fonti:

Categoria	[D]	[X]
Soci	✔	✔
Aderenti	✔
Tesserati	✔	✔
Volontari	✔	✔
Volontari occasionali		✔
Dipendenti / lavoratori	✔	✔
Collaboratori		✔
Sostenitori	✔
Partecipanti	✔

M4: Libri sociali (fase 1)

Tenuta digitale dei libri obbligatori dell'ente, con valore probatorio.

ID	Requisito	Fonte
RF-4.1	Libro soci: data delibera di ammissione, dati anagrafici, contatti, data cessazione/decadenza, note, firma operatore	D + X
RF-4.2	Registro volontari: data inizio, dati anagrafici, contatti, data fine, note, firma operatore	D + X
RF-4.3	Libro verbali assemblea soci: redazione dei verbali	D + X
RF-4.4	Libro verbali organo di amministrazione: redazione dei verbali	D + X
RF-4.5	Marcatura temporale dei documenti	D + X
RF-4.6	Conservazione digitale dei documenti ⏳ Q9	D
RF-4.7	Flusso di approvazione: l'ente compila, lo studio controlla, poi stampa e archiviazione definitiva	D + X

M5: Contabilità (fase 1)

Raccolta dei documenti contabili dell'ente, rendiconto di cassa e relazione illustrativa.

ID	Requisito	Fonte
RF-5.1	Alert all'ente alle scadenze per il caricamento dei documenti; calendario uguale per tutti gli enti, ma modificabile. 🔸 Calendario comune con eccezioni per singolo ente	D + D7
RF-5.2	Caricamento degli estratti conto bancari trimestrali (Excel o PDF) ⏳ Q10	D + X
RF-5.3	Caricamento della prima nota cassa trimestrale (Excel)	D + X
RF-5.4	Caricamento dei rendiconti delle raccolte fondi pubbliche occasionali	D
RF-5.5	Imputazione contabile dei singoli movimenti, fatta dallo studio direttamente sulle voci del Modello D	X + D6
RF-5.6	Elaborazione dei dati per il rendiconto per cassa su Modello D (schema ministeriale)	D
RF-5.7	Relazione illustrativa guidata su modelli preimpostati (attività dell'anno, progetti finanziati e realizzati), da allegare al bilancio	D

M6: Progettazione (fase 1)

Stesura guidata di un progetto per bandi, secondo un modello standard adattabile ai formulari degli enti erogatori.

ID	Requisito	Fonte
RF-6.1	Procedura guidata, a sezioni, per la stesura del progetto	D + X
RF-6.2	Sezioni: analisi del contesto, analisi dei bisogni, idea, obiettivi, attività, risorse, cronoprogramma, costi, piano economico-finanziario	D + X
RF-6.3	Modello standard convertibile sui formulari degli enti erogatori ⏳ Q13	X
RF-6.4	Lavoro condiviso tra ente e studio ⏳ Q19	X
RF-6.5	Schema di dettaglio del progetto: non esiste ancora ("sarà impostato nel dettaglio"; confermato nella risposta a Q13) ⏳ Q13	D

M7: Rendicontazione sociale (fase 2)

Raccolta guidata dei dati per il bilancio sociale, riusando i dati già presenti nel sistema.

ID	Requisito	Fonte
RF-7.1	Procedura guidata per redigere il bilancio sociale	D + X
RF-7.2	Estrazione automatica dei dati già presenti (anagrafica ente, soci, volontari, dati economici…)	D
RF-7.3	Sezioni: lettera del presidente [X], serie di dati standard [D], identità dell'ente, principali stakeholder, utenti, obiettivi e attività, situazione economico-finanziaria, relazione dell'organo di controllo ⏳ Q14, da chiedere prima della fase 2	D + X
RF-7.4	Lavoro condiviso tra ente e studio ⏳ Q19	X

M8: Circolari (fase 1)

ID	Requisito	Fonte
RF-8.1	Invio di circolari agli enti sulle scadenze di adempimenti amministrativi, contabili e fiscali	D + X
RF-8.2	Canale di invio: email e area comunicazioni dentro l'app, con stato di lettura	D5

M9: Valutazione volontariato (fase 2)

ID	Requisito	Fonte
RF-9.1	Inserimento del time sheet di volontari e dipendenti	D
RF-9.2	Per ogni registrazione: tipo di attività, ore dedicate, ruolo/qualifica	D + X
RF-9.3	Valorizzazione economica di ogni ora in base all'attività ⏳ Q15, da chiedere prima della fase 2	D
RF-9.4	L'inserimento è fatto dallo studio	X + D4

---

4. Requisiti trasversali

Non sono scritti come moduli nelle fonti, ma derivano da quanto richiesto.

ID	Requisito	Da dove deriva
RT-1	Separazione dei dati tra enti: ogni ente vede solo i propri dati, lo studio li vede tutti	D2
RT-2	Ruoli e permessi distinti per studio ed ente	Colonna "Operatore" di [X]
RT-3	Flusso di approvazione comune (bozza → in revisione → approvato/respinto → archiviato)	M4, e probabilmente M5–M7
RT-4	Notifiche: email + notifiche nell'app	M1, M5, M8
RT-5	Firma elettronica dei documenti ⏳ Q4	M1, M4
RT-6	Marca temporale e conservazione digitale ⏳ Q9	M4
RT-7	Generazione documenti (PDF/Word) da modelli: offerte, verbali, libri, Modello D, relazioni, progetti	M1, M4–M7
RT-8	Importazione file (Excel, PDF) per i documenti contabili	M5
RT-9	Registro delle operazioni (audit trail): chi ha fatto cosa e quando	Valore probatorio dei libri + GDPR
RT-10	Conformità GDPR (§5)	Dati personali di soci, volontari, dipendenti, clienti
RT-11	Dimensionamento: circa 100 utenti ⏳ Q1	Contesto di progetto
RT-12	Applicazione web usata da computer; nessun requisito per smartphone o accessibilità	D9
RT-13	Hosting nell'Unione Europea (il cliente non ha preferenze; l'UE evita i trasferimenti extra-UE e semplifica la conformità al GDPR)	D9 + §5
RT-14	Nessuna migrazione di dati all'avvio: il sistema parte vuoto	D8
RT-15	Trasferibilità dei servizi di produzione: a fine primo anno server, dominio, backup, email, firma, marche temporali ed eventuale conservazione passano al cliente senza interruzioni né perdita di dati; fornitori che permettono il trasferimento di account o contratto; documento di consegna con accessi, configurazioni e procedure	D10, D11
RT-16	Database PostgreSQL. Ogni modifica della struttura dei dati si fa con migrazioni versionate insieme al codice, applicate identiche in test e in produzione; nessuna modifica manuale del database in produzione	D12

---

5. Dati personali trattati

Il sistema tratta molti dati personali di persone che non sono utenti del software.

Dato	Di chi	Modulo	Nota
Anagrafici e contatti	Soci, volontari, dipendenti, collaboratori, sostenitori	M3, M4	Volume elevato
Dati per l'adeguata verifica antiriciclaggio (documenti d'identità, titolare effettivo…)	Legali rappresentanti degli enti	M1	Obblighi specifici di conservazione (D.Lgs. 231/2007)
Dati di lavoro e ore	Dipendenti, volontari	M9
Movimenti bancari e di cassa	Ente (possono contenere nomi di persone)	M5
Possibili categorie particolari (art. 9 GDPR)	Soci	M3	L'adesione a certi enti (religiosi, politici, sindacali, di pazienti) può rivelare di per sé dati particolari

Ruoli privacy (🔸 ipotesi, da verificare: domande-cliente.md C1):

• lo studio è titolare per i dati dei propri clienti e per l'antiriciclaggio;
• lo studio è responsabile del trattamento (art. 28 GDPR) per i dati delle persone degli enti, di cui gli enti sono titolari;
• chi sviluppa e gestisce il software e il fornitore di hosting sono sub-responsabili;
• primo anno (D10): Davide è intestatario dei servizi di produzione e firma i contratti sul trattamento dei dati con i fornitori; dal secondo anno (D11) i contratti passano al cliente e Davide resta coinvolto per la manutenzione.

---

6. Differenze tra le fonti

#	Punto	[D]	[X]	Esito
1	Circolari	Funzione aggiuntiva (fase 2)	Dentro "Gestione cliente"	✅ D3: fase 1
2	Scadenziario e proforma	Non citati	Presenti	✅ Inclusi (RF-1.7, RF-1.8)
3	Campi anagrafica ente	Data costituzione, qualifica, raccolte fondi	Sede, sezione RUNTS	✅ D13: inclusi tutti
4	Categorie di persone	7 categorie	6 categorie, in parte diverse	✅ D13: incluse tutte
5	Libri sociali	Firma operatore, note, conservazione digitale	Contatti	✅ D13: inclusi tutti
6	Contabilità	Alert, raccolte fondi occasionali, Modello D, relazione illustrativa	Imputazione dei singoli movimenti	✅ D13: inclusi tutti; [X] descrive come si arriva al Modello D
7	Sezioni progettazione	Contiene "Costi"	Contiene "Obiettivi" e "Risorse"	✅ D13: incluse tutte
8	Rendicontazione sociale	"Serie di dati standard"	"Lettera del presidente"; descrizione copiata da M6	⏳ Q14
9	Time sheet: chi inserisce	Non indicato	Operatore interno	✅ D4: lo studio
10	Valorizzazione oraria	Presente	Assente, ma c'è "ruolo/qualifica"	✅ D13: inclusi entrambi

Regola generale: D13.

---

7. Decisioni

Decisioni indicate da Davide: D1–D9 il 25/09/2026, D10–D13 il 27/09/2026. Vanno approvate dal cliente con la versione 1.0 (Q18).

#	Decisione	Motivo / origine	Requisiti toccati
D1	Interno = studio, esterno = ente	Le fonti usano "interno" in modi diversi; si adotta la convenzione di [X]	§1.2
D2	Piattaforma multi-ente: uno studio gestisce molti enti clienti	Conferma del modello di business	RT-1
D3	Circolari (M8) in fase 1	[D] le mette in fase 2, [X] in "Gestione cliente": si segue [X]	M8
D4	Il time sheet (M9) lo inserisce lo studio	[D] non lo dice, [X] indica l'operatore interno: si segue [X]. Non serve un nuovo tipo di utente	RF-9.4
D5	Circolari via email e nell'app	Risposta a Q6	RF-8.2, RT-4
D6	Imputazione contabile direttamente sulle voci del Modello D	Risposta a Q11	RF-5.5
D7	Scadenze degli alert uguali per tutti gli enti, ma modificabili	Risposta a Q12 (la precisazione è coperta dall'ipotesi in RF-5.1)	RF-5.1
D8	Nessuna migrazione di dati all'avvio	Risposta a Q16	RT-14
D9	Nessun requisito su smartphone, accessibilità o hosting	Risposta a Q17	RT-12, RT-13
D10	Primo anno di produzione: servizi intestati a Davide, che li paga; costi nel preventivo	Risposta a Q21	RT-15
D11	Dal secondo anno servizi intestati al cliente, che li paga; gestione tecnica a Davide con contratto di manutenzione separato	Risposta a Q22	RT-15
D12	Database PostgreSQL; ogni cambiamento della struttura dei dati tramite migrazioni	Dati fortemente relazionali (enti, persone, ruoli, libri, movimenti) con vincoli di integrità; separazione dei dati per ente anche nel database, con la row-level security (RT-1); open source, senza licenze, e trasferibile tra fornitori (RT-15). Le migrazioni permettono di recepire in modo tracciato e ripetibile le risposte del cliente che cambiano la struttura dei dati	RT-16, RF-3.2
D13	Tra le fonti prevale l'Excel [X] in caso di conflitto; i campi e le funzioni presenti in una sola fonte si includono	Risposta a Q20	§6

Ipotesi 🔸 adottate (al posto di domande al cliente, da validare con il cliente al collaudo; eventuali cambi della struttura dei dati con migrazioni, D12): RF-1.1 catalogo servizi · RF-2.13–2.14 conteggi · RF-3.3 una scheda per persona con più ruoli · RF-5.1 eccezioni per singolo ente · passi 🔸 di workflow.md.

---

Registro delle modifiche

Versione	Data	Modifiche
0.1	25/09/2026	Prima analisi delle fonti. Confermati D1 e D2; mappa dei moduli con i dubbi A, B, C; risolti A (D3) e B (D4); dubbio C trasformato in Q19
0.2	25/09/2026	Risposte a Q6, Q7, Q11, Q12, Q13, Q16, Q17 (D5–D9); Q8 e Q14 divise in sotto-domande; aggiunte Q20 e RT-12, RT-13, RT-14; aggiunto il registro delle decisioni
0.3	27/09/2026	Decisioni D10 e D11; chiuse Q21 e Q22; aggiunti RT-15 e Q23; aggiornati ruoli privacy e rischi
0.3.1	27/09/2026	Riorganizzazione senza modifiche ai requisiti: spostati in domande-cliente.md domande, spiegazioni delle domande, dubbio C, rischi e verifiche legali; tolte le note su costi e scelte progettuali (già in costi-ricorrenti.md e domande-cliente.md parte B); tolto il flusso complessivo (già in workflow.md); motivazioni dei dubbi A e B spostate nella tabella delle decisioni
0.4	27/09/2026	Decisioni D12 (PostgreSQL con migrazioni, RT-16) e D13 (priorità all'Excel in caso di conflitto, chiude Q20); domande Q2, Q3, Q7, Q8, Q12 sostituite da ipotesi 🔸 (RF-1.1, RF-2.13–2.14, RF-3.2–3.3, RF-5.1); Q14 e Q15 rimandate a prima della fase 2
0.4.1	27/09/2026	Allineamento: indicato che l'originale di [D] non è ancora nella cartella delle fonti
0.4.2	27/09/2026	Allineamento: corretta la motivazione di RT-13 (il GDPR non impone l'hosting UE, lo rende più semplice)

---

Stato

• Fase corrente: analisi dei requisiti, bozza v0.4.2.
• Decisioni prese: D1–D13. Fase 1 = M1–M6 + M8; fase 2 = M7 + M9.
• Prossimo passo: risposte del cliente alle domande aperte (domande-cliente.md), poi versione 1.0 dei requisiti.