Afeta
Equipes que consomem eventos do Lender, do Midaz ou do Reporter, ou que operam streaming para Lender, Pix Switch, Boleto ou SLC.
O que mudou
O evento
loan_account.debt_balance_changed do Lender usa a major de schema 2 e o tópico lender.loan_account.debt_balance_changed.v2. OUTBOX_RETRY_WINDOW_SEC é o atraso mínimo entre tentativas para uma linha, e não uma janela total de novas tentativas. Uma chave de definição do catálogo nem sempre é a chave de despacho; derive o despacho de ce-resourcetype e ce-eventtype.
O Reporter escreve os eventos críticos no seu outbox durável de streaming no Mongo depois do commit do estado de negócio. As duas escritas não formam uma única transação atômica da aplicação. Apenas os fatos terminais de relatório e as transições críticas de prazo têm identificadores determinísticos; os consumidores devem tratar os demais valores de ce-id como opacos e deduplicar por (ce-source, ce-id).
Os payloads de eventos de ciclo de vida do Midaz incluem routeId. Os fatos do CRM agora compartilham o tópico de aplicação lerian.streaming.ledger; ce-resourcetype continua sendo holder ou instrument, sem o segmento crm_.
Os guias também documentam um STREAMING_TLS_CA_CERT opcional no Lender, o streaming opcional do Pix Switch com as configurações obrigatórias de broker e de source quando habilitado, o outbox interno do Midaz no Boleto e a exigência de circuit breaker do SLC para um consumidor MQ RSFN.
Esta é uma correção da documentação que registra contratos implementados. Ela não anuncia um release de runtime.
Impacto
Classificação: Ação necessária. Consumidores que derivam os tópicos anteriores do Lender ou do CRM, que supõem que todos os identificadores do Reporter são determinísticos ou que usam a orientação anterior de nova tentativa e de deploy podem rotear eventos de forma errada ou operar uma configuração sem suporte.
O que você precisa fazer
1
Atualize as subscriptions do Lender para
lender.loan_account.debt_balance_changed.v2 e derive as chaves de despacho do tipo de recurso e do tipo de evento do CloudEvents.2
Aceite
routeId nos payloads de ciclo de vida do Midaz, use a forma documentada do tópico do CRM e mantenha (ce-source, ce-id) como chave de deduplicação do consumidor.3
Revise as suposições de entrega do Reporter, os controles de nova tentativa do Lender e a configuração de streaming antes do próximo deploy.