Añadir homelab/platform-40/BACKUP-RESTORE.md

homelab/platform-40/BACKUP-RESTORE.md

@@ -0,0 +1,76 @@
+# 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