成熟度评分:用一个等级衡量你的架构健康状况
你有漂移分数。你有合规规则。你有洞察。你有 DORA 指标。四个信号,四个仪表盘,四个数字需要逐一检查,才能回答一个最简单的问题:我们的架构状况好吗?
答案总是分散的。一个团队可能拥有完美的文档准确性(漂移分数 95),但部署实践却一塌糊涂(DORA 指标垫底)。另一个团队可能每天部署十次,却无视所有的合规规则。每个指标都只讲述了故事的一部分,没有任何一个能讲述完整的故事。
成熟度评分解决了这个问题。一个等级。四个维度。一个视图即可了解你的架构真实健康状况。
从 A 到 F,就这么简单。
打开 Archyl 中的任意项目,你会看到一个字母等级:
- A (90-100) — 你的架构文档完善、合规、持续监控,且交付可靠。这是目标。
- B (80-89) — 良好。一两个维度有小差距,但不至于让你寝食难安。
- C (70-79) — 基础尚可,存在实际弱点。你知道问题在哪,但还没修复。
- D (60-69) — 困难重重。多个维度表现不佳。技术债务在不断累积。
- F (低于 60) — 你的架构文档形同虚设。从基础开始吧。
这个等级不是虚荣指标。它由四个加权维度计算而来,每个维度衡量你的架构实践的不同方面。
四个维度,一个评分
漂移 — 你的文档是否反映真实情况?
漂移维度衡量你的 C4 模型与实际代码库的匹配程度。不再存在的文件路径、已重命名的服务、已合并的容器——每个文档化的元素都会与代码仓库进行验证。
高漂移分数意味着你的架构图描述的是实际运行在生产环境中的系统。低漂移分数则意味着它们描述的是六个月前存在的系统。
洞察 — 你是否在关注信号?
Archyl 持续分析你的架构并发现问题:循环依赖、过大的组件、缺失的文档、未使用的容器。洞察维度衡量这些问题的数量和严重程度。
快速解决关键洞察的团队得分高。放任警告堆积的团队得分低。这不是要求零问题——而是要有对问题采取行动的文化。
合规性 — 你是否遵守了自己制定的规则?
你制定架构规则是有原因的。前端容器不应直接调用数据库。每个系统必须至少有一个文档化的 API 契约。认证服务不得依赖业务逻辑。
合规维度衡量你的规则通过率。这是拥有治理和执行治理之间的区别。
DORA — 你真的能交付吗?
如果无法交付,架构质量毫无意义。DORA 维度跟踪四个标准指标:部署频率、变更前置时间、变更失败率和平均恢复时间。
一个拥有精美架构但每季度只部署一次的团队,存在交付问题。DORA 能发现这一点。
加权计算,而非简单平均
四个维度的权重并不相同。每个项目的成熟度评分是一个加权综合分数:
| 维度 | 默认权重 | 衡量目标 |
|---|---|---|
| 漂移 | 25% | 保持文档准确性 |
| 洞察 | 25% | 解决架构问题 |
| 合规性 | 25% | 遵守自定义规则 |
| DORA | 25% | 可靠地交付 |
权重在详情面板中可见——每个分数都显示其贡献值。你可以清楚地看到为什么你的等级是这样的,以及哪个维度在拖后腿。
组织级视图
单个项目的评分很有用。将所有项目并排查看则具有变革性意义。
组织成熟度仪表盘将每个项目显示为一张卡片:等级、分数、趋势,以及四个维度的详细拆分。按等级筛选、按分数排序、按名称搜索。三十秒内,你就知道哪些项目需要关注。
顶部的等级分布条展示了你组织架构健康状况的全貌。大多是 A 和 B?状况良好。出现一堆 D 和 F?你知道该往哪里投入了。
趋势才是真正的故事
每次成熟度计算都会随时间追踪。每个项目都显示一个趋势:上升中、稳定或下降中。
一个上个月从 C 升到 B 的项目正走在正确的道路上,即使它还不是 A。一个连续三个迭代持续下降的项目需要干预,即使它仍然是 B。趋势往往比绝对分数更具可操作性。
推荐引擎
详情面板不仅展示分数——还会告诉你该做什么。最弱的维度会获得具体、可操作的建议:
- 漂移最低? "运行漂移检测以更新你的文档一致性。"
- 洞察最低? "审查并解决关键架构洞察问题。"
- 合规性最低? "修复合规规则违规以提高合规率。"
- DORA 最低? "改进部署实践以提升 DORA 指标。"
没有模糊表述。没有"考虑改进你的流程"。只有具体的下一步行动,直指能最大幅度提升你评分的关键点。
为什么一个等级很重要
团队不会对有十二个指标的仪表盘采取行动。他们会对一个易于理解、易于比较、难以作弊的数字采取行动。
成熟度评分有着明确的立场:
它是全面的。 你不能仅靠出色的文档但糟糕的交付来获得 A。四个维度都很重要。
它是可比较的。 项目 A 是 B 级。项目 B 是 D 级。关于该把工程时间投入到哪里的讨论变得更简单了。
它是可追踪的。 一个能随时间绘制的数字就是一个你可以改进的数字。设定目标:"本季度末所有项目达到 C 级或以上。"现在你有了一个可衡量的目标。
它是诚实的。 等级不关心意图或路线图。它衡量的是当下的真实状况。你的文档要么与代码匹配,要么不匹配。你的规则要么通过,要么不通过。
开始使用
成熟度评分现已对所有 Archyl 项目开放。无需任何设置——如果你的项目有架构文档,你就已经有了一个评分。
- 打开任意项目。成熟度徽章会出现在项目标题栏中。
- 点击它查看完整的详细信息:总体评分、四个维度、趋势和建议。
- 访问组织成熟度页面,一览所有项目的全貌。
你的组织架构健康状况不应该是一个谜。现在,它就是一个字母等级。