integration

Fornece a infraestrutura de integração outbox/inbox e a orquestração de eventos de domínio.

Caminho de origem: libraries/core/src/integration

Arquivo do módulo: integration.module.ts

Introdução

O submódulo Integration fornece a infraestrutura orientada a eventos para uma comunicação confiável e desacoplada entre a lógica de negócio interna e sistemas externos. Seu mecanismo central é o transactional outbox: quando um evento de domínio é produzido, o registro do evento é gravado em uma tabela de outbox na mesma transação de banco de dados da alteração que o originou. Isso garante que o evento não possa ser perdido por uma falha ocorrida entre a operação de negócio e o despacho — ou tanto a alteração quanto o registro do evento são confirmados, ou nenhum deles é.

Um processador em segundo plano lê as entradas de outbox não processadas e as entrega aos seus destinos — webhooks, filas ou integration profiles. Os eventos recebidos de sistemas externos chegam a uma tabela de inbox para processamento idempotente, evitando efeitos colaterais duplicados de entregas reprocessadas. Os eventos que excedem o número máximo de tentativas são movidos para um armazenamento de dead-letter para inspeção manual, garantindo que falhas transitórias não resultem em perda permanente de dados.

O catálogo de eventos de integração registra todos os tipos de eventos de domínio conhecidos. Cada entrada do catálogo carrega um slug, um nome legível, uma descrição opcional e um JSON Schema opcional que documenta a estrutura do payload. O catálogo é a única fonte da verdade para os consumidores de eventos: tanto os event webhooks quanto os integration profiles se inscrevem em entradas do catálogo, em vez de nomes de eventos embutidos no código.

O submódulo Integration é dono do catálogo de eventos e do motor de outbox/inbox. O submódulo Webhook Integration consome o catálogo para viabilizar assinaturas de webhook baseadas em eventos. Essa separação mantém a camada de transporte plugável — os mesmos eventos de outbox podem ser consumidos por webhooks hoje e por uma fila de mensagens amanhã, sem alterar o código do produtor.

As ferramentas MCP do catálogo (core.integration-events.*) permitem que agentes de IA e pipelines de automação inspecionem os tipos de eventos disponíveis, criem novas entradas de catálogo e gerenciem as existentes de forma programática.

Endpoints HTTP

Nenhum endpoint de controller dedicado encontrado para este submódulo.

Ferramentas MCP

Ferramentas nomeadas que podem ser chamadas por modelos de IA através do Model Context Protocol (MCP).

core.integration-events.*
Operações completas de CRUD e de catálogo para eventos de integração