Riepilogo dell'architettura del team

Il riepilogo del team invia alla mailing list di un team un resoconto email periodico dell'attività architetturale. Ogni team configura la propria pianificazione, il fuso orario, l'indirizzo del destinatario e le sezioni che gli interessano — così le persone giuste ricevono le informazioni giuste al momento giusto, senza dover effettuare l'accesso.

Nel riepilogo sono inclusi solo i progetti di proprietà del team, quindi l'email di ogni team è limitata al suo perimetro.

Cosa contiene un riepilogo

Un riepilogo può includere fino a sette sezioni, ognuna attivabile o disattivabile per team:

  • Salute dell'architettura — drift score con la variazione rispetto al periodo precedente, tasso di conformità, numero di deployment, lead time e MTTR (snapshot DORA).
  • Modifiche all'architettura — elementi C4 aggiunti, aggiornati o rimossi (i principali).
  • Decisioni (ADR) — ADR aperti o approvati nel periodo.
  • Pull request — Architecture Change Request per stato.
  • Conformità — nuove violazioni e tasso di conformità.
  • Discussioni — nuovi thread di commenti aperti sugli elementi dell'architettura (container, componenti, ADR, …).
  • Insights — insight sull'architettura generati per il periodo.

Le sezioni senza nuova attività nel periodo vengono omesse automaticamente — il tuo team non riceverà un'email mezza vuota.

Attivare il riepilogo

Un amministratore del team configura il riepilogo dalle impostazioni del team:

  1. Apri il selettore dei team e clicca sulle impostazioni del team.
  2. Passa alla scheda Riepilogo.
  3. Inserisci l'email del team (di solito una mailing list condivisa come team-frontend@company.com).
  4. Scegli una frequenza: settimanale, ogni due settimane o mensile.
  5. Scegli il giorno (lunedì per impostazione predefinita per settimanale/ogni due settimane, giorno 1 per mensile) e l'ora di invio.
  6. Scegli il fuso orario del team, così il riepilogo arriva all'ora locale corretta.
  7. Seleziona le sezioni da includere.
  8. Clicca su Salva.

Il riepilogo resta disattivato (frequenza Disattivato) finché non salvi con una frequenza diversa da off.

Anteprima e test

Prima di attivare la pianificazione periodica, verifica l'aspetto e il contenuto:

  • Anteprima — apre un'anteprima inline dell'email generata con i dati più recenti. Non viene inviata alcuna email.
  • Invia test — invia subito una singola email all'indirizzo di riepilogo configurato per il team. Utile per verificare la recapitabilità e l'aspetto dell'email nel tuo client reale.

L'anteprima mostra lo stesso HTML che vedranno i destinatari, incluso l'adattamento alla modalità chiara/scura quando il loro client email supporta prefers-color-scheme.

Come funziona la pianificazione

Uno scheduler viene eseguito ogni ora. Per ogni team che non è Disattivato:

  • L'ora corrente viene convertita nel fuso orario del team.
  • Se l'ora locale corrisponde a Invia alle, viene verificata la regola del giorno:
    • Settimanale corrisponde al giorno della settimana configurato.
    • Ogni due settimane corrisponde al giorno della settimana nelle settimane ISO pari.
    • Mensile corrisponde al giorno del mese configurato, limitato all'ultimo giorno del mese (quindi il giorno 31 invia il 28 febbraio).
  • Se un riepilogo è già stato inviato entro la finestra di sicurezza (6 giorni per settimanale, 13 per ogni due settimane, 27 per mensile), l'esecuzione viene saltata — una protezione contro gli invii duplicati se il cron riprova.

Puoi modificare la pianificazione in qualsiasi momento. Il successivo tick utile applicherà la nuova configurazione.

Destinatario

Ogni team ha un unico indirizzo digest_email. Usa una mailing list condivisa se vuoi che ogni membro del team riceva il riepilogo — il riepilogo non è personalizzato, quindi un unico destinatario con inoltro a tutto il team è il modello più semplice.

Se l'indirizzo è vuoto quando imposti una frequenza diversa da Disattivato, il salvataggio viene rifiutato.

Permessi

  • I membri del team possono leggere la configurazione del riepilogo.
  • Gli amministratori del team possono aggiornare la configurazione, generare un'anteprima, inviare un'email di test e attivare/disattivare il riepilogo.
  • Gli amministratori dell'organizzazione sono trattati come amministratori di ogni team della loro organizzazione.

Interrompere o sospendere il riepilogo

Imposta la frequenza su Disattivato nelle impostazioni del team — il riepilogo si ferma al tick successivo. La configurazione viene conservata, quindi puoi riattivarlo in seguito senza reinserire tutto.

Correlati