Añadir climate-drainage-ngs/BACKUP-RESTORE.md

climate-drainage-ngs/BACKUP-RESTORE.md

@@ -0,0 +1,67 @@
+# BACKUP-RESTORE
+
+## Alcance
+
+Este documento cubre el material versionado de la vertical reusable dentro de Gitea.
+
+No cubre por sí solo:
+
+- restore de `platform-40`
+- restore de PostgreSQL
+- restore de ChirpStack
+- restore del tenant de OVH
+- restore de dashboards provisionados de cliente
+
+## Qué debe quedar versionado aquí
+
+- documentación técnica de la vertical
+- queries SQL reutilizables
+- semántica
+- referencias a arquitectura
+- inventario de archivos clave
+- notas de operación diaria
+- JSON base reusable de dashboards, si existe
+- scripts o fragmentos limpios si decides subirlos más adelante
+
+## Qué no debe guardarse aquí
+
+- secretos
+- `.env` reales
+- credenciales de cliente
+- dumps SQL
+- estados efímeros de contenedores
+- tokens bearer en claro
+
+## Dependencias principales fuera de este repo
+
+- `10-platforms/homelab/platform-40/`
+- `10-platforms/ovh-cloud/`
+- `25-kits/lsn50-v2-xkc-y25-v-drainage/`
+- Vaultwarden
+- Odoo
+- BookStack
+
+## Procedimiento mínimo de backup lógico
+
+1. verificar que toda la documentación modificada está committeada
+2. verificar que el repo está empujado al remoto
+3. verificar que las queries o JSONs relevantes no se han quedado solo en host
+4. verificar que las rutas reales del backend y del frontal están documentadas
+
+## Procedimiento mínimo de restore lógico
+
+1. clonar el repo
+2. revisar `docs/arquitectura.md`
+3. revisar `docs/archivos-clave.md`
+4. localizar el backend en `platform-40`
+5. localizar el frontal/tenant en OVH
+6. validar endpoints y tablas antes de tocar nada
+
+## Validación mínima
+
+- `README.md` presente
+- `docs/arquitectura.md` presente
+- `docs/semantica-drenaje.md` presente
+- `docs/archivos-clave.md` presente
+- `ops/operacion-diaria.md` presente
+- `grafana/queries/historical-state.sql` presente