================================================================================
MANUAL DE PROCEDIMIENTO: RESPALDO Y RECUPERACIÓN COMPLETA - SIGEM-GIS-GEOSERVER
================================================================================
Codificación requerida: UTF-8 (Obligatorio para preservar acentos)
Versión 1.1 (Abril 2026) - Actualizado: Estandarización de Prefijos y Git
Entorno: Servidor 192.168.1.123 
Ubicación: /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) en VERSION.txt
Actualización del archivo VERSION.txt (Codificación UTF-8) con el siguiente 
formato exacto de línea: 
"PROYECTO GIS-GEOSERVER - [YYYY.MM.DD.HH.MM.SS] ID DOCKER: [ID]. Observación: [Detalle]"

*Nota: Para obtener el ID del contenedor actual ejecute:*
$ docker ps --filter name=proyecto-backend-java-1 --format '{{.ID}}'

PASO 2: Sincronización de Código (Git)
Ejecución de commit y push hacia la rama base 'main' del repositorio central:
$ git add .
$ git commit -m "Hito: [Descripción]"
$ 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 usando credenciales (Regla 17):
   $ cd /yvyape/proyectos/
   $ git clone http://cbareiro%40yvaga.com.py:carlos57@192.168.1.100/geo/gis-geoserver.git sigem-gis
   (Alternativa SSH: git clone git@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. Extraer backup: $ tar -xzvf /publico/backup-geoserver-VERSION/geoserver-data_dir.tar.gz -C /yvyape/proyectos/sigem-gis/
3. Reiniciar: $ docker compose up -d geoserver

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

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