Collaborazione in Tempo Reale su Diagrammi C4 e Architettura Globale

Qualche settimana fa, abbiamo lanciato la collaborazione in tempo reale sulle lavagne. La risposta è stata immediata e chiara: i team hanno adorato vedere i cursori degli altri, adorato gli indicatori di presenza, adorato guardare l'architettura prendere forma insieme. Ma la richiesta più comune? "Possiamo averlo anche sui diagrammi C4?"

Domanda giusta. Le lavagne sono ottime per il brainstorming, ma l'architettura reale vive nei tuoi modelli C4 — i sistemi, container, componenti ed elementi di codice che definiscono come il tuo software è strutturato. È dove i team trascorrono la maggior parte del tempo. È dove la collaborazione conta di più.

Oggi lo realizziamo. La collaborazione in tempo reale ora funziona sui Diagrammi C4 di Progetto e sulla vista Architettura Globale.

Stessa Magia, Dove Conta

Se hai usato la collaborazione su lavagna, questo ti sembrerà immediatamente familiare. Apri la vista diagramma di un progetto, e quando un collega apre lo stesso progetto, il suo cursore appare sul tuo canvas. Una freccia colorata con il suo nome che scivola sul diagramma mentre esplora la tua architettura.

Seleziona un nodo sistema, e tutti lo vedono evidenziato con il tuo colore — un bordo sottile attorno all'elemento, il tuo nome sopra. Il tuo collega seleziona un container diverso? Vedi la sua selezione nel suo colore. Il linguaggio visivo è semplice: sai sempre chi sta guardando cosa.

Lo stack di avatar appare nell'angolo in basso. Vedi chi c'è. Una notifica appare quando qualcuno si unisce alla sessione. Tutto funziona naturalmente.

Collaborare Tra Livelli C4

Qui le cose si fanno interessanti. I modelli C4 sono gerarchici — potresti lavorare al livello Sistema mentre il tuo collega è nel livello Componente di un container specifico. Entrambi state editando lo stesso progetto, ma guardate a profondità diverse.

Tracciamo questo attraverso i metadati. La sessione di ogni collaboratore porta informazioni su quale livello C4 sta attualmente visualizzando. Questo significa che puoi vedere non solo che Sarah è nello stesso progetto, ma che sta lavorando al livello Container mentre tu sei al livello Sistema. Gli indicatori di presenza vi mantengono consapevoli l'uno dell'altro senza il rumore di mostrare cursori su una vista che non stai nemmeno guardando.

Quando due persone sono sullo stesso livello, cursori e highlight del focus appaiono naturalmente. Quando sono su livelli diversi, la collaborazione resta sullo sfondo — presente ma non distraente.

Architettura Globale: Collaborazione Tra Progetti

La vista Architettura Globale mostra tutti i sistemi della tua organizzazione in un unico posto. È dove vedi il quadro generale — come i progetti si collegano, dove sono i confini, quali sistemi parlano tra loro.

Ora puoi esplorare quella vista insieme. Apri l'Architettura Globale e i tuoi colleghi vedono il tuo cursore muoversi sul panorama organizzativo. Seleziona un sistema per esaminarlo, e tutti vedono il tuo focus.

Abbiamo aggiunto il filtraggio per ambito di vista qui perché la vista Architettura Globale ha due modalità di profondità — sistemi e container. Se stai guardando la panoramica dei sistemi e il tuo collega è sceso nella vista container, non vedrete i cursori l'uno dell'altro. Siete effettivamente su canvas diversi. Passate alla stessa profondità, e la collaborazione si riattiva.

Questo è il tipo di dettaglio che rende la collaborazione naturale piuttosto che rumorosa. Vedi ciò che è rilevante per il tuo contesto attuale.

Le Modifiche si Sincronizzano Automaticamente

La collaborazione non è solo vedere cursori. Quando un collega aggiunge un nuovo sistema, sposta un container o aggiorna una relazione, il tuo diagramma si aggiorna automaticamente. Non devi premere ricarica. Non devi chiedere "hai salvato?"

Usiamo operazioni con versione sotto il cofano. Ogni modifica incrementa un numero di versione. Il tuo client esegue il polling per nuove versioni ogni secondo e, quando rileva un cambiamento, riesegue il fetch dei dati rilevanti. È semplice, affidabile e funziona dietro qualsiasi proxy o firewall — nessuna connessione WebSocket di cui preoccuparsi.

Il risultato è una superficie di lavoro condivisa dove le modifiche di tutti appaiono entro uno o due secondi. Abbastanza veloce per la collaborazione attiva, senza la complessità della sincronizzazione in tempo reale carattere per carattere che servirebbe per un editor di testo.

Un Sistema Unificato

Una delle decisioni di cui siamo più soddisfatti è il modello di collaborazione unificato. Lavagne, Diagrammi C4 di Progetto e Architettura Globale girano tutti sulla stessa infrastruttura. Un servizio, un set di tabelle database, un set di endpoint.

Sotto il cofano, ogni sessione di collaborazione è identificata da un tipo di risorsa (whiteboard, project o global) e un ID risorsa. Il tracciamento del cursore, il rilevamento della presenza, il versioning delle operazioni e i job di pulizia sono condivisi. Questo significa che i miglioramenti a un tipo di risorsa beneficiano automaticamente tutti gli altri.

Significa anche che estendere la collaborazione a nuove aree in futuro — flussi, documentazione, ADR — è questione di collegare l'infrastruttura esistente a nuove viste, non costruire qualcosa da zero.

Dieci Colori, Zero Confusione

Ogni collaboratore riceve un colore unico da una palette di dieci tonalità accessibili e distinte. L'assegnazione è deterministica basata sull'ordine di ingresso, quindi se esci e rientri, ottieni lo stesso colore (a patto che il tuo slot non sia stato preso). Il tuo cursore, i tuoi highlight sugli elementi, il tuo anello avatar — tutti usano lo stesso colore.

L'abbiamo testato su vari tipi di display e profili di visione dei colori. La palette è stata scelta in modo che ogni coppia di colori sia distinguibile, anche per persone con forme comuni di daltonismo. L'architettura riguarda la comunicazione; gli strumenti non dovrebbero introdurre ambiguità.

Casi d'Uso che Stiamo Vedendo

Revisioni dell'architettura: Un tech lead guida il team attraverso il modello C4. Tutti seguono sul proprio schermo, cliccando sugli elementi su cui hanno domande. Il lead vede dove si concentra l'attenzione e adatta la discussione di conseguenza.

Onboarding: Un nuovo ingegnere esplora l'architettura con un collega senior. Invece di uno slide deck, percorrono insieme il diagramma vivo. L'ingegnere senior seleziona sistemi e li spiega in tempo reale. Il nuovo assunto clicca in giro e fa domande su ciò che vede.

Sessioni di pianificazione: Due team discutono un'integrazione. Ogni team ha il proprio progetto, ma aprono insieme la vista Architettura Globale per vedere come i loro sistemi si collegheranno. Possono indicare sistemi specifici e discutere i confini con tutti che guardano la stessa cosa.

Design distribuito: Un ingegnere backend aggiunge nuovi componenti a un servizio mentre un ingegnere frontend rivede il container API che consumerà. Entrambi sono nello stesso progetto, lavorano su parti diverse, consapevoli dei progressi dell'altro.

Per Iniziare

La collaborazione in tempo reale su Diagrammi C4 e Architettura Globale è disponibile ora su tutti i piani che supportano le funzionalità team. Non c'è nulla da configurare — basta aprire un progetto o la vista Architettura Globale, e la collaborazione è attiva non appena un collega apre la stessa vista.

La tua architettura è un artefatto di team. Ora i tuoi strumenti lo riflettono.

Nuovo alla collaborazione architetturale? Leggi come abbiamo costruito la Collaborazione su Lavagna per la storia completa, o esplora la Discovery Architetturale con AI per generare automaticamente l'architettura su cui il tuo team può collaborare.