架构总览怎么写，才算工业级？

📈系统架构文档是整个项目最重要的起点，但很多人第一章就“写穿了”： 不是写得太细，就是没有重点。想要写出高质量、能协作、能传承的架构文档，这一篇会告诉你应该怎么做——

---

✅ 架构总览的终极目标

明确边界、定义角色、画清数据流

别讲执行细节，别深入函数调用。

✅ 架构总览回答四个问题：

分类	应该讲	不应该讲
模块	有哪些模块，每个负责什么	模块内怎么实现功能
关系	模块之间怎么协作	模块里函数怎么写
流向	数据怎么流、事件怎么驱动	哪个 API 要怎么调用
规则	系统行为守则（不调用、不耦合）	状态机怎么切换

🎯 一句话总结边界感：

架构总览只负责回答“谁做什么、怎么配合”，不负责解释“他是怎么做的”。

---

🎬 架构总览的角色定位：像导演分镜头脚本

<