NextEdu/bugs/others_bug_v4.md

# 前端功能模块与用户体验深度审查报告 v4

> 审查范围：`src/app/(dashboard)/{announcements,dashboard,management,messages,profile,settings}` 及相关 `modules/*/components`
> 审查维度：功能模块合理性、页面布局、用户使用习惯、同类产品对比、缺陷与不足
> 审查日期：2026-06-20
> 审查方法：5 个子代理并行深度审查 + 同类产品对比分析

---

## 一、总体结论

本次审查覆盖 6 大模块、50+ 页面、100+ 组件，共发现 **201 个问题**，分布如下：

| 严重程度 | 数量 | 占比 |
|----------|------|------|
| P0（阻断/安全） | 14 | 7% |
| P1（重要功能缺失） | 52 | 26% |
| P2（体验/功能不完整） | 81 | 40% |
| P3（优化建议） | 54 | 27% |

### 核心发现

1. **安全漏洞集中爆发**：14 个 P0 问题中有 12 个是权限校验缺失，涉及 admin 下几乎所有页面，任何登录用户可访问管理后台数据
2. **功能完整性严重不足**：消息模块处于 MVP 阶段，缺草稿/群发/搜索/附件/实时推送；公告模块定向推送完全失效；设置模块缺 2FA/登录历史/设备管理
3. **用户体验与同类产品差距显著**：对比钉钉/企业微信/飞书/Google Classroom/PowerSchool，在实时性、批量操作、搜索筛选、数据可视化等方面全面落后
4. **中英文混排严重**：管理后台页面标题中文、组件 UI 英文、注释中文，缺乏统一 i18n 策略
5. **基础设施缺失**：大量路由缺少 loading.tsx/error.tsx，列表页缺少分页/搜索/批量操作

---

## 二、Dashboard 仪表盘模块（31 个问题）

### 2.1 P0 严重问题（4 个）

#### D-P0-1 多角色用户重定向逻辑存在优先级冲突
- **文件**：`src/app/(dashboard)/dashboard/page.tsx` 第 10-15 行
- **问题**：用户同时拥有多角色（如 admin+teacher）时，按 `admin → student → parent → teacher` 硬编码优先级重定向，用户无法选择以其他角色进入。`app-sidebar.tsx` 第 35-42 行同样逻辑重复
- **同类对比**：钉钉/企业微信均支持角色切换器
- **改进建议**：SiteHeader 增加角色切换下拉菜单，所选角色持久化到 cookie
- **严重程度**：P0

#### D-P0-2 StudentStatsGrid 接收的 props 与实际渲染不一致
- **文件**：`src/modules/dashboard/components/student-dashboard/student-stats-grid.tsx` 第 6-16 行
- **问题**：组件声明 5 个 props（enrolledClassCount、dueSoonCount、overdueCount、gradedCount、ranking），但只渲染 3 个。`enrolledClassCount` 和 `gradedCount` 完全未使用，学生仪表盘缺失"已选课程数"和"已评分作业数"
- **改进建议**：补全 4 个 StatCard 渲染
- **严重程度**：P0

#### D-P0-3 Teacher/Parent 仪表盘缺少 loading.tsx 和 error.tsx
- **文件**：`src/app/(dashboard)/teacher/dashboard/`、`src/app/(dashboard)/parent/dashboard/`、`src/app/(dashboard)/dashboard/` 三个目录
- **问题**：对比 student/dashboard 有 loading.tsx，teacher/parent 仪表盘在网络慢或数据加载失败时白屏。teacher/dashboard 并行请求 6 个数据源，任一失败整页崩溃
- **改进建议**：三个目录各添加 loading.tsx（骨架屏）和 error.tsx（错误边界+重试）
- **严重程度**：P0

#### D-P0-4 TeacherDashboardHeader 硬编码"Good morning"问候语
- **文件**：`src/modules/dashboard/components/teacher-dashboard/teacher-dashboard-header.tsx` 第 18 行
- **问题**：标题始终显示 `Good morning`，未根据时间动态切换。而 student-dashboard-header.tsx 第 9-13 行和 parent-dashboard.tsx 第 13-17 行都正确实现了按时段问候
- **改进建议**：复用 student 的问候逻辑，抽取到 `shared/lib/greeting.ts`
- **严重程度**：P0

### 2.2 P1 重要问题（7 个）

| 编号 | 文件 | 问题 | 改进建议 |
|------|------|------|----------|
| D-P1-1 | admin-dashboard.tsx 第 13-31 行 | AdminDashboard 缺少快捷操作入口（创建用户/发公告/调课表） | PageHeader actions 增加 Button |
| D-P1-2 | admin-dashboard.tsx 全文 | 缺少"待办事项""系统健康""今日关键事件""最近登录日志"模块 | 增加 Pending Approvals 和 System Health 卡片 |
| D-P1-3 | teacher-dashboard-view.tsx 第 36-42 行 | 未清理的注释和 `a.submittedAt!` 非空断言违反项目规则 | 清理注释，改为显式过滤 |
| D-P1-4 | student-dashboard-view.tsx 第 31-39 行 | Student 仪表盘布局比例失衡，col-span 嵌套混乱，缺少课程进度/出勤率/学习时长 | 修正 col-span，增加 Attendance Summary 卡片 |
| D-P1-5 | parent-dashboard.tsx 全文 | Parent 仪表盘缺少多子女对比视图、学校通知摘要、家长会预约、子女今日课表 | 增加 "Today at a Glance" 聚合区域 |
| D-P1-6 | app-sidebar.tsx 第 35-42 行 vs dashboard/page.tsx 第 12-15 行 | 角色判断逻辑重复且 fallback 到 teacher 导航可能展示无权限菜单 | 抽取 getPrimaryRole 工具函数，fallback 返回空数组 |
| D-P1-7 | site-header.tsx 第 70 行 | 面包屑过滤基于 title 而非 segment，逻辑脆弱 | 改为基于 segment 过滤 |

### 2.3 P2/P3 问题（20 个，略）

详见子报告，主要包括：col-span 冲突、ScrollArea 固定高度违反任意值规则、animate-pulse 可访问性、Avatar src 硬编码 undefined、metadata 不一致、toWeekday 函数重复、空状态文案语言不一致、缺少 focus-visible 样式、status 未本地化、缺少返回顶部、移动端搜索隐藏、表格无横向滚动、无数据刷新机制等。

### 2.4 同类产品对比

| 功能 | Google Classroom | 钉钉教育 | PowerSchool | 本项目 | 差距 |
|------|------------------|----------|-------------|--------|------|
| 首屏待办聚合 | ✅ | ✅ | ✅ | 部分角色有 | Parent 缺失 |
| 快速创建按钮 | ✅ "+" 浮动 | ✅ | ✅ | 仅 Teacher | Admin/Student 缺失 |
| 多子女对比 | N/A | ✅ | ✅ | ❌ | 缺失 |
| 出勤率热力图 | ❌ | ✅ | ✅ | ❌ | 缺失 |
| 数据大屏 | ❌ | ✅ | ✅ | 基础统计 | 不如图表化 |
| 课表打印 | ❌ | ✅ | ✅ | ❌ | 缺失 |

---

## 三、Announcements 公告模块（31 个问题）

### 3.1 P0 严重问题（4 个）

#### A-P0-1 管理端列表页缺失权限校验
- **文件**：`src/app/(dashboard)/admin/announcements/page.tsx` 第 20-32 行
- **问题**：未调用 `requirePermission(Permissions.ANNOUNCEMENT_MANAGE)`，任何登录用户可访问 `/admin/announcements` 查看所有状态公告（含草稿）和全部年级数据
- **对比**：同目录 `/admin/audit-logs/page.tsx` 第 27 行、`/admin/files/page.tsx` 第 20 行均有权限校验
- **改进建议**：增加 `await requirePermission(Permissions.ANNOUNCEMENT_MANAGE)`
- **严重程度**：P0

#### A-P0-2 管理端编辑页缺失权限校验
- **文件**：`src/app/(dashboard)/admin/announcements/[id]/page.tsx` 第 16-28 行
- **问题**：任何登录用户可查看任意公告完整内容（含草稿）及编辑表单
- **改进建议**：同上
- **严重程度**：P0

#### A-P0-3 公告定向推送完全失效——无受众过滤
- **文件**：`src/modules/announcements/data-access.ts` 第 50-88 行
- **问题**：`getAnnouncements` 仅按 status 和 type 过滤，完全不根据用户年级/班级过滤 `targetGradeId`、`targetClassId`。学生 A（高一）能看到定向给"高二"的年级公告，定向推送名存实亡
- **改进建议**：增加 `audience?: { gradeId?, classId?, roles? }` 参数，查询条件增加 `(type='school') OR (type='grade' AND target_grade_id=:userGradeId) OR (type='class' AND target_class_id=:userClassId)`
- **严重程度**：P0

#### A-P0-4 dashboard 布局无认证守卫，admin 路由无布局级权限拦截
- **文件**：`src/app/(dashboard)/layout.tsx`；`src/app/(dashboard)/admin/` 无 layout.tsx
- **问题**：dashboard 布局仅渲染 Sidebar/Header，无认证检查。admin/ 目录无 layout.tsx 做统一 admin 角色守卫。项目根目录无 middleware.ts 做路由级拦截
- **改进建议**：新增 `src/app/(dashboard)/admin/layout.tsx` 增加 `await requireRole("admin")`，或新增 `middleware.ts` 对 `/admin/*` 拦截
- **严重程度**：P0

### 3.2 P1 重要问题（8 个）

| 编号 | 文件 | 问题 | 改进建议 |
|------|------|------|----------|
| A-P1-1 | announcements/ 目录 | 用户端无公告详情页，用户只能看标题+3行摘要，无法查看完整正文 | 新增 `/announcements/[id]/page.tsx` |
| A-P1-2 | actions.ts 第 164-184 行 | 发布公告时不触发任何通知，通知基础设施已就绪但未接入 | publishAnnouncementAction 成功后调用 sendBatchNotifications |
| A-P1-3 | announcement-form.tsx | 定时发布功能完全不可用，publishedAt 无 UI 输入，无调度器 | 表单增加日期时间选择器，新增 Vercel Cron Job |
| A-P1-4 | admin/announcements/page.tsx 第 29-32 行 | 班级定向公告完全不可用，classes 数据未传递，班级下拉为空 | 并行调用 getClasses() 传入 |
| A-P1-5 | data-access.ts 第 50-88 行 | 无分页 UI，data-access 支持但页面未传入 page 参数，超过 20 条看不到 | 增加分页控件 |
| A-P1-6 | data-access.ts | 无关键词搜索 | 增加 keyword 参数和搜索框 |
| A-P1-7 | announcement-form.tsx 第 102-112 行 | 无富文本编辑，仅纯文本 Textarea | 集成 TipTap/Lexical，DOMPurify 清洗 |
| A-P1-8 | schema.ts 第 3-21 行 | 表单未校验定向目标，可创建 type=grade 但 targetGradeId=null 的无效公告 | Zod superRefine 条件校验 |

### 3.3 P2/P3 问题（19 个，略）

主要包括：无置顶功能、无阅读回执/已读统计、无附件/图片支持、无预览功能、无评论/反馈、不支持按角色定向、无法撤回已发布、客户端过滤与服务端过滤重复、无模板功能、无 loading.tsx、无分类标签、hidden input 冗余、formatDate 不显示时间、UI 中英文混杂、架构图与代码不一致、isWorking 状态未阻止重复提交、Dialog 关闭表单状态残留等。

### 3.4 同类产品对比

| 功能 | 钉钉公告 | 企业微信 | 飞书公告 | 本项目 | 差距 |
|------|---------|---------|---------|--------|------|
| 富文本编辑 | ✅ | ✅ | ✅ | 仅纯文本 | P1 |
| 附件/图片 | ✅ | ✅ | ✅ | ❌ | P2 |
| 置顶 | ✅ | ✅ | ✅ | ❌ | P2 |
| 阅读回执 | ✅ | ✅ | ✅ | ❌ | P2 |
| 定向推送 | ✅ | ✅ | ✅ | 仅年级/班级且过滤失效 | P0+P2 |
| 定时发布 | ✅ | ✅ | ✅ | 字段存在但无 UI | P1 |
| 预览 | ✅ | ✅ | ✅ | ❌ | P2 |
| 消息通知联动 | ✅ | ✅ | ✅ | ❌（基础设施已就绪） | P1 |
| 评论/反馈 | 部分 | ❌ | ✅ | ❌ | P2 |
| 撤回 | ✅ | ✅ | ✅ | 仅归档/删除 | P2 |
| 模板 | ✅ | ❌ | ✅ | ❌ | P2 |

---

## 四、Messages 消息模块（38 个问题）

### 4.1 P0 严重问题（3 个）

#### M-P0-1 缺少草稿箱
- **文件**：`src/modules/messaging/data-access.ts`、`src/shared/db/schema.ts` 第 898-914 行
- **问题**：`messages` 表无 `isDraft`/`status` 字段，无草稿相关 Action。用户在 MessageCompose 中输入内容后点击"取消"直接丢弃，无自动保存
- **改进建议**：新增 `status` 字段（draft/sent/trash/archived），撰写组件添加自动保存（每 30 秒）和"存为草稿"按钮
- **严重程度**：P0

#### M-P0-2 缺少群发消息、班级消息
- **文件**：`src/modules/messaging/components/message-compose.tsx` 第 85 行；`src/modules/messaging/schema.ts` 第 3-9 行
- **问题**：`receiverId` 是单个字符串，使用单选 Select，无法群发。K12 场景下教师给全班学生发消息是高频需求
- **改进建议**：`receiverId` 改为 `receiverIds: string[]`，使用多选 Combobox，支持按班级/年级批量选择
- **严重程度**：P0

#### M-P0-3 完全无实时推送机制
- **文件**：全项目 Grep `websocket|socket.io|sse|EventSource|realtime` 在 messaging/notifications 模块无任何匹配
- **问题**：消息和通知完全依赖页面刷新或手动 router.refresh()。教师发消息后学生看不到，除非主动刷新。与 IM 类产品实时性预期严重不符
- **改进建议**：引入 SSE（Server-Sent Events）或 WebSocket，实现新消息实时推送、未读计数实时更新、在线状态指示
- **严重程度**：P0

### 4.2 P1 重要问题（14 个）

| 编号 | 文件 | 问题 | 改进建议 |
|------|------|------|----------|
| M-P1-1 | messages/page.tsx 第 22-34 行 | 消息列表与通知列表垂直堆叠，信息架构混乱 | 三栏布局或通知拆分独立 Tab |
| M-P1-2 | messages/page.tsx 第 18 行 | 无分页 UI，仅加载前 50 条，getMessagesAction 返回 totalPages 未消费 | 添加分页器或无限滚动 |
| M-P1-3 | message-detail.tsx 全文 | 无会话线程视图，getMessageThread 已实现但未使用 | 改为会话视图，底部固定回复输入框 |
| M-P1-4 | message-list.tsx 第 18 行 | 缺少星标、垃圾箱、归档，deleteMessage 是硬删除不可恢复 | 扩展表结构，改为软删除 |
| M-P1-5 | message-list.tsx 全文 | 缺少搜索、筛选、排序 | getMessages 增加 keyword/isRead/dateFrom/sortBy 参数 |
| M-P1-6 | schema.ts / message-compose.tsx | 缺少附件支持，messages 表无 attachments 字段 | 新增 message_attachments 表，集成 FileUpload |
| M-P1-7 | message-detail.tsx 第 85-100 行 | 缺少消息撤回、转发 | 新增 recallMessageAction（限时 2 分钟），转发入口 |
| M-P1-8 | navigation.ts 第 96-99 行 | 导航栏 Messages 无未读红点，getUnreadMessageCount 已实现但未调用 | 在 sidebar 渲染未读数 Badge，轮询或 SSE 推送 |
| M-P1-9 | message-compose.tsx 第 85-97 行 | 收件人选择体验差，原生 Select 无搜索无分组，all scope 一次性返回所有用户 | 改用 Combobox + 搜索，后端支持分页 |
| M-P1-10 | 全模块 | 对比同类产品缺失群聊、@提及、消息反应、置顶、模板、定时发送、已读详情、引用回复、语音消息 | 按优先级分批实现 |
| M-P1-11 | notification-dropdown.tsx 第 41-54 行 | 通知下拉仅加载一次，无实时刷新，unreadCount 只计算初始 10 条 | 添加轮询或 SSE，从专门接口获取未读总数 |
| M-P1-12 | preferences.ts 第 47-56 行 | 缺少免打扰模式和安静时段（22:00-07:00），K12 家长晚间不希望被打扰是强需求 | 新增 quietHoursStart/quietHoursEnd/vacationMode 字段 |
| M-P1-13 | data-access.ts 第 157-161 行 | 发送方删除消息会导致接收方也丢失（硬删除） | 改为软删除 + senderDeletedAt/receiverDeletedAt |
| M-P1-14 | data-access.ts | 无历史消息搜索，家长可能需要搜索上学期教师发的通知 | getMessages 增加 keyword 参数 |

### 4.3 P2/P3 问题（21 个，略）

主要包括：撰写页是整页跳转非抽屉、列表项缺少星标/附件/分类标识、缺少富文本、已读回执不完整、回复 subject 通过 URL 传递、通知类型映射语义错误、通知偏好无法按类别选择渠道、微信渠道形同虚设（users 表无 wechat_open_id）、通知列表与下拉内容重复、权限粒度过粗、学生互发限制未在 UI 提示、管理员删除消息权限矛盾、无归档功能、无 loading.tsx/error.tsx、客户端过滤导致数据不一致、parentMessageId 无外键约束、getMessageThread 仅一层非递归、notification-dropdown 归属 messaging 模块错误、receiverId 状态管理冗余、无键盘快捷键、notFound() 后无自定义 404 等。

### 4.4 同类产品对比

| 功能 | 钉钉消息 | 企业微信 | 飞书邮件 | 本项目 | 差距 |
|------|---------|---------|---------|--------|------|
| 群聊/群组 | ✅ | ✅ | ✅ | ❌ | P0 |
| 草稿箱 | ✅ | ✅ | ✅ | ❌ | P0 |
| 实时推送 | ✅ | ✅ | ✅ | ❌ | P0 |
| 消息搜索 | ✅ | ✅ | ✅ | ❌ | P1 |
| 附件支持 | ✅ | ✅ | ✅ | ❌ | P1 |
| 消息撤回 | ✅ | ✅ | ✅ | ❌ | P1 |
| @提及 | ✅ | ✅ | ✅ | ❌ | P2 |
| 消息模板 | ✅ | 部分 | ✅ | ❌ | P2 |
| 定时发送 | ✅ | ❌ | ✅ | ❌ | P2 |
| 已读详情 | ✅ | ✅ | ✅ | ❌ | P2 |
| 免打扰时段 | ✅ | ✅ | ✅ | ❌ | P1 |

---

## 五、Management 管理模块（52 个问题）

### 5.1 P0 严重问题（1 类，涉及 10 个页面）

#### MG-P0-1 多个 admin 页面缺少权限校验
- **涉及文件**（10 个）：
  - `admin/school/schools/page.tsx`
  - `admin/school/academic-year/page.tsx`
  - `admin/school/classes/page.tsx`
  - `admin/school/departments/page.tsx`
  - `admin/school/grades/page.tsx`
  - `admin/school/grades/insights/page.tsx`
  - `admin/users/import/page.tsx`
  - `admin/scheduling/auto/page.tsx`
  - `admin/scheduling/changes/page.tsx`
  - `admin/scheduling/rules/page.tsx`
- **问题**：以上页面均未调用 `requirePermission()`，任何登录用户可直接访问所有 admin 管理页面，查看/操作学校、年级、班级、部门、学年、用户导入、排课等敏感数据
- **对比**：`admin/audit-logs/page.tsx`、`admin/files/page.tsx`、`management/grade/classes/page.tsx` 均正确实现了权限校验
- **改进建议**：各页面函数体首行添加对应 `requirePermission()` 调用
- **严重程度**：P0

### 5.2 P1 重要问题（9 个）

| 编号 | 文件 | 问题 | 改进建议 |
|------|------|------|----------|
| MG-P1-1 | 全模块 | 中英文混排严重不一致，页面标题中文、组件 UI 英文、注释中文 | 统一为中文（面向 K12 中文用户） |
| MG-P1-2 | navigation.ts | 文件管理页面未在导航中注册，用户无法通过侧边栏访问 | admin 配置添加 Files 菜单项 |
| MG-P1-3 | navigation.ts 第 58 行 | 用户导入入口放在"School Management"下，且整个系统无用户管理主页面 | 创建独立 "Users" 一级菜单 |
| MG-P1-4 | 多个子路由 | 子路由缺少 loading.tsx 和 error.tsx，management/grade/ 完全不在 admin 路由树下 | 为每个子路由添加定制边界 |
| MG-P1-5 | 多个列表页 | 除审计日志外，几乎所有列表页面一次性加载全部数据，无服务端分页 | 添加 page/pageSize 参数和分页控件 |
| MG-P1-6 | 多个列表页 | 大部分列表页面缺少批量操作（批量删除/导出/编辑） | 添加复选框列和批量操作工具栏 |
| MG-P1-7 | 多个列表页 | 大部分列表页面缺少搜索和筛选 | 参考 grades-view.tsx 的实现 |
| MG-P1-8 | admin/school/page.tsx 第 6 行 | 重定向到 /admin/school/classes 跳过学校管理，层级不合理 | 改为 redirect("/admin/school/schools") |
| MG-P1-9 | admin-classes-view.tsx 第 233、247 行 | 学校和年级为自由文本输入，导致数据完整性问题 | 改为从 schools/grades 表查询的 Select |

### 5.3 P2/P3 问题（42 个，略）

主要包括：原生 select 而非 shadcn Select、工具函数重复、formatDate 调用不一致、admin/files 硬编码 200 条上限、排课变更缺少筛选 UI、新建申请按钮链接到 teacher 页面、schedule-change-list 无分页、scheduling-rules-form 缺少表单验证、user-import-dialog 缺少文件大小校验、预览仅显示前 50 行、不支持拖拽上传、审计日志缺少用户搜索、数据变更日志显示原始 JSON 无 diff 视图、文件管理缺少上传者信息、缺少排序功能、使用原生 a 标签、无批量审批、部门管理功能简陋、学校管理缺少搜索、学年管理缺少日期校验、admin-classes-view 与 grade-classes-view 代码重复、formatSubjectTeachers join 符号不一致、缺少面包屑导航、提交模式不一致、常量未提取、JSON.stringify 传递复杂数据、申请可提交空内容、无自动刷新、无导出功能、无重置按钮、统计仅显示前 N 项、UA 被截断、缺少空状态插图、无排序功能、缺少 dataScope 控制、缺少操作日志记录、缺少键盘快捷键、缺少数据导出、缺少数据可视化等。

### 5.4 同类产品对比

| 功能 | 钉钉管理后台 | 企业微信管理 | PowerSchool | 本项目 | 差距 |
|------|------------|------------|-------------|--------|------|
| 权限校验 | ✅ | ✅ | ✅ | 10 页面缺失 | P0 |
| 批量操作 | ✅ | ✅ | ✅ | 仅文件管理 | P1 |
| 搜索筛选 | ✅ | ✅ | ✅ | 仅年级管理 | P1 |
| 分页 | ✅ | ✅ | ✅ | 仅审计日志 | P1 |
| 数据导出 | ✅ | ✅ | ✅ | 仅审计日志 | P3 |
| 数据可视化 | ✅ | ✅ | ✅ | 基础统计 | P3 |
| 面包屑导航 | ✅ | ✅ | ✅ | ❌ | P2 |
| dataScope | ✅ | ✅ | ✅ | ❌ | P3 |
| 键盘快捷键 | 部分 | ❌ | ❌ | ❌ | P3 |

### 5.5 正面发现（值得保持的良好实践）

1. **grades-view.tsx 是优秀范例**：完整的搜索/筛选/排序、表单校验、去重校验、isDirty 检测、nuqs URL 状态管理
2. **admin-files-view.tsx 批量删除实现良好**：复选框、全选/反选、indeterminate 状态
3. **file-upload.tsx 上传体验优秀**：拖拽上传、进度条、文件校验、多文件并行
4. **审计日志分页实现正确**：分页控件和 "Showing X-Y of Z" 信息
5. **Promise.all 并行查询**：多个页面使用 Promise.all 并行查询，性能良好
6. **AlertDialog 用于 destructive 操作**：所有删除操作都使用 AlertDialog 确认

---

## 六、Profile 个人资料模块（部分问题）

### 6.1 P0 严重问题（1 个）

#### P-P0-1 缺少 loading.tsx 与 error.tsx
- **文件**：`src/app/(dashboard)/profile/`
- **问题**：项目硬约束要求所有路由包含 loading.tsx 和 error.tsx，但 profile 目录只有 page.tsx
- **改进建议**：新增 loading.tsx（骨架屏）和 error.tsx（错误边界+重试）
- **严重程度**：P0

### 6.2 P1 重要问题（5 个）

| 编号 | 文件 | 问题 | 改进建议 |
|------|------|------|----------|
| P-P1-1 | profile/page.tsx 行 50-118、215-300 | 页面职责混乱，混入大量仪表盘逻辑（学生学业概览+教师教学概览），303 行中 180 行是仪表盘逻辑 | 移除 Student/Teacher Overview，聚焦个人资料 |
| P-P1-2 | profile/page.tsx 行 132-213 | 缺少头像展示，users 表有 image 字段但未展示 | 在 PageHeader 下方展示头像 |
| P-P1-3 | profile-settings-form.tsx 全文 | 缺少头像上传功能，UpdateUserProfileInput 不包含 image | 增加头像上传区，扩展类型 |
| P-P1-4 | 整个 settings 模块 | 缺少隐私设置（数据可见性、第三方授权、活动记录） | 新增 Privacy Tab |
| P-P1-5 | profile/page.tsx 行 37；settings/page.tsx 行 17 | 使用 requireAuth() 而非 requirePermission()，违反项目规则 | 改为 requirePermission(USER_PROFILE_UPDATE) |

### 6.3 P2/P3 问题（8 个，略）

主要包括：信息展示不完整（缺监护人、教育背景、最后登录）、Edit Profile 未深链到 Tab、Age 字段应改为 Birth Date、死代码 redirect("/login")、PageHeader 未复用等。

---

## 七、Settings 设置模块（部分问题）

### 7.1 P0 严重问题（1 个）

#### S-P0-1 缺少 loading.tsx 与 error.tsx
- **文件**：`src/app/(dashboard)/settings/`、`src/app/(dashboard)/settings/security/`
- **问题**：同 profile，违反项目硬约束
- **改进建议**：两个目录均新增 loading.tsx 和 error.tsx
- **严重程度**：P0

### 7.2 P1 重要问题（9 个）

| 编号 | 文件 | 问题 | 改进建议 |
|------|------|------|----------|
| S-P1-1 | settings/page.tsx 行 27-33 | 角色路由缺失 parent 分支，parent 用户被错误渲染为 TeacherSettingsView | 显式处理 parent 角色 |
| S-P1-2 | settings-view.tsx 行 63-81 | Tab 分类不齐全，缺少 AI Providers、Privacy、Account、Language & Region | 扩展为 6 个 Tab |
| S-P1-3 | settings/security/page.tsx 全文 | 缺少两步验证（2FA）、登录设备管理、登录历史 | 新增 2FA 设置区、设备管理卡片、登录历史卡片 |
| S-P1-4 | settings-view.tsx 行 83-86 | AiProviderSettingsCard 已存在但未在 SettingsView 中使用 | 在 General 或新增 AI Tab 中渲染 |
| S-P1-5 | notification-preferences-form.tsx 全文 | 缺少免打扰时段（DND）设置 | 新增 DND 卡片 |
| S-P1-6 | settings-view.tsx 行 63 | Tab 切换无 URL 持久化，刷新回到 General，无法分享特定 Tab 链接 | useSearchParams 实现 URL 同步 |
| S-P1-7 | password-change-form.tsx 行 22-24 | 使用任意值 Tailwind 类 `[&>div]:bg-red-500`，违反项目规则 | 在 globals.css 定义工具类 |
| S-P1-8 | 整个 settings 模块 | 无快捷键自定义功能 | 新增 Keyboard Shortcuts 设置区 |
| S-P1-9 | settings-view.tsx 行 63-81 | Tabs 缺少键盘箭头导航验证 | 确认 Radix Tabs ARIA 实现 |

### 7.3 P2/P3 问题（17 个，略）

主要包括：Appearance Tab 内容单薄（无字体大小/密度/语言/时区）、settings/security 与 SettingsView Security Tab 内容重复、邮箱不可修改、Age 应改为 BirthDate、密码修改后未登出其他会话、缺少密码历史检查、缺少邮件摘要频率、缺少按类别渠道覆盖、缺少删除 AI Provider、AI Provider 强制测试才能保存、Tab 切换无未保存变更警告、通知偏好无即时反馈、登出无二次确认、错误信息泄露用户存在性、AI Provider 测试无频率限制、ProfileSettingsForm 无错误状态展示、AiProviderSettingsCard 加载失败无重试、bcrypt salt rounds 偏低、主题描述硬编码 "admin console"、ProfileSettingsForm 无 Cancel/Reset、中文错误信息、中文注释等。

### 7.4 同类产品对比

| 功能 | Google 账户 | GitHub Settings | 钉钉设置 | 本项目 | 差距 |
|------|------------|----------------|---------|--------|------|
| 头像上传 | ✅ | ✅ | ✅ | ❌ | P1 |
| 2FA | ✅ | ✅ | ✅ | ❌ | P1 |
| 登录设备管理 | ✅ | ✅ | ✅ | ❌ | P1 |
| 登录历史 | ✅ | ✅ | ✅ | ❌ | P1 |
| 通知免打扰 | ✅ | ✅ | ✅ | ❌ | P1 |
| 语言切换 | ✅ | ✅ | ✅ | ❌ | P2 |
| 时区设置 | ✅ | ✅ | ✅ | ❌ | P2 |
| 第三方授权管理 | ✅ | ✅ | ✅ | ❌ | P1 |
| 数据导出 | ✅ | ✅ | ✅ | ❌ | P2 |
| 删除账户 | ✅ | ✅ | ✅ | ❌ | P2 |
| Tab URL 持久化 | ✅ | ✅ | ✅ | ❌ | P1 |
| 未保存变更警告 | ✅ | ✅ | ✅ | ❌ | P2 |

---

## 八、跨模块共性问题

### 8.1 安全问题集中爆发

**12 个 P0 权限校验缺失**：
- announcements 模块 2 个（admin 列表页+编辑页）
- management 模块 10 个（admin/school/* 6 个 + admin/users/import 1 个 + admin/scheduling/* 3 个）
- dashboard 布局无认证守卫

**根因分析**：项目缺少统一的 admin 路由守卫机制。建议在 `src/app/(dashboard)/admin/layout.tsx` 增加统一 `requireRole("admin")` 或 `requirePermission()` 检查，或新增 `middleware.ts` 对 `/admin/*` 路径拦截。

### 8.2 中英文混排严重

| 模块 | 页面标题 | 组件 UI | 注释 |
|------|----------|---------|------|
| Dashboard | 英文 | 英文 | 英文 |
| Announcements | 中文（metadata） | 英文 | 英文 |
| Messages | 英文 | 英文 | 英文 |
| Management | 中文（大部分） | 中英混排 | 中文 |
| Profile | 英文 | 英文 | 英文 |
| Settings | 英文 | 英文 | 中英混排 |

**改进建议**：建立统一 i18n 策略，推荐统一为中文（面向 K12 中文用户），或接入 next-intl。

### 8.3 loading.tsx / error.tsx 大面积缺失

| 模块 | 缺失目录 |
|------|----------|
| Dashboard | teacher/dashboard、parent/dashboard、dashboard |
| Announcements | announcements、admin/announcements |
| Messages | messages、messages/[id]、messages/compose |
| Management | admin/school/*、admin/scheduling/*、admin/users/import、management/grade/* |
| Profile | profile |
| Settings | settings、settings/security |

**改进建议**：为所有缺失目录添加 loading.tsx（骨架屏）和 error.tsx（错误边界+重试按钮）。

### 8.4 列表页分页/搜索/批量操作三件套缺失

| 模块 | 分页 | 搜索 | 批量操作 |
|------|------|------|----------|
| Announcements | ❌ | ❌ | N/A |
| Messages | ❌ | ❌ | N/A |
| Management（school/*） | ❌ | 仅 grades-view | ❌ |
| Management（audit-logs） | ✅ | ❌ | ✅（导出） |
| Management（files） | ❌ | ✅ | ✅（删除） |

**改进建议**：以 `grades-view.tsx`（搜索/筛选/排序）和 `admin-files-view.tsx`（批量操作）为范例，统一补齐。

### 8.5 实时性全面缺失

全项目无 WebSocket/SSE 实现，消息、通知、仪表盘数据均依赖页面刷新。对比钉钉/企业微信/飞书等 IM 类产品，实时性是核心差距。

**改进建议**：引入 SSE（Server-Sent Events），Next.js 14+ 支持 Route Handler 实现 SSE，成本低于 WebSocket。优先实现消息实时推送和通知实时刷新。

---

## 九、优先级修复建议

### 9.1 立即修复（P0，14 个）

1. **权限校验**（12 个页面）：为所有缺失 `requirePermission()` 的 admin 页面添加权限校验
2. **admin 布局守卫**：新增 `src/app/(dashboard)/admin/layout.tsx` 统一守卫
3. **公告定向推送**：修复 `getAnnouncements` 增加受众过滤
4. **消息草稿箱**：扩展 messages 表 status 字段
5. **消息群发**：支持多收件人
6. **实时推送**：引入 SSE
7. **StudentStatsGrid**：补全 props 渲染
8. **loading/error 边界**：为 teacher/parent/dashboard 添加
9. **TeacherDashboardHeader 问候语**：修复硬编码

### 9.2 短期修复（P1，52 个）

1. **Dashboard**：AdminDashboard 快捷操作、Parent 多子女对比、角色切换器、col-span 修复
2. **Announcements**：用户端详情页、通知联动、定时发布、班级数据传递、分页、搜索、富文本、表单校验
3. **Messages**：会话线程、软删除、搜索筛选、附件、撤回转发、未读红点、收件人 Combobox、免打扰时段、通知实时刷新
4. **Management**：中英文统一、文件管理导航、用户管理主页面、loading/error 边界、分页、批量操作、搜索筛选、学校年级 Select
5. **Profile/Settings**：职责拆分、头像展示上传、parent 角色路由、Tab 分类扩展、2FA/设备管理/登录历史、AiProvider 集成、DND、URL 持久化、权限校验

### 9.3 中期修复（P2，81 个）

富文本编辑、附件支持、置顶、阅读回执、预览、评论、按角色定向、撤回、模板、归档、@提及、消息反应、定时发送、已读详情、引用回复、通知类型映射重构、组件归属迁移、批量审批、表单校验、代码重复提取、面包屑导航等。

### 9.4 长期优化（P3，54 个）

数据可视化、dataScope 控制、键盘快捷键、数据导出、空状态插图、focus-visible 样式、返回顶部、移动端适配、i18n、架构图同步等。

---

## 十、架构图同步提醒

根据项目规则"改码必同步图"，以下修复完成后需要同步更新架构文档（`004_architecture_impact_map.md` 和 `005_architecture_data.json`）：

1. 新增 `admin/layout.tsx` → 更新 app 路由结构
2. 新增 `announcements/[id]/page.tsx` → 更新 announcements 路由
3. messages 表新增 status/isStarred/isArchived 字段 → 更新 dbTables
4. 新增 `ParentSettingsView` → 更新 settings 模块 exports
5. `AiProviderSettingsCard` 集成到 SettingsView → 更新组件依赖
6. 新增 `deleteAiProviderAction` → 更新 settings 模块 actions
7. 新增 privacy/2FA 相关 action → 更新 settings 模块职责
8. `notification-dropdown.tsx` 迁移到 notifications 模块 → 更新模块归属
9. `insertAnnouncement` 返回类型 `Promise<{ announcementId: string }>` → 实际为 `Promise<string>`，需修正文档
10. 抽取 `getPrimaryRole` 工具函数 → 更新 shared/lib exports

---

## 附录：审查文件清单

### Dashboard 模块
- `src/app/(dashboard)/dashboard/page.tsx`
- `src/app/(dashboard)/admin/dashboard/page.tsx`
- `src/app/(dashboard)/teacher/dashboard/page.tsx`
- `src/app/(dashboard)/student/dashboard/page.tsx`
- `src/app/(dashboard)/parent/dashboard/page.tsx`
- `src/modules/dashboard/components/` 下所有组件
- `src/modules/layout/components/app-sidebar.tsx`
- `src/modules/layout/components/site-header.tsx`
- `src/modules/layout/config/navigation.ts`

### Announcements 模块
- `src/app/(dashboard)/announcements/page.tsx`
- `src/app/(dashboard)/admin/announcements/page.tsx`
- `src/app/(dashboard)/admin/announcements/[id]/page.tsx`
- `src/modules/announcements/` 下所有文件

### Messages 模块
- `src/app/(dashboard)/messages/page.tsx`
- `src/app/(dashboard)/messages/[id]/page.tsx`
- `src/app/(dashboard)/messages/compose/page.tsx`
- `src/modules/messaging/` 下所有文件
- `src/modules/notifications/` 下所有文件

### Management 模块
- `src/app/(dashboard)/management/grade/` 下所有页面
- `src/app/(dashboard)/admin/school/` 下所有页面
- `src/app/(dashboard)/admin/users/import/page.tsx`
- `src/app/(dashboard)/admin/audit-logs/` 下所有页面
- `src/app/(dashboard)/admin/files/page.tsx`
- `src/app/(dashboard)/admin/scheduling/` 下所有页面
- `src/modules/classes/components/` 下相关组件
- `src/modules/school/components/` 下所有组件
- `src/modules/audit/components/` 下所有组件
- `src/modules/files/components/` 下所有组件
- `src/modules/scheduling/components/` 下所有组件
- `src/modules/users/components/` 下所有组件

### Profile & Settings 模块
- `src/app/(dashboard)/profile/page.tsx`
- `src/app/(dashboard)/settings/page.tsx`
- `src/app/(dashboard)/settings/security/page.tsx`
- `src/modules/settings/components/` 下所有组件
- `src/modules/settings/` 下所有文件
- `src/modules/users/data-access.ts`
- `src/modules/users/user-service.ts`

---

**本报告由 5 个子代理并行深度审查整合生成，覆盖 6 大模块、50+ 页面、100+ 组件，共发现 201 个问题。建议按 P0 → P1 → P2 → P3 优先级分四个迭代周期完成核心功能补齐，每个迭代同步更新架构图 004/005 文档。**