Colaboración en tiempo real en diagramas C4 y arquitectura global
Hace unas semanas, lanzamos la colaboración en tiempo real en pizarras. La respuesta fue inmediata y clara: a los equipos les encantaba ver los cursores de los demás, les encantaban los indicadores de presencia, les encantaba ver cómo la arquitectura tomaba forma en conjunto. Pero la solicitud más común fue: "¿Podemos tener esto en los diagramas C4 reales también?"
Pregunta justa. Las pizarras son geniales para el brainstorming, pero la verdadera arquitectura vive en sus modelos C4: los sistemas, contenedores, componentes y elementos de código que definen como está estructurado su software. Ahí es donde los equipos pasan la mayor parte del tiempo. Ahí es donde la colaboración importa más.
Hoy, lo hacemos realidad. La colaboración en tiempo real ahora funciona en los diagramas C4 de proyecto y la vista de Arquitectura Global.
La misma magia, donde importa
Si ha usado la colaboración en pizarras, esto le resultara inmediatamente familiar. Abra la vista de diagrama de un proyecto, y cuando un compañero abra el mismo proyecto, su cursor aparece en su lienzo. Una flecha de color con su nombre deslizándose por el diagrama mientras explora su arquitectura.
Seleccione un nodo de sistema y todos lo ven resaltado con su color: un borde sutil alrededor del elemento, su nombre encima. ¿Su compañero selecciona un contenedor diferente? Usted ve su selección en su color. El lenguaje visual es simple: siempre sabe quién está mirando que.
La pila de avatares aparece en la esquina inferior. Ve quién está aquí. Una notificación aparece cuando alguien se une a su sesión. Todo simplemente funciona.
Colaborando a través de los niveles C4
Aquí es donde las cosas se ponen interesantes. Los modelos C4 son jerárquicos: usted puede estar trabajando en el nivel de Sistema mientras su colega está profundamente en el nivel de Componente de un contenedor específico. Ambos están editando el mismo proyecto, pero mirando diferentes profundidades.
Rastreamos esto a través de metadatos. La sesión de cada colaborador lleva información sobre qué nivel C4 está visualizando actualmente. Esto significa que puede ver no solo que Sarah está en el mismo proyecto, sino que está trabajando en el nivel de Contenedor mientras usted está en el nivel de Sistema. Los indicadores de presencia lo mantienen informado sin el ruido de mostrar cursores en una vista que ni siquiera está mirando.
Cuando dos personas están en el mismo nivel, los cursores y resaltados de foco aparecen naturalmente. Cuando están en diferentes niveles, la colaboración permanece en segundo plano: presente pero sin distraer.
Arquitectura Global: colaboración entre proyectos
La vista de Arquitectura Global muestra todos los sistemas de su organización en un solo lugar. Es donde ve el panorama general: cómo se conectan los proyectos, dónde están los límites, qué sistemas se comunican entre si.
Ahora puede explorar esa vista juntos. Abra la Arquitectura Global y sus compañeros ven su cursor moviéndose por el paisaje organizacional. Seleccione un sistema para examinarlo, y todos ven su foco.
Agregamos filtrado por vista aquí porque la vista de Arquitectura Global tiene dos modos de profundidad: sistemas y contenedores. Si está mirando la vista general de sistemas y su colega ha profundizado en la vista de contenedores, no verán los cursores del otro. Están efectivamente en lienzos diferentes. Cambien a la misma profundidad, y la colaboración cobra vida nuevamente.
Es el tipo de detalle que hace que la colaboración se sienta natural en lugar de ruidosa. Ve lo que es relevante para su contexto actual.
Los cambios se sincronizan automáticamente
La colaboración no es solo cursores. Cuando un compañero agrega un nuevo sistema, mueve un contenedor o actualiza una relación, su diagrama se refresca automáticamente. No necesita recargar. No necesita preguntar "guardaste?"
Usamos operaciones versionadas internamente. Cada cambio incrementa un número de versión. Su cliente consulta nuevas versiones cada segundo y, cuando detecta un cambio, recarga los datos relevantes. Es simple, confiable y funciona detrás de cualquier proxy o firewall: sin conexiones WebSocket de las que preocuparse.
El resultado es una superficie de trabajo compartida donde los cambios de todos aparecen en uno o dos segundos. Lo suficientemente rápido para la colaboración activa, sin la complejidad de la sincronización carácter por carácter que necesitaría para un editor de texto.
Un sistema unificado
Una de las decisiones de las que estamos más satisfechos es el modelo de colaboración unificado. Pizarras, diagramas C4 de proyecto y Arquitectura Global funcionan sobre la misma infraestructura. Un servicio, un conjunto de tablas de base de datos, un conjunto de endpoints.
Internamente, cada sesión de colaboración se identifica por un tipo de recurso (whiteboard, project o global) y un ID de recurso. El seguimiento de cursores, la detección de presencia, el versionado de operaciones y las tareas de limpieza son compartidos. Esto significa que las mejoras en un tipo de recurso benefician automáticamente a todos los demás.
También significa que extender la colaboración a nuevas áreas en el futuro, como flujos, documentación o ADRs, es cuestión de conectar la infraestructura existente a nuevas vistas, no construir algo desde cero.
Diez colores, cero confusión
Cada colaborador recibe un color único de una paleta de diez tonos accesibles y distintos. La asignación es determinista según el orden de llegada, así que si sale y vuelve a entrar, obtiene el mismo color (asumiendo que su lugar no ha sido tomado). Su cursor, sus resaltados de elementos, su anillo de avatar: todo usa el mismo color.
Probamos esta paleta en diversos tipos de pantalla y perfiles de visión del color. La paleta fue elegida para que cada par de colores sea distinguible, incluso para personas con formas comunes de daltonismo. La arquitectura es comunicación: las herramientas no deberían introducir ambigüedad.
Casos de uso que estamos viendo
Revisiones de arquitectura: un tech lead recorre el modelo C4 con el equipo. Todos siguen en su propia pantalla, haciendo clic en los elementos sobre los que tienen preguntas. El lead ve dónde se concentra la atención y ajusta la discusión en consecuencia.
Onboarding: un nuevo ingeniero explora la arquitectura con un compañero senior. En lugar de una presentación de diapositivas, recorren juntos el diagrama vivo. El senior selecciona sistemas y los explica en tiempo real. El nuevo hace clic por todas partes y pregunta sobre lo que ve.
Sesiones de planificación: dos equipos discuten una integración. Cada equipo tiene su propio proyecto, pero abren la vista de Arquitectura Global juntos para ver cómo se conectaran sus sistemas. Pueden señalar sistemas específicos y discutir límites con todos mirando lo mismo.
Diseño distribuido: un ingeniero backend agrega nuevos componentes a un servicio mientras un ingeniero frontend revisa el contenedor API que consumirá. Ambos están en el mismo proyecto, trabajando en diferentes partes, conscientes del progreso del otro.
Para empezar
La colaboración en tiempo real en diagramas C4 y Arquitectura Global está disponible ahora en todos los planes que incluyen funciones de equipo. No hay nada que configurar: simplemente abra un proyecto o la vista de Arquitectura Global, y la colaboración se activa en cuanto un compañero abra la misma vista.
Su arquitectura es un artefacto de equipo. Ahora sus herramientas lo reflejan.
¿Nuevo en la colaboración arquitectónica? Lea como construimos la Colaboración en Pizarras para la historia completa, o explore el Descubrimiento de Arquitectura con IA para generar automáticamente la arquitectura sobre la que su equipo puede colaborar.