================================================================================
MANUAL DE PROCEDIMIENTO: RESPALDO Y RECUPERACIÓN COMPLETA - SIGEM-GIS-GEOSERVER
================================================================================
Version 1.0 (Abril 2026)
Responsable: Senior Fullstack Developer (IA Antigravity)
Entorno: Servidor 192.168.1.123 
Ubicacion: /yvyape/proyectos/sigem-gis/
================================================================================

1. POLÍTICA DE RESPALDO (HITOS)
--------------------------------------------------------------------------------
Los respaldos se ejecutarán única y exclusivamente BAJO PEDIDO Y AUTORIZACIÓN
del usuario al alcanzar un Hito de Despliegue Exitoso. Esto garantiza que
todas las versiones guardadas sean estados de sistema válidos y estables.

2. PROCEDIMIENTO DE RESPALDO (GENERACIÓN)
--------------------------------------------------------------------------------
Cada respaldo consta de un tríptico de acciones atómicas:

PASO 1: Identificación (Hito)
Actualización del archivo VERSION.txt con:
- Marca de tiempo completa (YYYY.MM.DD.HH.MM.SS)
- ID del Contenedor Docker actualmente en ejecución (ID DOCKER).
- Observación detallada del logro alcanzado.

PASO 2: Sincronización de Código (Git)
Ejecución de commit y push hacia el servidor Institucional 192.168.1.100:
$ git add .
$ git commit -m "Hito: [Descripcion]"
$ git push origin main

PASO 3: Snapshot de Infraestructura (Servidor .123)
Creación de carpeta cronológica en /publico/ y generación de archivos binarios:
$ mkdir -p /publico/backup-geoserver-YYYYMMDDHHMM
$ docker exec proyecto-postgres-1 pg_dump -U sigem_user sigem > /publico/backup-geoserver-YYYYMMDDHHMM/sigem_postgres_dump.sql
$ cd /yvyape/proyectos/sigem-gis && tar -czvf /publico/backup-geoserver-YYYYMMDDHHMM/geoserver-data_dir.tar.gz geoserver-data

3. PROCEDIMIENTO DE RECUPERACIÓN TOTAL (DRP)
--------------------------------------------------------------------------------
En caso de fallo catastrófico del servidor, siga estos pasos estrictamente:

FASE A: Restauración del Entorno
1. Clonar el repositorio desde el servidor central a la carpeta de trabajo:
   $ cd /yvyape/proyectos/
   $ git clone http://192.168.1.100/geo/gis-geoserver.git sigem-gis

2. Iniciar los contenedores base (Postgres y GeoServer):
   $ cd /yvyape/proyectos/sigem-gis
   $ docker compose up -d postgres geoserver

FASE B: Restauración de Datos (PostGIS)
Inyectar el volcado SQL al contenedor de base de datos recién creado:
$ cat /publico/backup-geoserver-VERSION/sigem_postgres_dump.sql | docker exec -i proyecto-postgres-1 psql -U sigem_user -d sigem

FASE C: Restauración de Capas y Estilos (GeoServer)
Descomprimir las configuraciones de GeoServer en su volumen de datos:
1. Detener geoserver: $ docker compose stop geoserver
2. Borrar data antigua: $ rm -rf geoserver-data/*
3. Extraer backup: $ tar -xzvf /publico/backup-geoserver-VERSION/geoserver-data_dir.tar.gz -C /yvyape/proyectos/sigem-gis/
4. Reiniciar: $ docker compose up -d geoserver

FASE D: Despliegue del Binario Java
Recompilar e iniciar el backend:
$ ./mvnw clean package -DskipTests
$ docker compose restart backend-java

================================================================================
FIN DEL MANUAL
================================================================================