Aparência
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.
Eventos de negócio
- 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.
- 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.
- 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)
- 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. - 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.
- A reconciliação roda em D+1 e D+7.
- 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.