← 中文资源

简体中文版本

设计优先评审工作流

在实现前评审设计意图,使结构性问题在写代码前被发现。

阅读英文原文

目标

应在实现前评审设计,以最低成本发现结构性问题。本工作流先呈现方案、备选与取舍理由,再对照功能与非功能需求核查设计是否满足,审视其在故障、负载与边界条件下的行为,最后做出批准、修改或拒绝的决策并记录理由。

步骤要点

  1. 呈现方案、备选与取舍理由。
  2. 对照功能与非功能需求核查。
  3. 审视故障、负载与边界下的行为。
  4. 记录批准、修改或拒绝的决策。
# record the design decision
adr new 'Use event sourcing for order history'

验证

按顺序执行上述步骤后,逐项确认每个步骤的预期状态均已满足;只有全部预期状态成立,才认为本流程完成。若某一步未达到预期状态,应先按排错提示排查,不要跳过继续,以免掩盖问题。

排错提示

  • 实现后才发现设计缺陷代价高。
  • 未审视故障模式会在生产暴露。
  • 未记录的决策会反复争论。

适用边界

  • 重大或不可逆的设计应先评审。
  • 评审者应含领域专家与通才。