sync-docs-and-fixes

2026-03-03 17:32:26 +08:00
parent 538805bad0
commit eb08c0ab68
73 changed files with 2218 additions and 422 deletions
--- a/docs/design/009_feature_gap_analysis.md
+++ b/docs/design/009_feature_gap_analysis.md
@@ -0,0 +1,150 @@
+# 功能实现对比文档（已实现 vs 规划）
+
+**日期**: 2026-03-03  
+**范围**: 基于 PRD 与现有设计文档的功能落地对比  
+
+---
+
+## 1. 依据与来源
+
+本对比基于以下文档：
+
+- 产品规划：PRD（`docs/product_requirements.md`）  
+- 已实现模块：
+  - 教师仪表盘与班级管理：[002_teacher_dashboard_implementation.md](file:///e:/Desktop/CICD/docs/design/002_teacher_dashboard_implementation.md)
+  - 教材模块：[003_textbooks_module_implementation.md](file:///e:/Desktop/CICD/docs/design/003_textbooks_module_implementation.md)
+  - 题库模块：[004_question_bank_implementation.md](file:///e:/Desktop/CICD/docs/design/004_question_bank_implementation.md)
+  - 考试模块：[005_exam_module_implementation.md](file:///e:/Desktop/CICD/docs/design/005_exam_module_implementation.md)
+  - 作业模块：[006_homework_module_implementation.md](file:///e:/Desktop/CICD/docs/design/006_homework_module_implementation.md)
+  - 学校管理模块：[007_school_module_implementation.md](file:///e:/Desktop/CICD/docs/design/007_school_module_implementation.md)
+
+---
+
+## 2. 便利贴视图（按 Roles / Page / 功能）
+
+> **🟨 Roles**
+>
+> - **教师（Teacher）**：备课、出卷、作业批改与班级管理  
+> - **学生（Student）**：作业完成与教材阅读（只读）  
+> - **管理端（Admin/校长/年级主任/教研组长/班主任）**：规划中，未完全落地
+
+> **🟨 Page**
+>
+> - **教师工作台**：`/teacher/dashboard`  
+> - **班级**：`/teacher/classes/*`  
+> - **作业**：`/teacher/homework/*`  
+> - **考试**：`/teacher/exams/*`  
+> - **题库**：`/teacher/questions`  
+> - **教材**：`/teacher/textbooks/*`
+
+> **🟨 功能（规划目标）**
+>
+> - **权限与角色**：多角色矩阵 + RLS 行级隔离  
+> - **智能题库**：嵌套题、知识点关联  
+> - **知识图谱**：知识点树 + 题目/章节关联  
+> - **教材映射**：章节 ↔ 知识点  
+> - **组卷引擎**：筛选/分组/结构化试卷  
+> - **作业闭环**：派发-提交-批改-统计  
+> - **通知中心**：分级提醒策略
+
+---
+
+## 3. 已实现页面功能清单（简述）
+
+> **🟨 教师工作台**
+>
+> - `/teacher/dashboard`  
+>   功能：汇总班级、课表、作业、提交与成绩趋势  
+>   目标：快速掌握教学全局
+
+> **🟨 班级**
+>
+> - `/teacher/classes`  
+>   功能：班级入口重定向  
+>   目标：统一进入我的班级
+> - `/teacher/classes/my`  
+>   功能：班级列表与学科选择  
+>   目标：管理所教班级
+> - `/teacher/classes/my/[id]`  
+>   功能：班级详情概览、作业趋势、学生与课表  
+>   目标：掌握班级学习情况
+> - `/teacher/classes/students`  
+>   功能：学生筛选与成绩查看  
+>   目标：定位学生画像与状态
+> - `/teacher/classes/schedule`  
+>   功能：班级课表查看  
+>   目标：排课信息可视化
+
+> **🟨 作业**
+>
+> - `/teacher/homework/assignments`  
+>   功能：作业列表与状态  
+>   目标：管理作业发布
+> - `/teacher/homework/assignments/create`  
+>   功能：从考试派发作业  
+>   目标：快速生成作业
+> - `/teacher/homework/assignments/[id]`  
+>   功能：作业详情与错题概览  
+>   目标：定位薄弱题型
+> - `/teacher/homework/assignments/[id]/submissions`  
+>   功能：作业提交列表  
+>   目标：查看班级完成度
+> - `/teacher/homework/submissions`  
+>   功能：所有作业提交汇总  
+>   目标：统一批改入口
+> - `/teacher/homework/submissions/[submissionId]`  
+>   功能：作业批改与反馈  
+>   目标：完成评分与讲评
+
+> **🟨 考试**
+>
+> - `/teacher/exams/all`  
+>   功能：考试列表与筛选  
+>   目标：管理考试资产
+> - `/teacher/exams/create`  
+>   功能：创建考试基础信息  
+>   目标：建立试卷草稿
+> - `/teacher/exams/[id]/build`  
+>   功能：题库选题与结构化组卷  
+>   目标：完成试卷构建
+
+> **🟨 题库**
+>
+> - `/teacher/questions`  
+>   功能：题库检索与管理  
+>   目标：积累与复用题目
+
+> **🟨 教材**
+>
+> - `/teacher/textbooks`  
+>   功能：教材管理与筛选  
+>   目标：组织课程资源
+> - `/teacher/textbooks/[id]`  
+>   功能：章节与知识点维护  
+>   目标：构建教材结构
+
+---
+
+## 4. 差距清单（简述）
+
+> **🟨 权限与治理**
+>
+> - 多角色 RBAC 细化权限未落地
+> - RLS 数据隔离策略未落地
+
+> **🟨 教学质量与推荐**
+>
+> - 章节 → 知识点 → 题库的自动推荐链路未落地
+> - 知识点图谱深层能力未落地
+> - 学科维度与权重/标签机制未落地
+
+> **🟨 组卷与作业高级能力**
+>
+> - AB 卷与乱序策略未落地
+> - 作业分层与交集筛选未落地
+> - 学习画像/成长档案层的评估闭环尚未体现
+
+> **🟨 通知与消息闭环**
+>
+> - 分级通知体系未落地
+