团队架构摘要

团队摘要会定期向团队的邮件列表发送一封架构动态汇总邮件。每个团队都可以自行配置发送计划、时区、收件地址以及关心的板块——这样无需登录，合适的人就能在合适的时间看到合适的信息。

摘要只包含该团队拥有的项目，因此每个团队的邮件都只覆盖自己的职责范围。

摘要包含哪些内容

一份摘要最多可包含七个板块，每个板块都可以按团队单独开启或关闭：

  • 架构健康状况 — 漂移评分及其相对上一周期的变化、合规通过率、部署次数、交付周期和 MTTR（DORA 快照）。
  • 架构变更 — 新增、更新或删除的 C4 元素（排名靠前的条目）。
  • 决策（ADR） — 本周期内创建或合并的 ADR。
  • 拉取请求 — 按状态分类的 Architecture Change Request。
  • 合规 — 新增违规和通过率。
  • 讨论 — 在架构元素（容器、组件、ADR 等）上新开启的评论线程。
  • 洞察 — 本周期生成的架构洞察。

本周期内没有新动态的板块会被自动省略——您的团队不会收到一封半空的邮件。

启用摘要

由团队管理员在团队设置中配置摘要：

  1. 打开团队选择器，点击该团队的设置。
  2. 切换到 摘要 标签页。
  3. 输入团队邮箱（通常是共享邮件列表，例如 team-frontend@company.com）。
  4. 选择 频率：每周、每两周或每月。
  5. 选择发送的 日期（每周/每两周默认星期一，每月默认 1 日）和 时间。
  6. 选择团队的 时区，确保摘要在正确的当地时间送达。
  7. 勾选需要包含的 板块。
  8. 点击 保存。

在以非 off 的频率保存之前，摘要会一直处于禁用状态（频率为 关闭）。

预览与测试

在开启定期发送之前，先确认邮件的外观和内容：

  • 预览 — 以最新数据渲染邮件，并在页面内打开预览。不会发送邮件。
  • 发送测试 — 立即向团队配置的摘要地址发送一封邮件。便于验证邮件能否送达，以及在您实际使用的邮件客户端中的显示效果。

预览显示的 HTML 与收件人看到的完全相同，如果收件人的邮件客户端支持 prefers-color-scheme，还会包含深色/浅色模式的适配。

调度机制

调度器每小时运行一次。对于每个未处于 关闭 状态的团队：

  • 将当前时间转换为团队所在时区的时间。
  • 如果当地的小时与 发送时间 一致，则检查日期规则：
    • 每周：与配置的星期几一致时发送。
    • 每两周：在 ISO 周数为偶数的周中，与配置的星期几一致时发送。
    • 每月：与配置的日期一致时发送，最晚不超过当月最后一天（因此设置为 31 日时，2 月会在 28 日发送）。
  • 如果在安全窗口期内（每周为 6 天，每两周为 13 天，每月为 27 天）已经发送过摘要，则跳过本次运行——以防 cron 重试时重复发送。

您可以随时修改发送计划。下一个符合条件的调度周期会采用新的配置。

收件人

每个团队只有一个 digest_email 地址。如果希望每位团队成员都收到摘要，请使用共享邮件列表——摘要本身不做个性化，因此一个收件地址加上面向整个团队的转发是最简单的方式。

如果在将频率从 关闭 切换为其他值时地址为空，保存将被拒绝。

权限

  • 团队成员 可以查看摘要配置。
  • 团队管理员 可以更新配置、生成预览、发送测试邮件，以及开启/关闭摘要。
  • 组织管理员 在其组织内的每个团队中都被视为团队管理员。

停止或暂停摘要

在团队设置中将频率设为 关闭——摘要会在下一个调度周期停止。配置会被保留，因此之后重新启用时无需重新填写所有内容。

相关文档