设计评审
设计评审是在实现前,检查方案是否满足目标、约束和运行要求,并对尚未确定的取舍作出决定。跨团队分歧需要拆成可以核验的问题:双方依据什么事实,担心什么后果,谁负责最终选择。资深岗位的项目面试中,要能说明这些问题如何得到解决。
1. 面试核心
先记住这几条,再读正文- 评审先明确要决定什么、必须满足哪些约束、已有何种证据,再讨论方案。
- 阻塞意见要指出违反了哪个约束、会造成什么后果,个人偏好作为建议。
- 评审者提供事实与风险,授权决策人对最终取舍负责;超出权限时带着证据升级。卡 · 综合题
- 跨团队接口约定还应包含兼容期限、迁移步骤和运行责任,保证方案有人执行和维护。
2. 评审材料
评审材料要让参与者看清待决定的问题。开头说明业务目标和决定期限,再给出当前限制与备选方案;涉及跨团队调用时,在图中标明数据流、接口所有者,以及请求跨越哪些信任边界。
每个待决定事项都要对应具体约束,使评审者能判断影响谁、如何验收。如果只提出一个方案,也要说明其他方案为什么被排除,否则评审者无法判断取舍是否充分。
3. 参与者
参与者按方案影响范围选择:直接上下游、数据所有者和运行团队应在提案早期介入,涉及安全或合规风险时,再由相应责任人评估。先确认接口与约束,可以避免详细设计完成后才发现关键要求不成立。
邀请时写清每个人负责检查什么,以及谁有权作最终决定。否则,即使收集了很多意见,也可能没人能结束讨论。
4. 异步评论
异步评论用于在开会前补齐信息。可以把意见标为阻塞、澄清、建议或偏好,让提案人知道哪些问题必须解决。
阻塞意见必须说明约束和后果。例如,“这个字段不能删除,仍有旧版批处理读取它”指出了真实的兼容问题;单纯偏好另一种命名,则作为建议。提案人相应地修改方案、补充证据,或解释为什么不采纳。
可测量的争议可以用小实验验证,但要先约定输入、目标和停止条件。否则实验结束后,双方仍可能用不同标准解释结果。
5. 评审会议
会议集中处理异步讨论后仍未解决的决定。双方先确认讨论的是同一问题、遵守同一组硬约束,再区分哪些是已有事实、哪些只是预期。
可逆方案可通过小范围试验验证。涉及数据安全或高退出成本时,需要更充分证据。超出当前范围的问题单独登记,避免会议持续扩张。
6. 决策权与升级
评审者负责指出事实与风险,决策人负责接受取舍并承担结果责任,具体可以由服务负责人或相关领域负责人担任。
仍有分歧时,把双方意见拆成待验证的假设,能实验的部分设期限补证据。证据齐备后,剩余风险由授权决策人判断;问题超出其权限,再按预设路径升级处理。
升级材料包含问题、选项、证据和双方意见。接收方应能据此作出具体取舍。
7. 异议记录
决定作出后,记录结论、理由和仍未消除的风险。保留异议,是为了知道后续应观察什么:如果担心某个依赖会成为容量瓶颈,就应约定怎样验证,以及何时重新讨论。
参与团队据此更新接口和排期。新证据满足复审条件时,再正式复审;决策人没有采纳某项技术建议时,也要记录承担的风险与验证条件。
8. 迁移与运行
跨团队方案只有落实到执行责任,才具备实施条件。评审时还需确认:
- 接口与事件有明确兼容期限。
- 回填、对账和数据所有权已经分配。
- 灰度与回退有执行人和停止条件。
- SLO、容量和告警有验收标准。
- 故障响应与旧能力删除有责任人。
迁移执行细节见架构迁移。评审重点是各团队是否接受并具备这些运行条件。
9. 评审效果
评审是否有效,可以看决定花了多久、是否减少重大返工、有没有漏掉关键依赖,以及约定的风险验证是否完成。会议结束或文档签字,本身不能证明方案已经得到充分检查。
评审过慢时,检查材料是否完整、权限是否明确。持续返工时,核对关键参与者的介入时机。指标用于定位流程缺口,再决定具体调整。
10. 面试题卡片
11. 参考资料
- Google Engineering Practices:The Standard of Code Review
- Google Engineering Practices:What to look for in a code review
- AWS Prescriptive Guidance:ADR review process
来源:Coding 101 原文 · 免费阅读,引用请保留出处。内容使用说明