Software · Arquitetura de Software

Context Mapping no DDD: Anti-Corruption Layer, Shared Kernel e Open Host Service

Como organizar as relações entre domínios delimitados no Domain-Driven Design: Anti-Corruption Layer para isolar legados, riscos do Shared Kernel e contratos via Open Host Service.

Diagrama conceitual ilustrando context mapping no ddd: anti-corruption layer, shared kernel e open host service
Neste artigo

Desenhar múltiplos Bounded Contexts em um diagrama de arquitetura é simples; o desafio real começa quando esses contextos precisam trocar dados e sincronizar processos de negócio. O Context Mapping do Domain-Driven Design cataloga as relações políticas e técnicas entre equipes e sistemas, definindo quem comanda a linguagem do contrato.

flowchart LR
  subgraph LegadoERP["Sistema Legado (Mainframe / ERP)"]
    ModeloCaotico["Tabelas com 200 colunas<br/>Nomes crípticos (CLI_TX_01)"]
  end

  subgraph ACL["Camada Anticorrupção (ACL)"]
    Adapter["Adapter de Protocolo"]
    Translator["Translator (Mapeador de Modelos)"]
    Facade["Facade Limpa de Negócio"]
    Adapter --> Translator --> Facade
  end

  subgraph NovoDominio["Novo Microsserviço de Checkout"]
    ModeloPuro["Entidades Ricas DDD<br/>Linguagem Ubíqua Impecável"]
  end

  LegadoERP -- "Payloads Complexos" --> Adapter
  Facade -- "Entidades de Domínio" --> NovoDominio

A Camada Anticorrupção (Anti-Corruption Layer - ACL)

Quando um novo microsserviço precisa integrar-se a um sistema legado repleto de débitos técnicos, a maior ameaça é permitir que as estruturas de dados malformadas do legado contaminem as entidades do novo sistema. A ACL atua como uma alfândega bidirecional:

  • Adapter: Comunica-se com o canal do legado (REST SOAP, filas ou banco direto).
  • Translator: Converte os dados legados para os tipos de valor e entidades limpas do novo modelo.
  • Facade: Expõe operações simples em termos de negócio para o novo domínio consumidor.

O Risco do Shared Kernel (Núcleo Compartilhado)

O Shared Kernel é um subconjunto de código e modelo compartilhado explicitamente por dois ou mais times. Embora pareça atraente para evitar duplicar código, o Shared Kernel cria acoplamento temporal e de release: nenhuma equipe pode alterar a biblioteca compartilhada sem o consentimento e alinhamento de todas as outras.

Padrão de Context Mapping Dinâmica de Relação Quando Utilizar
Anti-Corruption Layer (ACL) Cliente não aceita o modelo do fornecedor e cria camada isoladora Integração com sistemas legados, ERPs de terceiros ou APIs externas
Open Host Service (OHS) Fornecedor publica API padronizada e estável para muitos clientes Plataformas de serviços centrais (Gateways de pagamento, Autenticação)
Published Language (PL) Formato universal compartilhado (JSON Schema, Protobuf, XML padrão) Troca de dados em larga escala entre múltiplos parceiros
Conformist Cliente aceita o modelo do fornecedor sem alterações Quando o modelo do fornecedor é excelente ou quando o cliente não tem poder de negociação
Shared Kernel Dois times compartilham um núcleo comum de classes e banco Times pequenos sob a mesma gestão com necessidade de sincronização imediata

Aplicar o Context Mapping explícito transforma dependências veladas em contratos claros, reduzindo atritos entre squads e prevenindo regressões inesperadas.

Explorar este tema no Grafo de Conhecimento