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.