davideandClaude Sonnet 5
8a822a9245
- 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>
97 lines
6.1 KiB
Markdown
97 lines
6.1 KiB
Markdown
# Indice dei documenti di progetto
|
|
**Progetto:** Gestionale per enti del Terzo Settore
|
|
**Documento:** `indice-documenti.md` · **Aggiornato il:** 27/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
|
|
|
|
Ogni informazione sta in **un solo documento**; gli altri la richiamano con il suo codice.
|
|
|
|
| Documento | Contenuto (e solo questo) | Versione | Stato | Allineato a |
|
|
|---|---|---|---|---|
|
|
| `richiesta.md` | **Documento base.** Cosa deve fare il software: moduli, requisiti (RF, RT), dati personali, differenze tra le fonti, decisioni (D) | **0.3.1** | Bozza | Fonti del 25/09/2026 |
|
|
| `workflow.md` | Processi del software passo per passo (W), con i riferimenti ai requisiti | **0.3.1** | Bozza | `richiesta.md` v0.3 |
|
|
| `domande-cliente.md` | Tutto ciò che è aperto: domande per il cliente (Q), conferme sui processi, dubbi architetturali (B), rischi, verifiche con legale e commercialista (C) | **0.3.1** | Bozza | `richiesta.md` v0.3 |
|
|
| `costi-ricorrenti.md` | Costi ricorrenti di sviluppo, test e produzione: prezzi con fonte, scenari, effetti economici delle decisioni | **0.3.1** | Bozza | `richiesta.md` v0.3 |
|
|
| `indice-documenti.md` | Versioni in vigore e schema di versione | — | — | — |
|
|
| `CLAUDE.md` | Istruzioni per Claude: regole, convenzioni, procedura di aggiornamento | — | In uso | Non segue lo schema di versione |
|
|
|
|
**Dipendenze:**
|
|
|
|
```
|
|
fonti/AAAA-MM-GG/ (docx, xlsx del cliente)
|
|
↓
|
|
richiesta.md ← documento base
|
|
↓
|
|
├── workflow.md
|
|
├── domande-cliente.md
|
|
└── costi-ricorrenti.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 (workflow, domande, costi) **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/`) |
|
|
| 27/09/2026 | Aggiunto `costi-ricorrenti.md` (v0.2) in §1.2 e nelle dipendenze; aggiunto il documento alla tabella di `CLAUDE.md` |
|
|
| 27/09/2026 | Tutti i documenti di progetto portati a v0.3 per le decisioni D10 e D11 (chi paga e gestisce i servizi di produzione) |
|
|
| 27/09/2026 | Riorganizzazione per eliminare le informazioni ripetute: eliminato `richiesta-sintesi.md` (ripeteva `richiesta.md`); `richiesta.md`, `workflow.md`, `domande-cliente.md` e `costi-ricorrenti.md` portati a v0.3.1; descritto in §1.2 il contenuto esclusivo di ogni documento; aggiornato `CLAUDE.md` (elenco documenti, codici Cn) |
|