math_cms/docs/chapter-diagnostic-plan.md

章节摸底 + 按知识点顺序学习 方案文档

1. 需求概述

1.1 核心流程

章节摸底(20题) → 按知识点顺序学习 → 知识点达标(90%) → 下一个知识点 → 章节全部达标 → 下一章摸底

1.2 关键规则

1. 知识点来源：section 直接绑定的知识点（不扩展子知识点）
2. 90%判断：跳过没有题目的知识点
3. 智能组卷：按顺序找第一个未达标知识点，最多2个知识点
4. 题目不够：不从其他知识点补充，不够就不够
5. 章节流转：所有知识点达标 → 下一章摸底

---

2. assembleType 映射关系

2.1 前端传入 → 后端实际处理

前端传入	后端实际处理	说明
0 (旧摸底)	0 → buildChapterDiagnosticParams	章节摸底（新逻辑）
9 (原摸底)	0 → buildChapterDiagnosticParams	章节摸底（新逻辑）
1 (智能组卷)	8 → buildChapterIntelligentParams	按知识点顺序学习（新逻辑）
2/3/4/5	保持不变	原有逻辑不动

2.2 paper_type 值

paper_type	含义
0	摸底（包括章节摸底）
1	智能组卷
2	知识点组卷
3	教材组卷
5	追练

---

3. 数据库修改

3.1 papers 表增加字段

ALTER TABLE papers ADD COLUMN diagnostic_chapter_id INT NULL COMMENT '摸底的章节ID';

---

4. 代码修改清单

4.1 新增方法（不影响原有逻辑）

文件	方法	用途
ExamTypeStrategy.php	buildChapterDiagnosticParams	章节摸底（新逻辑）
ExamTypeStrategy.php	buildChapterIntelligentParams	按知识点顺序学习（新逻辑）
DiagnosticChapterService.php	getChapterKnowledgePointsWithoutExpand	获取知识点（不扩展子知识点）
DiagnosticChapterService.php	getFirstUnmasteredKnowledgePointInOrder	按顺序找第一个未达标知识点
DiagnosticChapterService.php	hasChapterDiagnostic	判断章节是否已摸底
StudentKnowledgeMastery.php	allAtLeastSkipNoQuestions	判断达标（跳过无题知识点）

4.2 修改方法

文件	方法	修改内容
ExamTypeStrategy.php	buildParams	增加 assembleType 映射逻辑

4.3 保持不变的方法

• buildDiagnosticParams（原摸底）
• buildIntelligentAssembleParams（原智能组卷）
• buildKnowledgePointAssembleParams（知识点组卷）
• buildTextbookAssembleParams（教材组卷）
• buildMistakeParams（追练）
• buildGeneralParams（通用）

---

5. 详细逻辑

5.1 章节摸底 (buildChapterDiagnosticParams)

1. 获取学生当前教材
2. 找第一个未完成摸底的章节：
   - 遍历章节，检查 papers 表是否有 paper_type=0 且 diagnostic_chapter_id=章节ID 的记录
   - 如果没有，说明这个章节需要摸底
3. 获取该章节所有 section 绑定的知识点（不扩展子知识点）
4. 过滤掉没有题目的知识点
5. 用这些知识点出题（20题）
6. 保存时记录 diagnostic_chapter_id

5.2 按知识点顺序学习 (buildChapterIntelligentParams)

1. 获取当前应该学习的章节（第一个有未达标知识点的章节）
2. 检查该章节是否已摸底
   - 如果没有摸底 → 返回章节摸底参数
3. 获取该章节所有知识点（按 section 顺序）
4. 按顺序遍历，找第一个未达标的知识点（跳过无题知识点）
5. 检查题目数量：
   - 如果不够20题，补充下一个未达标知识点
   - 最多2个知识点
6. 如果所有知识点都达标 → 返回下一章的摸底参数

5.3 90%达标判断 (allAtLeastSkipNoQuestions)

1. 遍历章节的所有知识点
2. 检查每个知识点是否有题目
   - 没有题目 → 跳过
3. 检查掌握度是否 >= 90%
   - 有题但没有掌握度记录 → 视为 0%，未达标
4. 所有有题的知识点都达标 → 返回 true

---

6. 执行步骤

1. 创建方案文档
2. 创建 migration 增加 diagnostic_chapter_id 字段
   • 文件: database/migrations/2026_02_01_000001_add_diagnostic_chapter_id_to_papers_table.php
3. 修改 StudentKnowledgeMastery 增加新方法
   • allAtLeastSkipNoQuestions: 判断达标（跳过无题知识点）
   • getFirstUnmasteredKpCode: 获取第一个未达标的知识点
4. 修改 DiagnosticChapterService 增加新方法
   • getChapterKnowledgePointsSimple: 获取知识点（不扩展子知识点）
   • hasChapterDiagnostic: 判断章节是否已摸底
   • getFirstUndiagnosedChapter: 获取第一个未摸底的章节
   • getCurrentLearningChapter: 获取当前学习章节
   • getNextChapter: 获取下一个章节
   • filterKpCodesWithQuestions: 过滤有题的知识点
   • getUnmasteredKpCodesInOrder: 按顺序获取未达标知识点
5. 修改 ExamTypeStrategy 增加新方法和映射逻辑
   • 修改 buildParams: 增加 assembleType 映射
   • 新增 buildChapterDiagnosticParams: 章节摸底
   • 新增 buildChapterIntelligentParams: 按知识点顺序学习
6. 修改 QuestionBankService 保存 diagnostic_chapter_id
7. 修改 Paper 模型增加 diagnostic_chapter_id 字段
8. 执行 migration
9. 测试验证

---

7. 风险控制

• 所有原有方法保持不变
• 新增独立方法处理新逻辑
• 通过 assembleType 映射控制流程
• 即使新逻辑有问题，也不影响 assembleType=2/3/4/5 的原有功能