Question

软件架构部分是“大局”视图，可以呈现出软件的结构。传统的软件架构文档往往称之为“概念视图”或“逻辑视图”，人们常常对这些视图是否应该指的是技术选择之类实现细节感到困惑。

意图

这个部分的目的是总结你的软件系统的软件架构，这样就能回答以下问题。

“大局”看起来是什么样？

是否有清晰的结构？

从“30000英尺视图”看系统如何工作是否清楚？

它展示了主要的容器和技术选择吗？

它展示了主要的组件及其交互吗？

关键的内部接口是哪些？（比如，你的Web层和业务层之间的Web服务。）

结构

我用容器和组件图作为这个部分的重点，附上一小段解释图所展示内容的叙述和对每个容器/组件的总结。

有时候，展示组件交互的UML序列或协作图是描绘软件如何满足主要用例/用户故事/等的一个很有用的方法。但是，要抵挡住描述每个用例/用户故事如何工作的诱惑，只有当它能增加价值时才这样做！

动机

写这个部分的动机是它为人们提供了可以得到软件概览的地图，并帮助开发者浏览代码库。

受众

主要是软件开发团队中的技术人员。

是否必须

是，所有软件指南都应该包含软件架构部分，因为要让开发团队中每个人都很好地理解软件整体结构，它就是必要的。