Bitácora · Money-path

GatewayQR — 21 de septiembre

Endurecimiento y release de GatewayQR: observabilidad de tráfico, configuración externalizada, fixes de seguridad revisados con doble juez, y un E2E completo con el beneficio aplicado de punta a punta.

Release v20260921 Judgment Day ✓ pasó E2E ✓ verde Spring Boot 1.5 · Java 8

Resumen

RELEASE

GatewayQR v20260921

War (E2E-validado) + templates de config externa, publicado en GitHub. Cambios de consola/gateway, sin cambios que rompan el pago.

RELEASE PREVIO

GatewayQR v20260916

Fix trx.mensaje_varios: un autorizador inalcanzable ya no aborta el guardado del trx (recorte a 500).

1 traffic.log — trazabilidad JSON

Un log dedicado que registra cada JSON que cruza un límite de integración, con origen → destino, una línea por evento.

10 puntos instrumentados: POS↔GatewayQR, GatewayQR↔Autorizador(Tecso), GatewayQR↔BeneficiosCenter, Emulador→GatewayQR (incluye el webhook de anulación).
No frena el money-path: logger trafico con AsyncAppender neverBlock=true, cada llamada en try/catch, additivity=false.
Sin secretos: nunca loguea headers → la X-Api-Key/Apikey jamás llega al log (verificado: 0 en el E2E).
Body en una sola línea, capado a 8 KB.

2 Log de configuración al arranque

Ahora se puede verificar la config efectiva en cada boot — justo lo que faltaba cuando el emulador quedó mal configurado.

Loguea server.emulador.*, app.beneficioscenter.*, datasource, puerto y perfiles.
Api-keys enmascaradas: set (••••da7c) — solo los últimos 4, y set (oculto) si el secreto es ≤4 chars.

3 Configuración 100% externa

El war ya no empaqueta ningún application*.yml (packagingExcludes). La config sale toda del archivo externo.
Templates autocontenidos: application-dev.yml.example (con emulador) y application-prod.yml.example (sin emulador).
Se detectó y corrigió que el prod estaba incompleto (faltaban 4 endpoint_name) → habría roto el arranque con perfil prod.

Ojo con el comando de prod: los -D van antes de -jar. Si van después del war, Boot 1.5 los ignora y usa la config interna (era un bug latente del comando de deploy).

java -Dspring.profiles.active=prod \
     -Dspring.config.location=file:<ruta>/application-prod.yml \
     -jar gatewayqr-20260921.war

4 Seguridad · revisado con Judgment Day

Doble juez ciego + fix + re-juicio. Los 7 hallazgos de Ronda 1, resueltos y re-verificados.

Fuga de apikey Tecso: se quitó el volcado del HttpEntity/headers a DEBUG (existía desde 2024).
Secretos scrubbeados a CHANGE_ME en los yml internos; enmascarado seguro para secretos cortos.
prod completado (los 4 endpoint_name) + .gitignore de configs con secretos.

Deuda pendiente (tu acción): rotar el apikey de Tecso y el jwt secret — estuvieron en texto plano en el historial de git (releases viejos, .yo-rc.json). El scrub los saca hacia adelante, no del pasado.

5 E2E completo — beneficio aplicado

Se levantaron los dos sistemas y se disparó un pago QR real. El traffic.log capturó todo el ida y vuelta:

POS → GatewayQR	intención de pago
GatewayQR → BeneficiosCenter	resolver · `branchId "1"`
BeneficiosCenter → GatewayQR	beneficio 10% · $1000 · code 999
GatewayQR → Autorizador:TECSO	intención + `benefits_methods_data`
Autorizador → GatewayQR	approved (emulador)
Emulador → GatewayQR	webhook-pago (callback async)
GatewayQR → BeneficiosCenter	resultado (Flujo 2) → `encolado`

✓

Resultado del pago con descuento: payment_method_id 999 · importe 10000 → importe_final 9000 · importe_recdesc −1000. El 10% se resolvió Y se aplicó. Externalización, log de arranque, enmascarado y traffic.log — todo validado en vivo.

6 Base de datos + prod yml

Cambio de DB requerido (cada ambiente): ALTER TABLE trx ALTER COLUMN mensaje_varios varchar(500) NULL;
Generado releases/20260921/application-prod.yml — estructura externalizada + valores reales de infra, con CHANGE_ME en los 4 secretos (a completar en el deploy).
setup-emulador-qa.sql — filas mínimas de ruteo para levantar el emulador en un QA nuevo.