跳转至

架构设计

本目录用于集中承载跨模块、跨系统或面向具体交付物的架构设计文档。

systems/ 目录不同,这里的文档更强调设计决策、边界划分、实现落点与演进路径,而不是某个稳定子系统的运行手册。

适用范围

  • 新功能或新工作台的架构方案
  • 跨前后端的集成设计
  • 还在演进中的模块拆分与边界设计
  • 需要沉淀设计约束、取舍和代码入口的专题

当前条目

其中:

  • AI Service 总体架构设计 描述当前 ai_service 的现状拓扑与主图
  • AI Service v2 目标架构设计 描述正在推进的新主干、模块边界与迁移规则
  • Outlook Index 架构设计 描述面向具体工作台的前后端集成设计

与其他文档目录的关系

  • systems/: 面向稳定系统能力的架构、运行时、运维和参考文档
  • guides/: 面向使用者或维护者的操作说明
  • core/: 面向平台核心概念和底层设计主线
  • architecture/: 面向具体方案的设计稿、边界说明和落地入口

编写约定

  • 先写设计目标与边界,再写模块拆分和数据流
  • 明确复用哪些已有能力,避免平行造层
  • 给出关键代码入口,方便设计和实现互相映射
  • 若设计已落地为稳定系统,应补充或迁移到 systems/ 中的对应文档