Fotografia de instalação minimalista. Esferas laranjas desenham saltos sucessivos sobre degraus brancos. As posições marcam os instantes de uma interação que a vista dinâmica organiza em sequência.
Parte 2 de 9 da série C4 e arquitetura de sistemas. Nesta série, vamos escolher o desenho que ajuda alguém a entender um sistema e decidir o que fazer com ele.
O pedido foi enviado, a resposta se perdeu e o cliente esperou. Vamos acompanhar a ordem dos eventos para descobrir em quem cada sistema pode confiar.
No plantão do banco hipotético, eu vejo duas tentativas de abertura e a confirmação de apenas uma chamada. Uma pessoa do atendimento me pergunta se deve orientar a cliente a enviar tudo novamente. A resposta depende do que o núcleo já fez e de quem pode confirmá-lo. Nesta parte da série sobre C4 e arquitetura de sistemas, vou desenhar a ordem das interações, converter o caminho de perda de resposta em teste e mostrar como eu usaria a mesma vista para ajudar quem assume a recuperação.
O banco quer abrir contas elegíveis em um dia útil. Eu escolheria a perda de resposta como cenário de revisão, porque a ordem das interações altera o que cada sistema consegue afirmar. Um desenho estrutural ajuda a reconhecer as peças. Um diagrama que representa o comportamento em execução ajuda a decidir o que fazer quando um desses passos fica incerto.
O modelo C4 chama de diagrama dinâmico a visão que mostra como elementos do modelo estático colaboram em um cenário. O C4 permite usar sistemas, contêineres ou componentes e documenta estilos de colaboração e sequência. Eu reservaria essa visão para situações em que a interação vale ser discutida, como a recuperação após a perda de uma resposta. Documentação oficial do C4 sobre diagramas dinâmicos
Escolha as peças que precisam aparecer
Para a equipe do banco, eu começaria pelo canal digital, pelo serviço de abertura e pelo sistema bancário central. A aplicação e o serviço são contêineres do sistema de abertura neste exemplo. O sistema central fica fora dessa fronteira. O repositório do serviço também aparece, pois guarda o estado que permitirá a recuperação depois de uma falha. Um contêiner no vocabulário do C4 é uma aplicação ou um armazenamento de dados. Documentação oficial do C4 sobre diagramas de contêineres
O desenho abaixo usa Mermaid como aproximação visual, com a fronteira e as responsabilidades que eu colocaria no modelo. Eu usaria os mesmos nomes nos diagramas seguintes para que cada interação possa voltar a um elemento conhecido.
Figura 1. Visão estrutural aproximada em Mermaid. Localize a fronteira que separa os contêineres do sistema de abertura e o núcleo bancário.
Fotografia noir em preto e branco. Um telefone fora do gancho projeta sombra sobre uma mesa com plantas em um escritório vazio. A interrupção representa a resposta perdida que o plantão precisa investigar com o contexto já disponível.
Desenhe o caminho em que o retorno se perde
Eu começaria pelo momento em que a cliente, já elegível e com oferta aceita, envia a solicitação. O canal recebe uma referência estável ou consegue recuperar a referência de uma tentativa em andamento. O serviço persiste a solicitação antes de encaminhar o pedido ao sistema central. Essa persistência permite que um processo retome o caso após uma queda e reconheça que a solicitação já entrou no fluxo.
Agora imagine que o sistema central confirma internamente a criação da conta, mas a resposta não chega. O serviço classifica o resultado como incerto. Enquanto investiga, continua informando ao canal que a abertura está em andamento. O passo decisivo é consultar a referência de origem e obter confirmação de disponibilidade para uso. O diagrama seguinte mostra o caso em que a consulta encontra a conta ativa.
Figura 2. Diagrama de sequência da perda de resposta. Observe onde o serviço deixa de saber o resultado mesmo após enviar a instrução.
A sequência coloca a falha no ponto em que o serviço perde visibilidade do resultado. Isso ajuda as equipes a discutir a diferença entre uma falha de comunicação e uma recusa efetiva do pedido. Eu explicitaria se uma consulta pode retornar dados atrasados. Uma resposta sem registro, em um sistema cuja consulta tem atraso, pode ser inconclusiva para decidir um novo envio. A equipe precisa acordar qual evidência é forte o suficiente para prosseguir.
Separe a ordem das mensagens dos estados permitidos
O desenho da sequência ajuda a conversar sobre um caso. O estado da abertura ajuda a testar vários casos sem reescrever a sequência inteira. Eu usaria o diagrama abaixo como complemento. Ele descreve o mesmo serviço em termos de transições permitidas e do sinal que autoriza cada mudança.
Figura 3. Diagrama de estados do pedido. Veja quais transições dependem de evidência e quais mantêm o caso pendente.
Eu daria à operação uma regra de escalonamento para o caso que permanece em conciliação. O registro deve indicar a referência de origem, a hora do envio, o último estado conhecido e qual equipe pode consultar o sistema central. O canal pode mostrar que a abertura está em andamento e orientar a cliente a acompanhar o mesmo pedido. A equipe pode medir a idade dessa pendência antes de decidir se precisa aumentar cobertura operacional.
Eu faria uma leitura do diagrama com quem mantém o sistema central. Pediria que a equipe marque a primeira operação que consegue afirmar que a conta existe e a primeira que consegue afirmar que está disponível. Se esses sinais vierem de fontes diferentes, eu colocaria a distinção no passo que afeta a decisão do canal. Uma anotação curta pode bastar para indicar a condição. Se for preciso explicar como duas confirmações chegam fora de ordem, vale desenhar outro cenário com o mesmo conjunto de participantes.
Também combinaria o que fica fora deste recorte. A forma de autenticar a cliente e o motor que decidiu a elegibilidade podem ter outros diagramas. Nesta conversa, eu mostraria a decisão como condição já satisfeita para o primeiro pedido. Isso ajuda a equipe a discutir a sequência crítica sem perder de vista o que o cenário pressupõe.
Tire do diagrama um teste que alguém consiga executar
Eu usaria três testes de integração. No primeiro, o sistema central aceita o pedido e confirma a conta disponível. O canal só mostra a conta aberta depois desse sinal. No segundo, um simulador grava a abertura e suprime a resposta. O serviço executa a consulta pela referência, localiza a conta existente e reflete o estado correto no canal. No terceiro, a consulta fica inconclusiva. A abertura permanece em conciliação e a operação consegue localizar o caso sem depender de um novo envio automático.
No piloto, eu pediria a alguém de atendimento para explicar os três resultados usando os mesmos identificadores do teste. Depois, compararia o prazo desde a solicitação completa até a conta disponível com a meta de um dia útil. Isso também mostra quanta espera ficou concentrada na recuperação de casos incertos.
Manteria a visão dinâmica junto ao contrato e aos testes. Se o sistema central mudar o comportamento da consulta ou a forma de confirmar ativação, a mudança deve passar pelos desenhos e pelos testes que dependem dela. A conversa sobre arquitetura fica mais próxima do dia a dia quando uma pessoa consegue seguir a mesma referência do primeiro pedido ao momento em que a conta pode ser usada.
Revise a sequência com as pessoas que enxergam partes diferentes
Eu começaria com alguém que usa o aplicativo, uma pessoa de atendimento e uma pessoa que mantém o serviço de abertura. Pediria a cada uma para descrever o que considera uma confirmação. Quem usa o aplicativo quer saber se já dispõe da conta. Atendimento precisa dizer se o banco ainda está processando e quem pode agir. Engenharia precisa saber se o sistema central executou ou apenas recebeu a instrução. A arquitetura precisa manter esses significados ligados aos sistemas que produzem a evidência.
No quadro, eu numeraria as interações que mudam o que cada participante pode afirmar. A ordem começa quando o canal registra a ação e termina quando disponibiliza o resultado. Uma interação pode representar a consulta que ocorre ao retomar um pedido, outra pode mostrar a leitura da confirmação pelo serviço interno. Se duas ações acontecem sem ordem garantida, eu indicaria o que as separa em vez de colocar uma seta arbitrária entre elas. A vista precisa permitir que alguém localize a dependência e faça uma pergunta específica sobre um evento.
Figura 4. Diagrama de sequência numerado. Observe quais interações mudam aquilo que o canal e o serviço podem afirmar.
No C4, eu manteria os nomes dos participantes ligados aos elementos já existentes no modelo. A equipe pode relacionar essa visão dinâmica a uma vista estática de contêineres ou ao contexto do serviço. Se o estado estiver em um repositório compartilhado, isso precisa aparecer porque muda a investigação. Se a equipe só precisa entender quando uma confirmação pode chegar, eu evitaria detalhar bibliotecas, threads ou tabelas sem relevância para o cenário. Cada elemento que entra na vista deve ajudar a explicar uma interação. C4 sobre diagramas dinâmicos.
Estampa gráfica minimalista. Impressões de um quadrado vermelho ganham intensidade ao avançar sobre uma linha no papel. A progressão aproxima as tentativas sucessivas sem confundir seus registros com a confirmação do efeito final.
Ensaie o cenário em que uma etapa acontece duas vezes
Imagine que a confirmação do núcleo seja emitida às 9h05. Antes que o serviço processe essa resposta, o canal repete a solicitação. A nova tentativa pode chegar antes da confirmação ou logo depois. Para a pessoa que espera a conta, as duas situações devem levar à mesma referência. Se a confirmação se repetir em seguida, a operação mantém a evidência sem duplicar efeitos. Eu faria essa análise com uma decisão simples em mente. Em qual momento o serviço tem autorização para informar disponibilidade?
Pense nas duas referências. Uma identifica o pedido local no escopo da integração com o canal. Outra identifica o comando enviado ao núcleo. Se funcionarem com ciclos de vida diferentes, explique como relacioná-las. O incidente pode aparecer em uma ferramenta que conhece apenas a segunda. Atendimento pode enxergar só a primeira. Operações precisa de uma consulta que encontre a relação sem copiar informações pessoais para mensagens de investigação. O desenho deveria permitir indicar o pai da interação na participação e orientar onde olhar o rastro.
Figura 5. Diagrama entidade-relacionamento de rastreabilidade. Siga as referências que ligam tentativas, confirmações e mudanças de estado.
A seguir, um trecho PostgreSQL ilustra uma consulta de investigação. Eu entregaria à operação uma forma autorizada de usar a mesma lógica. Aqui a leitura traz a ordem observada de registros e conserva o horário em que cada fonte afirma que algo ocorreu. Esses relógios podem divergir. Use a versão do pedido e a evidência de cada fonte para validar a sequência antes de concluir que o trânsito ocorreu naquela ordem.
SELECT origem, tipo_evento, evento_id,
ocorrido_em, recebido_em, versao_pedido,
resultado, evidencia_ref
FROM trilha_de_abertura
WHERE pedido_id = 'pedido-sintetico-018'
ORDER BY recebido_em, origem, evento_id;
Eu também executaria uma medição simples da diferença entre os horários do núcleo e do serviço. Uma demora recorrente nesse intervalo pode indicar fila ou processamento. Grandes diferenças de sentido inverso podem indicar diferença de relógio ou de representação da data. Em ambos os casos, a resposta muda a investigação. O diagrama mostra por onde a mensagem deveria seguir. A trilha mostra o que as fontes registraram. A equipe precisa preservar a possibilidade de confrontar as duas visões sempre que a operação mudar.
Teste a transição no serviço que consome a evidência
Considere um teste que primeiro envia a solicitação, confirma que chegou ao núcleo e depois provoca a perda da resposta. Eu pediria que o teste prove o resultado antes de verificar a interface. Se o núcleo registrou uma única conta para a referência, podemos avançar para a consulta local. Se o serviço ainda não tem evidência adequada, a interface continua mostrando a situação de espera. Após a conciliação, a consulta apresenta a conta disponível conforme os critérios que o banco acordou. Registre também qual evento encerra a medição de um dia útil.
# language: pt
Funcionalidade: Recuperar abertura depois de uma resposta perdida
Cenário: O núcleo já registrou a conta
Dado que o pedido foi aceito e recebeu uma referência estável
E que o núcleo gravou uma conta para essa referência
E que a confirmação da chamada não foi recebida
Quando o canal consultar o pedido antes da conciliação
Então o canal recebe uma situação pendente
Quando a abertura verificar o resultado com o núcleo
Então a consulta passa a indicar a conta disponível
E existe uma única conta vinculada à referência
Eu usaria esse cenário como contrato entre as equipes, com dados sintéticos e versão registrada em cada validação. A forma de provocar a perda precisa ser reproduzível no ambiente de teste. Pode ser um substituto que grava o efeito simulado e encerra a conexão. Pode ser um ambiente de homologação com ponto de injeção previsto pela equipe. Guarde o que o teste demonstra sobre a ordem e as garantias. Uma chamada bem simulada oferece evidência sobre o contrato esperado. A equipe ainda precisa validar integração, latência e concorrência numa configuração representativa.
Figura 6. Diagrama de estados após a falha. Compare a instrução confirmada localmente, a conciliação e a disponibilidade ao canal.
Talvez alguém proponha fazer a conciliação repetidamente até o núcleo responder. Eu pediria um orçamento de tentativas e de tempo. Depois de alcançar o limite, encaminhe para a pessoa responsável com as evidências coletadas. Repetir uma leitura é uma decisão diferente de repetir uma instrução de gravação. Se a origem tiver garantias de idempotência e uma janela de retenção, inclua as duas no contrato. A operação consegue assim escolher um passo com base na condição atual e num limite que conhece.
Ligue o desenho à resposta de plantão
Para uma simulação, eu escolheria cinco solicitações sintéticas. Duas terminam no caminho padrão. Uma tem confirmação externa atrasada. Uma recebe duas notificações. A última fica com resultado incerto depois de a consulta atingir seu limite. Peça à equipe para localizar os casos em até quinze minutos e dizer quem pode tomar a próxima ação. Esse prazo é ilustrativo. O importante é observar onde alguém para para procurar permissão, informação ou orientação. O problema pode estar em uma mensagem que não tem referência, em uma consulta que exige acesso extraordinário ou num contrato cujo significado ninguém confirmou.
Figura 7. Diagrama de jornada do atendimento. Veja como a equipe passa da consulta do estado à verificação da referência externa.
Ao terminar, eu faria a pessoa de plantão mostrar exatamente onde o sistema indica a próxima revisão. Se há um resultado conhecido, ela deve conseguir explicar de qual fonte veio. Se ainda não há, ela precisa indicar quem pode assumir e quando entra uma nova observação. Uma sequência que termina depois da última interação automática pode deixar esse trabalho invisível. Vale acrescentar um participante de operação se a decisão de intervenção é relevante para o cenário. Também vale separar o que depende da percepção de clientes e o que só diz respeito à reconstrução em ambiente técnico.
Preserve uma versão do desenho que corresponda à implantação
Em uma mudança futura, a confirmação pode deixar de chegar na resposta da chamada e passar a vir em um evento. Eu compararia a sequência anterior e a futura com quem mantém o atendimento. A referência externa ainda vale em ambos os caminhos? Quem consegue inspecionar uma confirmação que nunca chegou? O diagrama atualizado pode apontar a fila e a interação que faz o serviço gravar o resultado. Guarde o recorte do piloto em uma vista separada se dois comportamentos coexistirem temporariamente. Deixe claro quais grupos seguem cada caminho.
Eu colocaria na revisão da implantação uma pergunta bem concreta. Se uma cliente ligar amanhã às dez, a equipe consegue dizer se ela entrou antes ou depois da mudança? Uma etiqueta com a versão do fluxo pode ajudar, assim como um registro de quando cada grupo mudou de rota. A investigação histórica usa o desenho correspondente à época e as evidências disponíveis. Na retirada da versão anterior, documente quando deixou de valer e quem verificou os casos ainda em andamento. Esse cuidado preserva o sentido do desenho quando a equipe precisa interpretar chamados antigos.
Observe o que o cenário ensina sobre a arquitetura
A perda de uma resposta pode revelar que o serviço já tem uma operação de consulta suficiente. Nesse caso, o trabalho está em ligar a referência e mostrar o estado correto ao canal. Pode revelar que falta uma confirmação autorizada para declarar disponibilidade. Nesse caso, ampliar tentativas pode repetir o problema de interpretação. Observe em que passo a equipe consegue agir, em que momento precisa esperar outra evidência e qual controle explica o limite.
Eu pediria ao patrocinador para avaliar a sequência em um exemplo simples. A conta foi registrada às 9h05, o canal consultou às 9h10, Operações confirmou às 9h30 e o aplicativo mostrou disponibilidade às 9h31. Qual desses horários encerrou o compromisso? A decisão precisa coincidir com a definição de pronta e aparecer no teste. Se a área quiser medir o momento do núcleo para gerir um componente, preserve o segundo indicador ao lado da medida da jornada. Assim, a discussão pode encontrar o investimento que melhora o trecho certo, sem que o tempo de um componente passe a representar a experiência inteira.
Inclua o caminho que muda quando a fila está cheia
Eu prepararia uma segunda conversa a partir de um grupo maior. Imagine que quarenta instruções estejam aguardando confirmação porque o núcleo ficou indisponível. O plantão recupera o serviço às 15h e precisa decidir como tratar o atraso sem prejudicar as novas solicitações. Uma sequência só do caso bem-sucedido pode dar a impressão de que basta repetir cada chamada. A operação precisa saber quantas consultas o núcleo absorve, qual condição caracteriza uma confirmação utilizável e onde exibir a previsão para quem já espera.
Antes do ensaio, documente quem pode suspender novas instruções. A entrada pode continuar recebendo pedidos e oferecer uma estimativa, se a política permitir. A execução espera até que a área responsável confirme a retomada. Quando o núcleo volta, a primeira ação pode ser consultar as instruções que já saíram. Se cada caso mostrar um resultado conhecido, não é preciso iniciar nova abertura. Para as referências inconclusivas, a equipe registra a evidência e encaminha à pessoa que tem autoridade para decidir.
Eu testaria a recuperação com um limite pequeno e observaria a idade dos pedidos. Suponha que o teste trate cinco referências por minuto e que vinte delas ainda dependam de confirmar disponibilidade ao cliente. A fila técnica pode terminar em oito minutos, mas a equipe precisa olhar quando cada situação aparece para o canal. Registre as duas medições. A primeira ajuda a dimensionar a recuperação. A segunda mostra se a pessoa que espera recebeu uma informação utilizável.
Leve um exemplo de suporte para o próximo desenho
Numa revisão de arquitetura, eu pediria que cada área chegasse com um caso que consegue explicar hoje e um que ainda exige telefonar para alguém. Use referências sintéticas ou evidências com os acessos previstos. O grupo escolhe qual situação acrescentar à vista dinâmica. Talvez surja uma nova dependência com uma fila de mensagens, ou uma decisão manual que sempre foi omitida do desenho. Se ela for importante para o resultado, inclua-a com um papel claro e a interação que autoriza seguir. Se for uma etapa interna que não afeta aquela pergunta, ela pode ficar em outro recorte.
Também combinaria como verificar se a documentação foi útil. Num exercício, escolha duas pessoas que não desenharam a solução. Uma tenta reconstruir o caso usando a vista dinâmica, a outra começa pelo registro do incidente. As duas devem conseguir indicar o sistema que dá a evidência final e o momento em que ela ficou disponível. Se encontrarem sequências diferentes, procure a razão. Talvez exista uma versão ainda em operação ou um horário que a documentação trata de modo impreciso. Registre o achado no mesmo lugar em que as equipes revisam o código e o contrato.
No encerramento, eu voltaria a falar com quem responde ao cliente. Se ela consegue identificar a situação atual, localizar o próximo passo e dar uma previsão honesta usando as referências acordadas, o desenho começa a acompanhar o trabalho. A próxima atualização pode tratar a espera mais relevante ou acrescentar uma vista para outro cenário que a operação passou a encontrar com frequência.
Eu faria esse trabalho também para uma alteração que dá certo. Trace a sequência de uma conta disponível no mesmo dia e compare-a com a sequência da perda de resposta. Quem revisa precisa ver onde as duas coincidem e em que ponto a recuperação exige outra interação. Assim, quem desenvolve mantém o contrato principal legível, e quem opera encontra o caminho adicional sem procurar no meio de todas as possibilidades. Se a mesma pergunta surgir em dois cenários, anote qual vista deve ser mantida como referência. A atualização fica menor e as pessoas sabem de onde partir quando o desenho muda.
Compare o desenho com o registro de duas tentativas
Eu faria um ensaio com relógios ligeiramente desencontrados. O núcleo registra a criação às nove e cinco no seu relógio. O servidor de abertura registra a ausência de resposta às nove e quatro no dele. Se eu ordenar eventos só pelo horário exibido, o mapa pode sugerir que o pedido nunca chegou a tempo. Primeiro eu junto as duas pontas pela referência da operação e pela relação entre emissão e resposta. Depois interpreto os instantes com suas fontes e margens de erro. Essa ordem de investigação ajuda a distinguir a sequência causal que o diagrama ilustra da cronologia incompleta que o plantão conseguiu observar.
Ao revisar esse caso, eu anotaria também onde a equipe precisa de rastreabilidade que ainda não existe. Uma segunda tentativa sem a referência da primeira pede uma mudança de contrato ou uma rota operacional clara para investigar sem duplicar a solicitação.
A preparação do texto e a criação das ilustrações tiveram apoio de IA generativa.









Top comments (0)