Team-Architektur-Digest

Der Team-Digest schickt regelmäßig eine E-Mail-Zusammenfassung der Architekturaktivität an die Verteilerliste eines Teams. Jedes Team konfiguriert seinen eigenen Zeitplan, seine Zeitzone, seine Empfängeradresse und die Abschnitte, die es interessieren — damit die richtigen Personen die richtigen Informationen zur richtigen Zeit sehen, ohne sich anmelden zu müssen.

Nur Projekte, die dem Team gehören, werden in seinen Digest aufgenommen. So ist die E-Mail jedes Teams auf seinen eigenen Verantwortungsbereich beschränkt.

Was ein Digest enthält

Ein Digest kann bis zu sieben Abschnitte enthalten, die sich pro Team einzeln ein- und ausschalten lassen:

  • Architektur-Gesundheit — Drift-Score mit Veränderung gegenüber dem vorherigen Zeitraum, Konformitätsquote, Anzahl der Deployments, Lead Time und MTTR (DORA-Momentaufnahme).
  • Architekturänderungen — hinzugefügte, aktualisierte oder entfernte C4-Elemente (die wichtigsten Einträge).
  • Entscheidungen (ADRs) — im Zeitraum eröffnete oder gemergte ADRs.
  • Pull Requests — Architecture Change Requests nach Status.
  • Konformität — neue Verstöße und Konformitätsquote.
  • Diskussionen — neue Kommentar-Threads zu Architekturelementen (Container, Komponenten, ADRs, …).
  • Insights — generierte Architektur-Insights für den Zeitraum.

Abschnitte ohne neue Aktivität im Zeitraum werden automatisch weggelassen — Ihr Team erhält keine halb leere E-Mail.

Den Digest aktivieren

Ein Team-Admin richtet den Digest in den Team-Einstellungen ein:

  1. Öffnen Sie die Team-Auswahl und klicken Sie auf die Einstellungen des Teams.
  2. Wechseln Sie zum Tab Digest.
  3. Geben Sie die Team-E-Mail ein (typischerweise eine gemeinsame Verteilerliste wie team-frontend@company.com).
  4. Wählen Sie eine Häufigkeit: wöchentlich, alle zwei Wochen oder monatlich.
  5. Wählen Sie den Tag (standardmäßig Montag bei wöchentlich/zweiwöchentlich, Tag 1 bei monatlich) und die Stunde des Versands.
  6. Wählen Sie die Zeitzone des Teams, damit der Digest zur richtigen Ortszeit ankommt.
  7. Markieren Sie die Abschnitte, die enthalten sein sollen.
  8. Klicken Sie auf Speichern.

Der Digest bleibt deaktiviert (Häufigkeit Deaktiviert), bis Sie mit einer anderen Häufigkeit als off speichern.

Vorschau und Test

Bevor Sie den regelmäßigen Versand einschalten, prüfen Sie Aussehen und Inhalt:

  • Vorschau — öffnet eine eingebettete Vorschau der E-Mail, gerendert mit den neuesten Daten. Es wird keine E-Mail gesendet.
  • Test senden — schickt sofort eine einzelne E-Mail an die für das Team konfigurierte Digest-Adresse. Nützlich, um die Zustellbarkeit zu prüfen und zu sehen, wie die E-Mail in Ihrem echten E-Mail-Client aussieht.

Die Vorschau zeigt dasselbe HTML, das die Empfänger sehen, einschließlich der Anpassung an den Dark/Light Mode, wenn ihr E-Mail-Client prefers-color-scheme unterstützt.

So funktioniert die Planung

Ein Scheduler läuft jede Stunde. Für jedes Team, das nicht auf Deaktiviert steht:

  • Die aktuelle Uhrzeit wird in die Zeitzone des Teams umgerechnet.
  • Wenn die lokale Stunde mit Versand um übereinstimmt, wird die Tagesregel geprüft:
    • Wöchentlich trifft auf den konfigurierten Wochentag zu.
    • Alle zwei Wochen trifft auf den Wochentag in geraden ISO-Wochen zu.
    • Monatlich trifft auf den konfigurierten Tag des Monats zu, begrenzt auf den letzten Tag des Monats (Tag 31 wird also am 28. Februar gesendet).
  • Wenn innerhalb des Sicherheitsfensters (6 Tage bei wöchentlich, 13 bei zweiwöchentlich, 27 bei monatlich) bereits ein Digest gesendet wurde, wird der Lauf übersprungen — das schützt vor doppeltem Versand, falls der Cron einen erneuten Versuch startet.

Sie können den Zeitplan jederzeit ändern. Der nächste passende Tick übernimmt die neue Konfiguration.

Empfänger

Jedes Team hat eine einzige digest_email-Adresse. Verwenden Sie eine gemeinsame Verteilerliste, wenn alle Teammitglieder den Digest erhalten sollen — der Digest selbst ist nicht personalisiert, daher ist ein einzelner Empfänger mit teamweiter Weiterleitung das einfachste Modell.

Ist die Adresse leer, wenn Sie die Häufigkeit von Deaktiviert auf einen anderen Wert umstellen, wird das Speichern abgelehnt.

Berechtigungen

  • Teammitglieder können die Digest-Konfiguration lesen.
  • Team-Admins können die Konfiguration ändern, eine Vorschau erzeugen, eine Test-E-Mail senden und den Digest ein- und ausschalten.
  • Organisations-Admins werden für jedes Team ihrer Organisation wie Team-Admins behandelt.

Den Digest stoppen oder pausieren

Setzen Sie die Häufigkeit in den Team-Einstellungen auf Deaktiviert — der Digest stoppt beim nächsten Tick. Die Konfiguration bleibt erhalten, sodass Sie ihn später wieder aktivieren können, ohne alles neu einzugeben.

Verwandte Themen