知识卡片

普通读书笔记卡 · 4737

不涉及的设计也写无

理解等级:初级

架构设计文档描述选定方案的细化:总体方案与架构图、核心流程、详细设计(高可用、高性能、可扩展、安全等)、部署方案和演进规划。不涉及的设计点也要写“无”,表示考虑过但不需要;完全不写会被当成遗漏。已知不处理的场景也要写明,如 SDK 缓存的消息遇重启会丢失,由业务方兜底。需求一次做完周期太长时,按期拆分。发散:写明不做什么,评审才不反复追问。参见[[避免”PPT架构师”陷阱——细节可能推翻整个方案]]。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《从0开始学架构》第55章《50|架构实战:架构设计文档模板》“架构设计模板”(源文件:`_epub-src/OEBPS/Text/part0054_split_002.html`) - 结论依据:原文的架构设计模板包括总体方案、架构总览、核心流程、详细设计(高可用、高性能、可扩展、安全、其他)、部署方案和架构演进规划;并特别注明方案不涉及的设计点要简单写“无”,否则评审时可能被认为遗漏;需求完善但一次做完周期长时,应分期实施;示例还写明 SDK 缓存消息遇业务服务器重启会永久丢失、SDK 不做处理,由业务方自行持久化。 - 原始内容:[此处省略具体设计。如果方案不涉及,可以简单写上“无”,表示设计者有考虑但不需要设计;否则如果完全不写的话,方案评审的时候可能会被认为是遗漏了设计点]