Fotografia de maquete de inspiração construtivista, com sombras oblíquas. Uma esfera bicolor está no início de um canal transparente que sobe até uma porta iluminada. O canal dá forma ao caminho que eu percorro de um objetivo ao serviço e ao componente que o sustenta.
Parte 1 de 13 da série Referenciais complementares. Nesta série, vamos escolher ferramentas de arquitetura e gestão a partir da decisão que cada uma ajuda a esclarecer.
Eu começaria esta leitura com a pergunta que faria quando o fornecedor de identidade anunciasse uma troca no formato de resposta. Se eu mudar o componente que interpreta esse formato, qual compromisso com o cliente preciso testar de novo? As respostas podem vir de pessoas que usam palavras diferentes para as mesmas partes do serviço. Uma pessoa vai falar do adaptador. Outra, da fila manual. Outra, da mensagem que a cliente recebe. Quero conseguir levar as três até a mesma decisão e mostrar por que uma mudança na integração chega tão perto do prazo de abertura.
Nesta parte da série sobre referenciais complementares, eu uso ArchiMate para vincular o objetivo de um banco hipotético às camadas de negócio, aplicação e tecnologia. Mostro como eu mantenho os elementos identificáveis quando cada área precisa de um recorte diferente, como sigo uma relação de volta ao requisito e como uma transição preserva os casos que já entraram. Uso Mermaid para dar uma leitura acessível às relações e descrevo onde eu consultaria a notação do padrão para manter o modelo formal.
Um banco de varejo hipotético quer reduzir de cinco para um dia útil a abertura de contas correntes elegíveis. Produto enxerga uma jornada. Operações enxerga filas e passagens entre equipes. A equipe de soluções enxerga o aplicativo de abertura, as integrações de identidade e o sistema bancário central. Cada visão descreve uma parte da mudança.
ArchiMate oferece uma linguagem de modelagem comum para essas visões. Os elementos de motivação permitem representar objetivos e requisitos. As camadas centrais cobrem negócio, aplicação e tecnologia. Os pontos de vista ajudam a selecionar a parte do modelo necessária para uma decisão. The Open Group sobre modelagem e pontos de vista em ArchiMate
Fotogravura em tom de cobre. Engrenagens sustentam um escudo, uma credencial e uma lente que enquadra um pórtico. Cada elemento mostra uma função própria. Na vista ArchiMate, as relações tornam possível acompanhar como essas funções sustentam a promessa.
Conecte a promessa aos serviços que a entregam
Eu partiria do objetivo de reduzir o prazo e de um requisito de um dia útil para as solicitações elegíveis. Na camada de negócio, representaria o processo que avalia a elegibilidade e abre a conta, os papéis que tratam exceções e o serviço que o cliente recebe. Na camada de aplicação, identificaria os serviços que apoiam a validação de evidências, o fluxo de trabalho e a abertura. Na camada de tecnologia, mostraria as dependências, como mensageria gerenciada e monitoramento operacional.
Uma decisão importante é onde registrar o evento de disponibilidade. Se o sistema central criou a conta mas a pessoa ainda não consegue usá-la, o estado desse sistema é apenas uma parte da confirmação. O modelo deve mostrar essa dependência e identificar o papel de negócio que define quando a conta está disponível.
O Mermaid abaixo é um guia visual simplificado. Em uma ferramenta ArchiMate, eu usaria os tipos de elementos e relacionamentos permitidos. Um serviço de aplicação pode servir a um processo de negócio, por exemplo. Uma função de aplicação pode realizar um serviço de aplicação. Introdução da comunidade ArchiMate do The Open Group
Figura 1. Mapa de relações inspirado em ArchiMate. Siga como o objetivo chega ao processo e como serviços de aplicação e tecnologia apoiam a entrega da evidência.
Use as visões para revisar mudanças
Para quem patrocina o produto, eu mostraria o objetivo, o requisito, o serviço ao cliente e as evidências do resultado. Essa visão apoia a decisão sobre o cumprimento da promessa. Para Operações, mostraria o caminho de revisão manual, quem o atende e quais eventos são emitidos em cada passagem. Para Soluções, detalharia as dependências entre o fluxo de abertura, a verificação de identidade e a criação da conta.
Se o banco trocar o fornecedor de verificação de identidade, o modelo permite seguir o serviço de aplicação afetado até o processo de elegibilidade, a fila de exceções e o requisito de prazo. A equipe consegue perguntar se a mudança altera a quantidade de revisões manuais e quais testes devem ser repetidos.
Selecione os relacionamentos que sustentam decisões reais, atribua um responsável a cada visão e atualize-a quando o desenho mudar. O modelo pode assim apoiar a aprovação e continuar útil após o lançamento.
Monte um recorte para quem precisa aprovar a mudança
Eu começaria pelo requisito de abrir contas elegíveis em um dia útil e pela área que responde pelo resultado. Em uma vista de motivação, registraria o objetivo, os requisitos que o tornam verificável e as preocupações das partes interessadas. Produto precisa comunicar o estado da solicitação. Risco precisa reconstruir decisões. Operações precisa enxergar a fila e agir quando há atraso. A vista mostra quais preocupações entram na discussão sem exigir que todo mundo revise o mapa de sistemas.
Depois eu prepararia um recorte para a decisão sobre troca de fornecedor de identidade. O processo de verificar uma solicitação usa o serviço de verificação. A função que interpreta a resposta do fornecedor realiza o serviço apresentado ao processo. A referência às evidências deve continuar disponível para a operação. Se o problema em análise for o formato da resposta, basta evidenciar a fronteira do componente que traduz os dados externos e a informação que os consumidores precisam receber.
Figura 2. Mapa de relações entre negócio e aplicação. Observe que o processo é atendido pelo serviço e que a função que interpreta a resposta realiza esse serviço.
O diagrama acima ilustra um recorte de rastreabilidade. Em uma ferramenta de ArchiMate, eu confirmaria quais relacionamentos são válidos para cada par de elementos e usaria a notação apropriada. A versão de revisão pode mostrar as relações que respondem à pergunta, enquanto o modelo mantém o detalhe que outra área precisa consultar. Os identificadores dos elementos permitem reconhecer a mesma função ou o mesmo requisito em visões diferentes.
Use estados intermediários para discutir a substituição
Suponha que o banco possa enviar novas verificações ao fornecedor novo, mas ainda tenha 300 solicitações em andamento no fornecedor atual. Eu representaria a convivência como um estado intermediário. O pacote de trabalho dessa transição inclui seleção de rota, consulta aos dois fornecedores e acompanhamento da fila antiga. A retirada do primeiro fornecedor depende de confirmar que os casos em andamento foram concluídos ou encaminhados com evidência preservada.
Figura 3. Fluxograma da Arquitetura de Transição. Observe a verificação de casos e evidências durante a coexistência antes de considerar o fornecedor antigo retirado.
Eu levaria ao comitê uma tabela com o objetivo, a mudança, os elementos afetados e os critérios de passagem. Por exemplo, acompanhar a proporção de casos encaminhados para revisão após a troca ajuda a verificar se o fornecedor novo altera a demanda de Operações. Uma amostra de evidências recuperadas mostra se Risco ainda consegue reconstruir o resultado. As duas observações podem mudar a data de expansão mesmo quando o prazo técnico da integração é cumprido. Eu ligaria cada condição ao artefato onde a equipe mantém o resultado. Um aprovador consegue localizar a regra e o responsável. Uma pessoa de Operações consegue encontrar qual evento atualizará a fila. As duas trabalham com visões diferentes e referências aos mesmos elementos.
Dê nomes diferentes ao que as equipes pedem e ao que as aplicações fazem
Diante de um desenho inicial, eu separaria o serviço que a área de negócio consome da função que o realiza. No exemplo, o processo de verificar uma solicitação obtém uma avaliação de identidade de um serviço de aplicação. Uma função interpreta a resposta externa e ajuda a realizar esse serviço. O fornecedor remoto pode mudar enquanto o mesmo serviço preserva o sentido da resposta para o consumidor. Se a função de tradução falhar, porém, o processo deixa de receber a informação que usava para aplicar a política. Dar nome aos dois níveis me permite localizar qual parte da mudança precisa atravessar a fronteira.
Também pergunto qual papel decide que a conta já está disponível. O componente pode armazenar um código de ativação. A equipe de Produto pode basear a mensagem em outra evidência, como a conclusão da verificação de disponibilidade no canal. Posso ligar a função a um serviço de dados e ainda faltar um requisito que diga qual evento autoriza o anúncio. No recorte de motivação, tento colocar esse requisito ao lado da preocupação que lhe dá origem. Quando uma equipe abrir apenas a vista técnica, o identificador permanece disponível para buscar a definição acordada.
Às vezes a primeira versão do mapa coloca toda a jornada numa caixa chamada onboarding. Eu deixaria esse nome na vista de contexto se ele ajudar a conversa, mas pediria um recorte com fronteiras mais precisas para decidir sobre o fornecedor. O processo admite pedidos, verifica elegibilidade, trata exceções e confirma disponibilidade. A substituição afeta primeiro a verificação de identidade. Ela pode alcançar outras partes se mudar a taxa de encaminhamento ou a capacidade de recuperar evidências. Uma vista útil para essa decisão mostra como o impacto chega a cada fronteira e onde ainda é uma hipótese.
Fotograma de inspiração dadaísta com tratamento azul. A silhueta de uma ampulheta se sobrepõe à de uma engrenagem, uma campainha e dois cartões. O recorte coloca em primeiro plano os elementos que a pessoa precisa examinar para aprovar uma mudança.
Persiga as relações em direções diferentes
Quando olho um modelo na reunião, tento dizer em voz alta o verbo de cada relação. A função realiza o serviço. O serviço serve ao processo. A pergunta sobre impacto percorre a cadeia da alteração rumo aos consumidores. A pergunta de rastreabilidade parte da promessa e procura o que contribui para que ela se cumpra. É fácil usar uma seta para os dois sentidos e deixar a pessoa seguinte decidir o que ela queria dizer. Um modelo tipado me ajuda a preservar o sentido mesmo quando o desenho mostra um pedaço diferente para cada público.
No banco hipotético, eu prepararia uma vista para Produto que começasse no prazo e chegasse ao serviço que recebe a solicitação. Para a equipe de aplicação, eu mostraria a função de interpretação, o serviço que ela realiza e o contrato que entrega evidências. A vista de tecnologia iria até a mensageria e os elementos de implantação que têm efeito sobre a disponibilidade. As três vistas podem se referir à mesma verificação por um identificador. Se duas equipes derem nomes diferentes à função, eu usaria o identificador para conservar a referência e decidir se os nomes descrevem o mesmo elemento.
Numa revisão, a palavra impacto pode encobrir três coisas. Um consumidor depende mesmo do resultado da função. Outro apenas compartilha um recurso tecnológico e deve ser observado se houver aumento de carga. Um terceiro elemento aparece perto da função porque os dois pertencem à mesma equipe. Para decidir que testes repetir, trato essas pistas com pesos diferentes. Se eu seguir indiscriminadamente todas as arestas de associação, consigo provar que tudo se conecta a tudo e perco a capacidade de explicar por que um teste entrou na fila. Para a decisão do fornecedor, escolho relações explícitas com uma interpretação registrada.
Liste os testes a partir de uma travessia pequena
Neste exemplo sintético, guardo relações tipadas e uma projeção de dependências específica para a revisão de impacto. As relações de realização e serviço mantêm a direção que a equipe usa na modelagem. A ligação de evidência ao requisito é uma regra do repositório do exemplo. Para uma ferramenta ArchiMate, eu verificaria a relação formal apropriada e manteria a consulta editorial separada das regras de validação do padrão.
from collections import defaultdict, deque
from dataclasses import dataclass
@dataclass(frozen=True)
class Relação:
origem: str
tipo: str
destino: str
def impactos(relações: list[Relação], alterado: str) -> dict[str, tuple[str, ...]]:
adjacências = defaultdict(list)
tipos_navegados = {
"realiza", "serve", "contribui para o requisito", "verificado por"
}
for relação in relações:
if relação.tipo in tipos_navegados:
adjacências[relação.origem].append(relação.destino)
caminhos = {alterado: (alterado,)}
fila = deque([alterado])
while fila:
origem = fila.popleft()
for destino in adjacências[origem]:
if destino not in caminhos:
caminhos[destino] = (*caminhos[origem], destino)
fila.append(destino)
return caminhos
modelo = [
Relação("FUN-VERIF", "realiza", "APP-VERIF"),
Relação("APP-VERIF", "serve", "NEG-ELEG"),
Relação("NEG-ELEG", "contribui para o requisito", "REQ-PRAZO"),
Relação("NEG-ELEG", "contribui para o requisito", "REQ-EVID"),
Relação("REQ-PRAZO", "verificado por", "TESTE-PRAZO"),
Relação("REQ-EVID", "verificado por", "TESTE-RISCO"),
Relação("APP-VERIF", "associado a", "APP-RELATORIO"),
]
resultado = impactos(modelo, "FUN-VERIF")
assert resultado["TESTE-RISCO"] == (
"FUN-VERIF", "APP-VERIF", "NEG-ELEG", "REQ-EVID", "TESTE-RISCO"
)
assert resultado["TESTE-PRAZO"][-2:] == ("REQ-PRAZO", "TESTE-PRAZO")
assert "APP-RELATORIO" not in resultado
O caminho que sai da consulta é uma justificativa preliminar. Ele mostra quais relações conhecidas ligam a função a um teste de evidência. Se o negócio confirmar que a evidência exigida ficou igual, ainda pode ser preciso repetir o ensaio para demonstrar a preservação do comportamento. Se um requisito não aparece, eu verificaria se a ligação realmente não existe ou se o repositório está incompleto. A ausência de um caminho só ganha valor quando a equipe conhece a cobertura do modelo para aquela mudança.
No exemplo, a consulta preserva o primeiro caminho encontrado. Se houver mais de uma rota, posso precisar acompanhar a trajetória pela fila manual e também pela mensagem do canal. As duas podem chegar ao mesmo requisito por motivos distintos. Numa implementação, eu registraria as relações que explicam cada efeito relevante, sem enumerar ciclos indefinidamente. Para a reunião desta semana, começaria com um recorte pequeno e pediria às pessoas que cuidam dos dois fluxos que apontassem a dependência faltante. Essa revisão costuma melhorar o modelo mais do que estender o mapa para todas as aplicações.
Modele o que permanece em cada estado da transição
Na substituição do fornecedor, eu desenharia três estados com a mesma referência para o processo e para o serviço. No estado atual, um único fornecedor recebe verificações. No intermediário, casos novos podem ir para o destino novo enquanto as consultas antigas continuam na rota anterior. No alvo, a operação usa o fornecedor novo e preserva um meio de consultar evidências antigas pelo tempo definido. Essa escolha deixa visível o que muda entre os estados e impede que cada desenho seja lido como um sistema independente.
Na arquitetura intermediária, o identificador da solicitação referencia o resultado emitido pelo fornecedor que o recebeu. Se a rota passa a depender de uma configuração ativa, uma consulta a um pedido anterior não pode escolher o destino olhando só a configuração do dia. Eu pediria três amostras à equipe. Uma foi concluída integralmente no destino antigo. Outra entrou na véspera da troca e precisa de consulta depois do corte. A terceira entrou na rota nova durante uma interrupção. Eu colocaria as três ao lado da vista e seguiria a atividade que alguém precisa exercer em cada caso.
O fornecedor anterior pode permitir consultar registros por um período menor que o prazo usado pelo banco para investigar decisões. Se detecto essa diferença, adiciono uma lacuna na transição. A equipe precisa acertar se dará continuidade à consulta contratual ou se manterá um conjunto de evidências no repositório que controla. O pacote de trabalho passa a conter uma ação verificável e um evento que autoriza encerrar a convivência. No diagrama, eu ligaria essa condição ao estado em que o novo fornecedor entra sozinho. No relatório de aceite, preservaria quem consegue produzir a evidência de transição.
Posso ter um objeto no modelo chamado evidência de verificação e duas representações concretas ao longo da transição. Uma é recuperada por referência no fornecedor antigo. Outra é recebida como evento e armazenada pelo banco. Se as equipes derem o mesmo nome às duas sem descrever o contrato de recuperação, a vista de negócio continua plausível e a operação pode perder a capacidade de fazer a consulta para meia população. Eu usaria identificadores e relações que permitam saber qual forma se aplica a cada fluxo. O objetivo de negócio continua comum, com meios distintos de demonstrar cumprimento.
Escolha uma vista para cada decisão que alguém precisa tomar
Numa reunião de produto, eu abriria o objetivo, o prazo e as condições que sustentam o anúncio ao canal. Se a nova fonte produz mais casos ambíguos, a vista deve mostrar a consequência para Operações. Para planejar a implantação, acrescento a rota atribuída, o ponto de corte e as condições de coexistência. Para a revisão de risco, abro a vista com as evidências que as equipes precisam recuperar e com as ligações até as políticas usadas. São recortes de um modelo que deve ser identificado do mesmo jeito quando os stakeholders saem de uma reunião e entram em outra.
Em um projeto hipotético diferente, uma empresa de logística troca o fornecedor do sistema que reserva baias de carregamento. O serviço ao motorista é manter o horário confirmado consultável na entrada do centro de distribuição. Uma função traduz a confirmação externa para um evento interno. Se o novo fornecedor entrega um número de reserva que não aparece no documento do motorista, o processo de recepção precisa de uma consulta diferente. Eu começaria com a mesma pergunta de impacto e seguiria as relações até o atendimento na portaria e até o teste que o caminhoneiro de fato consegue executar.
Esse recorte produz um resultado diferente do banco. O compromisso que aparece no chão da operação é a chegada em um horário reservado, inclusive quando o aplicativo está indisponível. Para o teste, posso precisar de um turno em que a equipe consulta o número impresso ou o horário por outro sistema. No modelo, quero ver a relação entre a função de traduzir a confirmação e o serviço que oferece uma consulta durante a chegada. A semelhança entre os casos está na forma de investigar. O detalhe que torna a evidência válida para cada caso depende de quem usa o serviço.
Procure relações que envelhecem em silêncio
Depois que o projeto passa para Operações, eu voltaria ao modelo com um pedido que teve uma exceção. Quero ver se a referência de fornecedor ainda leva a um resultado e se os diagramas citam o serviço que a equipe usa hoje para consultar. A primeira versão pode ter gravado um link para a tela do projeto. Se a organização transferiu a consulta para outro time, o mapa precisa indicar quem responde e quais dados podem ser recuperados. Quando a condição existia só durante a coexistência, atualizar a vista evita que alguém mantenha suporte a uma interface que já deveria sair.
Uma mudança pequena pode deixar o modelo desatualizado de outro jeito. A equipe renomeia um serviço no catálogo de aplicações e cria um segundo identificador para o mesmo comportamento. A vista de Risco segue apontando para o primeiro e a de Aplicações começa a apontar para o segundo. Na próxima consulta de impacto, um requisito deixa de aparecer. Eu definiria onde a equipe registra que a identidade permanece a mesma, em que caso ela decide que há outro serviço e o que acontece com visões anteriores. Quero poder introduzir uma nomenclatura melhor sem quebrar as ligações que a operação já usa.
Para não depender de uma grande revisão, eu junto a atualização do modelo à decisão que modificou a fronteira. Quando a equipe altera o contrato de verificação, quero localizar as relações afetadas, rever os vínculos com os testes e indicar o recorte que deixa de valer. Posso fechar o trabalho com poucas mudanças, desde que a próxima pessoa consiga percorrer a relação com o mesmo identificador. Se ela precisar reunir três equipes para saber qual caixa representa o serviço novo, minha vista ainda exige trabalho.
Eu deixaria uma diferença visível entre a evidência produzida em teste e a relação que a explica no modelo. A relação se mantém enquanto a arquitetura usar a mesma função para realizar o serviço. O teste tem versão, ambiente e data. Se o serviço ganhar outra função sem perder a anterior, a consulta pode alcançar o mesmo requisito por um caminho novo. Eu gostaria de verificar quais casos foram executados para a nova configuração antes de reutilizar a evidência. Quando a janela de coexistência terminar, a equipe pode retirar a relação que deixou de existir sem apagar as referências que explicam os casos anteriores.
No fim, eu retornaria à pergunta sobre a troca do fornecedor. A equipe deve conseguir me mostrar a função alterada, o serviço que entrega a verificação e as duas condições mais expostas, preservar evidência e respeitar o prazo. Os testes mostram em que circunstâncias a promessa continua de pé. A vista de transição explica quais verificações permanecem na rota anterior. Eu gosto desse resultado porque qualquer pessoa da conversa consegue voltar ao modelo por uma pergunta sua, preservar o vínculo com as demais e apontar onde uma hipótese ainda está esperando evidência.
Referências primárias
Introdução à linguagem ArchiMate pela comunidade do The Open Group
A preparação do texto e a criação das ilustrações tiveram apoio de IA generativa.





Top comments (0)