Files
richiesta-software/richiesta-sintesi.md
T
davideandClaude Opus 5.5 a17065f33f 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>
2026-09-25 18:38:32 +02:00

201 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.