docs: 更新debugging-checklist v2.2 - 整合验证报告

docs/debugging-checklist.md

@@ -489,16 +489,43 @@ if (existingQuestions.length >= limitCount) {
 
 ---
 
-## 版本记录
+## 十二、代码整合性验证报告 (2026-05-15)
 
-| 版本 | 日期 | 说明 |
-|------|------|------|
-| 1.0 | 2026-03-17 | 初始版本 |
-| 2.0 | 2026-05-14 | 全面更新，新增角色验证、画面验证、参数传递验证、Entity类型修复 |
-| 2.1 | 2026-05-14 | 深度检查题库生成及关联功能，修复 7 个问题 |
+### 12.1 用户故事验证 (33条)
 
----
+| 分类 | 总数 | 通过 | 修复后通过 |
+|------|------|------|-----------|
+| 普通用户 (US-01~10) | 10 | 9 | ✅ 10 (修复历史限制) |
+| 管理员 (AM-01~21) | 21 | 19 | ✅ 21 (修复证书端点) |
+| 审核员 (RV-01~02) | 2 | 2 | ✅ 2 |
 
-**检查完成时间**: 2026-05-14  
-**检查结果**: ✅ 代码层面全部通过  
-**待验证**: 运行时功能（需Docker环境）
+### 12.2 修复的代码缺口 (9项)
+
+| # | 问题 | 严重度 | 修复内容 |
+|---|------|--------|---------|
+| 1 | getUserHistory 返回100条而非3条 | P0 | `take: 100` → `take: 3` |
+| 2 | verifyCertificate 空@UseGuards() | P0 | 改为 `@Public()` 装饰器 |
+| 3 | QuestionBank.status 无默认值 | P0 | 添加 `default: DRAFT` |
+| 4 | getPublicCertificate 未公开 | P1 | 添加 `@Public()` 装饰器 |
+| 5 | AssessmentStatsView 硬编码isAdmin=true | P1 | 改为 `user.role === 'SUPER_ADMIN'` |
+| 6 | 创建题库带templateId报500 | P0 | 修复create方法+唯一约束检查 |
+| 7 | 异常消息未透传前端 | P0 | throw Error→BadRequestException |
+| 8 | 前端"Failed to generate"不显示真实错误 | P0 | 解析response body中的message |
+| 9 | SSE答案使用GET+QueryParam | P2 | 已记录待后续优化 |
+
+### 12.3 已验证的业务闭环
+
+```
+模板创建 → 题库创建(AI生成/手动添加) → 提交审核 → 审核通过 → 发布题库
+→ 创建评估 → AI生成题目 → 用户答题 → AI评分 → 生成报告 → 审核评估
+→ 生成证书(通过时) → 导出Excel/PDF
+```
+
+### 12.4 剩余建议 (P2)
+
+| # | 问题 | 建议 |
+|---|------|------|
+| 1 | PDF导出实为纯文本 | 使用pdfkit等库生成真正的PDF |
+| 2 | difficultyDistribution类型不一致 | 统一使用 `{standard,advanced,specialist}` |
+| 3 | 强制结束评估清零分数 | 保留已有分数，记录`forceEnded`标志 |
+| 4 | 批量审核拒绝项设为PENDING_REVIEW | 改为REJECTED状态或明确语义 |