Architecture Decision Record

Active theme: Light

← 决策记录模板

架构决策记录(ADR)模板

迭是 EdgeX Foundry ADR 个模板。

来源:https://docs.edgexfoundry.org/2.3/design/adr/template/

提交者

列出 ADR 个提交者。

格式:

  • 姓名(组织)

变更日志

列出文件个变更,包括状态、日期搭 PR 个 URL。

状态是下底之一:待定、已批准、已修订、已弃用。

日期是 ISO 8601(YYYY-MM-DD)字符串。

PR 是提交迭个变更个 pull request,里向有差异、贡献者搭评审者等信息。

格式:

  • [ADR 个状态,比方已批准、已修订等等](pull request 个 URL) YYYY-MM-DD

引用个用例

列出所有相关个用例/需求文档。

ADR 起码需要一个相关、已批准个用例。

格式:

  • [用例名称](URL)

要是 ADR 勿是处理一个用例个全部需求,加上说明。

背景

描述:

  • 迭个设计辣架构上哪能重要,值得写 ADR(而弗是简单个 issue 搭 PR 来修复问题)

  • 高层设计办法(细节辣下底建议个设计里描述)

建议个设计

设计个细节(尽可能勿深入实现)。

概要:

  • 会受影响(被更改)个服务/模块

  • 要新增个服务/模块

  • 模型搭 DTO 个影响(更改/新增/删除)

  • API 个影响(更改/新增/删除)

  • 一般配置个影响(建立新章节、更改/新增/删除)

  • devops 个影响

考虑事项

记下备选方案、顾虑、附带或者相关个问题,还有辣 ADR 辩论当中提出个问题。

讲明伊拉有勿有解决或者缓和,哪能解决或者缓和个。

决策

记下任何一致同意个重要实现细节、注意事项、以后个考虑,还有剩下或者推迟个设计问题。

记下建议个设计呒没满足个需求个任何部分。

其他相关个 ADR

列出任何相关个 ADR,比方某个功能个子组件个设计决策、因为迭个设计而被弃用个设计等等。

格式:

  • [ADR 标题](URL) - 相关性

参考资料

列出其他参考资料。

格式:

  • [标题](URL)