Architecture Decision Record

Active theme: Light

← 决策记录模板

商业论证的决策记录模板

这个 ADR 模板强调为决策构建商业论证,包括评估标准、候选方案和成本。

顶层结构

  • 标题
  • 状态
  • 评估标准
  • 待考虑的候选方案
  • 对每个候选方案的调研与分析
    • 是否满足标准及原因
    • 成本分析
    • SWOT 分析
    • 意见与反馈
  • 建议

底层详解

标题:

  • 一个简短的一般现在时祈使短语,少于 50 个字符,类似 git 提交信息。

状态:

  • 已提议、已接受、已拒绝、已弃用、已取代等之一。

评估标准:

  • 概要:简要说明我们要探寻什么以及原因。

  • 具体内容

待考虑的候选方案:

  • 概要:简要说明我们是如何发现候选方案的,并提请注意任何异常值。

  • 列出所有候选方案和相关选项;我们要评估哪些潜在的解决方案?

  • 具体内容

对每个候选方案的调研与分析:

  • 概要:简要说明调研方法,并提请注意其中的模式、聚类和异常值。

  • 是否满足标准及原因

    • 概要

    • 具体内容

  • 成本分析

    • 概要

    • 示例

      • 许可,例如合同协议和法律承诺

      • 培训,例如技能提升和变更管理

      • 运营,例如支持和维护

      • 计量,例如带宽和 CPU 使用量

  • SWOT 分析

    • 概要

    • 优势(Strengths)

    • 劣势(Weaknesses)

    • 机会(Opportunities)

    • 威胁(Threats)

  • 内部意见与反馈

    • 概要

    • 示例

      • 来自团队,最好由当事人亲自撰写

      • 来自其他利益相关者

      • 质量属性,也称为跨职能需求

  • 外部意见与反馈

    • 概要

    • 谁在提供这些意见?

    • 你考虑过哪些其他候选方案?

    • 你在构建什么?

      • 示例

        • B2B 还是 B2C

        • 面向外部还是仅限员工使用

        • 桌面端还是移动端

        • 试点还是生产

        • 单体应用还是微服务

    • 你是如何评估候选方案的?

    • 你为什么选择了胜出者?

    • 自那以后情况如何?

      • 示例

        • 胜出者的表现如何?

        • 真实生产环境用户流量中有多大比例经过胜出者?

        • 涉及哪些类型的集成,例如与持续交付流水线、内容管理系统、分析与指标系统等的集成?

        • 以你现在所知,你会建议大家在哪些方面采取不同的做法?

  • 轶事

建议:

  • 概要

  • 具体内容