Saltar a contenido

SGE-JD en modo producción, en la misma laptop (S13)

Guía para levantar el sistema completo como correría en producción: backend empaquetado en una imagen Docker con el perfil prod, su propio Oracle y su propio Keycloak (otros contenedores, volúmenes y puertos que desarrollo) y el frontend compilado con ng build --configuration production servido por nginx.

Puertos

Servicio Desarrollo Producción local
Oracle 1522 (SGE-JD) 41521 (sge-jd-oracle-prod)
Postgres de Keycloak 35432 45432
Keycloak 38080 48080 (modo start, no start-dev)
Backend 8080 (mvn spring-boot:run, perfil dev) 48088 (contenedor, perfil prod)
Frontend 4200 (ng serve) 4300 (nginx con el build de producción)

Todos los puertos escuchan solo en 127.0.0.1.

Memoria. Los dos entornos no chocan en puertos, pero cada uno lleva un Oracle (~1,5 GB) y un Keycloak (~0,5 GB). En la laptop de desarrollo (7,4 GB de RAM, 3,5 GB para Docker) no caben los dos a la vez: se apaga uno para encender el otro (docker stop, no se pierde nada).

Archivos

Archivo Para qué
src/main/resources/application-prod.properties Perfil prod: todo por variables de entorno, sin valores por defecto; ddl-auto=validate; Swagger apagado; Actuator solo health,info
src/main/resources/application-dev.properties Perfil dev (el de siempre, activo por defecto)
src/main/resources/logback-spring.xml DEBUG + SQL en dev, INFO sin SQL en prod
Dockerfile, .dockerignore Imagen del backend (compila con Maven, la final solo lleva JRE + JAR, usuario sin privilegios, hora de Lima)
compose-prod.yml Oracle, Keycloak, su Postgres y el backend de prod
.env.prod.example Plantilla de secretos de prod (el .env.prod real no se versiona)
scripts/prod/generar_env_prod.py Crea .env.prod con secretos aleatorios, sin mostrarlos
scripts/prod/esquema_jdrefrigeracion.sql Esquema vacío (29 tablas, índices y claves foráneas), sacado del esquema real con DBMS_METADATA; al 07/11/2026 incluye migracion_comprobante_reemplazo.sql (comprobante de reemplazo, receptor fijo y ENVIOS_SUNAT)
keycloak/configurar_realm.py --prod El mismo script de dev contra el Keycloak de prod (SPA en 4300, sin el cliente de pruebas)
bomerp-frontend/src/environments/environment.prod.ts URLs de prod del SPA (reemplaza environment.ts en el build)
bomerp-frontend/Dockerfile, nginx.conf, compose-prod.yml El build servido por nginx en 4300

Pasos (PowerShell, desde bomerp-backend)

1. Apagar desarrollo (si está encendido) y crear los secretos de prod (una sola vez):

docker stop sge-jd-keycloak sge-jd-keycloak-db SGE-JD
python scripts/prod/generar_env_prod.py

2. Encender la infraestructura de prod (la primera vez Oracle tarda unos minutos en crear la base; esperar a que docker ps diga healthy):

docker compose -f compose-prod.yml --env-file .env.prod up -d oracle keycloak-db keycloak

3. Crear el esquema (solo la primera vez; sin contraseña: entra como sysdba dentro del contenedor):

docker cp scripts/prod/esquema_jdrefrigeracion.sql sge-jd-oracle-prod:/tmp/esquema.sql
"alter session set current_schema=JDREFRIGERACION;`n@/tmp/esquema.sql" | docker exec -i -e ORACLE_PDB_SID=FREEPDB1 sge-jd-oracle-prod sqlplus -s / as sysdba

Comprueba que SQL*Plus haya creado las tablas, los índices y las claves sin errores.

Si la base existente es anterior al 07/11/2026, aplica las migraciones históricas antes del paso 3b. Ejecuta migracion_comprobante_reemplazo.sql, migracion_venta_anulacion.sql, migracion_costos_precios.sql, migracion_envio_correo.sql y migracion_ambiente_emision.sql, en ese orden. Usa los comandos del paso 3c con esos cinco archivos de la raíz del repositorio.

3b. Migración BD2 (tablespace de ventas, reglas y PL/SQL, auditoría de ventas, índices, usuarios JD_APP y JD_REPORTES con roles, auditoría unificada y redo de 200 MB). Va después del esquema, en una base nueva o en la que ya existe, con el backend detenido y un respaldo previo. Está probada en una copia de desarrollo (220 pruebas en verde) y aplicada en desarrollo el 10/11/2026. Detalle en migracion_bd2/README.md.

.\scripts\respaldar_sgejd.ps1 -Contenedor sge-jd-oracle-prod -Nombre sgejd_prod_antes_migracion_bd2
.\migracion_bd2\migrar.ps1 -Contenedor sge-jd-oracle-prod -Secretos .env.prod

3c. Actualizar una base existente a esta versión. Con el backend detenido, el respaldo hecho y los roles del paso 3b creados, aplica estas migraciones en orden. El esquema del paso 3 ya incluye sus cambios para una instalación nueva.

$migraciones = @(
    'scripts/prod/migracion_condiciones_proforma.sql'
    'scripts/prod/migracion_configuracion_empresa.sql'
    'scripts/prod/migracion_agenda_refacturacion.sql'
)
foreach ($ruta in $migraciones) {
    $archivo = Split-Path -Leaf $ruta
    docker cp $ruta "sge-jd-oracle-prod:/tmp/$archivo"
    if ($LASTEXITCODE -ne 0) { throw "No se pudo copiar $archivo" }
    "whenever sqlerror exit failure`nalter session set current_schema=JDREFRIGERACION;`n@/tmp/$archivo`nexit" |
        docker exec -i -e ORACLE_PDB_SID=FREEPDB1 sge-jd-oracle-prod sqlplus -s / as sysdba
    if ($LASTEXITCODE -ne 0) { throw "Falló $archivo" }
}

4. Crear el realm, los roles, los clientes y los usuarios (las claves de Lisandro y Lucy quedan en .env.prod):

python keycloak/configurar_realm.py --prod

5. Construir y encender el backend:

docker compose -f compose-prod.yml --env-file .env.prod up -d --build backend
docker logs -f sge-jd-backend-prod

Debe terminar en Started BomerpApplication. Si Hibernate indica que falta una tabla o columna (ddl-auto=validate), verifica qué script corresponde a tu instalación y revisa los permisos del paso 3b.

6. Construir y servir el frontend (desde bomerp-frontend):

npm run build:prod

Compila y verifica que la Content-Security-Policy de nginx permita los dos scripts en línea de index.html (por su huella sha256). Si alguno cambió, termina con error y muestra la línea script-src correcta para cabeceras-seguridad.conf; sin ese cambio, el navegador los bloquearía y la página quedaría sin estilos.

docker compose -f compose-prod.yml up -d --build

Abrir http://localhost:4300 e iniciar sesión con lisandro o lucy (clave en .env.prod).

Encender y apagar (ya instalado)

Con producción ya instalada (pasos anteriores hechos una vez), el día a día es encender los contenedores, sin volver a compilar. Primero se apaga lo de desarrollo si está encendido (la PC tiene 8 GB: un solo Oracle a la vez):

scripts\detener_sgejd.bat
cd C:\SGE-JD\bomerp-backend
docker compose -f compose-prod.yml --env-file .env.prod up -d
docker compose -f ..\bomerp-frontend\compose-prod.yml up -d

Esperar uno o dos minutos (Oracle y el backend tardan en arrancar) y abrir http://localhost:4300. Para apagarlo, los dos stop de Volver a desarrollo. Las claves de lisandro y lucy de producción están en .env.prod (SGEJD_CLAVE_LISANDRO, SGEJD_CLAVE_LUCY) y son distintas de las de desarrollo (.env).

Facturación real: el backend de producción viene con FACTURACION_MODO=simulado. Para enviar a SUNAT, poner en .env.prod FACTURACION_MODO=sunat, SUNAT_AMBIENTE (PRODUCCION o BETA, obligatorio) y la dirección oficial de ese ambiente en SUNAT_URL (FACTURACION_SUNAT.md); si no corresponden, el backend no arranca y su log (docker logs sge-jd-backend-prod) dice qué corregir.

Verificación

curl http://localhost:48088/actuator/health
curl -i http://localhost:48088/actuator/env
Prueba Resultado esperado (verificado el 05/11/2026)
/actuator/health sin token 200 {"status":"UP"} (sin detalles)
/actuator/env, /heapdump, /metrics, /beans sin token 401
Los mismos con token de ADMIN 404: en prod no existen
/v3/api-docs, /swagger-ui/index.html 404
http://localhost:4300/ventas (recargar en una ruta del SPA) 200 (nginx devuelve index.html)
Login en 4300 → token con iss = http://localhost:48080/realms/bomerp Aceptado por el backend
Configuración › Usuarios y permisos Lista los usuarios (API de administración de Keycloak por la red interna)
Registrar una venta Venta y comprobante B001-00000001 emitidos
curl -I http://localhost:4300/ (y un .js, un 404) Cabeceras de seguridad en todas las respuestas: Content-Security-Policy, X-Frame-Options: DENY, X-Content-Type-Options: nosniff, Referrer-Policy: same-origin; Server: nginx sin versión (07/11/2026)
Login, Ventas, Proformas, Cobranza, Postventa, Compras, Productos, Clientes, Órdenes, Historial y cerrar sesión Sin ningún aviso de la CSP en la consola (07/11/2026)
fetch('https://example.com') desde la consola de 4300 Bloqueado por connect-src (07/11/2026)

Cabeceras de seguridad (auditoría M11): están en bomerp-frontend/cabeceras-seguridad.conf. Al pasar a un dominio real, cambiar ahí http://localhost:48088 y http://localhost:48080 (igual que en environment.prod.ts).

Volver a desarrollo

docker compose -f compose-prod.yml --env-file .env.prod stop
docker compose -f ../bomerp-frontend/compose-prod.yml stop
scripts\iniciar_sgejd.bat

Para empezar prod desde cero (borra su base y su Keycloak, no los de dev): docker compose -f compose-prod.yml --env-file .env.prod down -v.