Radar de Impacto: Entenda a Mudança Antes de Fazê-la
Algumas semanas atrás, uma equipe de plataforma com quem trabalho decidiu depreciar um serviço interno de autenticação. Parecia simples — o serviço tinha dois consumidores conhecidos. Eles atualizaram o diagrama, notificaram essas equipes e começaram a planejar a migração.
Três sprints depois, descobriram mais quatro serviços dependendo dele. Dois estavam em outros projetos. Um era um fluxo legado que ninguém havia mapeado. O prazo de migração dobrou.
A informação estava lá. Estava nos relacionamentos, na hierarquia C4, nos diagramas de fluxo. Mas ninguém conseguia ver o quadro completo de uma vez. Era preciso rastrear cada conexão manualmente, entre níveis, entre projetos, esperando não perder nenhum caminho.
É esse o problema que o Radar de Impacto resolve.
Clique com o Botão Direito, Veja Tudo
O Radar de Impacto fica onde você já trabalha — no diagrama. Clique com o botão direito em qualquer elemento do seu modelo C4 — um sistema, container, componente ou elemento de código — e selecione Analisar Impacto. A análise roda instantaneamente.
O diagrama se transforma. Cada elemento fora da zona de impacto desvanece para o fundo. Os elementos afetados permanecem vívidos, e os relacionamentos entre eles se iluminam, codificados por cor conforme a proximidade:
- Vermelho — diretamente conectado (grau 1)
- Âmbar — a um salto de distância (grau 2)
- Amarelo — a dois saltos de distância (grau 3)
As arestas se animam para mostrar a direção do fluxo de dependência. Você vê o raio de explosão de uma mudança no tempo que leva para olhar a tela.
O Painel de Impacto
Um painel desliza do lado direito com a análise completa. Sem página separada, sem troca de contexto — você ainda está no seu diagrama, ainda no seu projeto.
No topo, um único número: "Impacta X% da sua arquitetura." Esta é a porcentagem dos elementos do seu projeto que estão dentro da zona de impacto. É um número para verificação rápida. Se você clicar com o botão direito em um componente utilitário e ver 2%, provavelmente está seguro. Se clicar em um API gateway central e ver 38%, você sabe que essa mudança precisa de uma conversa.
Pontuação de Risco
Abaixo da porcentagem está o Medidor de Risco — uma pontuação de 0 a 100 calculada a partir de quatro fatores ponderados:
- Dependentes upstream (30%) — Quantos elementos dependem deste? Quanto mais consumidores, maior o raio de explosão.
- Alcance downstream (25%) — De quantas dependências este elemento depende? Mudanças aqui podem exigir atualização dessas dependências também.
- Filhos estruturais (25%) — Para containers e sistemas, quantos elementos filhos existem dentro? Modificar ou remover um container significa lidar com cada componente que ele contém.
- Razão de acoplamento (20%) — Quão conectado é este elemento em relação ao resto do grafo? Alto acoplamento significa alto risco.
O medidor mostra verde, âmbar ou vermelho com base na pontuação. Abaixo dele, uma decomposição de cada fator para que você entenda exatamente o que está gerando o número.
Upstream e Downstream
A análise separa o impacto em duas direções. Upstream mostra tudo que depende do elemento selecionado — os serviços que o chamam, os sistemas que o consomem, os componentes que o importam. Downstream mostra tudo do que o elemento depende — os bancos de dados de onde lê, as APIs que chama, as bibliotecas que usa.
Cada direção é organizada por grau. Elementos de grau 1 estão diretamente conectados. Elementos de grau 2 estão a um salto — não tocam seu elemento diretamente, mas tocam algo que toca. Grau 3 estende a análise mais um passo.
Essa visão em camadas ajuda a pensar sobre o impacto em anéis concêntricos. Mudanças de grau 1 são imediatas. Grau 2 e 3 são os efeitos secundários — aqueles que tendem a surpreender equipes que olharam apenas as conexões diretas.
Caminho Crítico
Se a cadeia de dependência é profunda, o Radar de Impacto destaca o caminho crítico — a cadeia mais longa do elemento selecionado até o nó afetado mais distante. Este é o caminho onde as mudanças levam mais tempo para se propagar e onde falhas em cascata são mais prováveis.
Cada nó no caminho crítico é clicável. Você pode rastrear a cadeia passo a passo e entender exatamente como uma mudança em uma ponta alcança a outra.
Dependências Entre Projetos
A arquitetura não para nas fronteiras de projeto. Se sua organização usa a visualização de Arquitetura Global do Archyl para conectar sistemas entre projetos, o Radar de Impacto segue essas conexões também.
O painel inclui uma seção de Dependências Entre Projetos que mostra elementos de outros projetos dentro da zona de impacto. Cada entrada exibe o nome do projeto, para que você saiba imediatamente quais equipes incluir.
É aqui que o Radar de Impacto passa de útil a essencial. Dentro de um único projeto, talvez você consiga rastrear dependências manualmente. Entre cinco projetos mantidos por equipes diferentes? É aí que as coisas passam despercebidas. O Radar de Impacto rastreia o grafo completo automaticamente, independente das fronteiras de projeto.
Fluxos Afetados
Se você documentou fluxos de usuário ou sistema no Archyl, o Radar de Impacto os referencia cruzadamente contra a zona de impacto. A seção de Fluxos Afetados lista cada fluxo que inclui pelo menos um passo tocando um elemento impactado, junto com quantos passos desse fluxo são afetados.
Um fluxo mostrando "4/12 passos afetados" diz algo diferente de "1/12 passos afetados". O primeiro significa que a mudança cruza uma porção significativa da jornada do usuário. O segundo significa que é um ponto de contato periférico.
Simulação "E se"
No final do painel, um botão: Simular Remoção. Este é o botão "o que quebra se deletarmos isso?".
Ative-o, e o Radar de Impacto calcula a cascata completa:
- Relacionamentos quebrados — Cada conexão explícita para ou do elemento (e seus filhos) que se tornaria uma referência pendente.
- Estruturalmente destruídos — Os filhos diretos que seriam removidos junto com o elemento. Delete um container, e cada componente dentro dele vai junto.
- Elementos órfãos — Elementos que se tornam inalcançáveis do resto do grafo após a remoção. Não são diretamente deletados, mas estão efetivamente mortos — nós desconectados sem caminho para nada.
- Quebras entre projetos — Relacionamentos globais de outros projetos que seriam cortados.
- Impacto total em cascata — A contagem total de tudo afetado.
Isso não é especulativo. É uma computação determinística sobre o grafo de relacionamentos. Os números dizem exatamente o que acontece se você prosseguir.
Por Que Isso Importa
O fluxo de trabalho comum para avaliar mudanças arquiteturais hoje é uma reunião. Alguém propõe uma mudança. A equipe discute quem pode ser afetado. Pessoas voluntariam dependências de memória. Alguém verifica um diagrama. Outra pessoa verifica um diagrama diferente. A reunião termina com um item de ação para "investigar mais".
O Radar de Impacto comprime esse ciclo em um clique com o botão direito. A análise é exaustiva — segue cada relacionamento, aresta estrutural e link entre projetos no grafo. Não depende da memória de ninguém sobre como o sistema está conectado. Lê o modelo que você já construiu e mostra o que o modelo diz.
Isso muda como as equipes abordam a evolução arquitetural:
- Antes de depreciar um serviço, veja cada consumidor em cada projeto.
- Antes de reestruturar uma hierarquia de componentes, entenda a repercussão downstream.
- Antes de uma refatoração grande, quantifique o raio de explosão e identifique quais equipes precisam estar envolvidas.
- Durante revisões de incidentes, rastreie a cadeia de dependência para entender por que uma falha em um componente se espalhou pelo sistema.
Começando
O Radar de Impacto está disponível agora em todos os planos. Abra qualquer projeto, clique com o botão direito em qualquer elemento do seu diagrama C4 e selecione Analisar Impacto.
A análise funciona melhor quando seu modelo de arquitetura está conectado — quando relacionamentos entre elementos estão documentados, quando fluxos capturam jornadas reais de usuários, e quando links entre projetos refletem as fronteiras reais do sistema. Quanto mais completo seu modelo, mais útil a análise de impacto se torna.
Sua arquitetura é um grafo. O Radar de Impacto permite que você o leia.
Quer construir um modelo de arquitetura mais conectado? Comece com a Introdução ao Modelo C4, depois conecte seus projetos com Colaboração em Tempo Real e Arquitetura Global. Para equipes que querem governança sobre mudanças, Solicitações de Mudança de Arquitetura combinam naturalmente com o Radar de Impacto — analise o impacto primeiro, depois proponha a mudança.