docs: update architecture docs, audit reports, and bug tracking

- Update architecture impact map, data, feature checklist, gap audit

- Add audit reports for dashboard, exam-homework, grades-diagnostic, settings-profile, textbooks

- Update bug reports (admin, teacher, lesson-preparation, others, shared)

- Update coding standards, DR plan, design docs, and README

docs/architecture/005_architecture_data.json

@@ -5,7 +5,7 @@
     "generatedAt": "2026-06-17",
     "formatVersion": "1.1",
     "rule": "每次文件修改后须同步更新本文件",
-    "lastUpdate": "V4 AI 模块深度增强（ai-module-v2 对标 Khanmigo/Duolingo Max/Squirrel AI/Century Tech）：(V4-1) SSE 流式响应：shared/lib/ai/client.ts 新增 createAiChatCompletionStream（AsyncGenerator 逐 token 产出），新增 API 路由 /api/ai/chat/stream（POST，requirePermission(AI_CHAT)+checkDailyLimit+filterUserInput+学生苏格拉底系统提示+ReadableStream 流式输出+filterAiOutput+incrementDailyUsage+trackEvent），新增 hook useAiChatStream（fetch+ReadableStream reader+SSE 解析+AbortController 停止生成+localStorage 持久化最近 20 条）。(V4-2) Markdown 渲染：新增组件 AiMarkdownRenderer（react-markdown+remark-gfm，代码块/表格/列表+hover 复制按钮+memo 优化），AiChatPanel 全面重写（流式渲染+停止按钮+清空确认+建议提示词空状态+aria-live+错误展示）。(V4-3) 全局 AI 助手：新增组件 AiAssistantWidget（fixed 浮动按钮+Sheet 侧抽屉+usePathname 路由推断上下文+inferContextFromPath 映射 7 类场景系统提示：教师批改/备课/考试/学生错题本/学生作业/家长/管理员+useAiClientOptional 无 Provider 时隐藏+pulsing 绿色指示器），dashboard layout 全局注入 AiClientProvider+AiAssistantWidget。(V4-4) 内容安全：新增 services/content-safety.ts（filterUserInput 阻断暴力/自残/色情/毒品/黑客/PII 索取；filterAiOutput 输出二次过滤+学生场景阻断直接答案；checkDailyLimit 学生 50/教师 200/家长 30/管理员 500；incrementDailyUsage；getDailyLimit），COPPA/FERPA K12 合规。(V4-5) 多角色 AI 覆盖：types.ts 新增 ChildSummaryInput/Result、StudyPathInput/Result、AiUsageStats 类型 + AiService/AiClientService 接口扩展；schema.ts 新增 4 个 Zod schema；prompt-templates.ts 新增 CHILD_SUMMARY_SYSTEM_PROMPT（家庭教育顾问，家长友好语言）+ STUDY_PATH_SYSTEM_PROMPT（自适应学习路径设计师，3-7 步骤）；ai-service.ts 新增 generateChildSummary（聚合成绩/出勤/错题本数据）+ recommendStudyPath（基于掌握度数据）；actions.ts 新增 generateChildSummaryAction/recommendStudyPathAction（AI_CHAT 权限）+ getAiUsageStatsAction（AI_CONFIGURE 权限）；新增组件 AiChildSummary（家长端：整体评估 Markdown+优势绿勾+改进橙警+家庭辅导建议+下一步徽章）、AiUsageDashboard（管理员端：4 统计卡片+按能力进度条+按角色徽章+Top 用户列表+最近活动日志）、AiStudyPath（学生端：当前等级横幅+学习路径步骤+连接线+状态图标+预估时间+激励消息）。(V4-6) i18n 修复与扩展：修复 AiGradingAssist/AiLessonContentGenerator/AiQuestionVariantGenerator 共 8 处错误 i18n 键引用（CardDescription 重复 title、label/placeholder/button 复用 generateContent、3 个变体类型标签全部显示「生成」）；zh-CN/en ai.json 全面重写新增 chat.streaming/stopGeneration/copy/clearConfirm/suggestedPrompts、grading.description/batch*、lessonPrep.description/additionalContext/insertContent、exam.variantType.*/targetDifficulty/addVariant、parent.*、admin.*、studyPath.*、widget.*、safety.* 等键。架构文档 004/005 同步更新。"
+    "lastUpdate": "grades 模块 v3/v4 P3 长期问题修复（2026-06-23）：(v3-P3-1) batch-grade-entry.tsx 新增下载模板按钮，客户端生成 CSV 模板（含学生姓名/分数/备注列头 + BOM 支持 Excel UTF-8）。(v3-P3-2) grade-record-list.tsx 新增多选复选框（全选/单选）+ 批量删除工具栏 + 批量删除确认对话框；data-access.ts 新增 bulkDeleteGradeRecords（使用 inArray 一次性删除避免 N+1）；actions.ts 新增 bulkDeleteGradeRecordsAction（GRADE_RECORD_MANAGE 权限 + 限制单次最多 500 条）。(v4-P3-2) batch-grade-entry.tsx 顶部新增可折叠新手引导提示框（4 步使用说明），使用 localStorage 记住用户关闭状态。i18n zh-CN/en grades.json 同步新增 batch.downloadTemplate/templateAriaLabel/templateStudentName/templateScore/templateRemark/templateFilename + batch.guide.* + list.bulkDelete/bulkDeleteConfirmation/bulkDeleteSelected/bulkDeleteSuccess/bulkDeleteFailed/selectAll/selectRow/clearSelection 键。--- 之前更新：V4 AI 模块深度增强（ai-module-v2 对标 Khanmigo/Duolingo Max/Squirrel AI/Century Tech）：(V4-1) SSE 流式响应：shared/lib/ai/client.ts 新增 createAiChatCompletionStream（AsyncGenerator 逐 token 产出），新增 API 路由 /api/ai/chat/stream（POST，requirePermission(AI_CHAT)+checkDailyLimit+filterUserInput+学生苏格拉底系统提示+ReadableStream 流式输出+filterAiOutput+incrementDailyUsage+trackEvent），新增 hook useAiChatStream（fetch+ReadableStream reader+SSE 解析+AbortController 停止生成+localStorage 持久化最近 20 条）。(V4-2) Markdown 渲染：新增组件 AiMarkdownRenderer（react-markdown+remark-gfm，代码块/表格/列表+hover 复制按钮+memo 优化），AiChatPanel 全面重写（流式渲染+停止按钮+清空确认+建议提示词空状态+aria-live+错误展示）。(V4-3) 全局 AI 助手：新增组件 AiAssistantWidget（fixed 浮动按钮+Sheet 侧抽屉+usePathname 路由推断上下文+inferContextFromPath 映射 7 类场景系统提示：教师批改/备课/考试/学生错题本/学生作业/家长/管理员+useAiClientOptional 无 Provider 时隐藏+pulsing 绿色指示器），dashboard layout 全局注入 AiClientProvider+AiAssistantWidget。(V4-4) 内容安全：新增 services/content-safety.ts（filterUserInput 阻断暴力/自残/色情/毒品/黑客/PII 索取；filterAiOutput 输出二次过滤+学生场景阻断直接答案；checkDailyLimit 学生 50/教师 200/家长 30/管理员 500；incrementDailyUsage；getDailyLimit），COPPA/FERPA K12 合规。(V4-5) 多角色 AI 覆盖：types.ts 新增 ChildSummaryInput/Result、StudyPathInput/Result、AiUsageStats 类型 + AiService/AiClientService 接口扩展；schema.ts 新增 4 个 Zod schema；prompt-templates.ts 新增 CHILD_SUMMARY_SYSTEM_PROMPT（家庭教育顾问，家长友好语言）+ STUDY_PATH_SYSTEM_PROMPT（自适应学习路径设计师，3-7 步骤）；ai-service.ts 新增 generateChildSummary（聚合成绩/出勤/错题本数据）+ recommendStudyPath（基于掌握度数据）；actions.ts 新增 generateChildSummaryAction/recommendStudyPathAction（AI_CHAT 权限）+ getAiUsageStatsAction（AI_CONFIGURE 权限）；新增组件 AiChildSummary（家长端：整体评估 Markdown+优势绿勾+改进橙警+家庭辅导建议+下一步徽章）、AiUsageDashboard（管理员端：4 统计卡片+按能力进度条+按角色徽章+Top 用户列表+最近活动日志）、AiStudyPath（学生端：当前等级横幅+学习路径步骤+连接线+状态图标+预估时间+激励消息）。(V4-6) i18n 修复与扩展：修复 AiGradingAssist/AiLessonContentGenerator/AiQuestionVariantGenerator 共 8 处错误 i18n 键引用（CardDescription 重复 title、label/placeholder/button 复用 generateContent、3 个变体类型标签全部显示「生成」）；zh-CN/en ai.json 全面重写新增 chat.streaming/stopGeneration/copy/clearConfirm/suggestedPrompts、grading.description/batch*、lessonPrep.description/additionalContext/insertContent、exam.variantType.*/targetDifficulty/addVariant、parent.*、admin.*、studyPath.*、widget.*、safety.* 等键。架构文档 004/005 同步更新。"
   },
   "architectureOverview": {
     "layers": [
@@ -9038,6 +9038,18 @@
               "grades/actions.deleteGradeRecordAction"
             ]
           },
+          {
+            "name": "bulkDeleteGradeRecords",
+            "signature": "(ids: string[]) => Promise<number>",
+            "file": "data-access.ts",
+            "deps": [
+              "shared.db",
+              "shared.db.schema.gradeRecords"
+            ],
+            "usedBy": [
+              "grades/actions.bulkDeleteGradeRecordsAction"
+            ]
+          },
           {
             "name": "getClassGradeStats",
             "signature": "(classId: string, subjectId?: string, examId?: string, scope?: DataScope, currentUserId?: string) => Promise<GradeStats | null>",
@@ -9297,6 +9309,15 @@
               "grades/components/grade-record-list"
             ]
           },
+          {
+            "name": "bulkDeleteGradeRecordsAction",
+            "signature": "(ids: string[]) => Promise<ActionState<number>>",
+            "file": "actions.ts",
+            "permission": "GRADE_RECORD_MANAGE",
+            "usedBy": [
+              "grades/components/grade-record-list"
+            ]
+          },
           {
             "name": "getGradeRecordsAction",
             "signature": "(params) => Promise<GradeRecordListItem[]>",
@@ -10033,10 +10054,12 @@
           {
             "name": "ClassComparisonChart",
             "file": "components/class-comparison-chart.tsx",
-            "purpose": "班级对比柱状图（recharts BarChart，均分/及格率/优秀率）",
+            "purpose": "班级对比柱状图（recharts BarChart，均分/及格率/优秀率；v3-P3-5 新增：显著性分析区域，基于极差和样本量经验规则判断班级间差异是否显著，含可折叠详细分析展示最高/最低分班级）",
             "deps": [
               "recharts",
-              "shared/components/ui/chart"
+              "shared/components/ui/chart",
+              "shared/components/ui/collapsible",
+              "shared/lib/utils"
             ]
           },
           {