30-verticals/climate-drainage-ngs/BACKUP-RESTORE.md

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