Skip to content

Eventos ​

A plataforma usa eventos para comunicação interna entre componentes e para as métricas regulatórias. Um evento só é publicado se a operação correspondente foi gravada no banco, e não se perde se o processo cair entre a gravação e a publicação.

Fluxo de eventosEventos de negócio são gravados no outbox na mesma transação e publicados no NATS JetStream; falhas repetidas vão para a fila de mensagens mortas. As métricas da PCM seguem um fluxo próprio até o envio à Plataforma de Coleta de Métricas.Eventos de negócioServiçooperação de negócioPostgreSQLdados + outboxna mesma transaçãoRelaya cada 5 sNATS JetStreamCloudEvents 1.0Fila de mensagensmortas (após 10 tentativas)Métricas regulatórias (PCM, Open Finance)Capturabanking e data-publicRegistro idempotenteno bancoTarefas agendadasmontam os lotesEnvio à PCMmTLSopcional: outbox → NATS → event-runtimeenvio automático dos lotesreconciliação em D+1 e D+7

Eventos de negócio ​

  1. A operação de negócio e o evento são gravados na mesma transação do PostgreSQL, na tabela de outbox. Se o evento não puder ser gravado, a operação inteira é desfeita.
  2. Um relay lê o outbox a cada 5 segundos e publica os eventos no NATS JetStream, no formato CloudEvents 1.0. O stream guarda os eventos em disco, com deduplicação. Em produção, com o NATS no cluster, ele tem três réplicas; no sandbox, ou com um NATS externo, uma.
  3. Um evento recusado dez vezes vai para a fila de mensagens mortas, para análise, sem travar os demais. Uma falha passageira de conexão não conta como tentativa.

Métricas regulatórias (PCM) ​

  1. Os serviços de Open Finance (banking) e de dados abertos (data-public) registram cada interação regulada no banco, uma única vez. A captura não guarda dados pessoais. A única exceção é o IP de quem chama as APIs de dados abertos, que a PCM exige.
  2. Tarefas agendadas montam os lotes e os enviam à Plataforma de Coleta de Métricas, com mTLS. O envio é automático. No modo manual, o operador aprova cada lote antes do envio.
  3. A reconciliação roda em D+1 e D+7.
  4. Como alternativa, a captura pode gravar num outbox próprio. Nesse caso, o relay publica as interações no NATS JetStream, e o event-runtime as consome com um consumidor durável e controle de idempotência. Esse caminho exige o event-runtime ligado.

Finnest Power — plataforma Open Finance Brasil e Open Insurance Brasil. Contato: oi@finnest.com.br