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,34 @@
+# BACKUP E RIPRISTINO
+
+Ultimo aggiornamento: **{{DATA}}**
+
+---
+
+## 1. Cosa va salvato
+
+| Dato | Dove vive | Ricostruibile | Backup |
+|---|---|:-:|---|
+| <!-- DA COMPILARE --> | | | |
+
+## 2. Obiettivi
+
+| Obiettivo | Valore |
+|---|---|
+| RPO (dati che si accetta di perdere) | <!-- DA COMPILARE --> |
+| RTO (tempo per tornare operativi) | <!-- DA COMPILARE --> |
+
+## 3. Procedura di ripristino
+
+1. <!-- DA COMPILARE -->
+
+## 4. Verifiche dopo un ripristino
+
+- [ ] <!-- DA COMPILARE -->
+
+## 5. Prova di ripristino
+
+Un backup mai ripristinato non è un backup. Prova <!-- DA COMPILARE: frequenza -->, esito registrato in `DEVELOPMENT_LOG`.
+
+## 6. Cosa non è coperto
+
+<!-- DA COMPILARE -->
@@ -0,0 +1,31 @@
+# CI/CD — Integrazione e rilascio
+
+Ultimo aggiornamento: **{{DATA}}**
+
+---
+
+## 1. Flussi
+
+| Flusso | Innesco | Ambiente di destinazione |
+|---|---|---|
+| <!-- DA COMPILARE --> | | |
+
+## 2. Sequenza
+
+1. <!-- DA COMPILARE: build, test, analisi, immagini, deploy -->
+
+## 3. Verifiche in pipeline
+
+| Verifica | Perché | Blocca il rilascio |
+|---|---|:-:|
+| Test automatici | criteri di accettazione delle spec | sì |
+| Ricerca di segreti | nessun segreto nel repository | sì |
+| Contratto contro implementazione | il codice rispetta `openapi.yaml` | sì |
+
+## 4. Segreti della pipeline
+
+<!-- DA COMPILARE -->
+
+## 5. Rilascio in produzione e rientro
+
+<!-- DA COMPILARE: chi approva, come si torna alla versione precedente, in quanto tempo. -->
@@ -0,0 +1,31 @@
+# ENVIRONMENTS — Sviluppo, collaudo, produzione
+
+Ultimo aggiornamento: **{{DATA}}**
+
+---
+
+## 1. Gli ambienti
+
+| Ambiente | Scopo | Dati | Chi vi accede |
+|---|---|---|---|
+| dev | sviluppo | di prova | sviluppatori |
+| qa | collaudo | di prova, realistici | sviluppatori, committente |
+| prod | esercizio | reali | utenti |
+
+## 2. Variabili di configurazione
+
+| Variabile | Significato | dev | qa | prod | Segreta |
+|---|---|---|---|---|:-:|
+| <!-- DA COMPILARE --> | | | | | |
+
+## 3. Ambiente locale di sviluppo
+
+<!-- DA COMPILARE: comandi per avviare tutto in locale (es. docker compose up). -->
+
+## 4. Promozione fra ambienti
+
+<!-- DA COMPILARE: dev → qa → prod, chi approva, cosa si verifica a ogni passo. -->
+
+## 5. Prima di dichiarare un ambiente pronto
+
+- [ ] <!-- DA COMPILARE -->
@@ -0,0 +1,31 @@
+# INFRASTRUCTURE — Topologia e risorse
+
+Ultimo aggiornamento: **{{DATA}}**
+
+---
+
+## 1. Topologia
+
+```
+<!-- DA COMPILARE: nodi, servizi, rete -->
+```
+
+## 2. Servizi e risorse
+
+| Servizio | Immagine / runtime | Repliche | CPU | Memoria |
+|---|---|:-:|---|---|
+| <!-- DA COMPILARE --> | | | | |
+
+## 3. Persistenza
+
+| Volume / storage | Contenuto | Dimensione | Backup |
+|---|---|---|:-:|
+| <!-- DA COMPILARE --> | | | |
+
+## 4. Rete, nomi e certificati
+
+<!-- DA COMPILARE: domini, ingress, TLS, porte esposte. -->
+
+## 5. Capacità e crescita
+
+<!-- DA COMPILARE -->
@@ -0,0 +1,37 @@
+# OBSERVABILITY — Log, metriche, allarmi
+
+Ultimo aggiornamento: **{{DATA}}**
+
+---
+
+## 1. Il problema che risolve
+
+<!-- DA COMPILARE: quali domande operative si devono poter rispondere senza aprire il database. -->
+
+## 2. Log
+
+| Aspetto | Regola |
+|---|---|
+| Formato | JSON strutturato |
+| Correlazione | un identificativo di richiesta propagato fra i servizi |
+| Mai nei log | password, token, segreti, dati personali non necessari |
+
+## 3. Metriche
+
+| Metrica | Tipo | Significato |
+|---|---|---|
+| <!-- DA COMPILARE --> | | |
+
+## 4. Allarmi
+
+| Allarme | Condizione | Gravità | Procedura |
+|---|---|:-:|---|
+| <!-- DA COMPILARE --> | | | [`RUNBOOK`](RUNBOOK.md) §… |
+
+## 5. Salute
+
+`GET /health` — <!-- DA COMPILARE: cosa verifica. -->
+
+## 6. Conservazione
+
+<!-- DA COMPILARE -->
@@ -0,0 +1,25 @@
+# RUNBOOK — Procedure operative
+
+Ultimo aggiornamento: **{{DATA}}**
+
+Ogni procedura segue lo stesso schema: **sintomo → verifica → azione → conferma**.
+
+---
+
+## 1. <!-- Sintomo, come lo descriverebbe chi lo nota -->
+
+| Passo | Cosa fare |
+|---|---|
+| **Verifica** | <!-- comando o schermata --> |
+| **Azione** | |
+| **Conferma** | |
+
+## 2. Ripristino da backup
+
+Vedi [`BACKUP_DR.md`](BACKUP_DR.md) §… .
+
+## 3. Contatti e riferimenti
+
+| Ruolo | Contatto |
+|---|---|
+| <!-- DA COMPILARE --> | |