Isolamento das dependências de normas

O COADF P-7 é publicado na íntegra. Sistemas de classificação, bases terminológicas e serviços externos de validação vivem em módulos adaptadores, marcados como tais, fora do modelo de dados central. Um serviço externo pode elevar a confiança de um atributo; nenhum deles pode bloquear uma saída. Quando um serviço está indisponível, o sistema produz evidência menos confiante em vez de nada; quando uma licença muda, o núcleo fica intacto; e o conteúdo licenciado é marcado em seus metadados e mantido apartado do núcleo aberto.

Como uma resposta externa altera a confiança não é publicado pelo COADF e não é descrito aqui. Os exemplos registram uma resposta externa e seu status, e não fazem mais nada com ela.

Normas e vocabulários sobrevivem a produtos, mudam de versão no próprio ritmo, trazem termos de licença e são servidos por sistemas que não estão sob a operação de quem os usa. Cada um desses pontos é uma forma de a decisão de outra pessoa virar uma indisponibilidade ou uma reescrita do próprio sistema. O mapa regulatório do COADF nomeia ECLASS e o IEC Common Data Dictionary como vocabulários licenciados tratados dessa forma; o mesmo raciocínio vale para um resolvedor de identificadores, um provedor de classificação ou um serviço externo de validação com disponibilidade própria.

O domínio precisa das respostas deles. Não pode precisar delas para funcionar, e não pode começar a pensar nos termos deles.

• Porta e adaptador. O domínio define a interface de que precisa, com suas próprias palavras; cada sistema externo recebe um adaptador que a implementa.
• Camada anticorrupção. O adaptador traduz o modelo externo para o modelo do domínio e de volta, de modo que os conceitos e nomes externos param na borda.
• Identificadores próprios. O domínio mantém sua própria identidade para um conceito e armazena um código externo como referência atribuída: o esquema de codificação, a versão do esquema, o código, de onde veio, quando, e se é licenciado.
• Versão fixada. Um código só significa algo dentro de uma versão do seu esquema. A versão é registrada em cada referência armazenada e enviada em cada consulta. Um novo transporte ou uma nova representação do fornecedor pode ficar dentro do adaptador; uma nova versão semântica da norma pode mudar o que os códigos significam, e então o mapeamento do domínio precisa mudar junto.
• Ausência explícita. Um serviço indisponível resulta num “não disponível” registrado, nunca num valor padrão e nunca numa pipeline parada. Toda chamada tem um timeout, e o caminho crítico não espera por um enriquecimento sem o qual consegue viver.
• Conteúdo licenciado marcado. Todo valor armazenado que veio de uma fonte licenciada carrega um marcador, para que exportações, logs, caches e artefatos públicos possam deixá-lo de fora mecanicamente.
• Uma fronteira de plugins onde os adaptadores são opcionais ou fornecidos por terceiros: carregados por meio de um registro do qual o domínio não depende.

Em Python a porta pode ser um typing.Protocol, verificado por verificadores de tipos estáticos; uma checagem isinstance em tempo de execução contra ele precisa de @runtime_checkable e verifica apenas que os métodos existem, não suas assinaturas. O teste de contrato é o que verifica o comportamento.

• Uma linguagem publicada ou modelo canônico compartilhado por vários contextos delimitados, com cada esquema externo mapeado sobre ele uma única vez.
• Um serviço envoltório em torno de um fornecedor, para que todo consumidor encontre a mesma interface estável.
• Uma cópia espelhada de um vocabulário, onde a licença permite, para que as consultas deixem de depender da disponibilidade.
• Código gerado em tempo de build a partir de um esquema, mantido dentro do pacote do adaptador e nunca exportado dele.

• O isolamento não resolve os termos de licença. Ele os torna aplicáveis num só lugar.
• O mapeamento perde nuance. Uma tabela de mapeamento é conhecimento de domínio e precisa de revisão própria.
• O padrão não descreve como a evidência externa afeta a confiança, o que pertence ao P-2.