OpenMAIC 系统设计文档站
权威基础文档
系统设计文档站 / 权威基础文档

系统设计文档索引

本目录用于沉淀 OpenMAIC 当前有效的课程内核、工程实施和平台延展设计。

00 静态 HTML 版本 2026年5月26日 15:08

本目录用于沉淀 OpenMAIC 当前有效的课程内核、工程实施和平台延展设计。

当前正式基线以以下文档为中心：

  • 蓝图基线：15 / 16
  • 实施级基线：17 - 21
  • 对齐后的权威基础文档：01 - 12

文档列表

  1. [01-系统架构设计文档.md](./01-%E7%B3%BB%E7%BB%9F%E6%9E%B6%E6%9E%84%E8%AE%BE%E8%AE%A1%E6%96%87%E6%A1%A3.md) - 说明课程工厂与教学运行内核的目标架构、包级边界和依赖方向。
  2. [02-业务架构设计文档.md](./02-%E4%B8%9A%E5%8A%A1%E6%9E%B6%E6%9E%84%E8%AE%BE%E8%AE%A1%E6%96%87%E6%A1%A3.md) - 说明课程生产、教学运行、训练闭环和课后补缺的业务结构。
  3. [03-领域模型说明.md](./03-%E9%A2%86%E5%9F%9F%E6%A8%A1%E5%9E%8B%E8%AF%B4%E6%98%8E.md) - 定义 Stage -> Unit -> Scene -> PracticePlan 以及能力、补救对象。
  4. [04-生成链路设计.md](./04-%E7%94%9F%E6%88%90%E9%93%BE%E8%B7%AF%E8%AE%BE%E8%AE%A1.md) - 说明三条正式主线共享的生成框架和 P0 收敛路径。
  5. [05-课堂运行状态机.md](./05-%E8%AF%BE%E5%A0%82%E8%BF%90%E8%A1%8C%E7%8A%B6%E6%80%81%E6%9C%BA.md) - 说明运行内核如何消费课程资产并驱动课堂过程。
  6. [06-重构迁移计划.md](./06-%E9%87%8D%E6%9E%84%E8%BF%81%E7%A7%BB%E8%AE%A1%E5%88%92.md) - 说明从蓝图冻结到主线落地的迁移阶段和优先级。
  7. [07-生成协议草案.md](./07-%E7%94%9F%E6%88%90%E5%8D%8F%E8%AE%AE%E8%8D%89%E6%A1%88.md) - 定义 GenerationInputV2、阶段产物和任务协议。
  8. [08-运行时事件协议.md](./08-%E8%BF%90%E8%A1%8C%E6%97%B6%E4%BA%8B%E4%BB%B6%E5%8D%8F%E8%AE%AE.md) - 定义运行事件、检查点事件和与生成事件的边界。
  9. [09-存储模型与表结构草案.md](./09-%E5%AD%98%E5%82%A8%E6%A8%A1%E5%9E%8B%E4%B8%8E%E8%A1%A8%E7%BB%93%E6%9E%84%E8%8D%89%E6%A1%88.md) - 定义课程资产、运行快照、任务日志和资源资产的持久化边界。
  10. [10-技术栈选型比较.md](./10-%E6%8A%80%E6%9C%AF%E6%A0%88%E9%80%89%E5%9E%8B%E6%AF%94%E8%BE%83.md) - 说明当前阶段推荐技术栈与后续可选路线。
  11. [11-项目全景图文档.md](./11-%E9%A1%B9%E7%9B%AE%E5%85%A8%E6%99%AF%E5%9B%BE%E6%96%87%E6%A1%A3.md) - 从总览视角说明课程内核优先、平台外壳后置的全景结构。
  12. [12-平台使用场景与用户分层设计.md](./12-%E5%B9%B3%E5%8F%B0%E4%BD%BF%E7%94%A8%E5%9C%BA%E6%99%AF%E4%B8%8E%E7%94%A8%E6%88%B7%E5%88%86%E5%B1%82%E8%AE%BE%E8%AE%A1.md) - 说明内核稳定后的老师、学生、家长、学校消费与分发路径。
  13. [13-商业计划书-对外沟通版.md](./13-%E5%95%86%E4%B8%9A%E8%AE%A1%E5%88%92%E4%B9%A6-%E5%AF%B9%E5%A4%96%E6%B2%9F%E9%80%9A%E7%89%88.md) - 面向外部沟通的项目价值说明。
  14. [14-产品打磨与学科强化思路记录.md](./14-%E4%BA%A7%E5%93%81%E6%89%93%E7%A3%A8%E4%B8%8E%E5%AD%A6%E7%A7%91%E5%BC%BA%E5%8C%96%E6%80%9D%E8%B7%AF%E8%AE%B0%E5%BD%95.md) - 持续记录产品与学科增强思路，正式基线以 15-21 为准。
  15. [15-课程内核重构蓝图（V1）.md](./15-%E8%AF%BE%E7%A8%8B%E5%86%85%E6%A0%B8%E9%87%8D%E6%9E%84%E8%93%9D%E5%9B%BE%EF%BC%88V1%EF%BC%89.md) - 课程内核最高层设计蓝图。
  16. [16-课程内核重构工程推进路线图（V1）.md](./16-%E8%AF%BE%E7%A8%8B%E5%86%85%E6%A0%B8%E9%87%8D%E6%9E%84%E5%B7%A5%E7%A8%8B%E6%8E%A8%E8%BF%9B%E8%B7%AF%E7%BA%BF%E5%9B%BE%EF%BC%88V1%EF%BC%89.md) - 从 0 开始重构的新工程路线图。
  17. [17-实施级目标架构与模块依赖图.md](./17-%E5%AE%9E%E6%96%BD%E7%BA%A7%E7%9B%AE%E6%A0%87%E6%9E%B6%E6%9E%84%E4%B8%8E%E6%A8%A1%E5%9D%97%E4%BE%9D%E8%B5%96%E5%9B%BE.md) - 定义包级目标架构和依赖方向。
  18. [18-基础设施与环境配置方案.md](./18-%E5%9F%BA%E7%A1%80%E8%AE%BE%E6%96%BD%E4%B8%8E%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE%E6%96%B9%E6%A1%88.md) - 定义本地、测试、生产环境基线。
  19. [19-持久化与资源边界设计.md](./19-%E6%8C%81%E4%B9%85%E5%8C%96%E4%B8%8E%E8%B5%84%E6%BA%90%E8%BE%B9%E7%95%8C%E8%AE%BE%E8%AE%A1.md) - 说明课程资产、运行快照、任务日志和资源资产边界。
  20. [20-生成任务状态机与审计日志协议.md](./20-%E7%94%9F%E6%88%90%E4%BB%BB%E5%8A%A1%E7%8A%B6%E6%80%81%E6%9C%BA%E4%B8%8E%E5%AE%A1%E8%AE%A1%E6%97%A5%E5%BF%97%E5%8D%8F%E8%AE%AE.md) - 定义生成任务状态机和阶段日志协议。
  21. [21-P0 编码准备清单与验收标准.md](./21-P0-%E7%BC%96%E7%A0%81%E5%87%86%E5%A4%87%E6%B8%85%E5%8D%95%E4%B8%8E%E9%AA%8C%E6%94%B6%E6%A0%87%E5%87%86.md) - 收敛 P0 进入编码前的最小准备项。

建议阅读顺序

  1. 先读 15 / 16，建立顶层设计和工程路线。
  2. 再读 17 - 21，建立实施级架构、环境、存储和任务边界。
  3. 再读 01 / 03 / 04 / 06 / 07 / 09，建立权威基础结构。
  4. 然后读 02 / 05 / 08 / 10 / 11 / 12，理解业务、运行、技术栈和平台延展。
  5. 最后读 13 / 14，作为外部沟通和长期记录补充。

当前判断基线

基于当前蓝图，系统最核心的判断已经固定为：

  • 系统本质是 课程工厂 + 教学运行内核
  • 第一阶段实现形态是 模块化单体
  • 课程主骨架是 Stage -> Unit -> Scene
  • PracticePlan 进入课程主干
  • 三条正式主线入口为 forward_design / diagnostic_remediation / capability_reverse_design

维护原则

  1. 15、16 为最高基线，不被旧文档反向修正
  2. 17-21 为实施级正式基线
  3. 01-12 为权威基础文档，必须与 15-21 对齐
  4. HTML 发布页应与 Markdown 源文档同步刷新