# BACKUP-RESTORE

## Alcance

Este documento cubre la capa documental y técnica versionada de `platform-40` dentro de Gitea.

No cubre por sí solo:

- backup real de volúmenes Docker
- dumps de PostgreSQL
- backup de MinIO
- backup de Grafana
- backup de Portainer
- backup de Mosquitto
- restore completo extremo a extremo ya probado

## Qué debe quedar versionado aquí

- documentación de servicios
- rutas clave
- puertos y criterios de acceso
- advertencias críticas
- comandos de operación
- referencias a `docker-compose.yml` saneados

## Qué no debe guardarse aquí

- credenciales
- secretos
- `.env` reales
- dumps de base de datos
- backups binarios
- exports sin sanear

## Advertencia crítica principal

Nunca usar en `/srv/platform`:

```bash
docker-compose down -v
````

porque elimina volúmenes persistentes de:

* Grafana
* MinIO
* Portainer
* Mosquitto

## Procedimiento mínimo de backup lógico

1. verificar que la documentación de plataforma está actualizada
2. verificar que los `docker-compose.yml` saneados están versionados cuando proceda
3. verificar que las rutas clave siguen siendo correctas
4. no asumir que un servicio está sano solo porque el puerto escucha

## Procedimiento mínimo de restore lógico

1. revisar `docs/arquitectura.md`
2. revisar `docs/servicios.md`
3. revisar `docs/rutas-clave.md`
4. validar los stacks:

   * `/srv/platform`
   * `/srv/chirpstack`
   * `/srv/verticals`
5. restaurar con extremo cuidado los servicios persistentes
6. nunca destruir volúmenes sin backup previo

## Validación mínima

* `README.md` presente
* `docs/arquitectura.md` presente
* `docs/servicios.md` presente
* `docs/rutas-clave.md` presente
* `ops/operacion-diaria.md` presente