1. 文档目的
本文档用于定义当前课程内核的正式领域对象，作为后续实现、协议、存储和运行设计的共同基线。
本文件以 15、16 号文档为最高依据，重点回答：
- 哪些对象属于课程主骨架
- 哪些对象属于运行附属模型
- 哪些对象用于补救与能力主线
2. 建模原则
- 领域模型独立于 UI 和数据库
- 课程主骨架稳定优先
- 运行态对象与课程资产对象分离
- 学科增强通过注入扩展，不改写主骨架
- 三条正式主线共享同一套核心对象
3. 核心对象分层
3.1 课程主骨架
StageUnitScenePracticePlan
3.2 知识与能力层
KnowledgePointCompositeKnowledgeChainProblemSolvingPatternCapabilityUnit
3.3 诊断与补救层
GapProfileRemediationCoursePlan
3.4 运行附属层
ActionAgentAssetRefPlaybackSnapshotLearningProgress
4. Stage
Stage 表示一门完整课程或一个完整课堂实例，是课程聚合根。
建议字段：
| 字段 | 说明 |
|---|---|
id | Stage 唯一标识 |
title | 课程标题 |
subject | 学科 |
schoolStage | 学段 |
gradeLevel | 年级 |
courseStrategy | 课程生产约束 |
lessonIntent | 当前课程任务 |
assemblyMode | 主装配方式 |
learningSessionMode | 三条主线入口 |
unitIds | 课程下属 Unit |
projectionRefs | 投影结果引用 |
assetRefs | 课程资产引用 |
createdAt / updatedAt | 时间戳 |
职责：
- 持有课程级约束和元信息
- 组织
Unit - 作为保存、导出、复用、运行的顶层对象
5. Unit
Unit 是面向教学目标的组织块，不等同于教材章节别名。
建议字段：
| 字段 | 说明 |
|---|---|
id | Unit 唯一标识 |
stageId | 所属 Stage |
title | Unit 标题 |
order | 顺序 |
unitType | 结构类型 |
assemblyMode | 装配方式 |
knowledgePointIds | 关联知识点 |
teachingObjectives | 教学目标 |
sceneIds | 下属 Scene |
practicePlanId | 关联训练计划 |
estimatedDurationSec | 预估时长 |
sourceRefs | 来源引用 |
当前正式 UnitType：
chapter_unitreview_unitremediation_unitcapability_unit
6. Scene
Scene 是课堂运行时最小教学场景。
建议字段：
| 字段 | 说明 |
|---|---|
id | Scene 唯一标识 |
unitId | 所属 Unit |
type | 场景类型 |
scenePattern | 教学意图模式 |
title | 场景标题 |
order | 顺序 |
content | 场景内容 |
actionRefs | 运行动作引用 |
checkpointRefs | 检查点引用 |
estimatedDurationSec | 预估时长 |
当前正式 SceneType：
slidequizinteractivepbl
常用 scenePattern：
concept_explanationworked_examplequiz_checkreview_feedbackreinforcement_blocksummary_transfer
7. PracticePlan
PracticePlan 是课程主骨架正式对象，用于承接课内、课后和补缺训练结构。
建议字段：
| 字段 | 说明 |
|---|---|
id | 训练计划 ID |
stageId | 所属 Stage |
unitId | 所属 Unit |
trainingBlocks | 训练段集合 |
assessmentFocus | 检查重点 |
commonMistakeFocus | 易错点聚焦 |
masteryCheckpoints | 掌握检查点 |
feedbackLoop | 回挂机制摘要 |
8. KnowledgePoint
KnowledgePoint 是课程内核的一等对象。
建议字段：
| 字段 | 说明 |
|---|---|
id | 知识点 ID |
subject | 学科 |
gradeLevel | 年级 |
chapter | 所属章节 |
title | 名称 |
description | 定义说明 |
prerequisites | 先修依赖 |
difficultyBand | 难度带 |
examRelevance | 考纲关联度 |
9. CompositeKnowledgeChain
CompositeKnowledgeChain 用于描述综合题背后需要联合调动的知识链。
建议字段：
| 字段 | 说明 |
|---|---|
id | 链 ID |
subject | 学科 |
title | 名称 |
knowledgePointIds | 关联知识点集合 |
dependencyEdges | 依赖边 |
bridgeConcepts | 关键桥接概念 |
targetProblemTypes | 目标题型 |
10. ProblemSolvingPattern
ProblemSolvingPattern 是能力模式原子，描述一类题的稳定解题结构。
建议按五层组织：
identityapplicabilitycognitiveKerneltrainingHintsassemblyHints
核心字段：
| 字段 | 说明 |
|---|---|
identity.id | 模式标识 |
identity.subject | 学科 |
identity.name | 名称 |
applicability.applicableProblemTypes | 适用题型 |
applicability.entrySignals | 识别信号 |
cognitiveKernel.requiredKnowledgeChains | 所需知识链 |
cognitiveKernel.reasoningSteps | 结构化步骤对象 |
cognitiveKernel.commonMistakes | 常见错误 |
cognitiveKernel.successCriteria | 学会判据 |
trainingHints.variantAxes | 变式轴 |
trainingHints.assessmentFocus | 检查重点 |
边界：
- 不直接拥有
Scene - 不直接拥有题目实例
- 不定义 UI 表现
- 可以被多个
CapabilityUnit复用
11. CapabilityUnit
CapabilityUnit 是对 ProblemSolvingPattern 的教学化裁剪结果。
建议字段：
| 字段 | 说明 |
|---|---|
id | 能力单元 ID |
stageId | 所属 Stage |
title | 标题 |
unitType | 固定为 capability_unit |
patternRefs | 关联模式 |
knowledgeChainRefs | 关联知识链 |
targetCapability | 目标能力 |
coverageScope | 覆盖范围 |
errorFocus | 本轮错误聚焦 |
masteryCheckpointPlan | 掌握检查规划 |
它不是 Pattern 的原样复制，而是面向课堂的教学组织对象。
12. GapProfile
GapProfile 用于描述学习缺口画像。
建议采用多维结构：
gapTypesgapTraitsevidenceSourcesdecisionHints
建议字段：
| 字段 | 说明 |
|---|---|
id | 画像 ID |
learnerId | 学生标识 |
knowledgeGaps | 知识缺口 |
prerequisiteGaps | 先修断层 |
errorPatterns | 错误模式 |
falseMasterySignals | 假掌握信号 |
gapTypes | 主类 |
gapTraits | 表现特征 |
evidenceSources | 证据来源 |
decisionHints | 默认建议 |
职责边界：
GapProfile回答“为什么不会”RemediationStrategySelector回答“这次怎么补”
13. RemediationCoursePlan
RemediationCoursePlan 用于把 GapProfile 转成可执行补救路径。
建议字段：
| 字段 | 说明 |
|---|---|
id | 计划 ID |
gapProfileId | 来源画像 |
remediationMode | rollback / recompose / hybrid |
targetKnowledgePoints | 目标知识点 |
backfillUnits | 回退单元 |
bridgeUnits | 过渡单元 |
practiceBlocks | 训练块 |
masteryCheckpoints | 检查点 |
exitCriteria | 退出条件 |
feedbackLoop | 回挂机制 |
14. 运行附属模型
14.1 Action
Action 是运行层统一动作协议，挂载在 Scene 运行阶段消费。
14.2 Agent
Agent 是运行和讨论角色对象，不进入课程主骨架。
14.3 AssetRef
AssetRef 负责引用图片、视频、音频、导出文件等外部资源。
14.4 PlaybackSnapshot
PlaybackSnapshot 表示运行快照，用于暂停、恢复和回放。
15. 结论
当前正式领域模型应围绕以下主线理解：
- 课程主骨架：
Stage -> Unit -> Scene -> PracticePlan - 知识与能力层：
KnowledgePoint -> CompositeKnowledgeChain -> ProblemSolvingPattern -> CapabilityUnit - 补救层：
GapProfile -> RemediationCoursePlan - 运行附属层：
Action / Agent / AssetRef / PlaybackSnapshot
后续实现、协议、存储和运行设计都不得偏离这条结构。