课堂运行状态机

1. 文档目的

本文档用于说明教学运行内核如何消费已装配课程资产并驱动课堂过程。

2. 运行定位

运行内核不参与组课决策，只消费：

• StageArtifact
• StageProjection

它服务的主骨架是：

• Stage -> Unit -> Scene

3. 运行目标

运行系统需要支持：

1. Unit 内 Scene 顺序运行
2. Scene 级 Action 执行
3. 检查点与课中小测
4. 暂停、恢复、回放
5. 学习进度与快照回写

4. 顶层状态

• idle
• playing
• paused
• live
• completed

说明：

• live 表示互动、讨论或临时控制态

5. 运行对象

5.1 RuntimeSession

负责维护：

• 当前 Stage
• 当前 Unit
• 当前 Scene
• 当前 Action 游标

5.2 ActionExecutor

负责执行 Scene 附属运行对象：

• speech
• spotlight
• laser
• play_video
• wb_*

5.3 CheckpointCoordinator

负责：

• 课中小测
• 掌握检查点
• PracticePlan 检查触发

5.4 SnapshotStore

负责：

• RuntimeSnapshot
• 恢复信息
• 学习进度回写

6. 典型状态流

6.1 正常播放

1. 进入 Stage，状态 idle
2. 开始运行，进入 playing
3. 在当前 Unit 中逐个切换 Scene
4. 执行当前 Scene 对应 Action
5. 触发检查点或小测
6. 所有 Unit 完成后进入 completed

6.2 暂停恢复

1. playing 中触发暂停
2. 进入 paused
3. 保存 RuntimeSnapshot
4. 恢复后回到 playing

6.3 互动/讨论

1. 从 playing 进入 live
2. 执行讨论、问答或老师控制动作
3. 结束后回到 playing

7. 与 PracticePlan 的关系

运行内核需要显式支持：

• Scene 内小测
• Unit 末检查点
• PracticePlan 中的训练段触发
• 训练结果回写

运行层不能把 PracticePlan 当作课堂外无关对象。

8. 与生成链的边界

生成链负责：

• 装配课程
• 定义训练结构

运行链负责：

• 消费课程
• 驱动课堂
• 回写快照和学习进度

生成链和运行链必须分离。

9. 结论

当前运行状态机的核心不是页面播放，而是：

• 对 StageArtifact 的稳定消费
• 对 Unit / Scene / Action / Checkpoint 的稳定调度
• 对 RuntimeSnapshot / LearningProgress 的稳定回写