系统设计 | 如何表达迭代技术方案?（战术篇）

文 | 少个分号（转载请注明出处）

在敏捷项目中，迭代前的技术方案设计是确保开发顺利进行的关键步骤。本文介绍了迭代技术方案的逻辑和输出物，强调设计文档的短暂性、准确性、文本化、形式化和可被反合的特点以及只做必要的设计。

技术方案设计的核心是采用形式化模型，如领域模型、数据库模型、API模型、交互流程等，以便团队成员能够并行工作并集成。特别提到使用PlantUML表达领域模型，强调其文本化、形式化和易渲染的特性。对领域模型图的产出要求包括英文命名、全量字段信息、枚举的准确使用。

数据库模型以DDL语句输出，API模型使用OpenAPI格式描述，流程模型推荐使用时序图来表达。对于不能用模型描述的技术方案，可以使用Markdown等标记语言进行文档编写。

文本格式和形式化模式的另一优点是它们适合用于代码生成器，简化样板代码的工作量，保持代码骨架一致性。文中还讨论了活文档的概念，即通过代码生成的文档，以帮助人们理解系统。

最后强调迭代方案的本质是模型，从模型到代码再到模型的循环过程，以及技术方案设计的重要性，要求用词精确，以便通过代码自身解释业务逻辑。