Riorganizza i documenti per eliminare le informazioni ripetute

- 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

No files matched your search

+14 -50
View File
@@ -1,21 +1,19 @@
# Workflow del software
**Progetto:** Gestionale per enti del Terzo Settore
**Documento:** `workflow.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`
**Fa fede a:** `richiesta.md` (sintesi in `richiesta-sintesi.md`)
**Versione:** 0.3.1 · **Data:** 27/09/2026 · **Stato:** Bozza, da validare con il cliente
**Allineato a:** `richiesta.md` v0.3 · **Schema di versione:** vedi `indice-documenti.md`
---
## 0. Regole del documento
1. **Il workflow deriva dalla richiesta, non il contrario.** Ogni passo cita il requisito (RF-x.x, RT-x), la decisione (Dx) o la domanda aperta (Qx) di `richiesta.md` da cui nasce.
2. **Versione allineata.** Il workflow segue lo schema di versione comune (`indice-documenti.md`). Quando `richiesta.md` cambia, si aggiorna il workflow e si registra la modifica al §11.
3. **Tre tipi di passo:**
- senza simbolo: scritto nella richiesta;
- 🔸 **dedotto**: non è scritto, ma serve perché il processo funzioni (es. "l'ente può rifiutare un'offerta"). Va confermato con il cliente;
- ⏳ **aperto**: dipende da una domanda senza risposta. Il passo descrive l'ipotesi di lavoro.
4. **Come si legge un passo:** chi lo fa, cosa fa, cosa fa il sistema, riferimento.
1. **Il workflow deriva dalla richiesta.** Ogni passo cita il requisito (RF, RT), la decisione (D) o la domanda (Q) di `richiesta.md` da cui nasce. Quando la richiesta cambia, si aggiornano i passi che ne citano i codici.
2. **Tre tipi di passo:**
- senza simbolo: scritto nelle fonti;
- 🔸 **dedotto**: non è scritto, ma serve perché il processo funzioni. La domanda di conferma è in `domande-cliente.md` A4;
- ⏳ **aperto**: dipende da una domanda senza risposta (in `domande-cliente.md`); il passo descrive l'ipotesi di lavoro.
3. **Come si legge un passo:** chi lo fa, cosa fa, cosa fa il sistema, riferimento.
**Attori:** **Studio** (operatore interno) · **Ente** (operatore esterno) · **Sistema** (azioni automatiche).
@@ -70,7 +68,6 @@ flowchart LR
| 6 | Studio | 🔸 Crea l'accesso per il referente dell'ente | Invia le credenziali; l'ente vede solo i propri dati | RT-1, RT-2 (🔸 dedotto) |
**Stati dell'offerta:** bozza → inviata → firmata · 🔸 rifiutata · 🔸 scaduta.
**Domande aperte:** Q3 catalogo · Q4 tipo di firma · 🔸 da confermare: gestione di rifiuto e scadenza dell'offerta; chi crea l'accesso dell'ente.
---
@@ -86,8 +83,6 @@ flowchart LR
| 3 | Studio | Verifica ed emette il proforma | Invia il proforma all'ente | RF-1.8 (⏳ Q5) |
| 4 | Studio | 🔸 Registra l'avvenuto pagamento | Chiude la scadenza | 🔸 dedotto |
**Domande aperte:** Q5 solo proforma o anche fattura elettronica · 🔸 da confermare: registrazione dell'incasso e gestione dei ritardi.
---
## 4. W3: Gestione delle persone dell'ente (M3)
@@ -101,8 +96,6 @@ flowchart LR
| 2 | Ente | ⏳ Assegna uno o più ruoli (es. socio e volontario) | ⏳ Una scheda per persona con più ruoli | RF-3.3 (⏳ Q8.c) |
| 3 | Sistema | — | ⏳ Se la persona è socio o volontario, prepara la voce nel libro soci o nel registro volontari (W4) | ⏳ Q8.c |
**Domande aperte:** Q8.a categorie · Q8.b dati per categoria · Q8.c più ruoli e collegamento con i libri.
---
## 5. W4: Tenuta dei libri sociali (M4)
@@ -122,7 +115,6 @@ flowchart LR
**Stati:** bozza → in revisione → 🔸 da correggere → approvato → archiviato.
**Flusso di approvazione:** è lo stesso flusso comune a più moduli (RT-3), riusato in W6 e W8.
**Domande aperte:** Q4 firma · Q9 conservazione a norma e stampa · 🔸 da confermare: il rimando all'ente con osservazioni.
---
@@ -153,8 +145,6 @@ flowchart LR
| 3 | Studio | 🔸 Controlla Modello D e relazione | 🔸 Flusso di approvazione (RT-3) | 🔸 dedotto |
| 4 | Studio / Ente | Esporta i documenti da allegare al bilancio | Genera PDF/Word | RT-7 |
**Domande aperte:** Q10 lettura automatica del PDF · Q12 scadenze per singolo ente · 🔸 da confermare: solleciti in caso di mancato caricamento; controllo dello studio su Modello D e relazione.
---
## 7. W6: Stesura di un progetto (M6)
@@ -162,7 +152,7 @@ flowchart LR
**Scopo:** preparare un progetto da presentare a un bando.
**Inizio:** l'ente o lo studio avvia un nuovo progetto · **Fine:** progetto esportato.
> ⏳ **Ipotesi di lavoro (Q19, opzione a):** l'ente scrive e lo studio rivede, con lo stesso flusso di W4. Se il cliente sceglie (b) sezioni divise o (c) modifica contemporanea, questo workflow va riscritto.
> ⏳ **Ipotesi di lavoro (Q19, opzione a):** l'ente scrive e lo studio rivede, con lo stesso flusso di W4. Con le opzioni (b) o (c) (`domande-cliente.md` B4.3) questo workflow va riscritto.
| # | Chi | Azione | Sistema | Rif. |
|---|---|---|---|---|
@@ -172,8 +162,6 @@ flowchart LR
| 4 | Studio | Rivede; approva o rimanda con osservazioni | Flusso di approvazione (RT-3) | RF-6.4 (⏳ Q19) |
| 5 | Studio / Ente | Esporta e adatta al formulario del bando | ⏳ Esporta in Word/PDF | RF-6.3 (⏳ Q13) |
**Domande aperte:** Q13 schema, formato di esportazione, adattamento ai formulari · Q19 divisione del lavoro.
---
## 8. W7: Invio delle circolari (M8)
@@ -189,8 +177,6 @@ flowchart LR
| 4 | Ente | Legge la circolare nell'app | Registra "letta" | RF-8.2 |
| 5 | Studio | Consulta chi l'ha letta e chi no | Mostra lo stato di lettura; segnala le email non recapitate | RF-8.2 |
**Domande aperte:** 🔸 da confermare: scelta dei destinatari (tutti o per gruppi, es. per qualifica dell'ente).
---
## 9. W8: Bilancio sociale (M7), fase 2
@@ -207,8 +193,6 @@ flowchart LR
| 3 | Studio | Rivede; approva o rimanda | Flusso di approvazione (RT-3) | RF-7.4 (⏳ Q19) |
| 4 | Studio / Ente | Esporta | Genera PDF/Word | RT-7 |
**Domande aperte:** Q14 sezioni e linee guida · Q19 divisione del lavoro.
---
## 10. W9: Time sheet e valorizzazione del volontariato (M9), fase 2
@@ -223,8 +207,6 @@ flowchart LR
| 3 | Studio | Inserisce il time sheet: attività, ore, ruolo/qualifica | — | RF-9.1, RF-9.2, RF-9.4, D4 |
| 4 | Sistema | — | Calcola il valore delle ore | RF-9.3 |
**Domande aperte:** Q15 chi definisce le tariffe; in che forma l'ente manda le ore.
---
## 11. Registro delle modifiche
@@ -232,30 +214,12 @@ flowchart LR
| Versione | Data | Versione di `richiesta.md` | Modifica |
|---|---|---|---|
| 0.2 | 25/09/2026 | 0.2 | Prima stesura, allineata a `richiesta.md` v0.2 |
**Procedura quando cambia la richiesta:**
1. Aggiornare `richiesta.md` e alzarne la versione.
2. Cercare in questo documento i riferimenti toccati (RF, D, Q).
3. Aggiornare i passi coinvolti; se una domanda ⏳ ha avuto risposta, togliere il simbolo; se un passo 🔸 è stato confermato o scartato, aggiornarlo o eliminarlo.
4. Allineare la versione del workflow e aggiungere una riga a questa tabella.
---
## 12. Riepilogo dei passi da confermare con il cliente
Sono i passi 🔸 dedotti, non scritti nella richiesta. Conviene aggiungerli alle domande (`domande-cliente.md`):
| Workflow | Passo dedotto |
|---|---|
| W1 | L'ente può rifiutare l'offerta; l'offerta può scadere; lo studio crea l'accesso dell'ente |
| W2 | Lo studio registra l'incasso; gestione dei ritardi di pagamento |
| W4 | Lo studio può rimandare un documento all'ente con osservazioni |
| W5 | Solleciti se l'ente non carica i documenti; controllo dello studio su Modello D e relazione |
| W7 | Circolari a tutti gli enti o a gruppi di enti |
| 0.3 | 27/09/2026 | 0.3 | Solo allineamento di versione: D10, D11 e RT-15 riguardano la gestione dei servizi, non i processi del software. Nessun passo modificato |
| 0.3.1 | 27/09/2026 | 0.3 | Riorganizzazione senza modifiche ai passi: tolti le righe "Domande aperte" (ripetevano la colonna Rif.), la procedura di aggiornamento (è in `indice-documenti.md`) e il §12 dei passi da confermare (spostato in `domande-cliente.md` A4) |
---
## Stato
- **Fase corrente:** analisi dei requisiti (v0.2), workflow in prima stesura.
- **Decisioni prese:** D1–D9 (`richiesta.md`, §9), riportate nei passi.
- **Prossimo passo:** confermare con il cliente i passi dedotti (§12) insieme alle domande aperte. Con le risposte si aggiornano richiesta e workflow alla v1.0.
- **Fase corrente:** analisi dei requisiti, workflow v0.3.1.
- **Decisioni prese:** D1–D11 (`richiesta.md` §7), riportate nei passi.
- **Prossimo passo:** confermare con il cliente i passi 🔸 (`domande-cliente.md` A4) e rispondere alle domande ⏳; poi aggiornare i passi coinvolti.