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,47 @@
+# DATABASE — Schema fisico
+
+Ultimo aggiornamento: **{{DATA}}**
+
+Traduzione fisica di [`../02-architecture/DATA_MODEL.md`](../02-architecture/DATA_MODEL.md).
+
+---
+
+## 1. Convenzioni
+
+| Aspetto | Regola |
+|---|---|
+| Motore | <!-- DA COMPILARE: es. PostgreSQL 16 --> |
+| Nomi | tabelle al singolare, `snake_case` |
+| Chiavi primarie | <!-- DA COMPILARE: UUID / bigint --> |
+| Date | `timestamptz`, sempre UTC |
+| Multi-tenancy | <!-- DA COMPILARE: colonna `tenant_id` su ogni tabella di dominio, o «non applicabile» --> |
+
+## 2. Tipi enumerati
+
+| Tipo | Valori |
+|---|---|
+| <!-- DA COMPILARE --> | |
+
+## 3. Tabelle
+
+### `<!-- tabella -->`
+
+| Colonna | Tipo | Null | Default | Note |
+|---|---|:-:|---|---|
+| `id` | | no | | PK |
+
+Indici: <!-- DA COMPILARE --> · Vincoli: <!-- DA COMPILARE -->
+
+## 4. Vincoli che riflettono requisiti
+
+| Vincolo | Requisito |
+|---|---|
+| <!-- DA COMPILARE --> | `REQ-…` |
+
+## 5. Migrazioni
+
+<!-- DA COMPILARE: strumento (es. Alembic), regola «una migrazione per modifica, mai riscrivere una migrazione già applicata». -->
+
+## 6. Dimensionamento
+
+<!-- DA COMPILARE: volumi attesi per tabella a 1 e 3 anni. -->
@@ -0,0 +1,30 @@
+# SEED E BOOTSTRAP — Stato iniziale del sistema
+
+Ultimo aggiornamento: **{{DATA}}**
+
+---
+
+## 1. Principio
+
+Il bootstrap è **idempotente**: eseguirlo due volte produce lo stesso stato di eseguirlo una.
+
+## 2. Cosa viene creato
+
+| Elemento | Quando | Origine dei valori |
+|---|---|---|
+| <!-- DA COMPILARE: utente amministratore iniziale, configurazione di base --> | primo avvio | variabili d'ambiente |
+
+## 3. Credenziali iniziali
+
+In collaudo e produzione l'avvio **fallisce** se le credenziali di bootstrap sono lasciate ai
+valori predefiniti.
+
+## 4. Variabili di bootstrap
+
+| Variabile | Obbligatoria | Significato |
+|---|:-:|---|
+| <!-- DA COMPILARE --> | | |
+
+## 5. Dati di prova per lo sviluppo
+
+<!-- DA COMPILARE: come si generano, e la regola che non arrivano mai in produzione. -->