Fotografia em plongée de inspiração Nova Visão. Uma trilha de luz liga uma peça de quebra-cabeça dourada, uma maquete arquitetônica e um cilindro de metal, perto de uma prancheta marcada. A luz representa o caminho de verificação entre requisito, definição e registro de implementação.

Parte 2 de 8 da série Fundamentos de arquitetura. Nesta série, vamos ligar decisões de arquitetura ao trabalho de quem precisa financiar, implementar e operar uma mudança.

O canal já mostrou a palavra «ativa» a doze pessoas. Na sala de incidente do banco hipotético desta série, eu ouço alguém ler a resposta do sistema central em voz alta. As doze solicitações continuam em processamento. No repositório encontro dois diagramas parecidos e uma página com um selo de aprovação. Os diagramas atribuem a confirmação a componentes diferentes. A primeira escolha que eu preciso fazer é qual evidência levar para decidir se interrompo as atualizações do canal.

Nesta parte de Fundamentos de arquitetura, vou mostrar como eu faria o conteúdo do TOGAF responder a perguntas desse tipo. Quero chegar da promessa de serviço à versão implantada, recuperar a decisão que valia naquele momento e descobrir se existia um teste que reproduzisse o incidente. Começo pelo trabalho que cada artefato faz e termino com uma consulta executável que distingue a aprovação de uma versão da evidência que sustenta essa aprovação. O banco, os horários e os incidentes são hipotéticos.

Linhas de madeira saem de um pergaminho, atravessam emblemas numa estante e convergem numa rosa dos ventos.

Marchetaria de madeiras contrastantes. Linhas de madeira saem de um pergaminho, atravessam emblemas numa estante e convergem numa rosa dos ventos. Cada material de trabalho carrega uma relação diferente com a decisão, identificada pelo caminho percorrido.

Use cada tipo de conteúdo para apoiar uma decisão

O Documento de Definição da Arquitetura aprovado é um entregável. Ele dá às partes interessadas uma descrição coerente da arquitetura acordada. Seus artefatos podem incluir um catálogo de aplicações, uma matriz de responsabilidade pelos estados das solicitações e um diagrama de interações entre a jornada de abertura e o sistema bancário central. Cada artefato responde a uma pergunta específica no nível de detalhe adequado ao público.

Os blocos de construção representam componentes da arquitetura e de sua realização. O banco descreve a capacidade de confirmar uma ativação como um Architecture Building Block, com o comportamento exigido e suas restrições. Um Solution Building Block descreve a combinação concreta que o implementa, como um serviço existente do sistema central e um adaptador que converte seu resultado em um status compartilhado. Essa distinção permite avaliar a implementação diante da capacidade requerida e dá a futuras iniciativas uma base para reúso.

Faça o repositório responder à pergunta da revisão

No exemplo, a Architecture Landscape descreve as estruturas atual e futura. A Standards Information Base identifica os padrões obrigatórios para contratos de interface. A Reference Library oferece exemplos, como um padrão para publicar um status oficial. O Governance Log registra a aprovação e as exceções com prazo. O banco vincula esses registros ao requisito e às evidências de implementação mantidas nas ferramentas de entrega.

Fluxograma de rastreabilidade. Siga o requisito até a evidência de teste e observe a passagem entre o bloco de arquitetura e os componentes que o realizam.

Figura 1. Fluxograma de rastreabilidade. Siga o requisito até a evidência de teste e observe a passagem entre o bloco de arquitetura e os componentes que o realizam.

Quem revisa a versão consegue seguir o requisito até um teste executável. O teste atrasa a resposta do sistema central e verifica se o canal mantém o status pendente até a confirmação. Se o adaptador for substituído depois, o requisito e os artefatos mostram o comportamento a preservar. Um responsável e uma data de revisão para cada registro ajudam a equipe a localizar a versão aprovada quando surgir a proposta de troca.

Uma lupa enquadra um ponto de interrogação perto de uma sequência de pastas recortadas e caixas empilhadas.

Décollage editorial de papéis rasgados. Uma lupa enquadra um ponto de interrogação perto de uma sequência de pastas recortadas e caixas empilhadas. A pergunta orienta a busca no repositório, e as camadas mostram o esforço de recuperar a evidência que apoia uma resposta.

Organize o conteúdo pela pergunta que ele responde

Eu manteria um índice de artefatos com responsável, versão aprovada, escopo e data da próxima revisão. Para o sistema de abertura, por exemplo, a matriz de estados explica qual aplicação pode produzir cada mudança. O catálogo de integrações identifica o contrato vigente e seus consumidores. A vista de implantação permite descobrir onde uma instância está executando. São recortes diferentes, relacionados pelo identificador da decisão e do requisito.

O repositório pode ser distribuído. O catálogo pode ficar em uma ferramenta de modelagem e os testes no sistema de entrega. O registro de arquitetura dá ao revisor o caminho para a versão pertinente. Eu ligaria o resultado de homologação à versão do contrato e ao ambiente onde foi executado. Assim, um teste aprovado seis meses antes continua interpretável se a integração for alterada depois.

Fluxograma de consulta do repositório. Observe que a versão do contrato orienta a busca pela execução aplicável à pergunta.

Figura 2. Fluxograma de consulta do repositório. Observe que a versão do contrato orienta a busca pela execução aplicável à pergunta.

Use um incidente para testar a qualidade do repositório

Imagine que o canal apresente conta ativa para 12 clientes enquanto o core informa processamento pendente. A equipe de suporte precisa encontrar a definição que valeu na implantação, a regra que governa a atualização de status e quem pode corrigir o comportamento. Eu começaria pela data da versão em produção. O registro da entrega aponta para o contrato de ativação vigente e para a decisão que reservou ao core a confirmação do estado.

A equipe reconstrói o incidente com referências aos casos autorizados. O histórico da decisão mostra se existia uma exceção com prazo e responsável. O resultado do teste inicial revela o cenário que a equipe executou. Se esse teste cobria apenas confirmação tardia, a revisão pode acrescentar um caso de status fora de ordem. O repositório recebe o novo vínculo e a validade da evidência fica associada à versão considerada.

Fluxograma de revisão após um incidente. A comparação entre os testes existentes e o ocorrido mostra onde registrar uma nova evidência.

Figura 3. Fluxograma de revisão após um incidente. A comparação entre os testes existentes e o ocorrido mostra onde registrar uma nova evidência.

Eu mediria a capacidade de recuperar informação em um exercício curto. Peça a uma pessoa de outra equipe que encontre em 15 minutos o responsável pelo status, o contrato e o resultado do teste aplicável. Se ela encontrar duas versões sem indicação de vigência, corrija a regra de publicação. Se precisar pedir acesso a dados sensíveis para ler a evidência de conformidade, separe o sumário acessível dos registros restritos e deixe o vínculo disponível para pessoas autorizadas. Esses resultados orientam a manutenção do repositório e ajudam a justificar o esforço.

Dê um ciclo de vida ao conteúdo

Eu trataria uma decisão revogada como informação histórica que ainda explica casos antigos. A página inicial pode apresentar a decisão atual e apontar para a anterior com a data em que cada uma passou a valer. Materiais de referência precisam informar onde podem ser reaproveitados. Um exemplo de integração para contas pessoais pode depender de regras diferentes das de um produto empresarial. Eu marcaria as condições de aplicação e o responsável pela revisão. Assim, a próxima equipe consegue partir de um registro útil e verificar se ele serve ao seu contexto. A publicação de uma nova versão deve atualizar os vínculos que as pessoas usam para chegar ao material.

Visão geral do padrão TOGAF · Modelos de entregáveis do The Open Group

Comece a revisão com duas perguntas que parecem iguais

Eu pergunto primeiro o que valia no dia da implantação. Quero identificar a regra publicada para aquele produto e grupo de clientes, o artefato que descreve sua realização e a pessoa que tinha autoridade para aprovar a versão. Depois pergunto o que existia no momento em que a aprovação foi registrada. As duas datas podem se separar. Uma evidência anexada depois de uma investigação explica o que um ambiente de teste conseguiu reproduzir naquela ocasião, enquanto o registro original mostra com que informação alguém assumiu o risco da entrega. Eu manteria as duas respostas mesmo quando a segunda é desconfortável.

Para saber o que valia, eu preciso de um fato de produção com identificação da versão realmente implantada. Um manifesto da aplicação, o digest da imagem ou o registro de entrega podem dar esse vínculo. No banco de exemplo, a implantação azul ainda atende parte do tráfego enquanto a verde começa a receber pedidos. Eu consultaria também a atribuição de tráfego no intervalo da falha. Se seis pedidos passaram pela versão antiga e seis pela nova, uma página que diz apenas «versão atual» reduz dois acontecimentos operacionais a um só. A distinção muda a investigação. Uma divergência compartilhada pode estar no produtor da confirmação. Uma divergência concentrada nos consumidores novos pode estar na conversão do status.

Para saber com que informação a decisão foi tomada, eu sigo o identificador do registro de governança até os testes, exceções e revisores que a sustentaram. Uma exceção tem condição de uso e prazo. Se foi concedida para um piloto de 200 pedidos durante o horário comercial, sua existência não explica uma implantação que assume o tráfego geral às dez da noite. Eu escreveria o escopo de modo que outra pessoa consiga fazer essa comparação. Também guardaria quem aceitou o risco residual e a data de avaliação da remoção do desvio. Um vínculo entre exceção e versão impede que o carimbo fique flutuando entre projetos, reutilizável sempre que um prazo aperta.

Penso nos identificadores como o primeiro entregável que a equipe produz para o futuro. Preciso de um identificador estável para o requisito e de outro para sua revisão concreta. O primeiro permite perguntar quem continua dependente da confirmação. Com o segundo consigo saber se a regra exigia resposta do core ou uma confirmação de processamento já reconciliada. Essa diferença aparece quando a organização avança. A ligação de uma entrega aprovada com a revisão específica permite explicar o passado mesmo que a regra de hoje seja mais exigente. Para mudar a regra, eu crio uma revisão com data e referência à anterior, e abro o trabalho necessário para atualizar as integrações dependentes.

Leve o requisito até o ponto onde ele poderia falhar

Eu escreveria o requisito em uma frase que permita a uma pessoa dizer que foi violado. «Só mostrar ativa após confirmação do core para a solicitação correlacionada» dá um produtor autorizado, uma pré-condição e a identidade do efeito. Acrescentaria o que fazer quando a confirmação fica incerta e quando duas confirmações contraditórias chegam com minutos de diferença. Essa parte merece um artefato próprio, uma matriz de transições. Nela cada linha declara o estado anterior, o evento, a fonte autorizada, o efeito e a regra de rejeição. Uma sequência complementa a matriz quando a ordem de chegada dos eventos precisa aparecer. Os dois têm link para a revisão aprovada do requisito.

A arquitetura de referência entra quando eu quero que o conhecimento sobreviva àquela entrega. Posso preservar um bloco arquitetural chamado Confirmar efeito externo. Ele descreve uma responsabilidade, a condição de validade de uma confirmação e o comportamento diante de estados incertos. Em uma solução concreta, essa responsabilidade combina o evento persistido pelo core, o adaptador e a consulta conciliatória. Quando a aplicação de cartões considera reutilizar o padrão, eu lhe dou também os limites do exemplo. Um comando de emissão pode criar um efeito diferente do comando de bloqueio, e a confirmação de cada fluxo vem de autoridades distintas. O bloco ajuda a formular a pergunta de reúso e a preservar o que permanece verdadeiro entre os fluxos.

Para medir se os artefatos ajudam, invento um segundo cenário. O lote de confirmação ficou retido numa janela de manutenção. Por alguns minutos, o cache do canal exibiu uma marca de ativação herdada de outra tentativa da mesma pessoa. Se eu tivesse apenas o desenho feliz, encontraria três setas corretas e nenhuma pista de que a identidade da tentativa foi perdida. Eu pediria um teste que envia duas solicitações para o mesmo cliente fictício com identificadores distintos, atrasa a confirmação da primeira e verifica o estado da segunda. A matriz de transições diz qual chave precisa acompanhar a confirmação. A sequência mostra onde o status cruza a fronteira do cache. O teste amarra os dois à falha que eu preciso evitar.

Eu investiria cedo na autoria da evidência. Uma captura de tela pode mostrar que uma interface cumpriu a instrução uma vez. A informação útil para a próxima revisão inclui a construção testada, a configuração, o contrato usado, os dados preparados, o cenário e o resultado bruto protegido adequadamente. Se o endereço daquele resultado expira em trinta dias, o repositório precisa fixar a retenção mínima que a equipe combinou com governança ou registrar um resumo verificável fora da área temporária. Eu manteria o resumo sem documentos de clientes e indicaria a trilha para a pessoa que tem autorização de seguir a investigação. Isso permite treinar a recuperação do material sem espalhar dados pessoais pelo catálogo de arquitetura.

Use uma consulta para descobrir qual cenário ficou por provar

Eu uso SQLite em memória para tornar o exemplo repetível. No cenário, duas construções implementam revisões do requisito. Para a segunda construção, a evidência de evento fora de ordem foi registrada um dia depois da aprovação. Outro teste da mesma construção cobre a confirmação tardia corretamente, e a versão anterior tem os dois testes. Minha regra local de governança pede que os cenários obrigatórios tenham resultado aprovado para a mesma construção e revisão, conhecido até o instante da aprovação. O exemplo usa timestamps UTC de formato fixo e dados fictícios. Em um sistema real eu armazenaria instantes com tipo apropriado e associaria o resultado ao ambiente aplicável.

import sqlite3 repositorio = sqlite3.connect(":memory:") repositorio.executescript(""" PRAGMA foreign_keys = ON; CREATE TABLE cenario_obrigatorio ( requisito TEXT, revisao INTEGER, cenario TEXT, PRIMARY KEY (requisito, revisao, cenario) ); CREATE TABLE aprovacao ( entrega TEXT PRIMARY KEY, construcao TEXT NOT NULL, requisito TEXT NOT NULL, revisao INTEGER NOT NULL, registrada_em TEXT NOT NULL ); CREATE TABLE evidencia ( id INTEGER PRIMARY KEY, construcao TEXT NOT NULL, requisito TEXT NOT NULL, revisao INTEGER NOT NULL, cenario TEXT NOT NULL, registrada_em TEXT NOT NULL, resultado TEXT NOT NULL CHECK (resultado IN ('passou', 'falhou')), FOREIGN KEY (requisito, revisao, cenario) REFERENCES cenario_obrigatorio (requisito, revisao, cenario) ); INSERT INTO cenario_obrigatorio VALUES ('ativacao-oficial', 1, 'confirmacao_tardia'), ('ativacao-oficial', 1, 'evento_fora_de_ordem'), ('ativacao-oficial', 2, 'confirmacao_tardia'), ('ativacao-oficial', 2, 'evento_fora_de_ordem'); INSERT INTO aprovacao VALUES ('azul', 'sha256:construcao-1', 'ativacao-oficial', 1, '2026-11-09T15:00:00Z'), ('verde', 'sha256:construcao-2', 'ativacao-oficial', 2, '2026-11-16T15:00:00Z'); INSERT INTO evidencia VALUES (1, 'sha256:construcao-1', 'ativacao-oficial', 1, 'confirmacao_tardia', '2026-11-09T12:00:00Z', 'passou'), (2, 'sha256:construcao-1', 'ativacao-oficial', 1, 'evento_fora_de_ordem', '2026-11-09T12:00:00Z', 'passou'), (3, 'sha256:construcao-2', 'ativacao-oficial', 2, 'confirmacao_tardia', '2026-11-16T13:00:00Z', 'passou'), (4, 'sha256:construcao-2', 'ativacao-oficial', 2, 'evento_fora_de_ordem', '2026-11-16T13:00:00Z', 'falhou'), (5, 'sha256:construcao-2', 'ativacao-oficial', 2, 'evento_fora_de_ordem', '2026-11-17T13:00:00Z', 'passou'); """) consulta = """ SELECT a.entrega, c.cenario, COALESCE(( SELECT e.resultado FROM evidencia e WHERE e.construcao = a.construcao AND e.requisito = c.requisito AND e.revisao = c.revisao AND e.cenario = c.cenario AND e.registrada_em <= a.registrada_em ORDER BY e.registrada_em DESC, e.id DESC LIMIT 1 ), 'ausente') AS estado_na_aprovacao FROM aprovacao a JOIN cenario_obrigatorio c ON c.requisito = a.requisito AND c.revisao = a.revisao ORDER BY a.entrega, c.cenario """ estados = repositorio.execute(consulta).fetchall() pendencias = [linha for linha in estados if linha[2] != "passou"] assert pendencias == [("verde", "evento_fora_de_ordem", "falhou")] repositorio.execute("DELETE FROM evidencia WHERE id = 4") estados = repositorio.execute(consulta).fetchall() pendencias = [linha for linha in estados if linha[2] != "passou"] assert pendencias == [("verde", "evento_fora_de_ordem", "ausente")] repositorio.close() 

O último teste executado até a aprovação é o que aparece para cada par de entrega e cenário. O exemplo também controla o caso de ausência por meio de uma segunda execução sobre os dados fictícios em memória. Eu aceito que a hipótese testada para a decisão local é pequena. Se um cenário tiver evidências contraditórias em ambientes diferentes, preciso de um vínculo de aplicação e de uma regra para lidar com a divergência. Se uma execução é repetida até passar sem explicação, eu quero ver o histórico de falhas e as condições das repetições. O relatório de pendências encaminha uma pergunta para o revisor. Ele aponta onde começar a investigação, sem precisar recuperar o log integral antes de olhar para a ressalva.

Existe uma distinção que eu explicitaria na revisão entre hora de execução, hora de registro e hora de validade. Na hipótese da entrega verde, a execução poderia até ter acontecido no dia anterior, mas o resultado foi registrado depois da aprovação e não existe confirmação de que a pessoa revisora o consultou. Se a organização admite evidências de outras ferramentas, eu manteria também um identificador da aprovação e a lista de provas que foram conferidas, com versões e condições de escopo. A consulta aponta aquilo que era recuperável na fonte modelada. O vínculo com a deliberação permite dizer o que foi efetivamente examinado. As duas coisas interessam quando precisamos aprender com uma liberação apressada.

Verifique os vínculos que mudam quando a posse do trabalho muda

No início do piloto, eu poderia manter o registro no mesmo projeto que desenvolve a integração. A equipe atualiza o diagrama, aprova o contrato e consulta o relatório de teste com as permissões padrão da ferramenta. O desenho começa a cobrar sua dívida quando outro time assume o adaptador. O caminho que parecia curto depende das mesmas pessoas continuarem na área, conhecerem o nome antigo do serviço e terem acesso ao projeto desativado. Eu anteciparia essa transferência com uma rotina simples. Cada registro relevante tem um responsável pelo conteúdo, um responsável pelo controle de acesso e uma forma conhecida de recuperar a versão fixada após a mudança de equipe. Às vezes uma única pessoa responde pelos três. Escrever os papéis mostra quem pode resolver cada perda durante a transferência.

Na minha mesa, eu compararia duas propostas de armazenamento. A primeira copia documentos para um acervo central a cada implantação. A segunda guarda versões e referências fixas para as fontes originais, com um resumo mínimo que ajuda a encontrar os registros. A cópia aumenta as chances de manter o material quando uma ferramenta é desligada. Também abre a possibilidade de divergir da matriz oficial se alguém editar só a duplicata. A referência fixa preserva a origem e reduz republicação. Ela depende da retenção e da permissão nas fontes. Eu escolheria para cada artefato em função do prazo de recuperação esperado. Para o teste de homologação do piloto, talvez eu preserve o resumo com versão e resultado por um ciclo maior que o log temporário. Para a regra de autorização, eu preservaria também o histórico completo sujeito às permissões que a área já aplica.

Quando alguém me pergunta por onde automatizar, eu começaria pelas relações cuja quebra tenho como detectar. Antes de aprovar a entrega verde, um passo de integração contínua poderia confirmar que a revisão existe, que há uma matriz de estados associada e que o conjunto de cenários bloqueantes foi registrado para aquela construção. Outra checagem periódica mede referências indisponíveis. A falha que exige acesso especializado segue para o responsável definido no catálogo. A falha que revela endereço desativado vira tarefa de manutenção com uma data. Eu acompanharia a proporção de referências que um revisor consegue abrir com o perfil previsto. Essa medida dá à área de arquitetura um sinal sobre manutenção e à área dona da ferramenta uma maneira de verificar se alterações de permissão quebraram as revisões.

No experimento hipotético, o prazo de liberar o novo canal coincide com a mudança de time proprietário do adaptador. Eu incluiria no critério de passagem a reconstrução de um caso por alguém do time que vai receber a solução. Essa pessoa localiza a matriz que governa o estado, aponta o hash da entrega que testou a regra e identifica o canal pelo qual abriria uma exceção. Se precisar que a equipe antiga envie qualquer um desses dados, a transferência ainda depende de informação tácita. Posso financiar uma hora para corrigir os vínculos enquanto ambas as equipes trabalham juntas. No dia em que cada uma estiver atendendo um incidente, essa hora deixa de caber na agenda. Prefiro que o custo de manutenção apareça enquanto posso escolher quem o assume.

Dê ao repositório um dono e uma pergunta de renovação

A primeira página que eu criaria para a área teria uma busca pelas perguntas mais repetidas. «Quem pode dizer que está ativa?» aponta para o requisito, o catálogo de estados e a autoridade de decisão. «Qual versão falhou?» aponta para o histórico de implantação e a regra de distribuição de tráfego. «Por que ela entrou?» aponta para a aprovação ou exceção e para a evidência disponível. Todas essas páginas citam as fontes autorizadas, com caminhos que uma rotação de equipe possa manter. A busca reduz o custo de entrada de gente nova e deixa visíveis os vazios de informação. Se uma página se torna grande demais, eu meço onde as pessoas param de encontrar o próximo vínculo.

Para manter os registros, eu seleciono duas condições de atualização. Há mudança planejada quando um contrato, uma responsabilidade ou a vigência do requisito muda. A entrega traz as referências revisadas, valida se os consumidores foram associados à versão certa e marca os registros que continuam explicando ocorrências antigas. Há descoberta durante um incidente quando uma equipe observa um cenário que os artefatos ignoravam. Nesse caso a investigação identifica o escopo a corrigir, marca a data em que descobriu o problema e cria a evidência necessária. A inclusão de um cenário obrigatório tem vigência própria. Assim, o reporte pode mostrar por que as mesmas provas eram suficientes sob uma regra anterior e deixam de ser sob a que aprovo hoje.

Em uma simulação de passagem de plantão, eu convidaria uma pessoa que nunca trabalhou no adaptador a reconstruir o percurso. Eu entregaria só o identificador anonimizado de uma solicitação fictícia, a hora aproximada e a mensagem mostrada ao cliente. Peço que ela localize a versão que recebeu o pedido, a autoridade para mudar o status e os cenários obrigatórios que a entrega tinha de satisfazer. Anoto onde faltou acesso, onde o identificador mudou e onde houve necessidade de perguntar no chat. A próxima melhoria do repositório vem dessa busca, com um responsável e uma prova de que a próxima pessoa consegue recuperar o caminho.

De volta às doze solicitações da abertura, eu pediria ao canal que mantivesse a comunicação compatível com a confirmação oficial enquanto o incidente é reconciliado. Usaria a versão, o contrato e os cenários recuperados para decidir a extensão da interrupção e para identificar casos que a equipe de atendimento precisa localizar. Depois registraria quais informações resolveram a dúvida e quais só apareceram depois. O repositório passa a valer para mim quando alguém consegue tomar essa decisão numa manhã ruim, com informação suficiente para mostrar a outro time como chegou a ela.

Referências

A preparação do texto e a criação das ilustrações tiveram apoio de IA generativa.