Colaboração em Tempo Real em Diagramas C4 e Arquitetura Global

Algumas semanas atrás, lançamos a colaboração em tempo real em whiteboards. A resposta foi imediata e clara: as equipes adoraram ver os cursores uns dos outros, adoraram os indicadores de presença, adoraram assistir a arquitetura tomando forma juntas. Mas o pedido mais comum? "Podemos ter isso nos diagramas C4 também?"

Pergunta justa. Whiteboards são ótimos para brainstorming, mas a arquitetura real vive nos seus modelos C4 — os sistemas, containers, componentes e elementos de código que definem como seu software é estruturado. É onde as equipes passam a maior parte do tempo. É onde a colaboração mais importa.

Hoje, estamos fazendo acontecer. A colaboração em tempo real agora funciona em Diagramas C4 de Projeto e na visualização de Arquitetura Global.

Mesma Magia, Onde Importa

Se você usou a colaboração em whiteboard, isso vai parecer imediatamente familiar. Abra a visualização de diagrama de um projeto, e quando um colega abrir o mesmo projeto, o cursor dele aparece no seu canvas. Uma seta colorida com o nome dele deslizando pelo diagrama enquanto explora sua arquitetura.

Selecione um nó de sistema, e todos veem ele destacado com sua cor — uma borda sutil ao redor do elemento, seu nome acima dele. Seu colega seleciona um container diferente? Você vê a seleção dele na cor dele. A linguagem visual é simples: você sempre sabe quem está olhando para o quê.

A pilha de avatares aparece no canto inferior. Você vê quem está aqui. Uma notificação aparece quando alguém entra na sua sessão. Tudo simplesmente funciona.

Colaborando Entre Níveis C4

Aqui é onde as coisas ficam interessantes. Modelos C4 são hierárquicos — você pode estar trabalhando no nível de Sistema enquanto seu colega está profundo no nível de Componente de um container específico. Ambos estão editando o mesmo projeto, mas olhando para profundidades diferentes.

Rastreamos isso através de metadados. A sessão de cada colaborador carrega informação sobre qual nível C4 está visualizando no momento. Isso significa que você pode ver não apenas que Sarah está no mesmo projeto, mas que ela está trabalhando no nível de Container enquanto você está no nível de Sistema. Os indicadores de presença mantêm vocês cientes um do outro sem o ruído de mostrar cursores em uma visualização que você nem está olhando.

Quando duas pessoas estão no mesmo nível, cursores e destaques de foco aparecem naturalmente. Quando estão em níveis diferentes, a colaboração fica em segundo plano — presente mas não distrativa.

Arquitetura Global: Colaboração Entre Projetos

A visualização de Arquitetura Global mostra todos os sistemas da sua organização em um só lugar. É onde você vê o panorama geral — como projetos se conectam, onde estão as fronteiras, quais sistemas conversam entre si.

Agora você pode explorar essa visualização junto. Abra a Arquitetura Global e seus colegas veem seu cursor se movendo pela paisagem organizacional. Selecione um sistema para examiná-lo, e todos veem seu foco.

Adicionamos filtragem por escopo de visualização aqui porque a visualização de Arquitetura Global tem dois modos de profundidade — sistemas e containers. Se você está olhando a visão geral de sistemas e seu colega entrou na visualização de containers, vocês não verão os cursores um do outro. Vocês estão efetivamente em canvas diferentes. Mude para a mesma profundidade, e a colaboração ganha vida novamente.

Este é o tipo de detalhe que faz a colaboração parecer natural ao invés de ruidosa. Você vê o que é relevante para seu contexto atual.

Mudanças Sincronizam Automaticamente

Colaboração não é apenas ver cursores. Quando um colega adiciona um novo sistema, move um container ou atualiza um relacionamento, seu diagrama atualiza automaticamente. Você não precisa recarregar. Não precisa perguntar "você salvou?"

Usamos operações versionadas internamente. Cada mudança incrementa um número de versão. Seu cliente faz polling por novas versões a cada segundo e, quando detecta uma mudança, busca novamente os dados relevantes. É simples, confiável e funciona atrás de qualquer proxy ou firewall — sem conexões WebSocket para se preocupar.

O resultado é uma superfície de trabalho compartilhada onde as mudanças de todos aparecem em um ou dois segundos. Rápido o bastante para colaboração ativa, sem a complexidade de sincronização em tempo real caractere por caractere que você precisaria para um editor de texto.

Um Sistema Unificado

Uma das decisões que mais nos orgulhamos é o modelo de colaboração unificado. Whiteboards, Diagramas C4 de Projeto e Arquitetura Global rodam na mesma infraestrutura. Um serviço, um conjunto de tabelas de banco de dados, um conjunto de endpoints.

Internamente, cada sessão de colaboração é identificada por um tipo de recurso (whiteboard, project ou global) e um ID de recurso. O rastreamento de cursor, detecção de presença, versionamento de operações e jobs de limpeza são compartilhados. Isso significa que melhorias em um tipo de recurso beneficiam todos automaticamente.

Também significa que estender a colaboração para novas áreas no futuro — fluxos, documentação, ADRs — é uma questão de conectar a infraestrutura existente a novas visualizações, não construir algo do zero.

Dez Cores, Zero Confusão

Cada colaborador recebe uma cor única atribuída de uma paleta de dez matizes distintas e acessíveis. A atribuição é determinística baseada na ordem de entrada, então se você sair e entrar novamente, recebe a mesma cor (assumindo que seu slot não foi tomado). Seu cursor, seus destaques de elemento, seu anel de avatar — todos usam a mesma cor.

Testamos isso em vários tipos de display e perfis de visão de cor. A paleta foi escolhida para que cada par de cores seja distinguível, mesmo para pessoas com formas comuns de daltonismo. Arquitetura é sobre comunicação; as ferramentas não deveriam introduzir ambiguidade.

Casos de Uso Que Estamos Vendo

Revisões de arquitetura: Um líder técnico apresenta o modelo C4 para a equipe. Todos acompanham na própria tela, clicando em elementos sobre os quais têm perguntas. O líder vê onde a atenção se concentra e ajusta a discussão de acordo.

Onboarding: Um novo engenheiro explora a arquitetura com um colega sênior. Ao invés de um slide deck, eles percorrem o diagrama vivo juntos. O engenheiro sênior seleciona sistemas e os explica em tempo real. O novo contratado clica e faz perguntas sobre o que vê.

Sessões de planejamento: Duas equipes estão discutindo uma integração. Cada equipe tem seu próprio projeto, mas abrem a visualização de Arquitetura Global juntas para ver como seus sistemas vão se conectar. Podem apontar para sistemas específicos e discutir fronteiras com todos olhando para a mesma coisa.

Design distribuído: Um engenheiro backend adiciona novos componentes a um serviço enquanto um engenheiro frontend revisa o container da API que vão consumir. Ambos estão no mesmo projeto, trabalhando em partes diferentes, cientes do progresso um do outro.

Começando

A colaboração em tempo real em Diagramas C4 e Arquitetura Global está disponível agora em todos os planos que suportam funcionalidades de equipe. Não há nada para configurar — apenas abra um projeto ou a visualização de Arquitetura Global, e a colaboração está ativa assim que um colega abre a mesma visualização.

Sua arquitetura é um artefato de equipe. Agora suas ferramentas refletem isso.

Novo na arquitetura colaborativa? Leia como construímos a Colaboração em Whiteboard para a história completa, ou explore a Descoberta de Arquitetura com IA para gerar automaticamente a arquitetura em que sua equipe pode colaborar.