教师域功能迁移差异分析报告
对比基准：CICD 项目（E:\Desktop\CICD） → portal-shell 项目（apps/portal-shell）
生成日期：2026-07-27
用途：后续迁移工作的依据清单
对比范围说明
| 维度 |
CICD |
portal-shell |
| 教师页面入口 |
src/app/(dashboard)/teacher/ |
src/app/shell/teacher/ |
| 教师域模块 |
src/modules/{exams,grades,homework,lesson-preparation,attendance,classes,diagnostic,elective,error-book,course-plans,leave-requests,questions,textbooks,ai,proctoring,adaptive-practice,dashboard}/ |
src/features/teacher/{对应模块}/ |
| 数据层 |
Server Actions + data-access |
src/lib/api/ GraphQL hooks + MSW 兜底 |
| 路由结构 |
(dashboard) 路由组 |
shell 路由组 |
架构差异说明：portal-shell 采用 GraphQL hooks（useXxx）替代 CICD 的 Server Actions（actions*.ts）+ data-access 层（data-access*.ts）。因此 CICD 中的 actions*.ts / data-access*.ts / schema.ts / types.ts 等非组件文件在 portal-shell 中按设计未迁移，对应能力由 lib/api/*.ts + features/*/transformations.ts 承担。本报告对这类"按架构设计未迁移"的文件不予标记为缺失，仅关注组件/UI 能力层面的缺失与简化。
第一部分：缺失页面清单（CICD 有但 portal-shell 没有的路由）
1.1 真正缺失的路由
| CICD 路由 |
对应文件 |
portal-shell 状态 |
备注 |
/teacher/dashboard |
teacher/dashboard/page.tsx |
⚠️ 功能合并 |
portal-shell 将仪表盘合并进 /teacher/page.tsx（TeacherDashboardPage），功能保留但路由路径不同。CICD 的 /teacher/page.tsx（773B）是入口跳转，/teacher/dashboard/page.tsx（835B）是实际仪表盘 |
结论：portal-shell 无完全缺失的教师路由。/teacher/dashboard 被合并到 /teacher 根路由，属结构性调整而非缺失。
1.2 路由名称变更（非缺失，但路径不同）
| CICD 路由 |
portal-shell 路由 |
说明 |
/teacher/exams/[id]/edit-rich |
/teacher/exams/[id]/edit |
重命名；实现由 Tiptap 简化为 contentEditable（见第二部分） |
1.3 portal-shell 新增的路由（CICD 没有）
| portal-shell 路由 |
说明 |
/teacher/ai/ai-assist |
AI 助教页（CICD 中 ai 模块以 widget 形式嵌入，无独立路由） |
/teacher/ai/ai-lesson-plan |
AI 教案页 |
/teacher/ai/ai-report |
AI 报告页 |
/teacher/analytics、/teacher/analytics/[studentId] |
学情分析页（CICD 中归属 grades/analytics） |
/teacher/knowledge-graph |
知识图谱页（CICD 中归属 textbooks 模块的 graph 组件） |
/teacher/students |
学生列表页 |
/teacher/homework/[id] |
作业详情（CICD 用 assignments/[id]） |
/teacher/homework/new |
新建作业（CICD 用 assignments/create） |
/teacher/classes/[id] |
班级详情顶层路由（CICD 仅 my/[id]） |
第二部分：简化迁移页面清单（portal-shell 实现是简化版，需补全功能）
| 页面路由 |
CICD 实现 |
portal-shell 实现 |
简化点 |
补全建议 |
/teacher/exams/[id]/edit（原 edit-rich） |
Tiptap 富文本编辑器（exam-rich-editor.tsx 懒加载 exam-rich-editor-inner.tsx，含 7 个扩展节点：blank-node / dotted-mark / group-block / image-node / question-block / section-block；selection-toolbar.tsx；双向转换 3 文件） |
exam-rich-form.tsx 使用 contentEditable + document.execCommand（见文件头注释："移除 ExamRichEditor 依赖，使用 contentEditable 简化实现"） |
缺失整个 Tiptap 编辑器基础设施、自定义节点扩展、结构与编辑器双向转换、选区工具栏 |
迁移 editor/ 目录全部文件 + @tiptap/* 依赖 |
/teacher/lesson-plans/[planId]/edit |
paper-editor.tsx 基于 Tiptap（依赖 useLessonPlanEditor hook）+ textbook-tiptap-editor.tsx |
paper-editor.tsx 使用 contentEditable + document.execCommand（见文件头注释："使用 contentEditable 替代 Tiptap，prop-driven"） |
富文本能力退化，无法支持复杂块级结构 |
引入 Tiptap，迁移 textbook-tiptap-editor.tsx |
/teacher/exams/[id]/proctoring |
独立 proctoring 模块（anti-cheat-monitor.tsx / exam-mode-config.tsx / proctoring-dashboard.tsx）+ WebSocket 实时推送 |
proctoring-client.tsx 使用 5s 轮询模拟实时刷新（见文件头注释："WS 契约未就绪...通过内置 5s 轮询模拟实时刷新"） |
缺反作弊监控、考试模式配置、WS 实时推送 |
待 WS 契约就绪后改接实时推送；补 anti-cheat-monitor / exam-mode-config 组件 |
/teacher/exams/[id]/build |
组卷工作台 + exam-assembly.tsx 完整子组件 |
exam-build-client.tsx 三栏布局存在，但 @contract-pending 全 MSW 兜底 |
契约未接通，数据为 mock |
接通 examBuild / questionsLibrary / saveExamBuild 真实契约 |
/teacher/homework/submissions/[submissionId]/scan-grading |
homework-scan-grading-view.tsx |
scan-grading-client.tsx（重命名），@contract-pending MSW 兜底 |
契约未接通 |
接通 submissionDetail / saveScanGrading 真实契约 |
/teacher/grades/entry |
batch-grade-entry.tsx + 独立 hooks/use-batch-grade-entry-undo.ts + hooks/use-draft-lock.ts |
batch-grade-entry.tsx 存在但 undo hook 内联为本地实现 |
撤销逻辑内联，未独立 Hook 化 |
当前功能完整，若需复用可抽出 hook |
/teacher/attendance/*（sheet/stats/report） |
独立 10+ 子组件（attendance-sheet.tsx / attendance-trend-chart.tsx / attendance-report-print.tsx / attendance-warnings-card.tsx / attendance-grade-correlation-card.tsx / class-comparison-card.tsx / student-attendance-view.tsx / attendance-rules-form.tsx / attendance-stats-class-selector.tsx / attendance-record-list.tsx / attendance-page-layout.tsx） |
4 个 client 文件，子组件内联或缺失 |
缺趋势图、成绩相关性卡、预警卡、班级对比卡、打印、规则表单、记录列表等 |
至少补 attendance-trend-chart / attendance-report-print / attendance-warnings-card |
/teacher/error-book |
13 个子组件（含 5 个图表 + 2 个对话框 + grouped-student-error-table / subject-tabs / class-filter / review-buttons / error-book-item-card / error-book-list） |
仅 error-book-list-client.tsx 1 个 client，无 components 子目录 |
图表与对话框全缺，列表能力退化 |
补齐图表组件与详情对话框 |
/teacher/textbooks/[id] |
22 个组件（含知识图谱 9 个 + 教材阅读器 3 个 + 章节管理 2 个 + 知识点 2 个 + 表单 6 个）+ 8 个 hooks + graph-layout.ts |
仅 textbook-detail-client.tsx + textbooks-list-client.tsx + transformations.ts；图谱能力拆到独立 knowledge-graph feature（仅 1 个 client） |
阅读器、章节管理、知识点 CRUD、图谱交互层全缺 |
补齐教材阅读器与章节管理 |
/teacher/questions |
12 个组件（create-question-dialog / create-question-button / knowledge-point-selector / options-editor / question-bank-results-client / question-columns / question-data-table 等） |
6 个组件（batch-operations / import-export-buttons / question-actions / question-cascade-filter / question-content-renderer / index） |
缺题目创建对话框、知识点选择器、选项编辑器、题目数据表 |
补齐 create-question-dialog / knowledge-point-selector / options-editor / question-data-table |
/teacher/ai/*（3 页面） |
15+ 组件（ai-assistant-widget / ai-chat-panel / ai-chat-input / ai-chat-messages / ai-chart-renderer / ai-markdown-renderer / ai-provider-selector / ai-usage-dashboard / ai-lesson-content-generator / ai-grading-assist / ai-error-book-analysis / ai-question-variant-generator 等）+ context + 5 hooks + services |
仅 3 个 client（ai-assist-client.tsx / ai-lesson-plan-client.tsx / ai-report-client.tsx）+ transformations.ts |
AI 聊天面板、图表渲染、Markdown 渲染、Provider 选择器、用量看板等全缺 |
至少补 ai-chat-panel / ai-markdown-renderer / ai-provider-selector / ai-usage-dashboard |
第三部分：每个模块的缺失组件清单
标注规则：✅ 已迁移；❌ 缺失；⚠️ 存在但简化/重命名；➖ 按架构设计未迁移（Server Actions / data-access / schema 等非组件文件，portal-shell 用 GraphQL hooks 替代）
3.1 exams 模块
组件（components/）
| CICD 文件 |
portal-shell 状态 |
备注 |
assembly/exam-paper-preview.tsx |
❌ 缺失 |
assembly/ 下未迁移此文件 |
assembly/question-bank-list.tsx |
✅ 已迁移 |
|
assembly/selected-question-list.tsx |
✅ 已迁移 |
|
assembly/structure-editor.tsx |
✅ 已迁移 |
|
exam-actions.tsx |
✅ 已迁移 |
|
exam-ai-generator.tsx |
✅ 已迁移 |
AI 出题 |
exam-analytics-dashboard.tsx |
✅ 已迁移 |
|
exam-assembly-config.tsx |
✅ 已迁移 |
|
exam-assembly-question-pool.tsx |
✅ 已迁移 |
|
exam-assembly-selected.tsx |
✅ 已迁移 |
|
exam-assembly.tsx |
✅ 已迁移 |
试卷组装 |
exam-basic-info-form.tsx |
✅ 已迁移 |
|
exam-boundaries.tsx |
❌ 缺失 |
分数边界组件 |
exam-card.tsx |
✅ 已迁移 |
|
exam-columns.tsx |
❌ 缺失 |
表格列定义 |
exam-data-table.tsx |
✅ 已迁移 |
|
exam-form-types.ts |
✅ 已迁移 |
|
exam-form.tsx |
✅ 已迁移 |
|
exam-grid.tsx |
✅ 已迁移 |
|
exam-mode-selector.tsx |
✅ 已迁移 |
|
exam-preview-dialog.tsx |
✅ 已迁移 |
|
exam-preview-question-editor.tsx |
✅ 已迁移 |
|
exam-preview-utils.ts |
✅ 已迁移 |
|
exam-preview.tsx |
✅ 已迁移 |
|
exam-rich-form.tsx |
⚠️ 简化 |
contentEditable 替代 Tiptap |
exam-viewer.tsx |
✅ 已迁移 |
|
question-options-editor.tsx |
✅ 已迁移 |
|
question-sub-questions-editor.tsx |
✅ 已迁移 |
|
Tiptap 编辑器（editor/）—— 整目录缺失（17 文件）
exam-rich-editor.tsx（懒加载入口）/ exam-rich-editor-inner.tsx（Tiptap 实现）/ exam-rich-editor-types.ts / editor-to-structure.ts / structure-to-editor.ts / exam-nodes-to-editor-doc.ts / selection-toolbar.tsx / types.ts / index.ts / extensions/（blank-node / dotted-mark / group-block / image-node / index / question-block / section-block 共 7 文件）/ utils/count-questions.ts —— 全部 ❌ 缺失
Hooks（hooks/）—— 整目录缺失（4 文件）
use-exam-preview.ts / use-exam-preview-rewrite.ts / use-exam-preview-state.ts / use-exam-preview-tasks.ts —— 全部 ❌ 缺失
AI Pipeline（ai-pipeline/）—— 整目录缺失（5 文件）
auto-mark.ts / index.ts / parse.ts / request.ts / structure.ts —— 全部 ❌ 缺失
Services / Config / Utils
services/exam-service-context.tsx / services/exam-service-port.ts / services/index.ts / config/exam-widgets.ts / utils/exam-structure-tree.ts / utils/normalize-structure.ts / lib/type-guards.ts —— 全部 ❌ 缺失
非组件文件（按架构设计未迁移）
actions.ts / actions-helpers.ts / actions-rich-editor.ts / data-access.ts / data-access-cross-module.ts / data-access-error-collection.ts / stats-service.ts / types.ts ➖ 由 lib/api/exams.ts + transformations.ts 替代
3.2 grades 模块
组件（components/）—— 全部已迁移（30+ 文件）
batch-grade-entry.tsx + 5 子组件（dialog/selectors/stats/table/toolbar）/ class-comparison-chart.tsx / class-grade-report.tsx / draft-lock-banner.tsx / excel-import-dialog.tsx / export-button.tsx / grade-distribution-chart.tsx / grade-record-detail.tsx / grade-record-form.tsx / grade-record-list.tsx / grade-record-row.tsx / grade-trend-card.tsx / grade-trend-chart.tsx / growth-archive-chart.tsx / knowledge-point-mastery-chart.tsx / ranking-trend-card.tsx / report-card-print-action.tsx / report-card-print-button.tsx / report-card-view.tsx / school-wide-summary-card.tsx / score-cell.tsx / stats-class-selector.tsx / student-grade-summary.tsx / subject-comparison-chart.tsx —— 全部 ✅ 已迁移
Hooks / Lib
| CICD 文件 |
portal-shell 状态 |
hooks/use-batch-grade-entry-undo.ts |
⚠️ 内联到 batch-grade-entry.tsx |
hooks/use-draft-lock.ts |
⚠️ 内联 |
lib/grade-utils.ts |
❌ 缺失 |
lib/notify.ts |
❌ 缺失（用 @/shared/lib/notify 替代） |
lib/report-card.ts |
❌ 缺失 |
lib/scope-check.ts / lib/scope-filter.ts |
❌ 缺失（权限范围校验） |
非组件文件（按架构设计未迁移）
actions*.ts（6 个）/ data-access*.ts（10 个）/ export.ts / import-export.ts / stats-service.ts / schema.ts / types.ts ➖ 由 lib/api/grades.ts 替代
3.3 homework 模块
组件（components/）
| CICD 文件 |
portal-shell 状态 |
备注 |
excellent-submissions.tsx |
❌ 缺失 |
优秀提交展示 |
homework-assignment-exam-content-card.tsx |
❌ 缺失 |
作业关联试卷内容卡 |
homework-assignment-exam-error-explorer.tsx |
❌ 缺失 |
作业试卷错误探索 |
homework-assignment-exam-error-explorer-lazy.tsx |
❌ 缺失 |
懒加载版本 |
homework-assignment-exam-preview-pane.tsx |
❌ 缺失 |
作业试卷预览面板 |
homework-assignment-form.tsx |
❌ 缺失 |
作业表单 |
homework-assignment-question-error-detail-panel.tsx |
❌ 缺失 |
题目错误详情面板 |
homework-assignment-question-error-overview-card.tsx |
❌ 缺失 |
题目错误概览卡 |
homework-batch-grading-view.tsx |
✅ 已迁移 |
批量批改 |
homework-grading-panel.tsx |
✅ 已迁移 |
|
homework-grading-toolbar.tsx |
✅ 已迁移 |
|
homework-grading-view.tsx |
✅ 已迁移 |
|
homework-scan-grading-view.tsx |
⚠️ 重命名 |
改为 scan-grading-client.tsx |
homework-submission-result.tsx |
✅ 已迁移 |
|
homework-take-confirm-dialog.tsx |
✅ 已迁移 |
|
homework-take-question.tsx |
✅ 已迁移 |
|
homework-take-sidebar.tsx |
✅ 已迁移 |
|
homework-take-toolbar.tsx |
✅ 已迁移 |
|
homework-take-view.tsx |
✅ 已迁移 |
|
question-renderer.tsx |
✅ 已迁移 |
|
scan-image-viewer.tsx |
✅ 已迁移 |
|
scan-uploader.tsx |
✅ 已迁移 |
|
student-homework-review-view.tsx |
❌ 缺失 |
学生作业复习视图 |
非组件文件（按架构设计未迁移）
actions.ts / data-access*.ts（7 个）/ stats-service.ts / schema.ts / types.ts ➖ 由 lib/api/homework.ts 替代
3.4 lesson-plans 模块（CICD: lesson-preparation）
组件 —— 大部分已迁移，编辑器简化
| CICD 文件 |
portal-shell 状态 |
备注 |
paper-editor/paper-editor.tsx |
⚠️ 简化 |
contentEditable 替代 Tiptap |
paper-editor/textbook-tiptap-editor.tsx |
❌ 缺失 |
Tiptap 编辑器 |
paper-editor/paper-toolbar.tsx |
✅ 已迁移 |
|
paper-editor/paper-context-menu.tsx |
✅ 已迁移 |
|
paper-editor/inline-node.tsx |
✅ 已迁移 |
|
paper-editor/inline-qa-dialog.tsx |
✅ 已迁移 |
|
blocks/ 目录（14 个块组件） |
✅ 已迁移 |
objective/exercise/homework/import/interaction/key-point/new-teaching/reflection/rich-text/summary/text-study/blackboard + types + type-guards |
detail-panel/ 目录（5 个文件） |
✅ 已迁移 |
detail-head/panel/props/qa-editor |
structure-tree/ 目录（2 个文件） |
✅ 已迁移 |
structure-tree/tree-node-row |
ai-feedback-dialog.tsx |
✅ 已迁移 |
AI 反馈 |
ai-differentiation-dialog.tsx |
✅ 已迁移 |
|
anchor-migration-banner.tsx |
✅ 已迁移 |
|
attachment-picker.tsx |
✅ 已迁移 |
|
consistency-check-dialog.tsx |
✅ 已迁移 |
|
inline-question-editor.tsx |
✅ 已迁移 |
|
knowledge-point-picker.tsx |
✅ 已迁移 |
|
lesson-plan-calendar-client.tsx |
✅ 已迁移 |
日历视图 |
lesson-plan-card.tsx |
✅ 已迁移 |
|
lesson-plan-dialogs.tsx |
✅ 已迁移 |
|
lesson-plan-edit-client.tsx |
✅ 已迁移 |
|
lesson-plan-heatmap-client.tsx |
✅ 已迁移 |
热力图 |
lesson-plan-library-client.tsx |
✅ 已迁移 |
|
lesson-plan-list-client.tsx |
✅ 已迁移 |
|
lesson-plan-mobile-view.tsx |
✅ 已迁移 |
|
lesson-plan-outline-tree.tsx |
✅ 已迁移 |
|
lesson-plan-publish-button.tsx |
✅ 已迁移 |
|
lesson-plan-readonly-view.tsx |
✅ 已迁移 |
|
lesson-plan-toolbar.tsx |
✅ 已迁移 |
|
new-lesson-plan-client.tsx |
✅ 已迁移 |
|
version-diff-view.tsx / version-diff-viewer.tsx / version-history-drawer.tsx |
✅ 已迁移 |
版本对比 |
非组件文件（按架构设计未迁移）
actions*.ts（12 个）/ data-access*.ts（13 个）/ publish-service.ts / ai-suggest.ts / seed-templates.ts / constants.ts / schema.ts / types.ts ➖ 由 lib/api/lesson-plans.ts 替代
3.5 attendance 模块
组件（components/）—— 大量缺失
| CICD 文件 |
portal-shell 状态 |
备注 |
attendance-grade-correlation-card.tsx |
❌ 缺失 |
考勤成绩相关性卡 |
attendance-page-layout.tsx |
❌ 缺失 |
页面布局 |
attendance-record-list.tsx |
❌ 缺失 |
记录列表 |
attendance-report-print.tsx |
❌ 缺失 |
报告打印 |
attendance-rules-form.tsx |
❌ 缺失 |
规则表单 |
attendance-sheet.tsx |
❌ 缺失 |
考勤表（独立组件） |
attendance-stats-class-selector.tsx |
❌ 缺失 |
统计班级选择器 |
attendance-trend-chart.tsx |
❌ 缺失 |
趋势图 |
attendance-warnings-card.tsx |
❌ 缺失 |
预警卡 |
class-comparison-card.tsx |
❌ 缺失 |
班级对比卡 |
student-attendance-view.tsx |
❌ 缺失 |
学生考勤视图 |
portal-shell 已有
attendance-list-client.tsx / attendance-sheet-client.tsx / attendance-stats-client.tsx / attendance-report-client.tsx / transformations.ts（4 个 client 整合了部分能力，但子组件未拆分）
非组件文件（按架构设计未迁移）
actions.ts / data-access*.ts（3 个）/ correlation-compute.ts / trend-compute.ts / warning-compute.ts / export.ts / notifications.ts / constants.ts / schema.ts / types.ts ➖ 部分计算逻辑（trend-compute / warning-compute / correlation-compute）应迁入 transformations.ts
3.6 classes 模块
组件 —— 全部已迁移
| CICD 文件 |
portal-shell 状态 |
class-detail/ 目录（7 个 widget + edit-class-dialog） |
✅ 已迁移 |
class-delete-dialog.tsx |
✅ 已迁移 |
class-form-dialog.tsx |
❌ 缺失（合并入 edit-class-dialog） |
class-form-utils.ts |
❌ 缺失 |
class-invitation-manager.tsx |
✅ 已迁移 |
class-list-table.tsx |
✅ 已迁移 |
class-list-toolbar.tsx |
✅ 已迁移 |
admin-classes-view.tsx |
➖ 管理员视图（非教师域） |
grade-classes-view.tsx |
➖ 年级视图（非教师域） |
my-classes-grid.tsx |
✅ 已迁移 |
schedule-create-dialog.tsx / schedule-delete-dialog.tsx / schedule-edit-dialog.tsx |
✅ 已迁移 |
schedule-utils.ts |
✅ 已迁移 |
schedule-view.tsx |
✅ 已迁移 |
students-table.tsx |
✅ 已迁移 |
Hooks / Lib
| CICD 文件 |
portal-shell 状态 |
hooks/use-class-data.ts |
❌ 缺失 |
hooks/use-class-filters.ts |
❌ 缺失 |
lib/admin-class-mappers.ts |
➖ 管理员映射（非教师域） |
3.7 diagnostic 模块
组件 / Services
| CICD 文件 |
portal-shell 状态 |
备注 |
components/class-diagnostic-view.tsx |
⚠️ 整合 |
portal-shell 用 diagnostic-class-detail-client.tsx |
components/student-diagnostic-view.tsx |
⚠️ 整合 |
portal-shell 用 student-diagnostic-client.tsx |
components/confidence-utils.ts |
❌ 缺失 |
置信度工具 |
components/mastery-radar-chart.tsx |
❌ 缺失 |
掌握度雷达图 |
components/report-list.tsx |
❌ 缺失 |
报告列表 |
services/default-diagnostic-service.ts |
❌ 缺失 |
|
services/diagnostic-monitor-context.tsx |
❌ 缺失 |
|
services/diagnostic-monitor.ts |
❌ 缺失 |
|
services/diagnostic-service-context.tsx |
❌ 缺失 |
|
services/diagnostic-service.ts |
❌ 缺失 |
|
services/monitored-diagnostic-service.ts |
❌ 缺失 |
|
非组件文件（按架构设计未迁移）
actions.ts / data-access*.ts（2 个）/ export.ts / role-config.ts / stats-service.ts / schema.ts / types.ts ➖ 由 lib/api/diagnostic.ts 替代
3.8 elective 模块
组件
| CICD 文件 |
portal-shell 状态 |
备注 |
elective-course-detail.tsx |
❌ 缺失 |
课程详情 |
elective-course-form.tsx |
⚠️ 整合 |
portal-shell 用 elective-create-client.tsx / elective-edit-client.tsx |
elective-course-list.tsx |
⚠️ 整合 |
portal-shell 用 elective-list-client.tsx |
elective-page-layout.tsx |
❌ 缺失 |
页面布局 |
parent-selection-view.tsx |
➖ 家长视图（非教师域） |
|
student-selection-view.tsx |
➖ 学生视图（非教师域） |
|
Lib
| CICD 文件 |
portal-shell 状态 |
lib/lottery.ts |
❌ 缺失（抽签算法） |
lib/schedule-conflict.ts |
❌ 缺失（课表冲突检测） |
3.9 error-book 模块
组件（components/）—— 几乎全缺
| CICD 文件 |
portal-shell 状态 |
备注 |
add-error-book-dialog.tsx |
❌ 缺失 |
添加错题对话框 |
chapter-weakness-chart.tsx |
❌ 缺失 |
章节薄弱图 |
class-error-bar-chart.tsx |
❌ 缺失 |
班级错题柱状图 |
class-filter.tsx |
❌ 缺失 |
班级筛选 |
error-book-detail-dialog.tsx |
❌ 缺失 |
错题详情对话框 |
error-book-item-card.tsx |
❌ 缺失 |
错题卡片 |
error-book-list.tsx |
❌ 缺失 |
列表（portal-shell 内联到 client） |
grouped-student-error-table.tsx |
❌ 缺失 |
分组学生错题表 |
knowledge-point-weakness-chart.tsx |
❌ 缺失 |
知识点薄弱图 |
review-buttons.tsx |
❌ 缺失 |
复习按钮 |
subject-distribution-chart.tsx |
❌ 缺失 |
学科分布图 |
subject-tabs.tsx |
❌ 缺失 |
学科 Tab |
top-wrong-questions.tsx |
❌ 缺失 |
高频错题 |
portal-shell 已有
仅 error-book-list-client.tsx + transformations.ts
非组件文件（按架构设计未迁移）
actions.ts / data-access*.ts（3 个）/ sm2-algorithm.ts（SM2 复习算法）/ schema.ts / types.ts ➖ sm2-algorithm.ts 是核心算法，建议迁入 transformations.ts 或独立 lib
3.10 course-plans 模块
组件（components/）—— 全缺
| CICD 文件 |
portal-shell 状态 |
备注 |
course-plan-calendar.tsx |
❌ 缺失 |
日历组件 |
course-plan-detail.tsx |
⚠️ 整合 |
portal-shell 用 course-plan-detail-client.tsx |
course-plan-form.tsx |
❌ 缺失 |
表单 |
course-plan-item-editor.tsx |
❌ 缺失 |
条目编辑器 |
course-plan-list.tsx |
⚠️ 整合 |
portal-shell 用 course-plan-list-client.tsx |
course-plan-progress.tsx |
❌ 缺失 |
进度组件 |
sortable-week-row.tsx |
❌ 缺失 |
可排序周行 |
template-picker-dialog.tsx |
❌ 缺失 |
模板选择对话框 |
Lib
| CICD 文件 |
portal-shell 状态 |
lib/calendar-utils.ts |
❌ 缺失 |
lib/export-utils.ts |
❌ 缺失 |
lib/track-event.ts |
❌ 缺失 |
3.11 leave-requests 模块（portal-shell: leave）
组件
| CICD 文件 |
portal-shell 状态 |
备注 |
leave-request-form.tsx |
❌ 缺失 |
请假表单 |
leave-request-list.tsx |
⚠️ 整合 |
portal-shell 用 leave-list-client.tsx |
leave-review-dialog.tsx |
❌ 缺失 |
审批对话框 |
leave-review-list.tsx |
❌ 缺失 |
审批列表 |
3.12 questions 模块
组件（components/）
| CICD 文件 |
portal-shell 状态 |
备注 |
batch-operations.tsx |
✅ 已迁移 |
|
create-question-button.tsx |
❌ 缺失 |
创建题目按钮 |
create-question-dialog.tsx |
❌ 缺失 |
创建题目对话框 |
import-export-buttons.tsx |
✅ 已迁移 |
|
knowledge-point-selector.tsx |
❌ 缺失 |
知识点选择器 |
options-editor.tsx |
❌ 缺失 |
选项编辑器 |
question-actions.tsx |
✅ 已迁移 |
|
question-bank-results-client.tsx |
❌ 缺失 |
题库结果客户端 |
question-cascade-filter.tsx |
✅ 已迁移 |
|
question-columns.tsx |
❌ 缺失 |
表格列定义 |
question-content-renderer.tsx |
✅ 已迁移 |
|
question-data-table.tsx |
❌ 缺失 |
题目数据表 |
Utils
| CICD 文件 |
portal-shell 状态 |
utils/parse-content.ts |
❌ 缺失 |
utils/track-event.ts |
❌ 缺失 |
3.13 textbooks 模块
组件（components/）—— 几乎全缺
| CICD 文件 |
portal-shell 状态 |
备注 |
chapter-sidebar-list.tsx |
❌ 缺失 |
章节侧边栏 |
create-chapter-dialog.tsx |
❌ 缺失 |
创建章节对话框 |
force-graph.tsx |
❌ 缺失 |
力导向图 |
graph-kp-node.tsx |
❌ 缺失 |
图谱知识点节点 |
graph-node-detail-panel.tsx |
❌ 缺失 |
图谱节点详情面板 |
graph-prerequisite-edge.tsx |
❌ 缺失 |
图谱前置依赖边 |
graph-toolbar.tsx |
❌ 缺失 |
图谱工具栏 |
knowledge-graph-controls.tsx |
❌ 缺失 |
图谱控制 |
knowledge-graph-inner.tsx |
❌ 缺失 |
图谱内部 |
knowledge-graph-node.tsx |
❌ 缺失 |
图谱节点 |
knowledge-graph.tsx |
❌ 缺失 |
图谱主组件 |
knowledge-point-dialogs.tsx |
❌ 缺失 |
知识点对话框 |
knowledge-point-list.tsx |
❌ 缺失 |
知识点列表 |
textbook-card.tsx |
❌ 缺失 |
教材卡片 |
textbook-content-panel.tsx |
❌ 缺失 |
教材内容面板 |
textbook-form-dialog.tsx |
❌ 缺失 |
教材表单对话框 |
textbook-form-fields.tsx |
❌ 缺失 |
教材表单字段 |
textbook-reader-content.tsx |
❌ 缺失 |
阅读器内容 |
textbook-reader-toc.tsx |
❌ 缺失 |
阅读器目录 |
textbook-reader.tsx |
❌ 缺失 |
阅读器主组件 |
textbook-settings-dialog.tsx |
❌ 缺失 |
教材设置对话框 |
Hooks（hooks/）—— 全缺
use-graph-data.ts / use-knowledge-point-actions.ts / use-kp-create.ts / use-kp-crud.ts / use-kp-delete.ts / use-kp-dialog-state.ts / use-kp-update.ts / use-text-selection.ts —— 全部 ❌ 缺失
Lib / Utils
| CICD 文件 |
portal-shell 状态 |
lib/type-guards.ts |
❌ 缺失 |
graph-layout.ts |
❌ 缺失（图谱布局算法） |
utils.ts |
❌ 缺失 |
analytics.tsx |
❌ 缺失 |
constants.ts |
❌ 缺失 |
portal-shell 已有
textbook-detail-client.tsx + textbooks-list-client.tsx + transformations.ts；图谱能力拆到独立 knowledge-graph feature（仅 knowledge-graph-client.tsx + transformations.ts）
3.14 ai 模块
组件（components/）—— 大量缺失
| CICD 文件 |
portal-shell 状态 |
备注 |
ai-assistant-widget.tsx / ai-assistant-widget-inner.tsx |
❌ 缺失 |
AI 助手浮窗 |
ai-chart-renderer.tsx |
❌ 缺失 |
图表渲染 |
ai-chat-input.tsx / ai-chat-messages.tsx / ai-chat-panel.tsx |
❌ 缺失 |
聊天面板三件套 |
ai-child-summary.tsx |
➖ 家长域（非教师域） |
|
ai-error-book-analysis.tsx |
❌ 缺失 |
错题分析 |
ai-grading-assist.tsx |
❌ 缺失 |
批改助手 |
ai-lesson-content-generator.tsx |
❌ 缺失 |
教案内容生成 |
ai-markdown-renderer.tsx |
❌ 缺失 |
Markdown 渲染 |
ai-provider-selector.tsx |
❌ 缺失 |
Provider 选择器 |
ai-question-variant-generator.tsx |
❌ 缺失 |
题目变体生成 |
ai-study-path.tsx |
➖ 学生域（非教师域） |
|
ai-usage-dashboard.tsx |
❌ 缺失 |
用量看板 |
Context / Hooks / Services
| CICD 文件 |
portal-shell 状态 |
context/ai-client-provider.tsx |
❌ 缺失 |
context/create-ai-client-service.ts |
❌ 缺失 |
hooks/stream-utils.ts / use-ai-chat-stream.ts / use-ai-suggestion.ts / use-drag-position.ts / use-floating-ball.ts / use-position-persistence.ts |
❌ 缺失 |
services/ai-service.ts / content-safety.ts / prompt-templates.ts / usage-tracker.ts |
❌ 缺失 |
portal-shell 已有
ai-assist-client.tsx / ai-lesson-plan-client.tsx / ai-report-client.tsx / transformations.ts（3 个 client 是页面级整合，但底层聊天/流式/Provider 能力全缺）
3.15 proctoring 模块（CICD 独立模块，portal-shell 并入 exams）
| CICD 文件 |
portal-shell 状态 |
备注 |
components/anti-cheat-monitor.tsx |
❌ 缺失 |
反作弊监控 |
components/exam-mode-config.tsx |
❌ 缺失 |
考试模式配置 |
components/proctoring-dashboard.tsx |
⚠️ 整合 |
portal-shell 用 exams/proctoring-client.tsx 替代 |
actions.ts / data-access.ts / types.ts |
➖ 由 lib/api/proctoring.ts 替代 |
|
3.16 adaptive-practice 模块（CICD 有，portal-shell 并入 practice）
组件 —— 全缺
answer-input.tsx / answer-result.tsx / question-card.tsx / question-content.tsx（答题核心）/ class-knowledge-point-weakness-chart.tsx / class-practice-comparison-table.tsx / inactive-students-alert.tsx / practice-type-breakdown-chart.tsx / student-practice-ranking-table.tsx（教师域分析图表）/ practice-history.tsx / practice-result-view.tsx / practice-session-view.tsx / practice-starter.tsx / practice-starter-with-nav.tsx（练习流程）/ services/practice-service.tsx / lib/answer-utils.ts / lib/errors.ts / lib/grading.ts / lib/source-meta.ts / lib/type-guards.ts —— 全部 ❌ 缺失
portal-shell 已有
practice/practice-list-client.tsx + transformations.ts（仅列表页，练习流程与分析图表全缺）
3.17 dashboard 模块（teacher-dashboard 子目录）
| CICD 文件 |
portal-shell 状态 |
备注 |
teacher-dashboard/recent-submissions.tsx |
❌ 缺失 |
最近提交 |
teacher-dashboard/teacher-classes-card.tsx |
❌ 缺失 |
班级卡 |
teacher-dashboard/teacher-dashboard-view.tsx |
⚠️ 整合 |
portal-shell 内联到 /teacher/page.tsx |
teacher-dashboard/teacher-grade-trends.tsx |
❌ 缺失 |
成绩趋势卡 |
teacher-dashboard/teacher-homework-card.tsx |
❌ 缺失 |
作业卡 |
teacher-dashboard/teacher-quick-actions.tsx |
❌ 缺失 |
快捷操作 |
teacher-dashboard/teacher-schedule.tsx |
❌ 缺失 |
课表卡 |
teacher-dashboard/teacher-todo-card.tsx |
❌ 缺失 |
待办卡 |
portal-shell 的 /teacher/page.tsx 用 useTeacherDashboard 接 data-ana 真实聚合查询，但仅展示 4 个 StatCard + 班级概览 + 预警，缺上述 7 个子组件卡片。
第四部分：核心功能完整性检查结果
4.1 exams 模块（4 项）
| 核心功能 |
完整性 |
详细说明 |
| Tiptap 富文本编辑器（exam-rich-editor） |
❌ 不完整 |
portal-shell exam-rich-form.tsx 用 contentEditable + document.execCommand 替代 Tiptap。CICD 的整个 editor/ 目录（17 个文件，含 7 个 Tiptap 扩展节点、双向转换、选区工具栏）未迁移。/teacher/exams/[id]/edit 路由对应 CICD 的 edit-rich，但实现退化。影响：无法支持试卷的题块/分节/分组/填空下划线/打点标记等结构化编辑 |
| AI 出题（exam-ai-generator） |
✅ 完整 |
exam-ai-generator.tsx 已迁移，改为 prop-driven（原版依赖 react-hook-form Control）。AI Provider 选择、预览、后台任务列表能力保留 |
| 试卷组装（exam-assembly） |
⚠️ 简化 |
exam-assembly.tsx + exam-assembly-config.tsx + exam-assembly-question-pool.tsx + exam-assembly-selected.tsx + assembly/ 3 子组件已迁移；但 exam-build-client.tsx 全 MSW 兜底（@contract-pending），exam-boundaries.tsx / exam-columns.tsx 缺失，hooks/use-exam-preview*.ts（4 个）缺 |
| 监考（proctoring） |
⚠️ 简化 |
proctoring-client.tsx 存在（三栏布局：考试信息/学生状态/事件流），但用 5s 轮询模拟 WS 实时推送。CICD 独立 proctoring 模块的 anti-cheat-monitor.tsx / exam-mode-config.tsx 未迁移 |
4.2 grades 模块（3 项）
| 核心功能 |
完整性 |
详细说明 |
| 批量录入（batch-grade-entry） |
✅ 完整 |
batch-grade-entry.tsx + 5 子组件（dialog/selectors/stats/table/toolbar）全部迁移。undo hook 内联为本地 token + useUndoGradeEntry 调用（功能保留） |
| Excel 导入 |
✅ 完整 |
excel-import-dialog.tsx 已迁移，用 useDownloadGradeImportTemplate + useImportGradesFromExcel hooks 替代 Server Actions。原生元素替代 shadcn Dialog/Select |
| 报表打印（report-card-print） |
✅ 完整 |
report-card-print-action.tsx + report-card-print-button.tsx + report-card-view.tsx + report-card-client.tsx 全部迁移 |
4.3 homework 模块（2 项）
| 核心功能 |
完整性 |
详细说明 |
| 扫描批改（scan-grading） |
⚠️ 简化 |
scan-grading-client.tsx（重命名自 homework-scan-grading-view.tsx）存在，三栏布局保留，但 @contract-pending MSW 兜底。scan-image-viewer.tsx + scan-uploader.tsx 已迁移 |
| 批量批改（batch-grading） |
✅ 完整 |
homework-batch-grading-view.tsx 已迁移，用 useBatchAutoGrade hook 替代 Server Action，原生 table + input 替代 shadcn Table/Checkbox |
4.4 lesson-plans 模块（5 项）
| 核心功能 |
完整性 |
详细说明 |
| 教案编辑器（lesson-plan-editor） |
❌ 不完整 |
paper-editor.tsx 用 contentEditable 替代 Tiptap（见文件头注释）。textbook-tiptap-editor.tsx 未迁移。blocks/ 目录 14 个块组件已迁移，但编辑器内核退化。影响：复杂块级结构编辑能力受限 |
| AI 反馈（ai-feedback） |
✅ 完整 |
ai-feedback-dialog.tsx 已迁移，改为 prop-driven（原版依赖 useLessonPlanAi hook）。ai-differentiation-dialog.tsx 也已迁移 |
| 版本对比（version-diff） |
✅ 完整 |
version-diff-viewer.tsx + version-diff-view.tsx + version-history-drawer.tsx 全部迁移 |
| 日历视图（calendar） |
✅ 完整 |
lesson-plan-calendar-client.tsx 已迁移 |
| 热力图（heatmap） |
✅ 完整 |
lesson-plan-heatmap-client.tsx 已迁移 |
4.5 attendance 模块（3 项）
| 核心功能 |
完整性 |
详细说明 |
| 考勤表（sheet） |
⚠️ 简化 |
attendance-sheet-client.tsx 存在，但 CICD 独立 attendance-sheet.tsx 组件未迁移（能力内联或缺失） |
| 统计（stats） |
⚠️ 简化 |
attendance-stats-client.tsx 存在，但 attendance-trend-chart.tsx / attendance-stats-class-selector.tsx / class-comparison-card.tsx / attendance-grade-correlation-card.tsx 未迁移 |
| 报告（report） |
⚠️ 简化 |
attendance-report-client.tsx 存在，但 attendance-report-print.tsx（打印）/ attendance-warnings-card.tsx（预警）未迁移 |
4.6 classes 模块（3 项）
| 核心功能 |
完整性 |
详细说明 |
| 班级详情 |
✅ 完整 |
class-detail-client.tsx + class-detail/ 7 个 widget（header/overview-stats/quick-actions/schedule-widget/students-widget/assignments-widget/trends-widget）全部迁移 |
| 学生管理 |
✅ 完整 |
students-table.tsx 已迁移 |
| 课表 |
✅ 完整 |
class-schedule-client.tsx + schedule-view.tsx + 3 个 schedule dialog（create/edit/delete）+ schedule-utils.ts 全部迁移 |
4.7 diagnostic 模块（2 项）
| 核心功能 |
完整性 |
详细说明 |
| 班级诊断 |
⚠️ 简化 |
diagnostic-class-detail-client.tsx 存在，但 CICD class-diagnostic-view.tsx / mastery-radar-chart.tsx（掌握度雷达图）/ report-list.tsx 未迁移 |
| 学生诊断 |
⚠️ 简化 |
student-diagnostic-client.tsx + student-diagnostic-transformations.ts 存在，但 student-diagnostic-view.tsx 独立组件未迁移 |
4.8 ai 模块（3 项）
| 核心功能 |
完整性 |
详细说明 |
| AI 助教 |
⚠️ 简化 |
ai-assist-client.tsx 存在（页面级），但 CICD ai-assistant-widget / ai-chat-panel / ai-chat-input / ai-chat-messages / ai-markdown-renderer / ai-provider-selector 等底层组件全缺，流式聊天能力缺失（use-ai-chat-stream / stream-utils 未迁移） |
| AI 报告 |
⚠️ 简化 |
ai-report-client.tsx 存在（页面级），但 ai-chart-renderer.tsx / ai-usage-dashboard.tsx 未迁移 |
| AI 教案 |
⚠️ 简化 |
ai-lesson-plan-client.tsx 存在（页面级），但 ai-lesson-content-generator.tsx 未迁移 |
4.9 核心功能完整性汇总
| 完整性 |
数量 |
功能列表 |
| ✅ 完整 |
10 项 |
exams AI 出题、grades 批量录入、grades Excel 导入、grades 报表打印、homework 批量批改、lesson-plans AI 反馈、lesson-plans 版本对比、lesson-plans 日历视图、lesson-plans 热力图、classes（详情/学生/课表 3 项） |
| ⚠️ 简化 |
11 项 |
exams 试卷组装、exams 监考、homework 扫描批改、attendance（考勤表/统计/报告 3 项）、diagnostic（班级/学生 2 项）、ai（助教/报告/教案 3 项） |
| ❌ 不完整 |
2 项 |
exams Tiptap 富文本编辑器、lesson-plans 教案编辑器 |
第五部分：迁移优先级建议
P0（阻断核心教学流程，建议优先补全）
- exams Tiptap 富文本编辑器：迁移
editor/ 全目录（17 文件）+ @tiptap/* 依赖，恢复试卷结构化编辑能力。涉及 7 个自定义节点扩展（blank-node / dotted-mark / group-block / image-node / question-block / section-block）+ 双向转换 + 选区工具栏
- lesson-plans Tiptap 编辑器：迁移
textbook-tiptap-editor.tsx，恢复教案块级编辑能力。当前 paper-editor.tsx 用 contentEditable 退化，blocks/ 14 个块组件已就绪但内核简化
- attendance 趋势图与预警卡：补
attendance-trend-chart.tsx / attendance-warnings-card.tsx / attendance-report-print.tsx，恢复考勤统计可视化与打印
P1（影响功能完整性）
- error-book 图表与对话框：补 5 个图表组件（
chapter-weakness-chart / class-error-bar-chart / knowledge-point-weakness-chart / subject-distribution-chart / top-wrong-questions）+ 2 个对话框 + sm2-algorithm.ts 复习算法
- questions 创建与编辑：补
create-question-dialog.tsx / knowledge-point-selector.tsx / options-editor.tsx / question-data-table.tsx，恢复题目 CRUD 完整流程
- textbooks 阅读器与章节管理：补
textbook-reader*.tsx（3 个）/ chapter-sidebar-list.tsx / create-chapter-dialog.tsx，恢复教材阅读与章节管理
- ai 聊天面板与流式：补
ai-chat-panel 三件套（input/messages/panel）+ ai-markdown-renderer + use-ai-chat-stream + ai-provider-selector，恢复 AI 流式聊天能力
P2（增强体验）
- proctoring 反作弊：补
anti-cheat-monitor.tsx / exam-mode-config.tsx，WS 契约就绪后改接实时推送（当前 5s 轮询）
- diagnostic 雷达图：补
mastery-radar-chart.tsx / confidence-utils.ts / report-list.tsx
- dashboard 教师卡片：补 7 个 teacher-dashboard 子组件卡片（recent-submissions / teacher-classes-card / teacher-grade-trends / teacher-homework-card / teacher-quick-actions / teacher-schedule / teacher-todo-card）
- course-plans 表单与日历：补
course-plan-form.tsx / course-plan-calendar.tsx / sortable-week-row.tsx / template-picker-dialog.tsx / course-plan-item-editor.tsx / course-plan-progress.tsx
- homework 试卷关联：补
homework-assignment-exam-*（5 个文件）/ homework-assignment-form.tsx / excellent-submissions.tsx / student-homework-review-view.tsx
P3（按需补全）
- adaptive-practice 练习流程：补答题核心组件（answer-input / answer-result / question-card / question-content）与教师分析图表（5 个）
- leave-requests 审批：补
leave-review-dialog.tsx / leave-review-list.tsx / leave-request-form.tsx
- elective 抽签与冲突检测：补
lib/lottery.ts / lib/schedule-conflict.ts / elective-course-detail.tsx / elective-page-layout.tsx
- exams 辅助：补
exam-boundaries.tsx / exam-columns.tsx / hooks/use-exam-preview*.ts（4 个）/ ai-pipeline/（5 个）/ services/（3 个）
附录：架构差异说明
A.1 数据层架构差异（非缺失）
CICD 采用 Next.js Server Actions 模式，每个模块包含：
actions.ts / actions-*.ts：Server Actions 入口data-access.ts / data-access-*.ts：数据访问层schema.ts：Zod 验证types.ts：类型定义
portal-shell 采用 GraphQL hooks 模式，对应能力由：
src/lib/api/{module}.ts：GraphQL 查询/mutation hooks（useXxx）src/lib/api/operations/{module}.graphql.ts：GraphQL operationssrc/features/teacher/{module}/transformations.ts：数据转换与纯函数
承担。本报告对 actions*.ts / data-access*.ts / schema.ts / types.ts 这类非组件文件不予标记为缺失，除非包含核心算法（如 sm2-algorithm.ts / graph-layout.ts / trend-compute.ts / warning-compute.ts / correlation-compute.ts / lottery.ts / schedule-conflict.ts）。
A.2 路由结构差异
- CICD：
src/app/(dashboard)/teacher/（路由组 (dashboard)）
- portal-shell：
src/app/shell/teacher/（路由组 shell）
路由组差异不影响实际路径，/teacher/* 路径在两端一致。
A.3 共享组件差异
CICD 使用 shadcn/ui 组件库（Dialog/Select/Table/Checkbox/ScrollArea/ResizablePanel 等），portal-shell 部分组件用原生 HTML 元素替代（见各文件头注释："使用原生元素替代"）。这是 portal-shell 的适配策略，不标记为缺失。
A.4 核心算法文件迁移建议
以下 CICD 非组件文件包含核心业务算法，建议迁入 portal-shell 对应模块的 transformations.ts 或独立 lib：
| CICD 文件 |
所属模块 |
建议迁移目标 |
sm2-algorithm.ts |
error-book |
features/teacher/error-book/lib/sm2-algorithm.ts |
graph-layout.ts |
textbooks |
features/teacher/knowledge-graph/lib/graph-layout.ts |
trend-compute.ts / warning-compute.ts / correlation-compute.ts |
attendance |
features/teacher/attendance/transformations.ts（合并） |
lottery.ts / schedule-conflict.ts |
elective |
features/teacher/elective/lib/ |
ai-pipeline/（5 文件） |
exams |
features/teacher/exams/lib/ai-pipeline/ |
lib/scope-check.ts / lib/scope-filter.ts |
grades |
features/teacher/grades/lib/ |
报告结束。后续迁移工作请基于本报告的"第三部分：每个模块的缺失组件清单"与"第五部分：迁移优先级建议"执行。
04b7a40bdc