richiesta-software/indice-documenti.md

Indice dei documenti di progetto

Progetto: Gestionale per enti del Terzo Settore Documento: indice-documenti.md · Aggiornato il: 25/09/2026

Questo indice è il punto unico in cui si vede quale versione è in vigore per ogni documento e come si versionano. Si aggiorna ogni volta che un documento cambia versione.

---

1. Documenti in vigore

1.1 Documenti del cliente (fonti)

Le fonti stanno nella cartella fonti/, con una sottocartella per ogni consegna, nominata con la data di ricezione. I file in fonti/ non si modificano mai.

Consegna	File	Contenuto	Note
fonti/2026-09-25/	funzioni software.docx	Funzioni richieste, divise in base e aggiuntive ([D])	⚠️ Originale da copiare in cartella (Davide). Nel frattempo c'è funzioni software - testo estratto.md, trascrizione senza modifiche
fonti/2026-09-25/	Software.xlsx	Tabella Moduli / Funzioni / Contenuti / Operatore / Note ([X])	Originale. SHA-256: 419b4d48…fb63cb9

Il cliente non indica versioni: ogni consegna si identifica con la data di ricezione. Se il cliente manda una nuova versione, si crea una nuova sottocartella senza toccare le precedenti, si aggiunge una riga qui e si aggiorna richiesta.md.

1.2 Documenti di progetto

Documento	Ruolo	Versione	Stato	Allineato a
richiesta.md	Documento base. Analisi completa della richiesta: requisiti, decisioni, domande, rischi	0.2	Bozza	Fonti del 25/09/2026
richiesta-sintesi.md	Sintesi di richiesta.md, senza perdita di informazioni	0.2	Bozza	richiesta.md v0.2
domande-cliente.md	Domande per il cliente (parte A) e dubbi progettuali interni (parte B)	0.2	Bozza	richiesta.md v0.2
workflow.md	Processi del software, passo per passo, con riferimento ai requisiti	0.2	Bozza	richiesta.md v0.2
indice-documenti.md	Questo indice	—	—	—
CLAUDE.md	Istruzioni per Claude: regole, convenzioni, procedura di aggiornamento	—	In uso	Non segue lo schema di versione: si aggiorna quando cambiano regole, documenti o convenzioni

Dipendenze:

fonti/AAAA-MM-GG/ (docx, xlsx del cliente)
        ↓
   richiesta.md  ← documento base
        ↓
   ├── richiesta-sintesi.md
   ├── domande-cliente.md
   └── workflow.md

---

2. Schema di versione

2.1 Numero di versione: X.Y.Z

Parte	Significato	Quando cambia
X	Stato di validazione	0 = bozza, non ancora approvata dal cliente · 1 = approvata dal cliente (base per il preventivo) · 2, 3… = nuova versione approvata dopo una modifica dei requisiti a progetto avviato
Y	Revisione dei contenuti	Quando cambia cosa deve fare il software: nuove risposte del cliente, nuove decisioni, requisiti aggiunti o tolti
Z	Correzione	Solo per correzioni che non cambiano i requisiti: refusi, riformulazioni, formattazione. Si omette quando è 0 (0.2 = 0.2.0)

Esempi:

• Il cliente risponde a Q1 → richiesta.md passa da 0.2 a 0.3.
• Si corregge un refuso in workflow.md → workflow.md passa da 0.2 a 0.2.1; gli altri documenti non cambiano.
• Il cliente approva i requisiti → tutti i documenti passano a 1.0.
• Dopo l'approvazione il cliente chiede una modifica → richiesta.md passa a 1.1 (proposta), poi a 2.0 quando la modifica è approvata.

2.2 Regola di allineamento

1. richiesta.md è il documento base. Ogni modifica ai requisiti parte da lì.
2. I documenti derivati (sintesi, domande, workflow) usano le stesse X e Y della versione di richiesta.md a cui sono allineati. La Z è propria di ogni documento.
3. Un documento derivato con X.Y diversa da richiesta.md è disallineato e va aggiornato prima di essere usato o inviato.

2.3 Cosa si fa a ogni cambio di versione

1. Aggiornare il contenuto del documento.
2. Aggiornare l'intestazione: versione, data, stato.
3. Aggiungere una riga al registro delle modifiche in fondo al documento: cosa è cambiato e perché.
4. Se è cambiato richiesta.md, aggiornare i documenti derivati e allinearne la versione.
5. Aggiornare la tabella del §1.2 di questo indice.

2.4 Nomi dei file

I nomi dei file non contengono la versione (richiesta.md, non richiesta_v0.2.md). Così i riferimenti tra documenti restano validi. La versione si legge nell'intestazione e in questo indice. Quando un documento viene inviato al cliente, se ne conserva una copia con la versione nel nome (es. invii/2026-09-25_domande-cliente_v0.2.md), per sapere sempre cosa ha ricevuto il cliente.

---

3. Registro delle modifiche dell'indice

Data	Modifica
25/09/2026	Creazione dell'indice e dello schema di versione; tutti i documenti di progetto portati a v0.2
25/09/2026	Aggiunto CLAUDE.md
25/09/2026	CLAUDE.md aggiornato da Davide: posizione delle fonti [D] e [X], codici Bn.m, simbolo ⚖️, struttura standard dei documenti, obbligo di versione a ogni modifica, procedura per gli invii al cliente; tolta la sezione "Da non fare"
25/09/2026	Creata la cartella fonti/2026-09-25/ con le fonti del cliente; aggiornati §1.1 e schema delle dipendenze; aggiornato CLAUDE.md (percorsi delle fonti e regole della cartella fonti/)