davide/richiesta-software
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Riorganizza i documenti per eliminare le informazioni ripetute

Browse Source 
- Eliminato richiesta-sintesi.md (ripeteva richiesta.md senza
  aggiungere informazione)
- domande-cliente.md: aggiunta parte C (verifiche legale/commercialista,
  nuovi codici Cn), riorganizzata parte B
- richiesta.md, workflow.md, costi-ricorrenti.md portati a v0.3.1:
  ciascuno descrive solo il proprio contenuto esclusivo, gli altri
  richiamano con il codice invece di ripetere
- CLAUDE.md: aggiornato elenco documenti, codici Cn, regola "nessuna
  informazione ripetuta", procedura di aggiornamento
- indice-documenti.md: registrate le versioni e il registro modifiche
  (D10/D11 su chi paga e gestisce i servizi di produzione; v0.3
  poi v0.3.1 per la riorganizzazione)

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5 committed 2026-09-27 15:43:13 +02:00
1 parent f6b56ef466
commit 8a822a9245
7 files changed
+317 -671
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

richiesta.md
+103 -292
View File
@@ -1,141 +1,66 @@
# Analisi della richiesta del cliente
# Richiesta del cliente
**Progetto:** Gestionale per enti del Terzo Settore
**Documento:** `richiesta.md` (documento base: gli altri documenti si allineano a questo)
**Versione:** 0.2 · **Data:** 25/09/2026 · **Stato:** Bozza, da validare con il cliente
**Schema di versione:** vedi `indice-documenti.md`
**Fonti analizzate:**
- **[D]** `funzioni software.docx`: descrizione testuale delle funzioni, divise in "di base indispensabili" e "aggiuntive"
- **[X]** `Software.xlsx`: tabella Moduli / Funzioni / Contenuti / Operatore / Note
**Versione:** 0.3.1 · **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`
**Novità rispetto alla v0.1:** vedi il registro delle modifiche in fondo al documento.
**Fonti:**
- **[D]** `fonti/2026-09-25/funzioni software.docx`: funzioni richieste, divise in "di base indispensabili" e "aggiuntive"
- **[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. Scopo del documento
## 1. Quadro generale
Il documento riordina le due richieste del cliente in un'unica descrizione lineare del software. Serve a:
### 1.1 Modello di business
1. capire **cosa deve fare** il programma, modulo per modulo;
2. tenere traccia di **cosa è deciso** e **cosa è ancora aperto**;
3. preparare le **domande da fare al cliente** prima di stimare tempi e costi.
✅ **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.
Qui non si fanno scelte tecniche e non si stimano costi. Quelle attività vengono dopo, sui requisiti validati.
### 1.2 Attori
**Legenda usata nel documento:**
- ✅ = deciso
- ⏳ = aperto, da chiedere al cliente
- 🔸 = ipotesi di lavoro, da confermare con il cliente
✅ **Terminologia (D1):** le due fonti usano "interno" con significati diversi. Qui, come in [X], **interno = studio** ed **esterno = ente**.
---
## 2. Il quadro generale: chi usa il software e perché
### 2.1 Modello di business
✅ Il software è una **piattaforma multi-ente**: uno **studio professionale** la usa per gestire **molti enti del Terzo Settore** suoi clienti. Di conseguenza ogni ente deve vedere solo i propri dati, mentre lo studio li vede tutti (RT-1).
⏳ Resta da sapere **quanti enti** saranno gestiti (Q1).
### 2.2 Attori
✅ **Terminologia:** i due documenti usano "interno" con significati diversi. In questo documento, come in [X], **interno = studio** ed **esterno = ente**.
| Attore | Chi è | Cosa fa (in sintesi) |
| Attore | Chi è | Cosa fa |
|---|---|---|
| **Studio** (operatore interno) | Professionista dello studio committente | Acquisisce i clienti, gestisce offerte, anagrafiche enti, imputazione contabile, circolari, time sheet; controlla e approva i documenti degli enti |
| **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… | Sono le persone di cui si trattano i dati. Non accedono al sistema |
### 2.3 Flusso complessivo
```
1. ACQUISIZIONE Lo studio prepara l'offerta → l'ente firma (offerta + privacy + antiriciclaggio)
↓
2. ATTIVAZIONE ENTE Lo studio registra l'anagrafica dell'ente → l'ente ottiene l'accesso
↓
3. GESTIONE ORDINARIA L'ente inserisce le persone, compila i libri sociali e carica i documenti contabili
Lo studio controlla, approva, imputa e registra i time sheet
↓
4. SCADENZE Il sistema invia all'ente alert (documenti da caricare), proforma (pagamenti)
e circolari (adempimenti)
↓
5. OUTPUT ANNUALI Rendiconto di cassa (Modello D), relazione illustrativa, bilancio sociale, progetti
```
| **Interessati** (non utenti) | Soci, volontari, dipendenti, collaboratori, sostenitori… | Persone di cui si trattano i dati; non accedono al sistema |
---
## 3. Mappa dei moduli e priorità
## 2. Moduli
### 3.1 Come leggere la mappa
Il software è diviso in **9 moduli**. Ogni modulo copre un'area di lavoro dello studio o dell'ente. Per ogni modulo la tabella indica:
- **Fase**: quando si sviluppa. **Fase 1** = funzioni che [D] chiama "di base indispensabili". **Fase 2** = funzioni che [D] chiama "aggiuntive". Fa eccezione M8: [D] lo mette in fase 2, ma si è deciso di seguire [X] e portarlo in fase 1.
- **Chi inserisce i dati**: chi lavora materialmente nel modulo.
- **Chi controlla / usa il risultato**: chi verifica o riceve l'output del modulo.
- **Stato**: *Definito* se non ci sono dubbi che cambiano la struttura del modulo; *Da chiarire* se c'è un dubbio aperto.
### 3.2 Mappa
**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: Q3, 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 (dettagli: Q8) |
| M3 | Anagrafiche collegate | Registro di soci, volontari, dipendenti e altre persone dell'ente | 1 | Ente | Ente; i dati alimentano M4 e M7 | Definito (dettagli: Q8) |
| 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 | **Da chiarire** (dubbio C, Q13) |
| M7 | Rendicontazione sociale | Stesura guidata del bilancio sociale | 2 | Ente e studio | Ente e studio | **Da chiarire** (dubbio C, Q14) |
| M8 | Circolari | Comunicazioni dello studio agli enti su scadenze e adempimenti | 1 | Studio | Ente (le riceve via email e nell'app) | Definito |
| 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 | ⏳ Q14, Q19 |
| 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 (dettagli: Q15) |
**In sintesi:**
- **Fase 1:** M1, M2, M3, M4, M5, M6, M8.
- **Fase 2:** M7, M9.
### 3.3 Dubbi sulla mappa
#### Dubbio A: in quale fase vanno le circolari (M8)? ✅ Risolto
[D] le mette in fase 2 ("funzioni aggiuntive"), [X] dentro "Gestione cliente", quindi in fase 1.
**Decisione:** si segue [X]. Le circolari sono in **fase 1** e vengono inviate **sia via email sia dentro l'app** (vedi M8 al §4).
#### Dubbio B: chi inserisce il time sheet (M9)? ✅ Risolto
[D] non lo dice, [X] indica l'operatore interno.
**Decisione:** si segue [X]. Il time sheet lo inserisce **lo studio**.
**Conseguenze:** non serve un nuovo tipo di utente per volontari e dipendenti. Nasce però una **dipendenza dal cliente**: lo studio deve ricevere le ore dagli enti, in una forma ancora da definire (Q15).
#### Dubbio C: cosa significa "entrambi" in progettazione e bilancio sociale (M6, M7)? ⏳ Aperto
| | Cosa dice |
|---|---|
| [D] | Il software "guida l'operatore". Non dice quale operatore |
| [X] | Operatore "entrambi", ma non dice chi fa cosa |
**Il dubbio:** i documenti dicono che ente e studio lavorano entrambi su progetti e bilancio sociale, ma non dicono **come si dividono il lavoro**.
**Perché conta:** "entrambi" può voler dire modi di lavorare molto diversi, con costi di sviluppo molto diversi:
| Opzione | Come funziona | Impatto sullo sviluppo |
|---|---|---|
| 1. Redazione e revisione | L'ente scrive, lo studio rivede e approva (come per i libri sociali, M4) | Il più semplice: riusa il flusso di approvazione già previsto (RT-3) |
| 2. Sezioni divise | Alcune sezioni le compila l'ente, altre lo studio (es. il piano economico-finanziario) | Medio: servono permessi per singola sezione |
| 3. Modifica contemporanea | Ente e studio lavorano sullo stesso documento nello stesso momento | Il più costoso: gestione dei conflitti e aggiornamento in tempo reale |
La risposta può essere diversa per M6 e M7. → Domanda **Q19**.
**Finché il cliente non risponde:** M6 e M7 non si possono stimare con precisione. Se serve presentare comunque il preventivo, conviene stimarli sull'opzione 1 e **scriverlo nel preventivo come assunzione**. Le opzioni 2 e 3 andrebbero quotate come variante.
**Fase 1:** M1, M2, M3, M4, M5, M6, M8 · **Fase 2:** M7, M9.
---
## 4. Requisiti funzionali per modulo
## 3. Requisiti funzionali per modulo
Legenda: **RF** = requisito funzionale · **Fonte**: [D], [X] o *Decisione* (vedi §9).
**RF** = requisito funzionale · **Fonte:** [D], [X] o decisione (Dn, §7).
### M1: Gestione cliente e contrattualistica (fase 1)
**Obiettivo:** gestire il rapporto commerciale tra lo studio e l'ente, dall'offerta all'incasso.
Gestire il rapporto commerciale tra studio ed ente, dall'offerta all'incasso.
| ID | Requisito | Fonte |
|---|---|---|
@@ -152,7 +77,7 @@ Legenda: **RF** = requisito funzionale · **Fonte**: [D], [X] o *Decisione* (ved
### M2: Anagrafica enti (fase 1)
**Obiettivo:** scheda completa di ciascun ente cliente. La compila lo studio.
Scheda completa di ciascun ente cliente, compilata dallo studio.
| ID | Campo | Fonte | Note |
|---|---|---|---|
@@ -168,23 +93,20 @@ Legenda: **RF** = requisito funzionale · **Fonte**: [D], [X] o *Decisione* (ved
| 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** (Q7) |
| RF-2.14 | Numero volontari | D + X | 🔸 Inserito **a mano** (Q7) |
| RF-2.13 | Numero soci | D + X | 🔸 Inserito a mano (Q7) |
| RF-2.14 | Numero volontari | D + X | 🔸 Inserito a mano (Q7) |
> 🔸 **Q7, ipotesi di lavoro:** numero soci e numero volontari si inseriscono a mano. Da confermare con il cliente.
> **Da sapere:** il software avrà comunque l'elenco dei soci e dei volontari (M3). Con l'inserimento manuale i due numeri possono non coincidere con quegli elenchi. Una soluzione che non complica lo sviluppo è mostrare accanto al numero inserito anche il conteggio calcolato, come controllo.
### M3: Anagrafiche collegate (fase 1)
### M3: Anagrafiche collegate, cioè le persone dell'ente (fase 1)
**Obiettivo:** registro delle persone legate a ciascun ente. Lo compila l'ente.
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 ⏳ Q8: elenco da definire (vedi sotto) | D + X |
| RF-3.3 | Una persona può appartenere a più categorie ⏳ Q8 | *da confermare* |
| RF-3.2 | Categorie di persona: elenco definitivo da stabilire ⏳ Q8 | D + X |
| RF-3.3 | Una persona può appartenere a più categorie ⏳ Q8 | 🔸 |
**Le categorie citate nei due documenti:**
Categorie citate nelle fonti:
| Categoria | [D] | [X] |
|---|---|---|
@@ -198,11 +120,9 @@ Legenda: **RF** = requisito funzionale · **Fonte**: [D], [X] o *Decisione* (ved
| Sostenitori | ✔ | |
| Partecipanti | ✔ | |
Le domande da fare al cliente su questo modulo sono spiegate in Q8 (§8).
### M4: Libri sociali (fase 1)
**Obiettivo:** tenuta digitale dei libri obbligatori dell'ente, con valore probatorio.
Tenuta digitale dei libri obbligatori dell'ente, con valore probatorio.
| ID | Requisito | Fonte |
|---|---|---|
@@ -212,67 +132,51 @@ Le domande da fare al cliente su questo modulo sono spiegate in Q8 (§8).
| 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 avvengono stampa e archiviazione definitiva | D + X |
| RF-4.7 | **Flusso di approvazione**: l'ente compila, lo studio controlla, poi stampa e archiviazione definitiva | D + X |
### M5: Contabilità (fase 1)
**Obiettivo:** raccogliere i documenti contabili dell'ente e produrre il rendiconto di cassa e la relazione illustrativa.
Raccolta dei documenti contabili dell'ente, rendiconto di cassa e relazione illustrativa.
| ID | Requisito | Fonte |
|---|---|---|
| RF-5.1 | **Alert all'ente** alle scadenze, per ricordare il caricamento dei documenti. Calendario delle scadenze **uguale per tutti gli enti, ma modificabile** ⏳ vedi nota | D + *Decisione* |
| RF-5.1 | **Alert all'ente** alle scadenze per il caricamento dei documenti; calendario **uguale per tutti gli enti, ma modificabile** ⏳ Q12 | 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** (nessun piano dei conti più dettagliato) | X + *Decisione* |
| RF-5.6 | Elaborazione dei dati per produrre il **rendiconto per cassa su Modello D** (schema ministeriale) | 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 |
> **Nota su RF-5.1:** "modificabile" può voler dire due cose diverse:
> - (a) lo studio può modificare il calendario comune, e la modifica vale per tutti gli enti;
> - (b) oltre al calendario comune, lo studio può cambiare le scadenze di un singolo ente.
>
> La (b) comprende la (a) e costa un po' di più. Va precisato quale delle due serve (Q12).
> **Conseguenza della scelta del Modello D (RF-5.5):** il modello dati della contabilità si semplifica, perché le voci sono fissate dallo schema ministeriale. Se il Ministero modifica lo schema, le voci vanno aggiornate: per questo conviene tenerle in una tabella configurabile, non scritte nel codice.
### M6: Progettazione (fase 1)
**Obiettivo:** guidare la stesura di un progetto (per bandi) secondo un modello standard, facilmente adattabile ai formulari dei vari enti erogatori.
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 (unione di [D] e [X]): **analisi del contesto, analisi dei bisogni, idea, obiettivi, attività, risorse, cronoprogramma, costi, piano economico-finanziario** | 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 ⏳ dubbio C, Q19 | X |
| RF-6.5 | Schema di dettaglio del progetto: **non esiste ancora** ("sarà impostato nel dettaglio") | D + *Risposta Q13* |
> **Attenzione:** lo schema del progetto non è disponibile. Finché non esiste, il modulo M6 è solo un elenco di sezioni. È il punto con il **rischio di scope creep più alto** della fase 1 (vedi §10). Serve sapere chi lo prepara e quando (Q13).
| 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)
**Obiettivo:** raccolta guidata dei dati per il bilancio sociale, riusando automaticamente i dati già presenti nel sistema.
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 ⏳ Q14: **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 | D + X |
| RF-7.4 | Lavoro condiviso tra ente e studio ⏳ dubbio C, Q19 | X |
| 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 | 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** | *Decisione* |
> **Quanto complica "entrambi" rispetto a un solo canale.** La circolare si scrive una volta sola e il software la manda su due canali. Ogni canale ha però un suo costo:
> - **Email:** serve un servizio di invio email (con un piccolo costo ricorrente), la configurazione del dominio dello studio perché le email non finiscano in spam, e la gestione delle email non recapitate. È molto probabile che l'email serva comunque per gli alert di M1 e M5 (RT-4), quindi questo costo c'è già.
> - **Nell'app:** serve un'area "comunicazioni" per l'ente, con lo stato letta/non letta. È un pezzo di sviluppo in più, non grande.
>
> Quindi "entrambi" costa più di un solo canale, ma non il doppio. In più dà allo studio una traccia di cosa l'ente ha letto, che la sola email non dà in modo affidabile.
| RF-8.2 | Canale di invio: **email e area comunicazioni dentro l'app**, con stato di lettura | D5 |
### M9: Valutazione volontariato (fase 2)
@@ -281,40 +185,37 @@ Le domande da fare al cliente su questo modulo sono spiegate in Q8 (§8).
| 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 | D |
| RF-9.4 | L'inserimento è fatto dallo **studio** | X + *Decisione* |
| RF-9.4 | L'inserimento è fatto dallo **studio** | X + D4 |
---
## 5. Requisiti trasversali (valgono per tutti i moduli)
## 4. Requisiti trasversali
Questi requisiti non sono scritti come moduli nei documenti, ma **derivano da quanto richiesto**. Hanno un forte impatto sull'architettura e sui costi.
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 | Piattaforma multi-ente (§2.1) |
| 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 | **Flussi di approvazione** (bozza → in revisione → approvato/respinto → archiviato) | M4, e probabilmente M5–M7 |
| RT-4 | **Sistema di notifiche**: email + notifiche nell'app | M1, M5, M8 |
| 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** (vedi §6) | Dati personali di soci, volontari, dipendenti, clienti |
| RT-10 | **Conformità GDPR** (§5) | Dati personali di soci, volontari, dipendenti, clienti |
| RT-11 | Dimensionamento: circa **100 utenti** ⏳ Q1, Q2 | Contesto di progetto |
| RT-12 | **Applicazione web** usata da computer. Nessun requisito specifico per smartphone o accessibilità | *Risposta Q17* |
| RT-13 | **Hosting:** il cliente non ha preferenze. Per il GDPR si raccomanda comunque un hosting nell'Unione Europea | *Risposta Q17* + §6 |
| RT-14 | **Nessuna migrazione di dati** all'avvio: il sistema parte vuoto | *Risposta Q16* |
> **Nota su RT-12:** "nessun requisito" per smartphone non vuol dire che dallo smartphone il software non si apra. Vuol dire solo che non si progetta e non si collauda per quell'uso. Conviene scriverlo nel preventivo, per evitare contestazioni dopo.
> **Nota su RT-14:** senza migrazione, ogni ente deve inserire a mano i soci e i volontari che ha già. Per enti con molti soci è un lavoro lungo, e potrebbe tradursi in una richiesta di importazione fatta a progetto avviato. Conviene dirlo al cliente adesso.
| 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 è richiesta dal 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 |
---
## 6. Dati personali: cosa tratta il software
## 5. Dati personali trattati
Il sistema tratta **molti dati personali di persone fisiche che non sono utenti del software**. Il tema va impostato da subito, perché condiziona architettura, hosting e contratti.
Il sistema tratta **molti dati personali di persone che non sono utenti del software**.
| Dato | Di chi | Modulo | Nota |
|---|---|---|---|
@@ -324,142 +225,52 @@ Il sistema tratta **molti dati personali di persone fisiche che non sono utenti
| 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 far verificare a un legale):**
**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 dei soci e dei volontari degli enti, di cui gli **enti** sono titolari;
- **chi sviluppa e gestisce il software** (e il fornitore di hosting) potrebbe essere *sub-responsabile*.
> ⚖️ Ruoli privacy, durata di conservazione dei dati antiriciclaggio, valore legale di firma, marca temporale e conservazione dei libri sociali vanno **fatti verificare da un legale e da un commercialista**. Qui sono riportati solo come vincoli da chiarire.
- 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.
---
## 7. Differenze tra i due documenti
## 6. Differenze tra le fonti
| # | Punto | [D] docx | [X] xlsx | Stato |
| # | Punto | [D] | [X] | Esito |
|---|---|---|---|---|
| 1 | Circolari | Funzione aggiuntiva (fase 2) | Dentro "Gestione cliente" | ✅ Si segue [X]: fase 1 |
| 2 | Scadenziario e proforma | Non citati | Presenti | ✅ Inclusi. Perimetro da chiarire (Q5) |
| 3 | Campi anagrafica ente | Data costituzione, qualifica, raccolte fondi | Sede, sezione RUNTS | 🔸 Unione dei campi |
| 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 | 🔸 Unione dei campi (Q20) |
| 4 | Categorie di persone | 7 categorie | 6 categorie, in parte diverse | ⏳ Q8 |
| 5 | Libri sociali | Firma operatore, note, conservazione digitale | Contatti | 🔸 Unione dei campi |
| 6 | Contabilità | Alert, raccolte fondi occasionali, Modello D, relazione illustrativa | Imputazione dei singoli movimenti | 🔸 Unione: [X] descrive *come* si arriva al Modello D |
| 7 | Sezioni progettazione | Contiene "Costi" | Contiene "Obiettivi" e "Risorse" | 🔸 Unione delle sezioni |
| 8 | Rendicontazione sociale | "Serie di dati standard" | "Lettera del presidente" + descrizione copiata da M6 | ⏳ Q14 |
| 9 | Time sheet: chi inserisce | Non indicato | Operatore interno | ✅ Si segue [X]: lo studio |
| 10 | Valorizzazione oraria | Presente | Assente, ma c'è "ruolo/qualifica" | 🔸 Unione |
| 5 | Libri sociali | Firma operatore, note, conservazione digitale | Contatti | 🔸 Unione dei campi (Q20) |
| 6 | Contabilità | Alert, raccolte fondi occasionali, Modello D, relazione illustrativa | Imputazione dei singoli movimenti | 🔸 Unione: [X] descrive *come* si arriva al Modello D (Q20) |
| 7 | Sezioni progettazione | Contiene "Costi" | Contiene "Obiettivi" e "Risorse" | 🔸 Unione delle sezioni (Q20) |
| 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" | 🔸 Unione (Q20) |
> 🔸 **Le righe "Unione"** sono una proposta di chi scrive, non una richiesta del cliente. Si possono confermare tutte insieme con una sola domanda (Q20).
Le righe "Unione" sono una proposta di chi scrive, non una richiesta del cliente.
---
## 8. Domande per il cliente
## 7. Decisioni
### 8.1 Domande aperte
Decisioni indicate da Davide: D1–D9 il 25/09/2026, D10–D11 il 27/09/2026. Vanno approvate dal cliente con la versione 1.0 (Q18).
Ordinate per peso sulla stima. Ogni domanda è scritta in modo da poterla fare direttamente al cliente.
**Pesano molto sulla stima**
| # | Domanda | Perché serve |
|---|---|---|
| **Q1** | Quanti enti pensate di gestire con il software, oggi e tra 3 anni? | Dimensionamento della piattaforma e dei costi di hosting |
| **Q2** | I circa 100 utenti come si dividono tra persone dello studio e referenti degli enti? | Dimensionamento, permessi, eventuali licenze |
| **Q4** | Per offerte, privacy/antiriciclaggio e libri sociali, che tipo di firma vi serve: una conferma semplice (click o codice via SMS), una firma elettronica avanzata o una firma digitale qualificata? | Scelta del fornitore di firma e costo ricorrente |
| **Q5** | Il software deve emettere solo proforma o anche la fattura elettronica? Usate già un programma di fatturazione? | La fatturazione elettronica è un sotto-progetto a sé |
| **Q9** | Per i libri sociali basta un'archiviazione con marca temporale, o vi serve una conservazione digitale a norma tramite un conservatore esterno? Serve anche la stampa? | Fornitore esterno, costi ricorrenti, valore legale |
| **Q10** | Gli estratti conto in PDF devono essere letti in automatico (estraendo i movimenti) o basta archiviarli? Da quante banche diverse arrivano? | Rischio tecnico alto se si vuole la lettura automatica |
| **Q19** | Per la progettazione e per il bilancio sociale, come vi immaginate il lavoro tra voi e l'ente? L'ente scrive e voi rivedete? Ognuno compila le sue parti? Oppure lavorate sullo stesso documento, anche nello stesso momento? Vale lo stesso per progetti e bilancio sociale? | Dubbio C: può cambiare di molto il costo di M6 e M7 |
**Definiscono il perimetro dei moduli**
| # | Domanda | Perché serve |
|---|---|---|
| **Q3** | Il catalogo dei servizi e dei pacchetti chi lo gestisce? Servono listini, sconti, aliquote IVA diverse? | Complessità di M1 |
| **Q7** | *Conferma:* numero soci e numero volontari nella scheda dell'ente si inseriscono a mano? (Ipotesi attuale: sì) | Coerenza dei dati |
| **Q8** | Tre domande sulle persone dell'ente, spiegate sotto | Modello dati di M3 e M4 |
| **Q12** | *Precisazione:* le scadenze degli alert sono uguali per tutti gli enti ma modificabili. Si modifica solo il calendario comune, o serve anche poter cambiare le scadenze di un singolo ente? | Complessità dello scadenziario (nota RF-5.1) |
| **Q13** | Lo schema del progetto non c'è ancora: chi lo prepara (voi, o va costruito insieme) e per quando? In che formato va esportato il progetto (Word, PDF)? L'adattamento ai formulari dei bandi è manuale o deve farlo il software? | Senza schema M6 non è stimabile con precisione |
| **Q14** | Due domande sul bilancio sociale, spiegate sotto | Correttezza dei requisiti di M7 |
| **Q15** | Chi stabilisce il valore di un'ora per ogni tipo di attività? In che forma l'ente vi manda le ore di volontari e dipendenti (Excel, carta, email)? | Modello dati di M9 ed eventuale funzione di importazione |
**Organizzazione del progetto**
| # | Domanda | Perché serve |
|---|---|---|
| **Q18** | Chi approva i requisiti da parte vostra? Se durante lo sviluppo servono modifiche, come le gestiamo (richiesta scritta, stima, approvazione)? | Controllo dello scope creep |
| **Q20** | Dove i due documenti elencano campi o sezioni diversi senza contraddirsi, confermate che vanno inclusi tutti (unione dei requisiti, §7)? | Chiude le righe "Unione" del §7 |
#### Q8 spiegata: le persone dell'ente
Il modulo M3 è il registro delle persone legate all'ente. Per costruirlo servono tre informazioni.
**Q8.a: quali categorie di persone esistono?** I due documenti ne citano 9 in tutto, ma non le stesse (tabella in M3). Serve l'elenco definitivo. Alcune potrebbero essere la stessa cosa con nomi diversi: per esempio "aderenti" e "tesserati", oppure "dipendenti" e "lavoratori".
> *Domanda al cliente:* "Quali tipi di persone deve gestire il software? Aderenti e tesserati sono la stessa cosa? Sostenitori e partecipanti servono?"
**Q8.b: quali dati servono per ogni categoria?** Per tutti servono i dati anagrafici e i contatti. Alcune categorie però potrebbero avere dati propri. Per esempio, per un socio la quota associativa o la data della delibera di ammissione; per un dipendente il tipo di contratto e la data di assunzione. I documenti non lo dicono.
> *Domanda al cliente:* "Oltre ad anagrafica e contatti, ci sono dati specifici da raccogliere per soci, volontari, dipendenti e collaboratori?"
**Q8.c: una persona può avere più ruoli?** Capita spesso che un socio sia anche volontario. Ci sono due modi di gestirlo:
- **una scheda per persona, con più ruoli**: i dati si inseriscono una volta sola e si aggiornano in un solo punto. È la soluzione più corretta, ma va decisa subito perché definisce la struttura del database;
- **una scheda per ogni ruolo**: più semplice all'inizio, ma la stessa persona compare due volte, con il rischio di dati diversi nelle due schede.
Collegata a questa: il libro soci e il registro volontari (M4) dovrebbero essere **generati da queste schede**, senza reinserire i dati.
> *Domanda al cliente:* "Una stessa persona può essere socio e volontario insieme? Il libro soci e il registro volontari devono prendere i dati da queste schede?"
#### Q14 spiegata: il bilancio sociale
**Q14.a: la descrizione nell'Excel è corretta?** Nella colonna "Funzioni" dell'Excel, per la Rendicontazione sociale c'è scritto: *"Guidare gli utenti nella stesura di un progetto secondo un modello standard facilmente convertibile sui formulari imposti dagli enti erogatori"*. È la stessa identica frase della Progettazione. Per il bilancio sociale ha poco senso: il bilancio sociale non è un progetto per un bando, e non va adattato ai formulari degli enti erogatori. Il bilancio sociale degli ETS segue le linee guida ministeriali (DM 4 luglio 2019). Quasi sicuramente è un copia-incolla.
> *Domanda al cliente:* "Nell'Excel la descrizione del bilancio sociale è uguale a quella della progettazione: è un errore? Il bilancio sociale deve seguire le linee guida ministeriali?"
**Q14.b: quali sono le sezioni?** Il Word cita "serie di dati standard", l'Excel cita "lettera del presidente". Il resto coincide. Serve l'elenco definitivo, e sapere cosa si intende per "serie di dati standard".
> *Domanda al cliente:* "Le sezioni del bilancio sociale sono quelle di entrambi i documenti? Cosa intendete per 'serie di dati standard'?"
### 8.2 Domande chiuse
| # | Domanda | Risposta | Effetto sul documento |
| # | Decisione | Motivo / origine | Requisiti toccati |
|---|---|---|---|
| Q6 | Canale di invio delle circolari | **Email e nell'app** | RF-8.2, RT-4 |
| Q11 | Piano dei conti per l'imputazione | **Voci del Modello D** | RF-5.5 |
| Q12 | Scadenze degli alert | **Uguali per tutti, modificabili** (resta una precisazione, vedi §8.1) | RF-5.1 |
| Q13 | Lo schema del progetto è disponibile? | **No** (restano aperte le altre parti, vedi §8.1) | RF-6.5, rischi |
| Q16 | Dati esistenti da importare | **No** | RT-14 |
| Q17 | Smartphone, accessibilità, hosting | **Nessuna preferenza** | RT-12, RT-13 |
| 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 (resta una precisazione) | 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 |
---
## 9. Registro delle decisioni
Tutte le decisioni sono state indicate da Davide (autore del preventivo) il 25/09/2026. Le decisioni sui requisiti vanno comunque fatte approvare dal cliente con la versione 1.0 (vedi Q18).
| # | Decisione | Riferimento |
|---|---|---|
| D1 | Interno = studio, esterno = ente | §2.2 |
| D2 | Il software è una piattaforma multi-ente: uno studio gestisce molti enti clienti | §2.1, RT-1 |
| D3 | Le circolari (M8) sono in fase 1, come in [X] | Dubbio A |
| D4 | Il time sheet (M9) lo inserisce lo studio, come in [X] | Dubbio B |
| D5 | Le circolari si inviano via email e nell'app | Q6, RF-8.2 |
| D6 | L'imputazione contabile usa direttamente le voci del Modello D | Q11, RF-5.5 |
| D7 | Le scadenze degli alert sono uguali per tutti gli enti, ma modificabili | Q12, RF-5.1 |
| D8 | Nessuna migrazione di dati all'avvio | Q16, RT-14 |
| D9 | Nessun requisito su smartphone, accessibilità o hosting | Q17, RT-12, RT-13 |
**Ipotesi di lavoro in attesa di conferma:** numero soci e volontari inseriti a mano (Q7); unione dei requisiti dei due documenti (Q20).
---
## 10. Rischi
| Rischio | Descrizione | Mitigazione proposta |
|---|---|---|
| **Scope creep su M6** | Lo schema del progetto non esiste (Q13) e non si sa come lavorano insieme ente e studio (Q19) | Stimare M6 su un'ipotesi dichiarata; far definire lo schema prima dello sviluppo del modulo; procedura formale per le modifiche (Q18) |
| **Scope creep in generale** | M7 è descritto solo come elenco di titoli | Requisiti firmati prima dell'avvio, fase 2 stimata a parte |
| **Dipendenza dal cliente** | Servono dal cliente: schema del progetto, modelli di verbale e di circolare, formati degli estratti conto, tariffe orarie, forma di invio delle ore | Elenco dei materiali da consegnare con date, riportato nel preventivo |
| **Inserimento iniziale dei dati** | Senza migrazione (D8), gli enti devono inserire a mano soci e volontari esistenti. Rischio di richiesta di importazione a progetto avviato | Dirlo al cliente ora; eventualmente quotare l'import da Excel come voce opzionale |
| **Sicurezza e privacy** | Dati personali di molte persone, possibili categorie particolari, dati antiriciclaggio | Privacy by design, DPA con lo studio e con i fornitori, hosting UE, verifica legale |
| **Valore legale dei documenti** | Firma, marca temporale e conservazione hanno requisiti normativi | Uso di fornitori qualificati invece di soluzioni fatte in casa, verifica legale |
| **Estratti conto PDF** | Formati diversi per ogni banca, estrazione poco affidabile | Fase 1 con import Excel/CSV e archiviazione del PDF; lettura automatica del PDF come evoluzione |
| **Adempimenti normativi** | Modello D, bilancio sociale e RUNTS possono cambiare per legge | Voci e modelli configurabili, non scritti nel codice |
| **Rendicontazione del bando** | Il budget è vincolato e le spese devono essere rendicontabili | Preventivo con voci chiare e verificabili, da validare con il commercialista |
**Ipotesi 🔸 in attesa di conferma:** RF-2.13 e RF-2.14 inseriti a mano (Q7); righe "Unione" del §6 (Q20).
---
@@ -467,14 +278,14 @@ Tutte le decisioni sono state indicate da Davide (autore del preventivo) il 25/0
| Versione | Data | Modifiche |
|---|---|---|
| 0.1 | 25/09/2026 | Prima analisi dei due documenti del cliente. Nel corso della revisione: confermati interno = studio / esterno = ente (D1) e piattaforma multi-ente (D2); riscritta la mappa dei moduli con i dubbi A, B, C; risolti dubbio A (circolari in fase 1, D3) e dubbio B (time sheet inserito dallo studio, D4); dubbio C trasformato nella domanda Q19 |
| 0.2 | 25/09/2026 | Registrate le risposte a Q6, Q7, Q11, Q12, Q13, Q16, Q17 (D5–D9); riscritte Q8 e Q14 in sotto-domande; aggiunte Q20 e i requisiti RT-12, RT-13, RT-14; aggiunto il registro delle decisioni (§9) |
| 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 |
---
## Stato
- **Fase corrente:** analisi dei requisiti, bozza v0.2.
- **Decisioni prese:** D1–D9 (§9). Fase 1 = M1–M6 + M8; fase 2 = M7 + M9.
- **Aperto:** 16 domande per il cliente (§8.1): Q1, Q2, Q3, Q4, Q5, Q7 (conferma), Q8, Q9, Q10, Q12 (precisazione), Q13, Q14, Q15, Q18, Q19, Q20. Le prioritarie per la stima sono Q1, Q2, Q4, Q5, Q9, Q10 e Q19.
- **Prossimo passo:** incontro con il cliente sulle domande del §8.1. Con le risposte si produce la versione 1.0 dei requisiti e si passa alla scelta dell'architettura e alla stima.
- **Fase corrente:** analisi dei requisiti, bozza v0.3.1.
- **Decisioni prese:** D1–D11. 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.