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>
201 lines
11 KiB
Markdown
201 lines
11 KiB
Markdown
# 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.
|