GatewayPrismaQR · documentación del sistema · 2026-11-18 · run 20261002-133836
1 / 1

Documentación del sistema · estado al 2026-11-18 · rama main

GatewayPrismaQR

Gateway de cobro QR entre el POS de Tipre y Prisma Gateway QR, como Sistema Propio / Integrador Grande Cuenta (v0.27). Esta presentación tiene dos pistas, comercial y técnica: cambiá de una a otra cuando quieras con los botones de arriba o con la tecla T.

Preparación medida

95,8 / 100

READY ledger, run 20261002-133836, corrida TR-2 sobre el código actual (commit 703f2f1). Sin tope activo

Criterios de aceptación

30 / 32 medidos

93,8 % cerrados por una prueba verde de una corrida registrada que lleva su identificador. 28 de 32 marcados en ACCEPTANCE.md; AC-15 y AC-16 tienen prueba verde pero siguen sin marcar

Última corrida registrada

4315 verdes · 0 rojas

TR-2 · PASSED · 637 s (10 min 37 s) · commit 703f2f1, 2026-11-19

Navegación: flechas ← →, botones de abajo, puntos del pie, Esc para el índice. Al imprimir, las diapositivas de las dos pistas salen una tras otra.

Comercial · 1

Qué hace y qué trabajo quita

Permite que el cliente pague en la caja del supermercado escaneando un QR con la billetera de su banco, con el descuento o el plan de cuotas que le corresponda, sin que el cajero ni el POS tengan que hablar con Prisma.

  1. La caja pide el cobro por el importe del ticket.
  2. El cliente escanea el QR fijo de la caja. Prisma nos manda las tarjetas de su billetera.
  3. En menos de 27 segundos respondemos qué cuotas, recargos o descuentos ofrece cada tarjeta.
  4. El cliente elige y paga. La caja recibe el importe cobrado y la diferencia, y cierra el ticket por lo realmente cobrado.
La garantía central: si le dijimos a la caja que el pago no se hizo, o el cajero lo canceló, el cliente no queda cobrado. Una espera vencida equivale a una cancelación con devolución automática; la caja nunca recibe un «no sé».

Primeros comercios

Almacor y Becerra, clientes existentes de Prisma.

Volumen esperado

5.000 a 10.000 pagos QR por día y por comercio; pico de diseño de 5 pagos por segundo.

Una sola instalación

Un servicio en el servidor central, compartido por varios comercios (uno por CUIT).

Comercial · 2

Valor y estado: qué está hecho, qué está en marcha

Hecho El gateway

  • Los seis tramos del sistema (S0 a S5) están integrados en main: contrato con el POS, flujo con Prisma, planes, compensación y consola.
  • Emulador de Prisma para probar de punta a punta sin tocar el servicio real.

Nuevo Consola de administración

  • Catálogo de medios de pago: los 15 medios oficiales del documento de Prisma. Ya no se puede cargar un medio con un número mal tipeado que Prisma rechazaría en plena venta.
  • Pantallas de alta, baja y modificación rediseñadas: formularios laterales, comercio y caja elegidos una sola vez, avisos de lo que falta.
  • En los planes, una vista previa de las cuotas que ve el cliente, que avisa si el gateway no ofrecería ese plan.

Nuevo Operación y salida a producción

  • Limpieza automática de datos viejos (más de 90 días), de madrugada.
  • Un administrador puede reenviar a mano una anulación o devolución que el sistema dio por perdida.
  • Lista de salida a producción: configuración de ejemplo, dos usuarios de base de datos con el mínimo permiso, respaldo antes de actualizar y versión publicada y probada por la integración continua.
  • Falta ensayarlo en el servidor central (D-148).

Hecho Pruebas de carga y de fallas

  • Según el informe del repositorio, el verificador de invariantes no encontró violaciones en ningún escenario (carga, reinicios bruscos, base de datos caída, fallas de Prisma).
  • Cinco clientes de una falla de Prisma inyectada quedaron cobrados y pasaron a una persona con alerta a los 30 minutos. Eso dio el reenvío manual.
  • Halló y corrigió una consulta que bloqueaba toda la tabla de notificaciones y una demora de 9 a 15 s tras un arranque en frío.

Integrado Lado del POS

  • El cambio del POS que imputa el descuento del QR al ticket (PR #1 de POS_ALMACOR) se integró a la rama principal del POS el 2026-11-15.
  • Falta desplegarlo en las cajas, probarlo en equipo real y con impresora fiscal. Con un recargo, el POS anula el cobro en lugar de imputarlo.

En revisión Evidencia de pruebas

  • El semáforo está en rojo porque la última corrida de pruebas registrada es anterior a los cambios de los últimos días. El ledger no muestra ninguna prueba roja: falta volver a correr y registrar la corrida (diapositiva de calidad).

Postura de riesgo

  • El dinero del cliente tiene prioridad sobre todo: ante la duda el sistema compensa, no aprueba.
  • Falta para salir a producción lo que no depende del código del gateway: respuestas de Prisma, cobertura de la VPN, el despliegue de la versión del POS con la imputación y la impresora fiscal, y el ensayo en el servidor central. Del lado del gateway, falta volver a registrar la corrida de pruebas.
  • Hay un riesgo conocido fuera de los dos repositorios (reloj del POS a medianoche), con mitigación operativa. Ver «Riesgos fuera del repositorio».

Comercial · 3

Calidad de un vistazo

95,8
de 100
READY

cap_reason: sin tope activo (cap_reason: ninguno)

Verde desde 80, ámbar de 50 a 79, rojo por debajo de 50. El número sale del ledger de evidencias, sin redondeo propio.

Por qué está en verde. Se corrió y registró una corrida nueva (TR-2) sobre el código actual, sin pruebas rojas: el ledger vuelve a contar la cobertura y los criterios de aceptación medidos. Es la corrida de GatewayPrismaQR; los worktrees GatewayPrismaQR-s3, -s4 y -s5 (ramas ya integradas) siguen con 66,7 e IN PROGRESS porque no tienen corrida propia, y el puntaje total los promedia igual.

Pruebas de la última corrida registrada

4315 verdes

0 rojas · 0 omitidas · 637 s (10 min 37 s) · commit 703f2f1, 2026-11-19

Cobertura de líneas (último snapshot)

94,27 %

umbral del ledger: 80 %; el dominio exige 90 % en la compilación, y la compilación pasó

Criterios de aceptación medidos

30 de 32

93,8 %. 28 de 32 marcados en ACCEPTANCE.md; AC-15 y AC-16 tienen prueba verde y siguen sin marcar. 2 criterios no llevan identificador AC-n y cuentan como abiertos

Pasos de QA registrados

160 pasos

en el ledger (revisiones, compuertas y correcciones); escalaciones: ninguna

La corrida TR-2 fue mvn -q -DskipITs=false verify sobre el commit 703f2f1, salida 0: gateway 3.314 pruebas unitarias y 877 de integración contra SQL Server, y emulador 124. No incluye las pruebas de la consola (vitest), que el ledger no registra y que quedan fuera del puntaje; en las corridas locales de esta sesión una prueba de la consola falló de forma intermitente (flaky conocida del cockpit), sin registrarse.

Comercial · 4

Riesgos abiertos y lo que falta para producción

Alto Reloj del POS a medianoche

La librería de red del POS (no es de este proyecto) se cuelga unos 30 minutos por cada conexión que cierra después de las 00:00. Confirmado en el kit de pruebas.

Mitigación: reiniciar el POS antes de las 00:00. El arreglo real le corresponde al dueño de la librería.

Medio Cambio del POS integrado, sin desplegar

El cambio ya está en la rama principal del POS, pero las cajas con una versión vieja siguen sin imputar los descuentos del QR: un comercio no debe tener planes con ajuste hasta que todas sus cajas tengan la versión nueva. Se probó en el kit, no en equipo real. Un plan con recargo nunca se completa en el POS (la versión nueva lo anula). Falta la prueba con impresora fiscal y configurar los perfiles 171 y 564 a 567.

Medio La evidencia de pruebas vence con cada cambio

El semáforo está en verde (95,8, READY) con la corrida TR-2 del 2026-11-19. La evidencia vence cuando cambia el código fuente: cada integración posterior exige volver a correr y registrar la corrida con test-run antes de salir a producción. Las pruebas de la consola quedan fuera del ledger y de CI (D-149).

Medio Venta aprobada sin rastro (D-135)

Si falla el envío de la respuesta «aprobado» al POS, no queda una línea de alerta que lleve el caso a una persona. Corregirlo está marcado como tarea previa a la salida a producción.

Medio Pagos tardíos

Si la billetera paga después de que el cajero canceló, la devolución automática puede terminar en falla y pasar a una persona (D-132; en el emulador, además, la notificación tardía viene incompleta). Si la intención nunca llegó a la intención completa, el pago tardío no tiene terminal, traza ni ticket y la anulación forzada no se puede armar (R-22). Ambos casos están preguntados a Prisma.

Externo Prisma, VPN, impresora, servidor

Respuestas de Prisma a las preguntas abiertas (docs/PRISMA-PREGUNTAS.md, secciones A a E: arquitectura, contrato, montos, reversas, homologación; entre ellas cómo se da de alta y se muestra el QR de la caja y qué trae un pago tardío), homologación, cobertura de la VPN por sucursal, prueba con impresora fiscal real y ensayo en el servidor central (D-148).

Técnica · 1

Arquitectura

Un servicio Java 25 (Spring Boot 4.1, servicio NSSM) con tres listeners aislados por ruta, una base SQL Server 2022 y varios nodos posibles. Sin estado en memoria que decida dinero: los trabajos de fondo se reparten con leases.

POS DOS de Almacoruna caja por terminal RouterQR (otras cadenas)una por cadena Operadorconsola React (/admin) Banco de pruebassolo perfil de desarrollo Servidor central · Windows Server · compartido con GatewayQR Listener POS:8090 · /api · HTTP plano Listener callbacks:8443 · /prisma/v1 · HTTPS Listener admin:8091 · /admin · sesión+CSRF GatewayPrismaQR dominio hexagonalmáquina de estados del pagoespera acotada del POScompensación con leasesbuzón de notificaciones SQL Server 2022GatewayPrismaQR Prisma Gateway QRAPI HTTPS con apikey · v27 Billetera del clienteescanea el QR de la caja Emulador de Prismamódulo prisma-emulatorpruebas y simulación local saliente entrante

Saliente hacia Prisma: crear intención, intención completa, reversas, anulación y devolución forzadas. Entrante desde Prisma con apikey: BINs, pago, anulación, devolución. Trazo continuo: tráfico de producción. Trazo punteado: solo desarrollo y pruebas. Una ruta que no pertenece al puerto que la recibe responde 404 (también tras normalizar .., %2e, ; y //), de modo que la anulación del POS no se alcanza desde internet ni desde la consola.

Diagramas interactivos, paso a paso: cobro QR aprobado · estados del pago · anulación del cajero.

Técnica · 2

Contratos entre las piezas

POS ⇄ gateway (API v1, compatible con GatewayQR)

EndpointFunción
POST /api/trxidEmite el identificador del pago (201). Identifica la caja con pos, sucursal y comercio.
POST /api/trxpagoInicia el cobro y espera el resultado con un tope por debajo de la lectura del llamador.
GET /api/trxes/{id}Misma forma que trxpago, con el estado y el importe actuales.
POST /api/trxanulacionAnulación del POS o del barrido de RouterQR. Idempotente.
GET /api/pingSonda de vida.

Reglas del cable

  • Decide solo la cadena estado, que nunca cambia.
  • Content-Length siempre, Connection: close, errores como {"status","message"}.
  • INV-04: importe + importe_recdesc == importe_final, al centavo; el recargo es positivo y el descuento negativo.

Lo que el POS oyó

  • Toda respuesta «aprobado» deja dos marcas durables; la intención se escribe antes de responder.
  • Si el POS oyó «aprobado», es una venta y nunca se compensa como «sin venta» (INV-01).

Gateway ⇄ Prisma

  • Saliente: crear intención, intención completa, anulación y devolución forzadas, cancelación.
  • Entrante con apikey: BINs, notificación de pago, anulación y devolución.
  • Presupuesto de 27 s entre los BINs y la intención completa.

Oferta por BIN

  • Un plan por BIN es una promoción, no una lista de tarjetas permitidas: una tarjeta de una marca que el comercio acepta se ofrece igual, como mínimo en 1 cuota.
  • La aceptación es por medio de pago más establecimiento. Un pago con un medio que no se ofreció se rechaza y se anula.
  • El PDF no habla de listas blancas de BIN. Detalle contrastado con el PDF v27: flujos de BIN.

Medios de pago

  • Desde V5 el medio de pago de un medio aceptado, un establecimiento o un plan apunta al catálogo (payment_method), no a un entero libre.
  • La oferta a Prisma no cambió: un medio no oficial se ofrece igual que uno oficial y Prisma puede rechazarlo.

Estado interno → estado del POS

InternoVe el POSstatuscode
INTENT_CREATED, BINS_RECEIVED, COMPLETE_SENTINTENCION_DE_PAGO_RECIBIDA_APROBADA0
APPROVEDAUTORIZACION_DE_PAGO_APROBADA0
REJECTED, CANCELLED, SUPERSEDED, EXPIRED, COMPENSATION_*AUTORIZACION_DE_PAGO_DENEGADA1
ANNULLED, REFUNDEDAUTORIZACION_DE_ANULACION_APROBADA0

La tabla completa, con los estados de consulta (REFUND_DENEGADO), está en docs/SISTEMA.md §5.

Técnica · 3

Vencimiento, cancelación y compensación

Un vencimiento de espera equivale a una cancelación: se cancela la intención en Prisma y, si la billetera llegó a cobrar, se programa una reversa. Ninguna reversa se envía dos veces.

Tarea durable

Cada compensación es una fila con lease en base de datos (SYSUTCDATETIME, READPAST), reclamable por cualquier nodo. Tras gateway.compensation.max-attempts (10 por defecto) la tarea queda en COMPENSATION_FAILED y se emite una alerta a una persona.

Una reversa por cobro

Un cobro de la billetera tiene a lo sumo una reversa activa. Una reversa enviada y sin respuesta queda IN_PROGRESS a propósito: Prisma no documenta idempotencia.

Modelo formal

El ciclo de vida del pago está modelado en TLA+ y verificado con TLC (docs/modelo/). Hallazgos: D-134 corregido (PR #7); D-132 abierto, depende de Prisma; D-135 diferido.

Brecha conocida del emulador. La notificación de «pago tardío tras cancelar» que arma el emulador no lleva método, establecimiento ni terminal. Por eso, en ese caso, la compensación termina en COMPENSATION_FAILED. El caso equivalente del banco de pruebas pasa porque solo exige que exista la tarea de reversa y no verifica cómo termina.

Recorrido paso a paso: vencimiento, cancelación y compensación · estados del pago.

Técnica · 4 · herramientas de desarrollo

Banco de pruebas, simulación local y BootUI

Banco de pruebas (cockpit)

  • Página de la consola solo para desarrollo, con una guarda que impide incluirla en producción.
  • Catálogo fijo de 15 casos, todos confirmados (seis desde fuentes, nueve tras una corrida en vivo).
  • Cada caso tiene verificaciones con veredicto propio, y los veredictos se atenúan si un carril deja de responder.
  • Rediseñado alrededor del diagrama del flujo: cuatro carriles con el de los callbacks de Prisma, eventos separados en historia y detalle, flujo esperado por caso, pantalla completa y zoom. Un caso fallido nunca se pinta todo en verde.
  • «Ejecutar todos» corre el catálogo entero; reinicia el emulador y la cola de fallas antes de cada caso. Un candado compartido evita que la caja manual y el banco corran a la vez.

Simulación local

  • tools\local-sim\sim.ps1 up -FastWaits levanta gateway y emulador en loopback.
  • up crea solo el usuario administrador de la consola.
  • -FastWaits acorta las esperas del gateway para ver los casos en segundos; el perfil local no aplica la guarda de tiempos.
  • Comandos de apoyo: pay, scenario, requests y smoke.

BootUI (consola de desarrollo)

  • Opcional, detrás del perfil Maven bootui del gateway; sim.ps1 up -BootUI reconstruye el jar con él y abre http://127.0.0.1:8091/admin/bootui/.
  • Solo en máquinas de desarrollo. Esa ruta saltea el login de la consola, el control CSRF y el filtro de direcciones de administración: no usarla nunca en un servidor compartido.
  • La guarda de CI (tools/ci/package_release.py) rechaza un jar de release que contenga BootUI. El jar con BootUI conserva el nombre del de release: no copiarlo fuera de target\.

Capturas del banco de pruebas: docs/cockpit-screens/; capturas antes y después del rediseño de la consola: docs/console-redesign/.

Técnica · 5 · PRs #41, #43 y #44

Consola: catálogo de medios y pantallas de alta, baja y modificación

Catálogo de medios de pago (V5)

  • Tabla payment_method sembrada con los 15 medios oficiales de la tabla de la p. 86 del PDF v27 (columna official); los oficiales no se editan ni se borran.
  • Un ADMIN puede agregar a la fuerza un medio que no está en el PDF (siempre official = 0), editarlo y borrarlo mientras nada lo use; la auditoría lo registra como PAYMENT_METHOD_CATALOG.
  • Claves foráneas desde los medios aceptados, los establecimientos y los planes.
  • Verificación previa en V5: si algún id guardado está fuera de 1 a 999, la migración se detiene antes de crear nada y nombra tabla e ids (nunca borra ni cambia filas); la consulta para corregirlos está en RUNBOOK §10. Los ids usados que el catálogo no conoce migran como no oficiales, «Migrado, sin descripción».
  • Página «Catálogo de medios» y selectores sobre el catálogo en medios aceptados, establecimientos y planes.

Rediseño de las pantallas

  • Encabezado de página, formularios en un panel lateral con confirmación al descartar cambios, insignias de estado, estados vacíos y tablas compactas.
  • El alcance comercio, sucursal y caja se elige una vez y se mantiene entre pantallas y al recargar (en el almacenamiento de sesión del navegador; se olvida al cerrar sesión en la consola).
  • Planes: formulario en secciones, resumen de una línea por plan y vista previa en vivo de las cuotas, calculada como el gateway (PlanFigures y PosRounding), que marca los planes que el gateway no ofrecería (transferencia, o por debajo del mínimo). Es solo una vista previa: el servidor sigue siendo quien decide.
  • Formateadores de CUIT y CBU.

Pasos de despliegue de V5 y del catálogo: docs/RUNBOOK.md §10. Las pruebas de la consola (vitest) no están en la compuerta de CI (D-149) ni en el ledger.

Técnica · 6 · PRs #30 a #40

Operación: retención, reenvío manual y salida a producción

Retención de datos (D-139)

  • Borra callbacks ya procesados y el registro del cable con más de gateway.retention.days (90 por defecto), en la ventana 03:00 a 05:00 de Buenos Aires.
  • Lotes de 200 filas (tope 500) y un máximo de 500.000 filas por ventana, compartido entre nodos con un lease.
  • Los callbacks que una persona debe leer se conservan hasta revisarlos: página «Notificaciones a revisar» (ADMIN); el tablero cuenta los no revisados.
  • Migraciones V3 y V4 (índices de las consultas calientes). Sin retención todavía: admin_audit, instantáneas y tareas terminadas (D-143).

Reenvío manual de una reversa forzada (D-137)

  • Acciones «Reenviar anulación» y «Reenviar devolución» en el detalle del pago, solo ADMIN.
  • Solo para una reversa IN_PROGRESS, nunca aceptada por Prisma, cuya tarea se rindió y que una consulta de estado nueva dice que Prisma no conoce.
  • El reenvío automático se probó y se retiró tras la revisión: puede duplicar la reversa. La automatización sigue abierta, a la espera de Prisma.

Carga y fallas

  • Arnés en tools/load-test, informe en docs/LOAD-FAULTS-REPORT.md (2026-11-16): según el informe, el verificador de invariantes no halló violaciones en ningún escenario.
  • Hallazgos corregidos: la consulta de duplicados del buzón escaneaba y bloqueaba toda la tabla (F1, D-138) y el primer pico tras arrancar frenaba el gateway de 9 a 15 s (F3, bloqueo por sp_getapplock sobre el hash).
  • F2 (una falla 5xx inyectada en una reversa forzada) dejó cinco clientes cobrados, escalados a una persona a los 30 minutos.

Lista de salida a producción (D-14)

  • RUNBOOK §15: archivo de configuración de producción de ejemplo, dos usuarios de base de datos con el mínimo permiso y quién corre Flyway, chequeo de collation, respaldo antes de actualizar y certificado de SQL Server bajo prod.
  • CI publica el jar probado, incluye la consola y prueba el jar empaquetado con un certificado descartable en Linux. Opciones de JVM -Xms256m -Xmx512m sin medir con esos valores exactos.
  • QA con callbacks de Prisma por Cloudflare Tunnel: RUNBOOK §13.
  • Pendiente: ensayo en el servidor Windows (D-148), migraciones expand/contract (D-147, hoy un solo nodo) y pruebas de consola en la compuerta (D-149).

Técnica · 7

Integración continua recuperada en main

Las seis últimas ejecuciones de CI sobre main (PRs #19 a #24, 2026-11-14) terminaron en verde. Las fallas intermitentes eran de las pruebas, con tres causas:

PRCausaArreglo
#21SeedDevIT dejaba SET NOCOUNT ON y XACT_ABORT ON en conexiones del pool; después, los UPDATE de otras pruebas informaban -1 filas y fallaban los conteos.La semilla corre en una conexión propia y restaura las dos opciones al terminar.
#23 y #24El emulador registra una petición después de contestarla; las pruebas leían el registro antes de que existiera la fila.Las pruebas esperan (await) el registro del emulador antes de afirmar.
#22La latencia del callback de BINs (AC-07) se medía con el máximo de 48 muestras: un salto de GC o de un runner cargado la rompía.Se mide el percentil 95 (ver abajo).
AC-07 cambió: el callback de BINs responde 204 en menos de 200 ms al percentil 95 (antes se afirmaba sobre el máximo); la intención completa llega a Prisma en menos de 3 s al percentil 99, siempre dentro de los 27 s. Cambiado en ACCEPTANCE.md, SPEC.md y CompleteIntentionIT; la decisión la tomó el responsable el 2026-11-14.

Técnica · 8

Resultados de QA

95,8
de 100
READY

cap_reason: sin tope activo (cap_reason: ninguno)

Corrida registrada (test-run)

TR-2: PASSED. 4315 verdes, 0 rojas, 0 omitidas, 637 s (10 min 37 s). mvn -q -DskipITs=false verify sobre el commit 703f2f1, salida 0: gateway 3.314 pruebas unitarias y 877 de integración contra SQL Server, y emulador 124. No incluye las pruebas de la consola (vitest), que el ledger no registra. Reemplaza a TR-1 (2026-11-15, commit 563f136), vencida tras los PRs #25 a #45.

Preparación por repositorio

RepositorioPuntajeEstadoCobertura (dim.)Convergencia (dim.)
GatewayPrismaQR 100,0READY100,0 %100,0 %
GatewayPrismaQR-s3 66,7IN PROGRESS0,0 %100,0 %
GatewayPrismaQR-s4 66,7IN PROGRESS0,0 %100,0 %
GatewayPrismaQR-s5 66,7IN PROGRESS0,0 %100,0 %

Repositorios convergidos: 4 de 4. Los worktrees -s3, -s4 y -s5 siguen con la cobertura sin medir (0,0 %) porque no tienen una corrida registrada propia.

Dimensiones de la preparación

DimensiónPesoValorAporte
acceptance3093,8 %31,2
adr1587,5 %14,6
coverage15100,0 %16,7
static_gate20100,0 %22,2
convergence10100,0 %11,1

Mediciones del último snapshot (corrida TR-2)

RepositorioCoberturaPruebasLOC prod.LOC pruebaPruebas/kLOC
GatewayPrismaQR94,27 %43151915944179225,2
GatewayPrismaQR-s3no snapshot taken
GatewayPrismaQR-s4no snapshot taken
GatewayPrismaQR-s5no snapshot taken

Por herramienta

HerramientaReportadosCorregidos% corregidoDiferidosSuprimidosPasadas
code-review15600,0 %80019
judgment-day35600,0 %202033
improve11800,0 %49013
gate:gate-check00n/d0011
gate:operability100,0 %002
gate:ci200,0 %0020
fix-pass414097,6 %52022
e2e-real-pos400,0 %301
gate:smoke00n/d001
gate:pit-check00n/d001
tla-statechart3133,3 %201

Escalaciones: ninguna. Rendimiento a la primera: 0,0 %. Todos los números salen de qa_ledger.py summary --json y readiness --json del run 20261002-133836 (ledger actualizado por última vez el 2026-11-19, corrida TR-2).

Notas del ledger.
· El puntaje volvió de 45,1 (NOT READY, evidencia vencida) a 95,8 (READY) al registrar la corrida TR-2 con test-run sobre el código actual, sin pruebas rojas. Sin tope activo (cap_reason: ninguno).
· Criterios: 30 de 32 medidos (93,8 %); 28 de 32 marcados en ACCEPTANCE.md. AC-15 y AC-16 tienen prueba verde y siguen sin marcar (dependen de la respuesta de Prisma).
· 2 criterios no tienen identificador AC-n y cuentan como abiertos en la dimensión de aceptación.
· Hallazgos con severidad de compuerta abiertos: 0.
· Los worktrees GatewayPrismaQR-s3, -s4 y -s5 (ramas ya integradas) siguen listados en el ledger, con 66,7 e IN PROGRESS y cobertura sin medir; 425 reportes JUnit de esos worktrees figuran como no atestados por no nacer de una corrida registrada. Retirarlos del config o correrles test-run subiría el promedio por repositorio.
· Ciclo de vida: sin medir, el SPEC no declara fecha de salida a producción (go_live).
· Señal de parada (advisory): activa, todo converge y lo que queda es deuda medible.
· Fuera del puntaje y sin medir: las pruebas de la consola (vitest), que CI tampoco corre (D-149); una prueba intermitente del cockpit falló en las corridas locales.

Técnica · 9

Issues diferidos

ISSUES-DEFERRED.md tiene 202 entradas (D-01 a D-149 más las de cada tramo: D-S3, D-S4, D-S5): según su encabezado del 2026-11-17, 86 cerradas y 116 abiertas, 22 de ellas bloqueadas por Prisma, una decisión humana, el equipo del POS o una verificación de operación. Las cerradas siguen en el archivo con «Closed» en la fila. El ledger cuenta 0 hallazgos con severidad de compuerta abiertos.

EntradaQué esEstado
D-132¿Puede la billetera pagar una intención después del DELETE? Pregunta 17g a Prisma.Abierto, espera a Prisma
D-135Se pierde la respuesta aprobada y no queda línea de alerta (PosApprovalMarkerFilter). Re-calificado a medio el 2026-11-16.Abierto, antes de salir a producción
D-136Nada vuelve a consultar una reversa que el trabajo dio por rendida; barrido de baja frecuencia previsto.Abierto, medio
D-137Reversa forzada con envío ambiguo: entregada la acción manual «Reenviar»; la automatización queda abierta a la espera de Prisma.Parcial, medio
D-133Imputación del descuento QR en el POS: arreglada en el código del POS (PR #1); queda su despliegue, la prueba en equipo real y los perfiles.Acotado al despliegue
D-140 a D-146Residuos de la retención: callbacks UNKNOWN sin purgar, consultas que escanean, retención de auditoría e instantáneas, edición y modo de recuperación de SQL Server sin conocer, reversas sin medir.Abiertos
D-147 a D-149Migraciones expand/contract, ensayo en el servidor central y pruebas de la consola fuera de la compuerta de CI.Abiertos (lista de salida)
D-138, D-139Consulta de duplicados del buzón que bloqueaba la tabla; retención e índices de las consultas calientes.Cerrados el 2026-11-16
D-134, D-106Venta aprobada anulada por una reversa tardía (modelo formal); latencia de BINs medida con el máximo.Cerrados (PR #7, PR #22)

La mayoría del resto es endurecimiento de operación y se anota por tramo; el detalle está en el archivo.

Técnica · 10

POS y riesgos fuera del repositorio

POS Almacor: imputación del descuento QR (tipre/POS_ALMACOR, PR #1)

  • Rama feat/qr-imputation, integrada a la rama principal del POS el 2026-11-15 (commit 5049830; estado leído hoy con gh). No está desplegada: las cajas con una versión anterior siguen ignorando importe_recdesc.
  • Verificada en el kit (DOSBox-X, no en equipo real): un ticket con promoción clásica P y descuento de billetera D imprime en el comprobante 2612,50 / -261,25 / 2351,25 (original, descuento, pagado); la fila del medio guarda P+D. La versión nueva anula el pago cuando hay un recargo o cuando importe + importe_recdesc difiere de importe_final: un plan con recargo nunca se completa en el POS.
  • Sin verificar todavía: reimpresión del comprobante, importes de la anulación al salir con P, y la impresora fiscal (R-05).
Condiciones de despliegue: mientras una caja de un comercio tenga la versión vieja, no se habilitan planes con ajuste para ese comercio; perfil 171 (PermitePromosXMdeP) en 1 (en 0 el descuento se anula) y perfiles 564 a 567 con valores propios; impresora fiscal sin probar. El campo de importe del QR sigue truncando el importe precargado: hay que reescribir los importes con centavos (G-14, fuera del PR #1).

Librería TCP del POS (TITCP, LIBSP/WATTCPE/titcp.cpp)

  • Sus temporizadores usan la hora de pared como número HHMMSS. Después de las 00:00 los plazos fijados antes de medianoche no vencen, y sock_close espera set_timeout(3000): unos 30 minutos reales, no 3 s.
  • Confirmado en el kit: el POS se colgó a las 00:01:16, se liberó a los 30:00 exactos, volvió a colgarse y se liberó otra vez a las 28:27 (efecto del cambio de hora). La DLL del kit tiene el mismo md5 que la del árbol de fuentes.
  • Mitigación: reiniciar el POS antes de las 00:00. Arreglo real: segundos desde medianoche con tiempo transcurrido tolerante al cambio de día, y 3 en lugar de 3000 (R-21).

Prisma

  • Preguntas abiertas en docs/PRISMA-PREGUNTAS.md (secciones A a E). Sin respuesta registrada en el repositorio. Las agregadas el 2026-11-15: la 23 (alta y forma de mostrar el QR de la caja) y la 24 (qué trae el pago tardío de una intención que nunca recibió la intención completa, R-22).
  • De sus respuestas dependen D-132, el cierre de AC-15 y AC-16, y la automatización de D-137.

Verificación manual

Lista de humo

Local o desarrollo; el humo de producción se define con la primera versión (RUNBOOK §4). Las casillas no se guardan: sirven para esta sesión.