# 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