Fonte Única da Verdade: Sistemas no Nível da Organização que Você Define Uma Vez e Usa em Todo Lugar

Aqui está um padrão que aparece em toda organização a partir de um certo tamanho. A Equipe A documenta sua arquitetura. Eles adicionam uma caixa para o Serviço de Autenticação — nome, descrição, stack tecnológico. A Equipe B faz a mesma coisa no seu projeto. A Equipe C também. Três projetos, três definições separadas do mesmo sistema, cada uma ligeiramente diferente. Uma diz "Auth Service", outra diz "Authentication Platform", a terceira diz "Identity Provider." Mesmo sistema. Três nomes. Três descrições que enfatizam coisas diferentes. Sem conexão entre elas.

Seis meses depois, a equipe de autenticação renomeia o serviço e atualiza seu stack tecnológico. A mudança se propaga para zero desses três diagramas. A versão da realidade de cada projeto silenciosamente diverge do sistema real e uma da outra.

Este é o problema da consistência. Não vem de negligência. Vem de ferramentas de arquitetura que tratam cada projeto como uma ilha. Se a única forma de representar um sistema é criá-lo dentro de um projeto, então cada projeto que toca esse sistema tem sua própria cópia. Cópias divergem. É o que cópias fazem.

Construímos sistemas no nível da organização para corrigir isso.

Sistemas Que Pertencem à Organização, Não a um Projeto

O Archyl agora suporta dois escopos para sistemas C4. Sistemas com escopo de projeto funcionam exatamente como antes — pertencem a um único projeto e vivem no diagrama daquele projeto. Sistemas com escopo de organização pertencem à sua organização. Existem independentemente de qualquer projeto, e qualquer projeto pode vinculá-los.

A distinção importa porque espelha como a arquitetura real funciona. Alguns sistemas são internos a um projeto. Mas muitos sistemas cortam fronteiras de projeto — infraestrutura compartilhada, serviços de plataforma, integrações de terceiros, capacidades de negócio centrais das quais múltiplas equipes dependem. Esses pertencem à organização.

Quando você cria um sistema no nível da organização, está fazendo uma declaração: este sistema é uma realidade compartilhada. Seu nome, descrição, tecnologia e tags são definidos uma vez. Todo projeto que o referencia vê a mesma definição.

Como Funciona

Criando Sistemas da Organização

Sistemas da organização são criados a partir de uma seção dedicada na plataforma. Você define o sistema da mesma forma que faria em um projeto — nome, descrição, tipo, tecnologia e tags. A diferença é que não está vinculado a nenhum projeto. Vive no nível da organização, visível para toda equipe.

Vinculando Sistemas a Projetos

Quando você está trabalhando em um diagrama de projeto e quer referenciar um sistema da organização, você o vincula. Um modal mostra todos os sistemas da organização disponíveis com busca. Selecione os que precisa — eles aparecem no seu diagrama imediatamente.

Sistemas vinculados se comportam como sistemas nativos no diagrama. Você pode posicioná-los onde fizer sentido para o layout daquele projeto. A única diferença é que a identidade central do sistema — nome, descrição, tecnologia — vem da definição da organização, não do projeto.

Desvinculando

Se um projeto não depende mais de um sistema compartilhado, desvincule-o. O sistema desaparece do diagrama do projeto mas continua existindo no nível da organização e em todo outro projeto que o referencia.

Por Que Isso Importa

Consistência Sem Coordenação

Sistemas no nível da organização tornam a consistência estrutural. Há uma definição. Projetos a referenciam. Quando alguém atualiza a descrição ou stack tecnológico do sistema, todo projeto vinculado reflete a mudança automaticamente.

Dependências Precisas Entre Projetos

Quando múltiplos projetos vinculam-se ao mesmo sistema da organização, a plataforma conhece essas conexões. O Radar de Impacto pode rastrear dependências através de sistemas da organização entre fronteiras de projeto.

Onboarding e Descoberta

Novos membros da equipe veem os mesmos nomes de sistema, descrições e labels de tecnologia que todo outro projeto usa.

Redução de Duplicação

Ao invés de cada projeto documentar independentemente a mesma infraestrutura, você define cada um uma vez. Projetos os vinculam em segundos.

O Quadro Maior

Esta funcionalidade é parte de uma direção mais ampla: fazer o Archyl funcionar da forma como as organizações realmente funcionam. Arquitetura não é uma coleção de projetos independentes. É uma rede de sistemas compartilhados, capacidades de plataforma e preocupações transversais.

Sistemas no nível da organização são o primeiro passo em direção a um modelo onde infraestrutura compartilhada é documentada uma vez e referenciada em todos os lugares. Combinado com a visualização de Arquitetura Global e o Radar de Impacto, você agora tem uma plataforma que entende sua arquitetura como um todo conectado.

Começando

Sistemas no nível da organização estão disponíveis agora. Vá à seção da organização, crie seus sistemas compartilhados, depois vincule-os a qualquer projeto pela visualização de diagrama.

Sua arquitetura tem uma fonte única da verdade. Sua documentação também deveria.

Para mais sobre arquitetura entre projetos, veja Arquitetura Global e Colaboração em Tempo Real. Para entender como mudanças em sistemas compartilhados se propagam, experimente o Radar de Impacto. Para mudanças governadas em sistemas compartilhados, explore Solicitações de Mudança de Arquitetura.