架构治理
架构治理回答:架构决策怎么产生、边界怎么守、债怎么还。
治理不是审批流程的同义词。有效的治理由四件事组成:决策留痕、边界守护、质量度量、债务偿还。
方法与模型:用 ADR 留下决策,用适应度函数把边界与质量指标变成可自动检查的门禁,用技术债台账量化偿还顺序;治理常态靠检查项,不靠审批会。
治理对象要落到可检查的四件事
| 对象 | 治理动作 |
|---|---|
| 决策 | 记录背景、选项、结论与代价,设定复审条件 |
| 边界 | 依赖规则、跨库访问、平台下沉的评审与检查 |
| 质量 | 可用性、性能、安全、可维护性的指标与门禁 |
| 债务 | 分类、登记、量化、预算化偿还 |
| 变更 | 高风险变更的评审与回滚预案 |
决策的价值在复审条件
每条重要决策用一页记录:
- 背景:要解决什么问题,约束是什么;
- 选项:考虑过哪些方案;
- 决定:选了什么,为什么;
- 代价:接受了什么缺点;
- 复审条件:什么情况下重新评估。
| 决策 | 代价 | 复审信号 |
|---|---|---|
| 一服务一库 | 跨域查询与事务复杂 | 跨域查询成为主要瓶颈 |
| 单节点起步 | 可用性有限 | 故障影响面超出承受范围 |
| 平台能力下沉 | 平台成为关键路径 | 平台变更阻塞多个业务域 |
| 技术栈收敛 | 特定场景表达力受限 | 关键场景无法用现有栈实现 |
决策记录的价值在"复审":没有复审条件的决策会变成没人敢动的历史包袱。
边界要检查,不能只靠规范
架构边界最容易在实现中被绕过,所以需要检查而不只是规范:
- 禁止跨库直接访问,跨域取数走接口或消息;
- 禁止业务域重复实现平台已提供的能力;
- 服务拆分、合并与公共能力下沉必须经过架构评审;
- 关键依赖关系可自动化检查(分层依赖、循环依赖、跨模块引用)。
边界守护的前提是原则明确:架构原则写清取舍标准,冲突时按原则裁决;例外允许偏离,但要有期限与回收计划。
指标要绑到具体服务与负责人
| 维度 | 指标示例 | 采集方式 |
|---|---|---|
| 可用性 | 关键服务可用率、故障时长 | 监控与告警 |
| 性能 | 接口 P95 延迟、关键页面加载 | 链路追踪与前端监控 |
| 安全 | 鉴权覆盖率、敏感数据访问记录 | 网关日志与审计 |
| 可维护性 | 重复实现数量、测试覆盖、构建时长 | 代码扫描与 CI |
指标要绑定到具体服务与负责人,否则只是报表上的数字。
债务不登记就不会被偿还
技术债分类登记,避免笼统的"以后优化":
- 代码债:重复代码、命名混乱、圈复杂度过高;
- 架构债:不合理依赖、单点故障、过时组件;
- 测试债:缺自动化、手工回归成本高;
- 文档债:架构文档缺失、接口文档与实现不一致。
偿还方式按规模区分:日常提交顺手清理、每个迭代预留固定比例、重大债务立项治理。债务不登记就不会被偿还,登记了不量化就无法排优先级。
债与缺口逐项登记,不打包成"技术债"
治理落地时,债与缺口要登记到具体项,而不是笼统写一句"技术债较多":
- 端口规划越界、自动化测试不足、监控覆盖不均、前端复用不足、文档与实现不同步,逐项登记为技术债;
- 安全治理落在鉴权集中、最小权限、凭据不入库、备份底线,并如实标注审计日志与密钥轮换的缺口;
- 项目复盘记录哪些决策成立、哪些付出了代价、下一步先做什么。
逐项登记的好处是每一项都能被排进预算与责任;打包成一句"技术债",就等于没有登记。
公开边界
只公开治理对象、决策复审、边界检查、指标绑定与债务登记的方法;不包含内部决策记录原文、审计结果、责任人与整改台账。