docs(architecture): sync architecture docs with code changes

- Update 001_project_overview.md

- Update 004_architecture_impact_map.md

- Update 005_architecture_data.json

- Add 008_module_role_mapping.md

- Add _update_004.cjs helper script

docs/architecture/001_project_overview.md

@@ -368,7 +368,7 @@ AI 模式:  选择 AI Provider → 粘贴试卷源文本 → AI 解析生成 →
 | API 路由 | 9 |
 | Server Actions | 80+ |
 | 用户角色 | 6 (admin/teacher/student/parent/grade_head/teaching_head) |
-| 权限点 | 54 |
+| 权限点 | 67 |
 
 ---
 
@@ -380,3 +380,4 @@ AI 模式:  选择 AI Provider → 粘贴试卷源文本 → AI 解析生成 →
 | [005 架构数据](./005_architecture_data.json) | AI 友好的结构化架构数据 |
 | [006 功能清单](./006_k12_feature_checklist.md) | 企业级 K12 标准功能模块清单 |
 | [007 差距审计报告](./007_gap_audit_report.md) | 功能差距审计与补齐路线图 |
+| [008 模块角色映射](./008_module_role_mapping.md) | 模块-角色-功能映射总览 |

docs/architecture/008_module_role_mapping.md

@@ -0,0 +1,299 @@
+# 模块-角色-功能映射总览
+
+> 生成日期：2026-06-22
+> 数据来源：`src/modules/` 全量扫描 + `src/app/(dashboard)/` 路由权限校验 + `src/shared/types/permissions.ts` 权限点定义
+> 角色体系：admin / teacher / student / parent / grade_head / teaching_head（含 management 路由组）
+
+---
+
+## 一、模块-角色速查表
+
+| # | 模块 | 目录 | admin | teacher | student | parent | mgmt | 核心功能 |
+|---|------|------|:-----:|:-------:|:-------:|:------:|:----:|----------|
+| 1 | adaptive-practice | `adaptive-practice/` | | ✅ | ✅ | ✅ | ✅ | 专项练习：自适应出题、答题、练习历史、成绩分析 |
+| 2 | ai | `ai/` | ✅ | ✅ | ✅ | ✅ | ✅ | AI 赋能：对话助手、出题辅助、批改辅助、学情分析、多模型配置 |
+| 3 | announcements | `announcements/` | ✅ | ✅ | ✅ | ✅ | ✅ | 通知公告：学校/年级/班级三级公告发布与查看 |
+| 4 | attendance | `attendance/` | ✅ | ✅ | ✅ | ✅ | | 考勤管理：学生/教师考勤登记、统计、规则配置 |
+| 5 | audit | `audit/` | ✅ | | | | | 日志审计：操作日志、登录日志、数据变更日志、导出 |
+| 6 | auth | `auth/` | ✅ | ✅ | ✅ | ✅ | ✅ | 认证系统：登录/注册/JWT/双因素认证 |
+| 7 | classes | `classes/` | ✅ | ✅ | ✅ | | | 班级管理：班级 CRUD、课表、学生管理、邀请码 |
+| 8 | course-plans | `course-plans/` | ✅ | ✅ | ✅ | ✅ | | 课程计划：教学计划创建、进度跟踪、日历视图 |
+| 9 | dashboard | `dashboard/` | ✅ | ✅ | ✅ | ✅ | ✅ | 仪表盘：角色独立看板（统计卡片/图表/快捷操作） |
+| 10 | diagnostic | `diagnostic/` | | ✅ | ✅ | ✅ | | 学情诊断：知识点掌握度雷达图、班级/个人诊断报告 |
+| 11 | elective | `elective/` | ✅ | ✅ | ✅ | ✅ | | 选课管理：选修课创建/选课/退选/抽签 |
+| 12 | error-book | `error-book/` | ✅ | ✅ | ✅ | ✅ | | 错题本：错题自动采集、SM-2 间隔复习、统计分析 |
+| 13 | exams | `exams/` | | ✅ | | | | 考试管理：AI 出题/组卷/批改/监考/分析 |
+| 14 | files | `files/` | ✅ | ✅ | ✅ | ✅ | ✅ | 文件管理：上传/预览/存储/权限控制 |
+| 15 | grades | `grades/` | ✅ | ✅ | ✅ | ✅ | ✅ | 成绩管理：录入/查询/统计/趋势/导出/排名 |
+| 16 | homework | `homework/` | | ✅ | ✅ | | | 作业管理：布置/提交/批改/评分/统计分析 |
+| 17 | layout | `layout/` | ✅ | ✅ | ✅ | ✅ | ✅ | 布局框架：导航配置/侧边栏/顶部栏（所有角色共用） |
+| 18 | lesson-preparation | `lesson-preparation/` | ✅ | ✅ | ✅ | ✅ | | 备课系统：教案创建/编辑/发布/查看 |
+| 19 | messaging | `messaging/` | ✅ | ✅ | ✅ | ✅ | ✅ | 站内消息：私信/群发/草稿/已读状态 |
+| 20 | notifications | `notifications/` | ✅ | ✅ | ✅ | ✅ | ✅ | 通知系统：站内/邮件/短信/微信多渠道推送、偏好管理 |
+| 21 | onboarding | `onboarding/` | ✅ | ✅ | ✅ | ✅ | ✅ | 新手引导：首次登录角色选择、资料填写、班级加入 |
+| 22 | parent | `parent/` | | | | ✅ | | 家长聚合：子女学习概览、成绩/作业/考勤详情 |
+| 23 | proctoring | `proctoring/` | | ✅ | | | | 考试监考：实时提交进度、异常行为标记 |
+| 24 | questions | `questions/` | ✅ | ✅ | | | | 题库管理：题目 CRUD、分类标签、批量导入导出 |
+| 25 | rbac | `rbac/` | ✅ | | | | | 角色权限：动态角色管理、权限目录、角色-权限分配 |
+| 26 | scheduling | `scheduling/` | ✅ | ✅ | ✅ | | | 排课系统：自动排课引擎、课表查看、调课/代课 |
+| 27 | school | `school/` | ✅ | | | | | 学校管理：学校信息/学年学期/年级/班级/部门/学科 |
+| 28 | settings | `settings/` | ✅ | ✅ | ✅ | ✅ | ✅ | 用户设置：个人信息/通知偏好/外观/安全/登出 |
+| 29 | standards | `standards/` | (via) | (via) | | | | 课标库：国家/校标/自定义课标，通过 lesson-preparation 使用 |
+| 30 | student | `student/` | | | ✅ | | | 学生聚合：课程查看/课表/学习路径 |
+| 31 | textbooks | `textbooks/` | (via) | ✅ | ✅ | | | 教材资源：教材库/章节结构/知识点图谱/内容阅读 |
+| 32 | users | `users/` | ✅ | | | | | 用户管理：用户 CRUD、批量导入、角色分配 |
+
+> 注：`✅` = 有独立页面路由；`(via)` = 通过其他模块间接使用，无独立路由页面
+
+---
+
+## 二、按角色展开的模块清单
+
+### 2.1 admin（系统管理员）
+
+| 模块 | 页面路由 | 权限点 | 功能说明 |
+|------|----------|--------|----------|
+| **school** | `/admin/school` | `SCHOOL_MANAGE` | 学校基础信息配置 |
+| | `/admin/school/schools` | `SCHOOL_MANAGE` | 多校区管理 |
+| | `/admin/school/academic-year` | `SCHOOL_MANAGE` | 学年学期管理 |
+| | `/admin/school/classes` | `SCHOOL_MANAGE` | 班级创建与管理 |
+| | `/admin/school/departments` | `SCHOOL_MANAGE` | 部门管理 |
+| | `/admin/school/grades` | `SCHOOL_MANAGE` | 年级管理与组长指派 |
+| | `/admin/school/grades/insights` | `SCHOOL_MANAGE` | 年级洞察分析 |
+| **users** | `/admin/users` | `USER_MANAGE` | 用户账号管理 |
+| | `/admin/users/import` | `USER_MANAGE` | 批量导入用户 |
+| **rbac** | `/admin/roles` | `ROLE_READ` | 角色列表查看 |
+| | `/admin/roles/[id]` | `ROLE_READ` | 角色详情与权限编辑 |
+| | `/admin/permissions` | `PERMISSION_READ` | 权限点目录查看 |
+| **announcements** | `/admin/announcements` | `ANNOUNCEMENT_MANAGE` | 公告管理（创建/编辑/删除） |
+| | `/admin/announcements/[id]` | `ANNOUNCEMENT_MANAGE` | 公告详情 |
+| | `/admin/announcements/[id]/edit` | `ANNOUNCEMENT_MANAGE` | 编辑公告 |
+| **audit** | `/admin/audit-logs` | `AUDIT_LOG_READ` | 操作日志查看 |
+| | `/admin/audit-logs/overview` | `AUDIT_LOG_READ` | 审计概览统计 |
+| | `/admin/audit-logs/data-changes` | `AUDIT_LOG_READ` | 数据变更日志 |
+| | `/admin/audit-logs/login-logs` | `AUDIT_LOG_READ` | 登录日志 |
+| **dashboard** | `/admin/dashboard` | `DASHBOARD_ADMIN_READ` | 管理员仪表盘 |
+| **scheduling** | `/admin/scheduling/auto` | `SCHEDULE_AUTO` | 自动排课 |
+| | `/admin/scheduling/changes` | `SCHEDULE_ADJUST` | 调课管理 |
+| | `/admin/scheduling/rules` | `SCHEDULE_ADJUST` | 排课规则配置 |
+| **course-plans** | `/admin/course-plans` | `COURSE_PLAN_READ` | 课程计划查看 |
+| | `/admin/course-plans/create` | `COURSE_PLAN_MANAGE` | 创建课程计划 |
+| | `/admin/course-plans/[id]` | `COURSE_PLAN_READ` | 课程计划详情 |
+| | `/admin/course-plans/[id]/edit` | `COURSE_PLAN_MANAGE` | 编辑课程计划 |
+| **elective** | `/admin/elective` | `ELECTIVE_READ` | 选课管理 |
+| | `/admin/elective/create` | `ELECTIVE_MANAGE` | 创建选修课 |
+| | `/admin/elective/[id]` | `ELECTIVE_READ` | 选修课详情 |
+| | `/admin/elective/[id]/edit` | `ELECTIVE_MANAGE` | 编辑选修课 |
+| **attendance** | `/admin/attendance` | `ATTENDANCE_READ` | 考勤数据查看 |
+| **error-book** | `/admin/error-book` | `ERROR_BOOK_ANALYTICS_READ` | 全校错题统计分析 |
+| **questions** | `/admin/questions` | `QUESTION_READ` | 题库管理 |
+| **files** | `/admin/files` | `FILE_READ` | 文件管理 |
+| **ai** | `/admin/ai-settings` | `AI_CHAT` | AI 多模型配置 |
+| **lesson-plans** | `/admin/lesson-plans` | `LESSON_PLAN_READ` | 教案查看 |
+| | `/admin/lesson-plans/[planId]/view` | `LESSON_PLAN_READ` | 教案详情 |
+| **settings** | `/admin/settings` | `SETTINGS_ADMIN` | 管理员设置 |
+
+---
+
+### 2.2 teacher（教师）
+
+| 模块 | 页面路由 | 权限点 | 功能说明 |
+|------|----------|--------|----------|
+| **dashboard** | `/teacher/dashboard` | `DASHBOARD_TEACHER_READ` | 教师仪表盘（待批改/今日课表/班级动态） |
+| **classes** | `/teacher/classes/my` | `CLASS_READ` | 我的班级列表 |
+| | `/teacher/classes/my/[id]` | `CLASS_READ` | 班级详情 |
+| | `/teacher/classes/schedule` | `CLASS_READ` | 班级课表 |
+| | `/teacher/classes/students` | `CLASS_READ` | 班级学生管理 |
+| **exams** | `/teacher/exams` | `EXAM_READ` | 考试列表 |
+| | `/teacher/exams/all` | `EXAM_READ` | 全部考试 |
+| | `/teacher/exams/create` | `EXAM_CREATE` | 创建考试 |
+| | `/teacher/exams/new` | `EXAM_CREATE` | AI 出题 |
+| | `/teacher/exams/[id]/build` | `EXAM_READ` | 组卷 |
+| | `/teacher/exams/[id]/edit-rich` | `EXAM_UPDATE` | 富文本编辑试卷 |
+| | `/teacher/exams/[id]/analytics` | `EXAM_READ` | 考试分析 |
+| | `/teacher/exams/[id]/proctoring` | `EXAM_PROCTOR` | 考试监考 |
+| | `/teacher/exams/grading` | `HOMEWORK_GRADE` | 批改列表 |
+| | `/teacher/exams/grading/[submissionId]` | `HOMEWORK_GRADE` | 批改详情 |
+| **homework** | `/teacher/homework/assignments` | `HOMEWORK_CREATE` | 作业管理 |
+| | `/teacher/homework/assignments/create` | `HOMEWORK_CREATE` | 布置作业 |
+| | `/teacher/homework/assignments/[id]` | `HOMEWORK_CREATE` | 作业详情 |
+| | `/teacher/homework/assignments/[id]/submissions` | `HOMEWORK_GRADE` | 提交列表 |
+| | `/teacher/homework/submissions` | `HOMEWORK_GRADE` | 批改列表 |
+| | `/teacher/homework/submissions/[submissionId]` | `HOMEWORK_GRADE` | 批改详情 |
+| | `/teacher/homework/submissions/[submissionId]/scan-grading` | `HOMEWORK_GRADE` | 阅卷式批改 |
+| **grades** | `/teacher/grades` | `GRADE_RECORD_READ` | 成绩查询 |
+| | `/teacher/grades/analytics` | `GRADE_RECORD_READ` | 成绩分析 |
+| | `/teacher/grades/entry` | `GRADE_RECORD_MANAGE` | 成绩录入 |
+| | `/teacher/grades/stats` | `GRADE_RECORD_READ` | 成绩统计 |
+| **questions** | `/teacher/questions` | `QUESTION_READ` | 题库管理 |
+| **textbooks** | `/teacher/textbooks` | `TEXTBOOK_READ` | 教材查看 |
+| | `/teacher/textbooks/[id]` | `TEXTBOOK_READ` | 教材内容 |
+| **lesson-plans** | `/teacher/lesson-plans` | `LESSON_PLAN_READ` | 教案列表 |
+| | `/teacher/lesson-plans/new` | `LESSON_PLAN_READ` | 创建教案 |
+| | `/teacher/lesson-plans/[planId]/edit` | `LESSON_PLAN_READ` | 编辑教案 |
+| **diagnostic** | `/teacher/diagnostic` | `DIAGNOSTIC_READ` | 学情诊断总览 |
+| | `/teacher/diagnostic/class/[classId]` | `DIAGNOSTIC_READ` | 班级诊断 |
+| | `/teacher/diagnostic/student/[studentId]` | `DIAGNOSTIC_READ` | 学生诊断 |
+| **attendance** | `/teacher/attendance` | `ATTENDANCE_READ` | 考勤查看 |
+| | `/teacher/attendance/sheet` | `ATTENDANCE_MANAGE` | 考勤登记 |
+| | `/teacher/attendance/stats` | `ATTENDANCE_READ` | 考勤统计 |
+| **course-plans** | `/teacher/course-plans` | `COURSE_PLAN_READ` | 课程计划 |
+| | `/teacher/course-plans/[id]` | `COURSE_PLAN_READ` | 计划详情 |
+| **elective** | `/teacher/elective` | `ELECTIVE_READ` | 选课管理 |
+| | `/teacher/elective/create` | `ELECTIVE_MANAGE` | 创建选修课 |
+| | `/teacher/elective/[id]/edit` | `ELECTIVE_MANAGE` | 编辑选修课 |
+| **error-book** | `/teacher/error-book` | `ERROR_BOOK_ANALYTICS_READ` | 班级错题分析 |
+| **practice** | `/teacher/practice` | `ADAPTIVE_PRACTICE_READ` | 专项练习统计 |
+| **schedule** | `/teacher/schedule-changes` | `SCHEDULE_ADJUST` | 调课申请 |
+
+---
+
+### 2.3 student（学生）
+
+| 模块 | 页面路由 | 权限点 | 功能说明 |
+|------|----------|--------|----------|
+| **dashboard** | `/student/dashboard` | `DASHBOARD_STUDENT_READ` | 学生仪表盘（作业/考试/成绩趋势） |
+| **learning** | `/student/learning` | `CLASS_READ` | 学习中心 |
+| | `/student/learning/assignments` | — | 作业列表 |
+| | `/student/learning/assignments/[assignmentId]` | — | 作答 |
+| | `/student/learning/assignments/[assignmentId]/result` | — | 作答结果 |
+| | `/student/learning/courses` | `CLASS_READ` | 课程列表 |
+| | `/student/learning/courses/[classId]` | `CLASS_READ` | 课程详情 |
+| | `/student/learning/textbooks` | `TEXTBOOK_READ` | 教材 |
+| | `/student/learning/textbooks/[id]` | `TEXTBOOK_READ` | 教材内容 |
+| | `/student/learning/study-path` | `AI_CHAT` | AI 学习路径 |
+| **grades** | `/student/grades` | `GRADE_RECORD_READ` | 成绩查询 |
+| **error-book** | `/student/error-book` | `ERROR_BOOK_READ` | 我的错题本 |
+| **practice** | `/student/practice` | `ADAPTIVE_PRACTICE_READ` | 专项练习 |
+| | `/student/practice/[sessionId]` | `ADAPTIVE_PRACTICE_READ` | 练习对话 |
+| **diagnostic** | `/student/diagnostic` | `DIAGNOSTIC_READ` | 学情诊断 |
+| **elective** | `/student/elective` | `ELECTIVE_READ` | 选课 |
+| | `/student/elective/[id]` | `ELECTIVE_READ` | 课程详情 |
+| **schedule** | `/student/schedule` | `CLASS_READ` | 课表查看 |
+| **attendance** | `/student/attendance` | `ATTENDANCE_READ` | 考勤查询 |
+| **course-plans** | `/student/course-plans` | `COURSE_PLAN_READ` | 课程计划 |
+| | `/student/course-plans/[id]` | `COURSE_PLAN_READ` | 计划详情 |
+| **lesson-plans** | `/student/lesson-plans` | `LESSON_PLAN_READ` | 教案查看 |
+| | `/student/lesson-plans/[planId]/view` | `LESSON_PLAN_READ` | 教案详情 |
+
+---
+
+### 2.4 parent（家长）
+
+| 模块 | 页面路由 | 权限点 | 功能说明 |
+|------|----------|--------|----------|
+| **dashboard** | `/parent/dashboard` | `DASHBOARD_PARENT_READ` | 家长仪表盘（子女学习概况） |
+| **children** | `/parent/children/[studentId]` | — | 子女详情聚合页 |
+| **grades** | `/parent/grades` | `GRADE_RECORD_READ` | 子女成绩查询 |
+| **error-book** | `/parent/error-book` | `ERROR_BOOK_READ` | 子女错题本 |
+| **diagnostic** | `/parent/diagnostic` | `DIAGNOSTIC_READ` | 子女学情诊断 |
+| **elective** | `/parent/elective` | `ELECTIVE_READ` | 子女选课查看 |
+| **attendance** | `/parent/attendance` | `ATTENDANCE_READ` | 子女考勤查询 |
+| **course-plans** | `/parent/course-plans` | `COURSE_PLAN_READ` | 课程计划 |
+| | `/parent/course-plans/[id]` | `COURSE_PLAN_READ` | 计划详情 |
+| **lesson-plans** | `/parent/lesson-plans` | `LESSON_PLAN_READ` | 教案查看 |
+| | `/parent/lesson-plans/[planId]/view` | `LESSON_PLAN_READ` | 教案详情 |
+| **practice** | `/parent/practice` | `ADAPTIVE_PRACTICE_READ` | 子女练习记录 |
+| **leave** | `/parent/leave` | — | 请假申请 |
+
+---
+
+### 2.5 management（年级组长/教研组长）
+
+| 模块 | 页面路由 | 权限点 | 功能说明 |
+|------|----------|--------|----------|
+| **grade** | `/management/grade` | `GRADE_MANAGE` | 年级管理首页 |
+| | `/management/grade/dashboard` | `GRADE_RECORD_READ` | 年级仪表盘 |
+| | `/management/grade/insights` | `GRADE_RECORD_READ` | 年级洞察分析 |
+| | `/management/grade/classes` | `GRADE_MANAGE` | 年级班级管理 |
+| | `/management/grade/practice` | `ADAPTIVE_PRACTICE_READ` | 年级练习统计 |
+
+---
+
+## 三、共享模块（所有角色可访问）
+
+以下模块为所有已登录用户提供服务，不区分角色路由：
+
+| 模块 | 路由 | 权限点 | 说明 |
+|------|------|--------|------|
+| **auth** | `/login`, `/register` | 公开 | 认证（登录/注册） |
+| **onboarding** | `/onboarding` | 已登录 | 新手引导（首次登录） |
+| **announcements** | `/announcements`, `/announcements/[id]` | `ANNOUNCEMENT_READ` | 公告查看（所有角色） |
+| **messages** | `/messages`, `/messages/[id]`, `/messages/compose` | `MESSAGE_READ` / `MESSAGE_SEND` | 站内消息 |
+| **profile** | `/profile` | `USER_PROFILE_UPDATE` | 个人资料 |
+| **settings** | `/settings` | `USER_PROFILE_UPDATE` | 用户设置（通知/外观/安全） |
+| **dashboard** | `/dashboard` | 角色自动路由 | 仪表盘（自动重定向到角色对应仪表盘） |
+| **layout** | 所有路由 | — | 全局布局框架（侧边栏/顶部栏/导航配置） |
+| **notifications** | 全局组件 | — | 通知弹窗/偏好管理（内嵌于 layout） |
+| **files** | 全局上传 | `FILE_UPLOAD` | 文件上传（所有角色可上传，admin 可管理） |
+
+---
+
+## 四、权限点汇总（67 个）
+
+| 权限分类 | 权限点 | 适用角色 |
+|----------|--------|----------|
+| **考试** | `exam:create/create/read/update/delete/duplicate/publish/ai_generate/submit` | teacher |
+| | `exam:proctor/read` | teacher |
+| **作业** | `homework:create/grade` | teacher |
+| | `homework:submit` | student |
+| **题库** | `question:create/read/update/delete` | admin, teacher |
+| **教材** | `textbook:create/read/update/delete` | admin, teacher |
+| **班级** | `class:create/read/update/delete/enroll/schedule` | admin, teacher, student |
+| **学校管理** | `school:manage` | admin |
+| | `grade:manage` | admin, grade_head |
+| | `user:manage` | admin |
+| **成绩** | `grade_record:manage/read` | admin, teacher, student, parent |
+| **考勤** | `attendance:manage/read` | admin, teacher, student, parent |
+| **课程计划** | `course_plan:manage/read` | admin, teacher, student, parent |
+| **公告** | `announcement:manage` | admin |
+| | `announcement:read` | all |
+| **消息** | `message:send/read/delete` | all |
+| **排课** | `schedule:auto/adjust` | admin, teacher |
+| **选课** | `elective:manage/read/select` | admin, teacher, student, parent |
+| **诊断** | `diagnostic:manage/read` | admin, teacher, student, parent |
+| **备课** | `lesson_plan:create/read/update/delete/publish` | admin, teacher, student, parent |
+| **仪表盘** | `dashboard:admin_read/teacher_read/student_read/parent_read` | 各角色独立 |
+| **错题本** | `error_book:read/manage` | student, parent |
+| | `error_book:analytics_read` | admin, teacher |
+| **专项练习** | `adaptive_practice:read/manage` | student, teacher, parent, grade_head |
+| **AI** | `ai:chat` | all |
+| | `ai:configure` | admin |
+| **文件** | `file:upload/read/delete` | all（upload），admin（delete） |
+| **审计** | `audit_log:read` | admin |
+| **RBAC** | `role:create/read/update/delete/assign` | admin |
+| | `permission:read` | admin |
+| **设置** | `settings:admin` | admin |
+| | `user:profile_update` | all |
+
+---
+
+## 五、模块依赖关系速查
+
+| 模块 | 依赖模块（通过 data-access） | 被依赖模块 |
+|------|------------------------------|-----------|
+| **exams** | questions, classes, school, homework | homework, dashboard, proctoring, diagnostic, grades |
+| **homework** | exams, classes, school, users | grades, dashboard, diagnostic |
+| **grades** | exams, classes, school, users | dashboard, parent |
+| **classes** | homework, scheduling | exams, homework, grades, scheduling, attendance, dashboard |
+| **dashboard** | users, classes, textbooks, questions, exams, homework | — |
+| **parent** | classes, homework, grades | — |
+| **diagnostic** | exams, questions, classes, users | — |
+| **lesson-preparation** | textbooks, questions, exams, homework, classes, files | — |
+| **messaging** | notifications | settings |
+| **scheduling** | classes, users | — |
+| **proctoring** | exams, users | — |
+| **school** | — | exams, classes, grades, scheduling, attendance |
+| **textbooks** | — | questions, exams, homework, lesson-preparation |
+| **users** | — | all modules |
+| **rbac** | — | admin |
+| **audit** | — | all modules (via shared/audit-logger) |
+
+---
+
+## 六、维护说明
+
+- 新增模块时，需同步更新本文档的模块-角色速查表（第一节）和对应角色的详细清单（第二节）
+- 新增权限点时，需同步更新权限点汇总（第四节）
+- 模块依赖关系变更时，需同步更新依赖关系速查（第五节）
+- 路由变更时，需同步更新对应角色的路由表

docs/architecture/_update_004.cjs

@@ -0,0 +1,101 @@
+// 临时脚本：更新 004_architecture_impact_map.md
+const fs = require('fs');
+const path = require('path');
+
+const filePath = path.join(__dirname, '004_architecture_impact_map.md');
+const content = fs.readFileSync(filePath, 'utf8');
+
+const oldString = [
+  '| `components/blocks/reflection-block.tsx` | 反思 Block（V3 续：select onChange 使用 `isReflectionAspect` 类型守卫替代 `as` 断言） |',
+  '',
+  '---',
+  '',
+  '## 2.28 error-book（错题本模块）'
+].join('\r\n');
+
+const newLines = [
+  '| `components/blocks/reflection-block.tsx` | 反思 Block（V3 续：select onChange 使用 `isReflectionAspect` 类型守卫替代 `as` 断言） |',
+  '| `components/calendar-view.tsx` | **M9 日历视图组件（2026-07-01 新增）**：客户端组件，支持周历/月历切换，6 种事件类型颜色映射 |',
+  '| `components/curriculum-map-view.tsx` | **M4 课程地图热力图组件（2026-07-01 新增）**：学科×年级矩阵表格，颜色编码覆盖率 |',
+  '| `data-access-calendar.ts` | **M9 日历事件数据访问层（2026-07-01 新增）** |',
+  '| `data-access-review.ts` | **M3 审核工作流数据访问层（2026-07-01 新增）** |',
+  '| `data-access-comments.ts` | **M2 协同备课评论数据访问层（2026-07-01 新增）** |',
+  '| `data-access-formative.ts` | **M5 形成性评价数据访问层（2026-07-01 新增）** |',
+  '| `data-access-attachments.ts` | **M6 资源附件库数据访问层（2026-07-01 新增）** |',
+  '| `data-access-substitutes.ts` | **M12 代课教师数据访问层（2026-07-01 新增）** |',
+  '| `data-access-ai-evaluation.ts` | **M8 AI 评估数据访问层（2026-07-01 新增）** |',
+  '| `data-access-analytics.ts` | **M10 备课分析仪表盘数据访问层（2026-07-01 新增）** |',
+  '| `actions-calendar.ts` | **M9 日历 Server Actions（2026-07-01 新增）** |',
+  '| `actions-review.ts` | **M3 审核工作流 Server Actions（2026-07-01 新增）** |',
+  '| `actions-comments.ts` | **M2 评论 Server Actions（2026-07-01 新增）** |',
+  '| `actions-formative.ts` | **M5 形成性评价 Server Actions（2026-07-01 新增）** |',
+  '| `actions-attachments.ts` | **M6 附件库 Server Actions（2026-07-01 新增）** |',
+  '| `actions-substitutes.ts` | **M12 代课教师 Server Actions（2026-07-01 新增）** |',
+  '| `actions-ai-evaluation.ts` | **M8 AI 评估 Server Actions（2026-07-01 新增）** |',
+  '| `actions-analytics.ts` | **M10 分析仪表盘 Server Actions（2026-07-01 新增）** |',
+  '',
+  '> 架构变更（2026-07-01，M1-M12 中长期计划完整实施）：',
+  '> - **M1 课标对标体系**：新增 modules/standards/ 模块；新增 3 个 STANDARD_* 权限点；新增路由 /admin/curriculum-map',
+  '> - **M2 协同备课评论**：新增 data-access-comments.ts + actions-comments.ts，支持 Block 级评论、resolved 状态',
+  '> - **M3 审核工作流**：新增 data-access-review.ts + actions-review.ts，状态机 draft → submitted → approved/rejected → published',
+  '> - **M4 课程地图**：新增 admin/curriculum-map 路由 + curriculum-map-view.tsx 热力图组件',
+  '> - **M5 形成性评价闭环**：新增 data-access-formative.ts + actions-formative.ts，4 种互动类型',
+  '> - **M6 资源附件库**：新增 data-access-attachments.ts + actions-attachments.ts',
+  '> - **M7 移动端 PWA**：见 1.1.1 章节',
+  '> - **M8 AI 差异化生成 + 评估**：新增 data-access-ai-evaluation.ts + actions-ai-evaluation.ts',
+  '> - **M9 日历视图**：新增 data-access-calendar.ts + actions-calendar.ts + calendar-view.tsx + teacher/lesson-plans/calendar 路由',
+  '> - **M10 备课分析仪表盘**：新增 data-access-analytics.ts + actions-analytics.ts，3 个分析维度',
+  '> - **M11 版本 diff 预览**：data-access-versions.ts 的 getVersionContent 支持读取历史版本内容',
+  '> - **M12 代课教师**：新增 data-access-substitutes.ts + actions-substitutes.ts',
+  '> - **权限扩展**：新增 STANDARD_READ/MANAGE/LINK + LESSON_PLAN_SUBMIT/REVIEW/ANALYTICS_READ/SUBSTITUTE_MANAGE',
+  '> - **i18n 扩展**：zh-CN 新增 9 个命名空间；status 扩展为 6 状态',
+  '> - **数据库表**：新增 6 张表（lessonPlanComments/lessonPlanReviewRecords/lessonPlanFormativeItems/lessonPlanAttachments/lessonPlanAiEvaluations/lessonPlanSubstituteAssignments）',
+  '',
+  '---',
+  '',
+  '## 2.27b standards（课标模块，2026-07-01 新增）',
+  '',
+  '**职责**：K12 课标管理，支持课标树、按学科+年级筛选、课案与课标多对多关联。',
+  '',
+  '**导出函数**：',
+  '- Data-access：getStandards / getStandardsTree / getStandardById / createStandard / updateStandard / deactivateStandard / searchStandards / getStandardsByPlanId / linkPlanToStandard / unlinkPlanFromStandard',
+  '- Actions：10 个 Server Actions，全部使用 requirePermission() + ActionState<T>',
+  '- Schema：createStandardSchema / updateStandardSchema / getStandardsParamsSchema / linkPlanToStandardSchema',
+  '- Types：Standard / StandardTreeNode / LessonPlanStandardLink',
+  '',
+  '**权限点**：',
+  '- STANDARD_READ（standard:read）',
+  '- STANDARD_MANAGE（standard:manage）',
+  '- STANDARD_LINK（standard:link）',
+  '',
+  '**依赖关系**：',
+  '- 依赖：shared/*、modules/lesson-preparation/lib/i18n-errors',
+  '- 被依赖：modules/lesson-preparation、app/(dashboard)/admin/curriculum-map',
+  '',
+  '**文件清单**：',
+  '| 文件 | 职责 |',
+  '|------|------|',
+  '| types.ts | 类型定义 |',
+  '| schema.ts | Zod 验证 |',
+  '| data-access.ts | 课标 CRUD + 树形查询 + 课案关联 |',
+  '| actions.ts | 10 个 Server Actions |',
+  '',
+  '---',
+  '',
+  '## 2.28 error-book（错题本模块）'
+];
+const newString = newLines.join('\r\n');
+
+if (!content.includes(oldString)) {
+  console.error('ERROR: old string not found');
+  process.exit(1);
+}
+const occurrences = content.split(oldString).length - 1;
+if (occurrences !== 1) {
+  console.error('ERROR: appears ' + occurrences + ' times');
+  process.exit(1);
+}
+
+const newContent = content.replace(oldString, newString);
+fs.writeFileSync(filePath, newContent, 'utf8');
+console.log('SUCCESS 004 updated, before=' + content.length + ' after=' + newContent.length);