Menu

Asset

Scegli un livello prima di aprire la review

Una pratica: scegliere un livello C4 e un System Boundary prima di aprire la review.

Tipo
Pratica

Scegliere una scala prima della discussione

Una review diventa confusa quando lo stesso disegno mescola utenti, sistemi, container, componenti e dettagli di codice. Prima di aprire la discussione scegli un solo livello C4 e nomina il System Boundary che la vista deve rappresentare.

Usare il livello per decidere cosa nascondere

  • System Context: sistema, utenti e sistemi esterni.
  • Container: applicazioni e data store che compongono il sistema.
  • Component: responsabilità interne a un singolo container.
  • Code: struttura implementativa quando serve davvero.
Quattro livelli C4 disposti dal contesto al codice, ognuno con un confine esplicito e dettagli degli altri livelli nascosti.
Una review efficace sceglie una scala e rende esplicito cosa resta fuori.

Il diagramma che mostra tutto non decide nulla

La completezza apparente può ridurre la leggibilità. Se un diagramma contiene elementi di scale diverse, i partecipanti discutono contemporaneamente responsabilità strategiche e dettagli implementativi, rendendo difficile chiudere decisioni sul confine corretto.

Prima della review

Tag