67 lines
1.7 KiB
Markdown

# 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