ff

2026-10-26 00:25:18 +01:00
parent 1df884da84
commit 1bc033c329
46 changed files with 2958 additions and 0 deletions
@@ -0,0 +1,37 @@
+# GLOSSARY — Lessico di {{PROGETTO}}
+
+Ultimo aggiornamento: **{{DATA}}**
+
+Un termine, un significato. Gli stessi nomi si usano nei documenti, nel codice (classi,
+tabelle, rotte) e nell'interfaccia. Se un termine cambia, cambia qui per primo.
+
+---
+
+## 1. Termini di dominio
+
+| Termine | Significato | Nel codice |
+|---|---|---|
+| <!-- DA COMPILARE --> | | `nome_tecnico` |
+
+## 2. Termini di piattaforma
+
+| Termine | Significato | Nel codice |
+|---|---|---|
+| <!-- DA COMPILARE: es. Tenant, Utente, Ruolo --> | | |
+
+## 3. Convenzioni di identificazione nei documenti
+
+| ID | Significato | Dove nasce |
+|---|---|---|
+| `REQ-<AREA>-<nn>` | Requisito | `01-product/REQUIREMENTS.md` |
+| `DIF-<nn>` | Difetto noto | `01-product/REQUIREMENTS.md` |
+| `SPEC-<nnn>` | Specifica | `03-specs/` |
+| `T-<nnn>` | Task | sezione *Task* della spec e `08-project/TODO.md` |
+| `D-<nnn>` | Decisione | `08-project/DECISIONS.md` |
+| `A1`, `B3`, … | Criterio di accettazione (lettera della spec + numero) | sezione *Criteri* della spec |
+
+Gli ID sono **immutabili**: non si rinumerano e non si riusano. Un ID chiuso senza lavoro si barra (`~~T-xxx~~`).
+
+## 4. Falsi amici
+
+<!-- DA COMPILARE: parole che il committente usa con un significato diverso da quello tecnico. -->
@@ -0,0 +1,44 @@
+# PERSONAS E CASI D'USO — {{PROGETTO}}
+
+Ultimo aggiornamento: **{{DATA}}**
+
+---
+
+## 1. Attori
+
+### 1.1 Attori umani
+
+| Attore | Ruolo nel sistema | Permessi |
+|---|---|---|
+| <!-- DA COMPILARE --> | | |
+
+### 1.2 Attori non umani
+
+| Attore | Come interagisce |
+|---|---|
+| <!-- DA COMPILARE: sistemi esterni, job pianificati, integrazioni --> | |
+
+## 2. Persone
+
+### 2.1 <!-- Nome — Ruolo -->
+
+<!-- DA COMPILARE: chi è, cosa fa ogni giorno, cosa lo frustra oggi, cosa considera un successo. -->
+
+## 3. Casi d'uso
+
+### UC-01 — <!-- titolo come risultato: «Una richiesta completa diventa una proposta» -->
+
+| | |
+|---|---|
+| **Attore** | |
+| **Precondizioni** | |
+| **Flusso principale** | 1. … 2. … 3. … |
+| **Flussi alternativi** | |
+| **Esito** | |
+| **Requisiti** | `REQ-…` |
+
+## 4. Matrice attore × caso d'uso
+
+| Caso d'uso | <!-- attore 1 --> | <!-- attore 2 --> |
+|---|:-:|:-:|
+| UC-01 | ● | |
@@ -0,0 +1,62 @@
+# REQUIREMENTS — {{PROGETTO}}
+
+Ultimo aggiornamento: **{{DATA}}** · Stato: **in stesura**
+
+---
+
+## Come leggere questo documento
+
+Ogni requisito ha un identificativo `REQ-<AREA>-<nn>` immutabile, citato dalle specifiche
+(`03-specs/`), dai task (`08-project/TODO.md`) e dalla matrice di tracciabilità
+(`07-quality/TRACEABILITY.md`).
+
+**Tipo:**
+
+| Sigla | Significato |
+|:-:|---|
+| **P** | **Parità** — comportamento già presente nel sistema esistente, da riprodurre **identico**. Una differenza è una regressione. *(Solo per riscritture o evoluzioni.)* |
+| **C** | **Correzione** — comportamento esistente difettoso, da correggere. Rimanda a un `DIF-nn`. |
+| **N** | **Nuovo** — introdotto da questo progetto. |
+
+**Origine:** dove il requisito è stato osservato o deciso: committente e data, `D-nnn`, oppure
+`file:funzione` del codice esistente per i requisiti di parità.
+
+> **Regola.** Un requisito descrive un comportamento osservabile e verificabile, non una
+> soluzione tecnica. Modificare un requisito approvato è una decisione di prodotto e richiede
+> una `D-nnn`.
+
+---
+
+## Riepilogo
+
+| Area | Codice | Requisiti | P | C | N |
+|---|:-:|:-:|:-:|:-:|:-:|
+| <!-- DA COMPILARE: es. Autenticazione e utenti --> | <!-- AUT --> | | | | |
+| Non funzionali | NFR | | | | |
+| **Totale** | | | | | |
+
+---
+
+## <!-- AREA --> · <!-- Nome dell'area -->
+
+| ID | Requisito | Tipo | Origine |
+|---|---|:-:|---|
+| <!-- **REQ-AREA-01** --> | <!-- DA COMPILARE: «Il sistema …», condizioni in grassetto, limiti numerici espliciti --> | N | <!-- committente, AAAA-MM-GG --> |
+
+---
+
+## NFR · Non funzionali
+
+| ID | Requisito | Tipo | Origine |
+|---|---|:-:|---|
+| <!-- **REQ-NFR-01** --> | <!-- DA COMPILARE: prestazioni, disponibilità, sicurezza, conservazione dei dati — sempre con un numero --> | N | |
+
+---
+
+## Difetti noti
+
+Difetti del sistema esistente, o emersi durante il progetto, che un requisito di tipo **C** corregge.
+
+| ID | Difetto | Effetto osservato | Requisito |
+|---|---|---|---|
+| <!-- **DIF-01** --> | | | `REQ-…` |
@@ -0,0 +1,52 @@
+# VISION — {{PROGETTO}}
+
+Ultimo aggiornamento: **{{DATA}}** · Stato: **in stesura**
+
+---
+
+## 1. La frase che guida il prodotto
+
+> <!-- DA COMPILARE: una frase sola, quella con cui si decide cosa entra e cosa no. -->
+
+## 2. Il problema
+
+<!-- DA COMPILARE: chi ha il problema, come lo risolve oggi, quanto costa (tempo, errori, denaro).
+Preferire un dato misurato a un aggettivo. -->
+
+## 3. Cosa fa il prodotto
+
+<!-- DA COMPILARE: il flusso principale in 5-7 passi, dal punto di vista di chi lo usa. -->
+
+## 4. Perché adesso
+
+<!-- DA COMPILARE: cosa rende necessario il progetto ora (scadenza, cliente, limite del sistema attuale). -->
+
+## 5. Cosa NON cambia
+
+<!-- DA COMPILARE: vincoli fissi (sistemi esistenti, interfacce, abitudini degli utenti), oppure «non applicabile». -->
+
+## 6. Perimetro
+
+### Dentro il perimetro (primo rilascio)
+
+- <!-- DA COMPILARE -->
+
+### Fuori dal perimetro (esplicitamente)
+
+- <!-- DA COMPILARE: ciò che qualcuno potrebbe aspettarsi e che NON si fa. Scriverlo evita discussioni dopo. -->
+
+## 7. Come si misura il successo
+
+| Indicatore | Valore attuale | Obiettivo |
+|---|:-:|:-:|
+| <!-- DA COMPILARE --> | | |
+
+## 8. Rischi principali
+
+| Rischio | Probabilità | Impatto | Contromisura |
+|---|:-:|:-:|---|
+| <!-- DA COMPILARE --> | | | |
+
+## 9. Documenti collegati
+
+[`REQUIREMENTS.md`](REQUIREMENTS.md) · [`PERSONAS_CASI_USO.md`](PERSONAS_CASI_USO.md) · [`../08-project/DECISIONS.md`](../08-project/DECISIONS.md)