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
READY ledger, run 20261002-133836, corrida TR-2 sobre el código actual (commit 703f2f1). Sin tope activo
Criterios de aceptación
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
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.
- La caja pide el cobro por el importe del ticket.
- El cliente escanea el QR fijo de la caja. Prisma nos manda las tarjetas de su billetera.
- En menos de 27 segundos respondemos qué cuotas, recargos o descuentos ofrece cada tarjeta.
- El cliente elige y paga. La caja recibe el importe cobrado y la diferencia, y cierra el ticket por lo realmente cobrado.
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
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.
Pruebas de la última corrida registrada
0 rojas · 0 omitidas · 637 s (10 min 37 s) · commit 703f2f1, 2026-11-19
Cobertura de líneas (último snapshot)
umbral del ledger: 80 %; el dominio exige 90 % en la compilación, y la compilación pasó
Criterios de aceptación medidos
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
en el ledger (revisiones, compuertas y correcciones); escalaciones: ninguna
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.
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)
| Endpoint | Función |
|---|---|
| POST /api/trxid | Emite el identificador del pago (201). Identifica la caja con pos, sucursal y comercio. |
| POST /api/trxpago | Inicia 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/trxanulacion | Anulación del POS o del barrido de RouterQR. Idempotente. |
| GET /api/ping | Sonda de vida. |
Reglas del cable
- Decide solo la cadena
estado, que nunca cambia. Content-Lengthsiempre,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
| Interno | Ve el POS | statuscode |
|---|---|---|
| INTENT_CREATED, BINS_RECEIVED, COMPLETE_SENT | INTENCION_DE_PAGO_RECIBIDA_APROBADA | 0 |
| APPROVED | AUTORIZACION_DE_PAGO_APROBADA | 0 |
| REJECTED, CANCELLED, SUPERSEDED, EXPIRED, COMPENSATION_* | AUTORIZACION_DE_PAGO_DENEGADA | 1 |
| ANNULLED, REFUNDED | AUTORIZACION_DE_ANULACION_APROBADA | 0 |
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.
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 -FastWaitslevanta gateway y emulador en loopback.upcrea solo el usuario administrador de la consola.-FastWaitsacorta las esperas del gateway para ver los casos en segundos; el perfil local no aplica la guarda de tiempos.- Comandos de apoyo:
pay,scenario,requestsysmoke.
BootUI (consola de desarrollo)
- Opcional, detrás del perfil Maven
bootuidel gateway;sim.ps1 up -BootUIreconstruye el jar con él y abrehttp://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 detarget\.
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_methodsembrada con los 15 medios oficiales de la tabla de la p. 86 del PDF v27 (columnaofficial); 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 comoPAYMENT_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 (
PlanFiguresyPosRounding), 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 endocs/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_getapplocksobre 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 -Xmx512msin 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:
| PR | Causa | Arreglo |
|---|---|---|
| #21 | SeedDevIT 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 #24 | El 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. |
| #22 | La 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). |
ACCEPTANCE.md, SPEC.md y CompleteIntentionIT; la decisión la tomó el responsable el 2026-11-14.Técnica · 8
Resultados de QA
cap_reason: sin tope activo (cap_reason: ninguno)
Corrida registrada (test-run)
Preparación por repositorio
| Repositorio | Puntaje | Estado | Cobertura (dim.) | Convergencia (dim.) |
|---|---|---|---|---|
| GatewayPrismaQR | 100,0 | READY | 100,0 % | 100,0 % |
| GatewayPrismaQR-s3 | 66,7 | IN PROGRESS | 0,0 % | 100,0 % |
| GatewayPrismaQR-s4 | 66,7 | IN PROGRESS | 0,0 % | 100,0 % |
| GatewayPrismaQR-s5 | 66,7 | IN PROGRESS | 0,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ón | Peso | Valor | Aporte |
|---|---|---|---|
| acceptance | 30 | 93,8 % | 31,2 |
| adr | 15 | 87,5 % | 14,6 |
| coverage | 15 | 100,0 % | 16,7 |
| static_gate | 20 | 100,0 % | 22,2 |
| convergence | 10 | 100,0 % | 11,1 |
Mediciones del último snapshot (corrida TR-2)
| Repositorio | Cobertura | Pruebas | LOC prod. | LOC prueba | Pruebas/kLOC |
|---|---|---|---|---|---|
| GatewayPrismaQR | 94,27 % | 4315 | 19159 | 44179 | 225,2 |
| GatewayPrismaQR-s3 | no snapshot taken | ||||
| GatewayPrismaQR-s4 | no snapshot taken | ||||
| GatewayPrismaQR-s5 | no snapshot taken | ||||
Por herramienta
| Herramienta | Reportados | Corregidos | % corregido | Diferidos | Suprimidos | Pasadas |
|---|---|---|---|---|---|---|
| code-review | 156 | 0 | 0,0 % | 80 | 0 | 19 |
| judgment-day | 356 | 0 | 0,0 % | 202 | 0 | 33 |
| improve | 118 | 0 | 0,0 % | 49 | 0 | 13 |
| gate:gate-check | 0 | 0 | n/d | 0 | 0 | 11 |
| gate:operability | 1 | 0 | 0,0 % | 0 | 0 | 2 |
| gate:ci | 2 | 0 | 0,0 % | 0 | 0 | 20 |
| fix-pass | 41 | 40 | 97,6 % | 52 | 0 | 22 |
| e2e-real-pos | 4 | 0 | 0,0 % | 3 | 0 | 1 |
| gate:smoke | 0 | 0 | n/d | 0 | 0 | 1 |
| gate:pit-check | 0 | 0 | n/d | 0 | 0 | 1 |
| tla-statechart | 3 | 1 | 33,3 % | 2 | 0 | 1 |
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).
· 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.
| Entrada | Qué es | Estado |
|---|---|---|
| D-132 | ¿Puede la billetera pagar una intención después del DELETE? Pregunta 17g a Prisma. | Abierto, espera a Prisma |
| D-135 | Se 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-136 | Nada vuelve a consultar una reversa que el trabajo dio por rendida; barrido de baja frecuencia previsto. | Abierto, medio |
| D-137 | Reversa forzada con envío ambiguo: entregada la acción manual «Reenviar»; la automatización queda abierta a la espera de Prisma. | Parcial, medio |
| D-133 | Imputació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-146 | Residuos 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-149 | Migraciones 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-139 | Consulta 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-106 | Venta 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 congh). No está desplegada: las cajas con una versión anterior siguen ignorandoimporte_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_recdescdifiere deimporte_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).
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_closeesperaset_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.