1. 文档目的
本文档用于说明课程内核重构的迁移路径，确保实现阶段以 15、16 号文档为基线推进，而不是被旧结构牵回去。
2. 当前迁移总原则
- 先冻结协议，再推进实现
- 先搭新骨架，再迁移旧能力
- 先打通正向主链，再补另外两条主线
- 先模块化单体，再判断是否拆服务
- 技术栈替换不是当前前置中心任务
3. 迁移目标
3.1 业务目标
- 让课程内核能够稳定生成课程主干
- 让生成结果可被运行、训练和回挂
- 让补救主线和能力主线有正式承接对象
3.2 工程目标
- 建立新工程骨架
- 冻结领域模型和生成协议
- 建立最小任务模型和运行模型
- 建立稳定持久化边界
4. 非目标
当前迁移阶段不以以下事项为优先：
- 不以平台外壳重做为优先
- 不以多角色权限体系为优先
- 不以多媒体深课程化为优先
- 不以微服务拆分为优先
- 不以大规模技术栈切换为优先
5. 迁移对象优先级
5.1 第一优先级
Stage / Unit / Scene / PracticePlanGenerationInputV2StagePlan / UnitPlan / ScenePlan / StageArtifact
5.2 第二优先级
GapProfile / RemediationCoursePlanProblemSolvingPattern / CapabilityUnitLearningProgress / RuntimeSnapshot
5.3 第三优先级
- 学科增强器
- 局部编辑和局部重生成
- 高级导出和复杂投影
6. 阶段路线
阶段 0：蓝图冻结
交付物：
- 蓝图
- 路线图
- 实施级文档
- 第一批基础文档对齐稿
退出标准：
- 关键对象不再反复改名改义
阶段 1：新工程骨架建立
重点：
- 建立
apps/web / apps/api - 建立
packages/domain-model / generation-contracts / course-kernel / runtime-engine / subject-enhancers / infra-adapters
退出标准：
- 新工程能独立编译
- 包级依赖方向清晰
阶段 2：领域模型与协议落地
重点：
- 落
GenerationInputV2 - 落
Stage -> Unit -> Scene -> PracticePlan - 落最小任务状态协议
退出标准：
- 三条主线输入样例都可被协议表达
阶段 3：正向主链打通
重点：
forward_design- 教材同步课
- 课程主干稳定生成
退出标准：
- 第一条课程可生成并运行
阶段 4：教学运行内核打通
重点：
- Scene 切换
- Action 执行
- 检查点与快照回传
退出标准：
- 生成结果可进入最小运行闭环
阶段 5：诊断补救主线打通
重点：
GapProfileRemediationStrategySelectorRemediationCoursePlan
退出标准：
- 能从诊断证据生成补救课程
阶段 6：能力专题主线打通
重点：
ProblemSolvingPatternCapabilityUnit- 四次投影链
退出标准：
- 能从样题或能力目标生成专题课
阶段 7：学科增强与导出补齐
重点：
- 首批语数英增强器
- 局部修订
- 最小导出能力
阶段 8：平台外壳扩展
重点：
- 组织
- 权限
- 分发
- 协作
7. P0 / P1 / P2 优先级
P0
先做出课程主干：
- 新工程骨架
- 核心协议
- 正向组课主链
- 最小运行链
P1
做成三条正式主线：
- 补救主线
- 能力主线
- 首批学科增强
P2
做强与做深：
- 课程质量增强
- 深交互
- 动画 / 视频 / TTS / ASR 深课程化
- 更复杂投影和导出
8. 当前实施建议
当前不建议把下面这些事提前：
- 为未来平台化预埋过重抽象
- 为了技术栈替换而先改业务对象
- 同时深做三条主线
- 用 UI 状态反向定义课程协议
9. 结论
当前正确的迁移顺序不是：
- 先重做页面
- 先重做后端框架
- 先重做平台体系
而是：
- 先冻结对象
- 先搭新骨架
- 先打通
forward_design - 再补补救与能力专题主线
后续所有工程实施都应沿这条路线推进。