Pular para o conteúdo

Soluções · Integrações, sistemas e qualidade de dados

Arquitetura sem mapa: como reconstruir o caminho do dado

Como saber a arquitetura real dos sistemas quando a documentação não existe ou está desatualizada

Resposta direta

Reconstruir a arquitetura começa por um dado, não pelos sistemas. Toma-se um campo crítico, como valor do pedido ou código do cliente, e segue-se o que acontece com ele desde a origem até o último ponto em que é usado. Em cada trecho, quatro registros: onde nasce, o que altera o valor, onde é consumido e quem responde por ele. O produto não é um diagrama de fornecedores, e sim a lista de trechos sem responsável, sem teste ou sem registro. É essa lista que indica onde intervir primeiro.

Objetivo
Diagnosticar
Formato indicado
Projeto de implementação
Atualizado em

O que esta página acrescenta: Trata a arquitetura pelo caminho de um campo crítico, e não pela lista de sistemas ou de integrações existentes.

O inventário de sistemas não descreve a arquitetura

A lista de sistemas contratados, com módulos e contratos, descreve o que foi comprado, não o que acontece com o dado. Dois sistemas podem estar conectados e, ainda assim, o valor de um campo mudar no meio do percurso sem que ninguém saiba em qual ponto.

O inventário costuma registrar a integração como um par de sistemas. Na prática, um único campo passa por vários pontos: cadastro, pedido, faturamento, relatório. Cada ponto tem regra própria. É nessas regras, e não nos nomes dos fornecedores, que a arquitetura se define.

O que registrar em cada trecho do caminho

O registro de um trecho tem cinco campos: onde o dado nasce, o que altera o valor, onde é consumido, quem responde pela regra e como isso é verificado. Sem a forma de verificação, o registro é declaração de intenção, não mapa.

A verificação é uma consulta ou um teste que qualquer pessoa da equipe consegue repetir sozinha. Quando o responsável sai, o registro continua útil porque a verificação não depende de quem o escreveu. O mapa cresce por campo crítico, não por sistema.

O que o levantamento não resolve

O levantamento não corrige o dado nem conserta a integração. Ele mostra onde a responsabilidade não está definida e onde a verificação não existe. Corrigir é etapa separada, com custo, prazo e risco próprios, e pode exigir decisão que o mapa não sustenta.

Ele também não cobre fluxos que a empresa ainda não conhece e perde validade quando sistemas ou regras mudam. Se ninguém consegue nomear o responsável por um trecho, o registro não substitui essa decisão. O documento vira lista de intenções.

Recurso prático

Cobertura do caminho do dado por campo crítico

CMC = campos críticos com origem, transformação, destino e responsável definidos dividido pelo total de campos críticos

Total de campos críticos
campos
campos cujo erro ou ausência interrompe faturamento, atendimento ou obrigação de registro
Campos com caminho completo
campos
campos cujos origem, transformação, destino e responsável estão registrados de forma verificável
Campos sem verificação
campos
campos com caminho descrito, mas sem consulta ou teste que outra pessoa consiga repetir

O erro mais comum é considerar o trecho definido porque existe integração ativa entre dois sistemas. Integração em produção não equivale a caminho registrado: sem a transformação do valor e o responsável nomeados, o campo continua sem dono.

Sobre o que está escrito aqui

Conceitos relacionados: campo crítico · origem e destino do dado · transformação intermediária · responsável pela regra · inventário de integrações. Exemplos são ilustrativos. Não há cliente, resultado, preço, prazo ou certificação nesta página. Quando o formato indicado é Projeto de implementação, ele descreve uma possibilidade de trabalho — a conversa inicial avalia contexto e aderência.

Para continuar

Páginas relacionadas

O mesmo problema em outro objetivo

Outras leituras em Integrações, sistemas e qualidade de dados

Quer avaliar isso no seu contexto?

Esta página trata de arquitetura. Diagnóstico de integração é a frente que investiga o mecanismo por trás desse tipo de problema. O formato mais associado é Projeto de implementação.