架构设计
本目录用于集中承载跨模块、跨系统或面向具体交付物的架构设计文档。
与 systems/ 目录不同,这里的文档更强调设计决策、边界划分、实现落点与演进路径,而不是某个稳定子系统的运行手册。
适用范围
- 新功能或新工作台的架构方案
- 跨前后端的集成设计
- 还在演进中的模块拆分与边界设计
- 需要沉淀设计约束、取舍和代码入口的专题
当前条目
其中:
AI Service 总体架构设计描述当前ai_service的现状拓扑与主图AI Service v2 目标架构设计描述正在推进的新主干、模块边界与迁移规则Outlook Index 架构设计描述面向具体工作台的前后端集成设计
与其他文档目录的关系
systems/: 面向稳定系统能力的架构、运行时、运维和参考文档guides/: 面向使用者或维护者的操作说明core/: 面向平台核心概念和底层设计主线architecture/: 面向具体方案的设计稿、边界说明和落地入口
编写约定
- 先写设计目标与边界,再写模块拆分和数据流
- 明确复用哪些已有能力,避免平行造层
- 给出关键代码入口,方便设计和实现互相映射
- 若设计已落地为稳定系统,应补充或迁移到
systems/中的对应文档