Afecta a
Equipos que consumen eventos de Lender, Midaz o Reporter, u operan el streaming de Lender, Pix Switch, Boleto o SLC.
Qué cambió
El evento
loan_account.debt_balance_changed de Lender usa la versión mayor de esquema 2 y el tema lender.loan_account.debt_balance_changed.v2. OUTBOX_RETRY_WINDOW_SEC es el retraso mínimo entre intentos para una fila, no una ventana total de reintentos. La clave de definición del catálogo no siempre es la clave de despacho; deriva el despacho de ce-resourcetype y ce-eventtype.
Reporter escribe los eventos críticos en su outbox de streaming durable en Mongo después del commit del estado de negocio. Las dos escrituras no son una única transacción atómica de la aplicación. Solo los facts terminales de informe y las transiciones críticas de fecha límite tienen identificadores determinísticos; los consumidores deben tratar los demás valores de ce-id como opacos y deduplicar por (ce-source, ce-id).
Los payloads de los eventos de ciclo de vida de Midaz incluyen routeId. Los facts de CRM ahora comparten el tema de aplicación lerian.streaming.ledger; ce-resourcetype sigue siendo holder o instrument, sin un segmento crm_.
Las guías también documentan un STREAMING_TLS_CA_CERT opcional en Lender, el streaming opcional de Pix Switch con los ajustes de broker y de fuente obligatorios cuando se habilita, el outbox interno de Midaz en Boleto y el requisito de circuit breaker de SLC para un consumidor de MQ RSFN.
Esta es una corrección de documentación que registra contratos implementados. No anuncia una versión en tiempo de ejecución.
Impacto
Clasificación: acción requerida. Los consumidores que derivan los temas anteriores de Lender o de CRM, que suponen que todos los identificadores de Reporter son determinísticos, o que usan la orientación previa de reintentos y despliegue pueden enrutar los eventos de forma incorrecta u operar una configuración no admitida.
Qué debes hacer
1
Actualiza las suscripciones de Lender para
lender.loan_account.debt_balance_changed.v2 y deriva las claves de despacho del recurso y del tipo de evento de CloudEvents.2
Acepta
routeId en los payloads de ciclo de vida de Midaz, usa la forma documentada del tema de CRM y conserva (ce-source, ce-id) como clave de deduplicación del consumidor.3
Revisa los supuestos de entrega de Reporter, los controles de reintento de Lender y la configuración de streaming antes del próximo despliegue.