Récap d'architecture d'équipe

Le récap d'équipe envoie par email un résumé récurrent de l'activité architecturale à la liste de diffusion d'une équipe. Chaque équipe configure sa propre fréquence, son fuseau horaire, son adresse destinataire et les sections qui l'intéressent — pour que les bonnes informations arrivent aux bonnes personnes au bon moment, sans avoir à se connecter.

Seuls les projets détenus par l'équipe sont inclus dans son récap, ce qui scope chaque email au périmètre de l'équipe.

Contenu d'un récap

Un récap peut inclure jusqu'à sept sections, chacune activable par équipe :

  • Santé de l'architecture — score de drift avec delta vs période précédente, taux de conformité, nombre de déploiements, lead time et MTTR (snapshot DORA).
  • Changements d'architecture — éléments C4 ajoutés, modifiés ou supprimés (top éléments).
  • Décisions (ADRs) — ADRs ouvertes ou mergées sur la période.
  • Pull requests — Architecture Change Requests par statut.
  • Conformité — nouvelles violations et taux de pass.
  • Discussions — nouveaux fils de commentaires ouverts sur les éléments d'architecture (containers, composants, ADRs, …).
  • Insights — insights générés pour la période.

Les sections sans activité sur la période sont automatiquement omises — votre équipe ne recevra pas un email à moitié vide.

Activer le récap

Un admin de l'équipe configure le récap depuis les paramètres de l'équipe :

  1. Ouvrez le sélecteur d'équipe et cliquez sur les paramètres de l'équipe.
  2. Allez dans l'onglet Récap.
  3. Saisissez l'email d'équipe (typiquement une mailing list partagée comme team-frontend@entreprise.com).
  4. Choisissez une fréquence : hebdomadaire, toutes les deux semaines, ou mensuelle.
  5. Choisissez le jour (lundi par défaut pour hebdo/bi-hebdo, jour 1 pour mensuel) et l'heure d'envoi.
  6. Choisissez le fuseau horaire de l'équipe pour que le récap arrive à la bonne heure locale.
  7. Cochez les sections à inclure.
  8. Cliquez sur Enregistrer.

Le récap reste désactivé tant que vous n'enregistrez pas avec une fréquence différente de Désactivé.

Prévisualiser et tester

Avant d'activer la planification, validez le rendu et le contenu :

  • Prévisualiser — ouvre un aperçu en ligne de l'email rendu avec les dernières données. Aucun email n'est envoyé.
  • Envoyer un test — envoie immédiatement un seul email à l'adresse configurée. Utile pour vérifier la délivrabilité et le rendu dans votre client réel.

L'aperçu montre exactement le HTML que recevront les destinataires, y compris l'adaptation dark/light mode quand leur client email supporte prefers-color-scheme.

Fonctionnement de la planification

Un planificateur tourne toutes les heures. Pour chaque équipe non désactivée :

  • L'heure courante est convertie dans le fuseau horaire de l'équipe.
  • Si l'heure locale correspond à Envoyer à, la règle de jour est vérifiée :
    • Hebdomadaire correspond au jour de semaine configuré.
    • Toutes les deux semaines correspond au jour de semaine sur les semaines ISO paires.
    • Mensuel correspond au jour du mois configuré, capé au dernier jour du mois (donc jour 31 envoie le 28 février).
  • Si un récap a déjà été envoyé dans la fenêtre de sécurité (6 jours pour hebdo, 13 pour bi-hebdo, 27 pour mensuel), le run est ignoré — protection contre les doublons en cas de retry du cron.

Vous pouvez changer la planification à tout moment. Le prochain tick éligible reprend la nouvelle configuration.

Destinataire

Chaque équipe a une seule adresse digest_email. Utilisez une mailing list partagée si vous voulez que chaque membre reçoive le récap — le récap n'est pas personnalisé, donc un destinataire unique avec re-routage interne est le modèle le plus simple.

Si l'adresse est vide quand vous changez la fréquence depuis Désactivé, l'enregistrement est rejeté.

Permissions

  • Les membres de l'équipe peuvent lire la configuration du récap.
  • Les admins de l'équipe peuvent modifier la configuration, prévisualiser, envoyer un test, et activer/désactiver le récap.
  • Les admins d'organisation ont les droits admin sur toutes les équipes de leur organisation.

Désactiver ou suspendre le récap

Passez la fréquence à Désactivé dans les paramètres de l'équipe — le récap s'arrête au prochain tick. La configuration est conservée, vous pouvez réactiver plus tard sans tout ressaisir.

Liens connexes