From d6cc70e02e31876e7ffb229b6153a36749c8d00b Mon Sep 17 00:00:00 2001 From: SpecialX <47072643+wangxiner55@users.noreply.github.com> Date: Mon, 13 Jul 2026 12:53:32 +0800 Subject: [PATCH] =?UTF-8?q?docs(student-portal):=20workline.md=20=E6=96=B0?= =?UTF-8?q?=E5=A2=9E=20=C2=A79=20=E5=8F=82=E8=80=83=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E5=B7=AE=E8=B7=9D=E5=88=86=E6=9E=90=E4=B8=8E=E5=AE=9E=E7=8E=B0?= =?UTF-8?q?=E5=AE=89=E6=8E=92?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../worklines/student-portal_workline.md | 41 ++++++++++++++++++- 1 file changed, 40 insertions(+), 1 deletion(-) diff --git a/docs/architecture/issues/worklines/student-portal_workline.md b/docs/architecture/issues/worklines/student-portal_workline.md index afa91ae..4654d62 100644 --- a/docs/architecture/issues/worklines/student-portal_workline.md +++ b/docs/architecture/issues/worklines/student-portal_workline.md @@ -299,7 +299,46 @@ gantt - **文档阶段**：✅ 完成（01-understanding + 02-architecture-design + contract + workline + issue 全部对齐 ARB-019 裁决） - **代码实现阶段**：✅ 已完成（通过 `606acb6` 合并到 main，包含 P2-P6 全部代码） - **集成测试阶段**：✅ 已完成（通过 `61d8249` + `a6b0c54` 修复全部集成测试 bug） -- **待办**：无未完成的架构工作项（contract.md + workline.md + 02-architecture-design.md 全部对齐 ARB-019 裁决） +- **待办**：参考项目差距分析（见 §9） + +--- + +## §9 参考项目差距分析与实现安排（2026-07-13） + +### §9.1 参考项目功能清单 + +参考项目 `E:\Desktop\edunexus-pro (4)`（Next.js 生产级实现）中学生端已实现的功能： + +| # | 功能 | 参考项目实现 | 当前项目状态 | +|---|------|-------------|-------------| +| 1 | 学生仪表盘 | 4 统计卡 + 成长曲线 vs 班级平均 + 能力雷达 + 薄弱知识点 + 通知列表 + 近期作业 | ✅ 已实现（缺今日课表 + 班级平均对比） | +| 2 | 学生作业列表 | 多维筛选（学科/考试类型/状态）+ 延期申请 + 继续答题 | ✅ 已实现（缺多维筛选 + 延期申请） | +| 3 | 学生考试作答 | 文本/手写板/图片三种作答 + localStorage 自动保存 + 答题卡树形结构 | ✅ 已实现（缺手写板 + 图片上传 + 树形答题卡） | +| 4 | 学生考试结果 | 教师批注 canvas 叠加 + 手写作答渲染 + 全局/单题批注切换 | ✅ 已实现（缺教师批注叠加） | +| 5 | 学生班级 | 加入班级（6 位邀请码）+ 退出班级 + 仅看成员 | ✅ 已实现（缺加入/退出班级） | +| 6 | 学生课表 | 周课表网格视图（学生只读） | ❌ 未实现 | +| 7 | 消息中心 | 全部/未读筛选 + 消息详情 + 标记已读 | ✅ 已实现（通知中心） | +| 8 | 个人设置 | 个人资料 + 偏好学科 + 安全设置（修改密码） | ❌ 未实现 | +| 9 | 作业分析 | 试卷详解 + 数据总览 + 知识点定位 | ❌ 未实现 | +| 10 | 手写板作答 | Fabric.js Canvas 手写 + 自动保存 | ❌ 未实现 | +| 11 | 图片上传作答 | FileReader → dataURL + 上传到服务器 | ❌ 未实现 | +| 12 | 作业延期申请 | 弹出 prompt 输入理由 → API 调用 | ❌ 未实现 | + +### §9.2 差距实现安排 + +| 批次 | 功能 | 优先级 | 实现方式 | +|------|------|--------|----------| +| A | 手写板组件（HandwritingPad） | 高 | 新建 `src/components/handwriting-pad.tsx`，Fabric.js Canvas | +| A | 图片上传作答 | 高 | 考试作答页 + 作业提交页增加图片上传 | +| A | 教师批注叠加显示 | 高 | 考试结果页增加 canvas 批注渲染 | +| A | 作业延期申请 | 高 | 作业列表页增加延期申请按钮 + mutation | +| A | 加入/退出班级 | 高 | 班级页增加 JoinClassModal + leaveClass | +| B | 课表查看页 `/schedule` | 中 | 新建页面 + GraphQL query | +| B | 个人设置页 `/settings` | 中 | 新建页面 + profile mutation | +| B | 作业分析页 `/my-homework/[id]/analysis` | 中 | 新建页面 + GraphQL query | +| B | 作业多维筛选 | 中 | 作业列表页增加筛选器 | +| C | Dashboard 增强 | 低 | 添加今日课表卡片 + 成长曲线 vs 班级平均 | +| C | 答题卡树形结构 | 低 | 考试作答页答题卡改为树形 | ---