NextEdu/bugs/admin_bug_v4.md

# Admin 模块产品体验与功能完整性审查报告 v4

> 版本：v4（产品体验 / UX / 功能完整性 / 同类产品对比）
> 核查范围：`src/app/(dashboard)/admin/` 全部 26 个页面 + 导航布局 + 10 个功能模块的视图组件
> 核查维度：
> - 功能模块完整性（对比 K12 教务系统标准功能）
> - 页面布局与信息架构合理性
> - 用户使用习惯符合度
> - 与同类产品（校宝在线、智学网、钉钉教育、PowerSchool、Veracross）的差距
> 核查日期：2026-06-22
> 历史版本：v1（规范审查）、v2（复查）、v3（修复）、v4（产品体验）

---

## 一、核查概览

| 维度 | 模块数 | 优秀 | 合格 | 待改进 | 严重缺陷 |
|------|--------|------|------|--------|---------|
| 导航与信息架构 | 1 | 0 | 0 | 1 | 0 |
| 功能完整性 | 10 | 1 | 4 | 4 | 1 |
| 列表交互（分页/搜索/排序/批量） | 10 | 0 | 2 | 6 | 2 |
| 数据可视化 | 1 | 0 | 0 | 1 | 0 |
| 用户引导与帮助 | 全局 | 0 | 0 | 1 | 0 |
| 移动端适配 | 全局 | 0 | 1 | 0 | 0 |

**总体评价**：架构分层清晰、权限校验到位、空状态处理较好，但在**功能完整性、列表交互能力、数据可视化、用户引导**方面与成熟 K12 教务产品存在明显差距。核心问题集中在：分页缺失、搜索能力薄弱、无数据图表、无用户管理列表页、无系统设置页、Dashboard 缺少快捷操作。

---

## 二、导航与信息架构问题

### N1【严重】两个功能页面无侧边栏入口（用户无法发现）

**文件**：[src/modules/layout/config/navigation.ts](file:///e:/Desktop/CICD/src/modules/layout/config/navigation.ts)

**现状**：`NAV_CONFIG.admin` 中**未列出**以下实际存在的独立功能页：
- `/admin/files`（文件管理）— 有完整页面、权限校验、批量操作，但侧边栏无入口
- `/admin/attendance`（考勤总览）— 有完整页面、权限校验、筛选器，但侧边栏无入口

**影响**：用户只能通过 URL 直达或全局搜索访问，严重违背用户使用习惯（用户期望所有功能都能从侧边栏到达）。

**同类产品对比**：校宝在线、智学网均将"文件中心""考勤管理"作为一级或二级菜单项。

**修复建议**：在 `NAV_CONFIG.admin` 中补充：
```tsx
{
  title: "Attendance",
  icon: CalendarCheck,
  href: "/admin/attendance",
  permission: Permissions.ATTENDANCE_READ,
},
{
  title: "Files",
  icon: FolderOpen,
  href: "/admin/files",
  permission: Permissions.FILE_READ,
},
```

---

### N2【待改进】School Management 子菜单混入跨域功能

**现状**：`School Management` 子菜单包含 8 项，其中 `Course Plans`（`/admin/course-plans`）和 `Import Users`（`/admin/users/import`）不属于"学校管理"业务域：

```
School Management
├─ Schools
├─ Grades
├─ Grade Insights
├─ Departments
├─ Classes
├─ Academic Year
├─ Course Plans      ← 属于"教学管理"域
└─ Import Users      ← 属于"用户管理"域
```

**影响**：
- 信息架构混乱，用户在"学校管理"下找"课程计划"和"导入用户"不符合心智模型
- 子菜单过长（8 项），认知负荷高

**同类产品对比**：校宝在线将"课程管理""用户管理"作为独立一级菜单；PowerSchool 将"Courses""Users"分列。

**修复建议**：
1. 将 `Course Plans` 独立为一级菜单"教学管理"（或与 Electives 合并为"课程与教学"）
2. 将 `Import Users` 独立为一级菜单"用户管理"（并补充用户列表页，见 F1）
3. School Management 子菜单缩减为 6 项纯学校组织架构管理

---

### N3【待改进】无角色切换机制（多角色用户被困）

**文件**：[src/modules/layout/components/app-sidebar.tsx](file:///e:/Desktop/CICD/src/modules/layout/components/app-sidebar.tsx#L30-L36)

**现状**：角色判定逻辑为硬编码优先级 `admin > student > parent > teacher`：
```tsx
if (hasRole("admin")) {
  currentRole = "admin"
} else if (hasRole("student")) {
  currentRole = "student"
}
```

**影响**：若用户同时具有 admin + teacher 角色（如教务主任兼课），**只能看到 admin 菜单**，无法切换到 teacher 视图查看自己的课程/班级。

**同类产品对比**：钉钉教育、企业微信教育版均支持"切换身份"功能；Veracross 支持多角色用户在顶部切换视角。

**修复建议**：在 SiteHeader 用户菜单旁增加"角色切换"下拉，当 `session.user.roles.length > 1` 时显示，切换后更新 `currentRole`。

---

### N4【待改进】面包屑对未配置路由回退效果差

**文件**：[src/modules/layout/components/site-header.tsx](file:///e:/Desktop/CICD/src/modules/layout/components/site-header.tsx)

**现状**：面包屑标题来自 `BREADCRUMB_MAP`（从 NAV_CONFIG 构建）。未在配置中的路由（如 `/admin/files`、`/admin/attendance`、`/admin/announcements/[id]`）回退为 segment 首字母大写（`Files`、`Attendance`、`[id]`）。

**影响**：
- 动态路由 `[id]` 在面包屑中显示为 `[id]` 而非资源标题（如"编辑公告"）
- 未配置菜单的页面面包屑显示英文 segment，与页面中文标题不一致

**修复建议**：
1. 补充 N1 的菜单配置后，`/admin/files` 和 `/admin/attendance` 面包屑自动修复
2. 对动态路由页面，在 page.tsx 中通过 `generateMetadata` 动态生成标题
3. 或在 `BREADCRUMB_MAP` 中补充动态路由的固定标题映射

---

## 三、功能完整性问题

### F1【严重】无用户管理列表页（仅有批量导入）

**现状**：admin 模块有 `/admin/users/import`（批量导入用户），但**没有用户列表页**。管理员无法：
- 查看所有用户列表
- 搜索/筛选用户（按角色、姓名、邮箱、状态）
- 编辑单个用户信息（改名、改角色、重置密码、停用/启用）
- 删除用户
- 查看用户详情

**影响**：这是 K12 教务系统的**核心功能缺失**。管理员只能批量导入，无法管理已存在的用户。

**同类产品对比**：
| 产品 | 用户列表 | 搜索 | 筛选 | 单条编辑 | 重置密码 | 停用/启用 | 删除 |
|------|---------|------|------|---------|---------|----------|------|
| 校宝在线 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 智学网 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| PowerSchool | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **本项目** | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |

**修复建议**：新增 `/admin/users` 页面，包含：
1. 用户列表表格（姓名、邮箱、角色、状态、创建时间、操作）
2. 搜索框（姓名/邮箱模糊搜索）
3. 角色筛选、状态筛选
4. 分页
5. 单条编辑 Dialog（改名、改角色、重置密码、停用/启用）
6. 删除操作（AlertDialog 确认）
7. 导出入口（链接到 `/admin/users/import`）

---

### F2【严重】无系统设置页（侧边栏 Settings 指向 /settings 但无 admin 专属配置）

**现状**：侧边栏 `Settings` 指向 `/settings`（通用设置页），但 admin 角色需要的**系统级配置**无处设置：
- 学校基础信息（校名、校徽、地址、联系电话）
- 学期/学段配置（当前学期、学段划分）
- 角色权限管理（查看/修改角色-权限映射）
- 系统参数（密码策略、会话超时、文件上传限制）
- 邮件/短信通知配置
- 数据备份与导出

**影响**：管理员无法进行系统级配置，系统缺乏可运维性。

**同类产品对比**：校宝在线有"系统设置"一级菜单（含学校信息、学期管理、权限管理、日志配置）；PowerSchool 有"District Setup"。

**修复建议**：新增 `/admin/settings` 页面或路由组，至少包含：
1. 学校信息编辑表单
2. 学期管理（与 Academic Year 联动）
3. 系统参数配置
4. 角色权限查看（只读展示当前角色-权限矩阵）

---

### F3【待改进】Dashboard 缺少快捷操作与趋势图表

**文件**：[src/modules/dashboard/components/admin-dashboard/admin-dashboard.tsx](file:///e:/Desktop/CICD/src/modules/dashboard/components/admin-dashboard/admin-dashboard.tsx)

**现状**：Dashboard 为纯数据展示，4 个 StatCard + 3 张统计 Card + 1 张 Recent Users 表格，**无任何操作按钮、无趋势图、无图表**。

**影响**：
- 管理员进入系统后无法快速跳转到高频操作（新建公告、导入用户、审批变更等）
- 无法直观看到用户增长趋势、作业提交趋势、考勤异常趋势
- 与同类产品差距明显

**同类产品对比**：
| 产品 | 快捷操作 | 趋势图表 | 待办事项 | 实时动态 |
|------|---------|---------|---------|---------|
| 校宝在线 | ✅（快捷入口卡片） | ✅（折线图/饼图） | ✅ | ✅ |
| 智学网 | ✅ | ✅ | ✅ | ✅ |
| PowerSchool | ✅ | ✅ | ✅ | ✅ |
| **本项目** | ❌ | ❌ | ❌ | ❌ |

**修复建议**：
1. 在 StatCard 下方增加"快捷操作"区（4-6 个快捷入口卡片：导入用户、新建公告、审批变更、自动排课、文件管理、考勤总览）
2. 增加"用户增长趋势"折线图（近 30 天新增用户）
3. 增加"作业提交趋势"折线图（近 7 天提交量）
4. 增加"待办事项"区（待审批的课表变更数、待批改的作业数、草稿公告数）
5. Recent Users 表格增加"查看全部"链接

---

### F4【待改进】考勤模块功能薄弱（仅查看，无统计/导出/异常预警）

**文件**：[src/app/(dashboard)/admin/attendance/page.tsx](file:///e:/Desktop/CICD/src/app/(dashboard)/admin/attendance/page.tsx) + [AttendanceRecordList](file:///e:/Desktop/CICD/src/modules/attendance/components/attendance-record-list.tsx)

**现状**：admin 考勤页仅提供：
- 筛选器（班级、状态、日期）
- 考勤记录列表（含删除操作）

**缺失功能**：
- ❌ 考勤统计仪表盘（出勤率、异常率、趋势图）
- ❌ 按班级/年级/时间段汇总报表
- ❌ 考勤异常预警（连续缺勤 N 天的学生自动标红）
- ❌ 导出考勤报表（Excel/PDF）
- ❌ 批量补录/修改考勤
- ❌ 考勤对比分析（班级间对比、年级间对比）

**同类产品对比**：校宝在线考勤模块包含"考勤看板""异常预警""报表导出""批量补录"四大功能区。

**修复建议**：
1. 增加考勤统计概览卡片（今日出勤率、异常人数、连续缺勤人数）
2. 增加导出按钮（Excel）
3. 增加异常预警列表（连续缺勤 ≥3 天的学生）
4. 长期：增加考勤可视化图表

---

### F5【待改进】排课模块缺少课表预览与冲突可视化

**文件**：[AutoSchedulePanel](file:///e:/Desktop/CICD/src/modules/scheduling/components/auto-schedule-panel.tsx) + [ScheduleChangeList](file:///e:/Desktop/CICD/src/modules/scheduling/components/schedule-change-list.tsx)

**现状**：
- `AutoSchedulePanel`：选班级 → 预览 → 应用，但预览结果通过 `AutoScheduleResultView` 展示（未审查到课表网格视图）
- `ScheduleChangeList`：表格列出变更申请，无课表可视化
- `SchedulingRulesForm`：纯表单配置规则

**缺失功能**：
- ❌ 周课表网格视图（横轴时间段、纵轴星期/班级，单元格显示科目+教师）
- ❌ 课表对比视图（旧课表 vs 新课表，差异高亮）
- ❌ 冲突日历视图（按日期展示冲突事件）
- ❌ 教师课表视图（按教师查看个人课表）
- ❌ 班级课表视图（按班级查看课表）
- ❌ 课表导出（Excel/PDF）

**同类产品对比**：校宝在线排课模块提供"课表网格""冲突检测可视化""教师/班级课表切换""导出打印"功能。

**修复建议**：
1. 新增 `ScheduleGrid` 组件，以网格形式展示周课表
2. 支持按"班级视图""教师视图""教室视图"切换
3. 冲突单元格红色高亮
4. 增加导出按钮

---

### F6【待改进】公告模块缺少目标预览与已读统计

**文件**：[AdminAnnouncementsView](file:///e:/Desktop/CICD/src/modules/announcements/components/admin-announcements-view.tsx) + [AnnouncementForm](file:///e:/Desktop/CICD/src/modules/announcements/components/announcement-form.tsx)

**现状**：公告管理支持创建/编辑/列表，但缺失：
- ❌ 公告预览（发布前预览渲染效果）
- ❌ 已读/未读统计（多少人已读、谁未读）
- ❌ 定时发布（设置未来时间自动发布）
- ❌ 公告置顶
- ❌ 公告分类/标签
- ❌ 推送通知（发布时自动推送到目标用户）

**同类产品对比**：钉钉教育公告支持"已读/未读统计""定时发布""置顶""Ding 推送"。

**修复建议**：
1. AnnouncementForm 增加"预览"按钮（侧边抽屉展示渲染效果）
2. 公告列表增加"已读率"列
3. 增加定时发布字段（publishAt）
4. 增加置顶开关

---

### F7【合格但有改进空间】选修模块缺少选课实时监控

**文件**：[ElectiveCourseList](file:///e:/Desktop/CICD/src/modules/elective/components/elective-course-list.tsx)

**现状**：选修课程管理支持创建/编辑/开放选课/关闭选课/抽签，功能较完整。

**缺失功能**：
- ❌ 选课实时监控（各课程已选人数实时更新、竞争激烈度可视化）
- ❌ 选课结果通知（抽签后自动通知中选/未中选学生）
- ❌ 退选管理（学生退选后名额释放）
- ❌ 选课规则配置（每人最多选 N 门、最低学分要求）

**修复建议**：
1. 开放选课期间，课程卡片显示"已选/容量"进度条 + 实时刷新
2. 抽签完成后增加"发送通知"按钮
3. 长期增加选课规则配置页

---

## 四、列表交互能力问题（分页/搜索/排序/批量）

### L1【严重】大部分列表无分页（数据量大时性能与可用性灾难）

**现状**：仅 audit 模块（3 个组件）实现了分页。以下列表**无分页**：

| 模块 | 组件 | 数据量预估 | 风险 |
|------|------|----------|------|
| SchoolsClient | 学校列表 | 1-50 | 低 |
| GradesClient | 年级列表 | 10-200 | 中 |
| AdminClassesClient | 班级列表 | 50-500 | **高** |
| DepartmentsClient | 部门列表 | 5-50 | 低 |
| AcademicYearClient | 学年列表 | 5-20 | 低 |
| CoursePlanList | 课程计划列表 | 50-500 | **高** |
| ElectiveCourseList | 选修课程列表 | 20-200 | 中 |
| AttendanceRecordList | 考勤记录列表 | 1000-100000 | **极高** |
| AdminFilesView | 文件列表 | 100-10000 | **极高** |
| AnnouncementList | 公告列表 | 50-500 | 中 |
| ScheduleChangeList | 变更申请列表 | 50-500 | 中 |
| Recent Users (Dashboard) | 最近用户 | 固定少量 | 低 |

**影响**：考勤记录和文件列表数据量可达数万条，无分页会导致：
- 首屏加载缓慢（数据库全量查询 + 前端全量渲染）
- 浏览器内存溢出
- 用户无法定位历史数据

**修复建议**：
1. **优先级最高**：`AttendanceRecordList`、`AdminFilesView` 必须增加服务端分页
2. **优先级高**：`AdminClassesClient`、`CoursePlanList` 增加分页
3. 统一使用 URL 参数 `?page=N&pageSize=20` 驱动分页（与 audit 模块一致）
4. 分页组件复用 audit 模块的实现模式

---

### L2【严重】大部分列表无搜索功能

**现状**：仅 `GradesClient`（关键词搜索）、audit 三件套（字段筛选）、`AdminFilesView`（文件名搜索）、`AttendanceFilters`（筛选）提供搜索/筛选。以下列表**无搜索**：

| 模块 | 需要搜索的字段 |
|------|--------------|
| AdminClassesClient | 班级名称、班主任、年级 |
| CoursePlanList | 科目、班级、教师、状态 |
| ElectiveCourseList | 课程名、科目、年级、教师 |
| ScheduleChangeList | 班级、教师、状态、日期 |
| AnnouncementList | 标题、状态、类型 |
| SchoolsClient | 学校名称、代码 |
| DepartmentsClient | 部门名称 |
| AcademicYearClient | 学年名称 |

**影响**：数据量增长后用户无法快速定位记录，只能滚动浏览。

**修复建议**：每个列表顶部增加搜索框 + 常用筛选器，使用 `nuqs` 同步 URL 状态。

---

### L3【严重】仅 1 个列表支持排序

**现状**：仅 `GradesClient` 提供 7 种排序。其他所有列表均无排序能力。

**影响**：用户无法按"创建时间倒序""名称排序""学生数排序"等常见需求排列数据，默认顺序依赖后端返回。

**修复建议**：在表格表头增加可点击排序图标（升序/降序/无），使用 URL 参数 `?sort=field&order=desc`。

---

### L4【待改进】批量操作极少

**现状**：仅 `AdminFilesView`（批量删除文件）和 `UserImportDialog`（批量导入）支持批量操作。

**缺失的批量操作**：
- ❌ 批量删除班级/课程计划/选修课程/公告
- ❌ 批量停用/启用用户
- ❌ 批量审批课表变更（当前仅单条审批）
- ❌ 批量导出考勤记录/用户列表

**同类产品对比**：校宝在线、智学网的所有管理列表均支持多选 + 批量操作工具栏。

**修复建议**：
1. 列表表格增加 Checkbox 列 + 表头全选
2. 选中时底部浮现批量操作工具栏
3. 优先实现 `ScheduleChangeList` 的批量审批（高频操作）

---

## 五、数据可视化问题

### V1【待改进】全模块无图表（纯数字+表格）

**现状**：整个 admin 模块**没有任何图表组件**（折线图、柱状图、饼图、热力图）。所有数据以 StatCard 数字、表格、Badge 形式展示。

**影响**：
- Dashboard 无法展示趋势（用户增长、作业提交、考勤异常）
- `school/grades/insights` 名为"洞察"但无可视化图表，仅有表格
- 考勤无出勤率趋势图
- 排课无课表网格图

**同类产品对比**：
| 产品 | 折线图 | 柱状图 | 饼图 | 热力图 | 课表网格 |
|------|--------|--------|------|--------|---------|
| 校宝在线 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 智学网 | ✅ | ✅ | ✅ | ✅ | ✅ |
| PowerSchool | ✅ | ✅ | ✅ | ❌ | ✅ |
| **本项目** | ❌ | ❌ | ❌ | ❌ | ❌ |

**修复建议**：
1. 引入图表库（推荐 `recharts`，与 shadcn 风格兼容）
2. Dashboard 增加用户增长折线图、作业提交趋势图、角色分布饼图
3. `school/grades/insights` 增加班级均分柱状图、成绩分布直方图
4. 考勤增加出勤率热力图（横轴日期、纵轴班级）
5. 排课增加课表网格视图

---

## 六、用户引导与帮助问题

### U1【待改进】无新手引导/操作提示

**现状**：admin 模块无任何形式的用户引导：
- ❌ 无首次登录引导（功能巡览）
- ❌ 无操作提示气泡（Tooltip onboarding）
- ❌ 无帮助文档入口
- ❌ 无 FAQ/常见问题
- ❌ 无空数据引导（如"还没有班级？点击创建第一个班级"）

**影响**：新管理员面对 8 个一级菜单 + 20+ 页面，学习成本高。

**同类产品对比**：校宝在线有"新手引导"弹窗序列；钉钉教育有"帮助中心"入口。

**修复建议**：
1. 首次登录 admin 时展示 3-5 步功能巡览（使用 `driver.js` 或 `react-joyride`）
2. 空状态组件增加"创建第一个 XXX"引导按钮
3. SiteHeader 增加"帮助"图标，链接到帮助文档

---

### U2【待改进】操作反馈不统一

**现状**：
- 创建/编辑操作：部分通过 Dialog 关闭 + `router.refresh()` 反馈，部分跳转列表页
- 删除操作：AlertDialog 确认后无 Toast 提示成功/失败
- 异步操作（如选修课抽签）：仅 `useTransition` 的 pending 状态，无成功/失败 Toast

**影响**：用户不确定操作是否成功，需要手动刷新确认。

**修复建议**：
1. 统一引入 `sonner`（Toast 库，shadcn 推荐）作为操作反馈
2. 所有 CRUD 操作完成后显示 Toast（"创建成功""删除成功""导入成功 N 条"）
3. 失败时显示错误 Toast 并保留表单数据

---

## 七、移动端适配问题

### M1【合格】响应式布局基本到位

**现状**：
- 侧边栏：移动端通过 `Sheet` 抽屉展示，桌面端固定侧栏
- 面包屑：移动端隐藏（`hidden md:flex`）
- 全局搜索：移动端隐藏（`hidden md:block`）
- 表格：部分表格在小屏会横向滚动（但未统一处理）

### M2【待改进】表格在移动端体验差

**现状**：`AdminClassesClient`（10 列）、`ScheduleChangeList`（11 列）、`DataChangeLogTable`（7 列）等宽表格在移动端需要横向滚动，但：
- ❌ 无固定首列（滚动时看不到行标识）
- ❌ 无响应式卡片视图替代（小屏切换为卡片列表）
- ❌ 操作列在滚动后不可见

**修复建议**：
1. 宽表格增加 `sticky left-0` 固定首列
2. 移动端（`< md`）切换为卡片列表视图（每条记录一张卡片）
3. 或使用 `react-data-table` 组件库处理响应式

---

## 八、其他产品体验问题

### O1【待改进】无操作日志导出

**现状**：audit 模块有 `AuditLogExportButton` 组件，但仅 audit 模块支持导出。其他模块（考勤、用户、成绩）均无导出功能。

**修复建议**：在考勤、用户列表、年级洞察等页面增加"导出 Excel"按钮。

---

### O2【待改进】无数据筛选器记忆

**现状**：除使用 `nuqs` 同步 URL 的组件外，其他筛选器（如 `AttendanceFilters`）在页面刷新后丢失状态。

**修复建议**：所有筛选器统一使用 `nuqs` 的 `useQueryState` 同步 URL。

---

### O3【待改进】Dashboard "Recent Users" 无分页无"查看全部"

**现状**：Dashboard 的 Recent Users 表格仅显示少量最近用户，无分页、无"查看全部"链接（因为不存在用户列表页，见 F1）。

**修复建议**：待 F1 用户列表页实现后，增加"查看全部用户 →"链接。

---

### O4【待改进】删除操作无二次确认文案差异化

**现状**：所有删除操作使用相同的 AlertDialog 确认模式，文案通用（"确定删除吗？"），未根据删除对象差异化：
- 删除学校（影响下属年级/班级/学生）
- 删除班级（影响学生/课表/作业）
- 删除用户（影响关联数据）

**修复建议**：高危删除操作（学校、班级、用户）增加影响范围提示（"此操作将影响 N 个年级、N 个班级"）。

---

## 九、与同类产品功能对比总表

| 功能模块 | 校宝在线 | 智学网 | PowerSchool | 本项目 | 差距 |
|---------|---------|--------|-------------|--------|------|
| 用户管理（列表/编辑/停用） | ✅ | ✅ | ✅ | ❌ 仅导入 | **严重** |
| 系统设置 | ✅ | ✅ | ✅ | ❌ | **严重** |
| Dashboard 快捷操作 | ✅ | ✅ | ✅ | ❌ | 待改进 |
| Dashboard 趋势图表 | ✅ | ✅ | ✅ | ❌ | 待改进 |
| 学校/年级/班级管理 | ✅ | ✅ | ✅ | ✅ | 合格 |
| 学年管理 | ✅ | ✅ | ✅ | ✅ | 合格 |
| 部门管理 | ✅ | ✅ | ❌ | ✅ | 优秀（超越 PowerSchool） |
| 课程计划 | ✅ | ✅ | ✅ | ✅ | 合格 |
| 排课（自动+规则+变更） | ✅ | ✅ | ✅ | ✅ | 合格（缺课表网格） |
| 选修管理 | ✅ | ✅ | ✅ | ✅ | 合格（缺实时监控） |
| 考勤管理 | ✅ 全面 | ✅ 全面 | ✅ | ⚠️ 仅查看 | 待改进 |
| 公告管理 | ✅ | ✅ | ✅ | ⚠️ 基础 | 待改进 |
| 审计日志 | ✅ | ✅ | ✅ | ✅ | 优秀（三类日志+导出） |
| 文件管理 | ✅ | ✅ | ✅ | ✅ | 合格（有批量操作） |
| 列表分页 | ✅ 全部 | ✅ 全部 | ✅ 全部 | ⚠️ 仅 audit | **严重** |
| 列表搜索 | ✅ 全部 | ✅ 全部 | ✅ 全部 | ⚠️ 部分 | **严重** |
| 列表排序 | ✅ 全部 | ✅ 全部 | ✅ 全部 | ⚠️ 仅 1 个 | **严重** |
| 批量操作 | ✅ 全部 | ✅ 全部 | ✅ 全部 | ⚠️ 仅 2 个 | 待改进 |
| 数据导出 | ✅ 多模块 | ✅ 多模块 | ✅ 多模块 | ⚠️ 仅 audit | 待改进 |
| 数据可视化 | ✅ 丰富 | ✅ 丰富 | ✅ 基础 | ❌ 无 | 待改进 |
| 新手引导 | ✅ | ✅ | ❌ | ❌ | 待改进 |
| 移动端适配 | ✅ | ✅ | ⚠️ | ⚠️ | 合格 |
| 角色切换 | ✅ | ✅ | ✅ | ❌ | 待改进 |

---

## 十、问题优先级与修复建议

### P0 严重缺陷（影响核心可用性）

| 编号 | 问题 | 影响 | 建议工期 |
|------|------|------|---------|
| F1 | 无用户管理列表页 | 管理员无法管理用户 | 新增 `/admin/users` 页面 |
| F2 | 无系统设置页 | 无法配置系统参数 | 新增 `/admin/settings` 页面 |
| L1 | 大部分列表无分页 | 数据量大时不可用 | 优先修复考勤/文件/班级列表 |
| N1 | 两个页面无侧边栏入口 | 用户无法发现功能 | 补充 NAV_CONFIG |

### P1 重要缺陷（影响使用体验）

| 编号 | 问题 | 影响 | 建议工期 |
|------|------|------|---------|
| L2 | 大部分列表无搜索 | 无法定位记录 | 逐步为各列表增加搜索 |
| L3 | 仅 1 个列表支持排序 | 无法按需排列 | 表头增加排序功能 |
| F3 | Dashboard 无快捷操作/图表 | 入口深、无趋势 | 增加快捷入口+图表 |
| F4 | 考勤功能薄弱 | 仅查看无统计 | 增加统计/导出/预警 |
| F5 | 排课无课表网格 | 无法可视化课表 | 新增 ScheduleGrid |
| N2 | 子菜单混入跨域功能 | 信息架构混乱 | 重组菜单分组 |
| N3 | 无角色切换 | 多角色用户被困 | 增加角色切换 |

### P2 一般改进（提升体验）

| 编号 | 问题 | 影响 |
|------|------|------|
| L4 | 批量操作极少 | 效率低 |
| V1 | 无数据可视化 | 数据不直观 |
| F6 | 公告缺已读统计/定时发布 | 功能不完整 |
| F7 | 选修缺实时监控 | 运营困难 |
| U1 | 无新手引导 | 学习成本高 |
| U2 | 操作反馈不统一 | 不确定操作结果 |
| M2 | 表格移动端体验差 | 小屏不可用 |
| O1 | 无数据导出（非 audit） | 无法离线分析 |
| N4 | 面包屑回退效果差 | 导航不清晰 |
| O4 | 删除无影响范围提示 | 误删风险 |

---

## 十一、优秀实践（应保持）

1. **审计日志模块**：三类日志（操作/登录/数据变更）+ 导出 + 行展开查看 JSON 差异，是全项目最完善的模块，超越 PowerSchool
2. **文件管理批量操作**：多选 + 批量删除 + indeterminate 状态，交互完整
3. **年级管理搜索/排序**：`GradesClient` 提供 7 种排序 + 关键词搜索 + URL 状态同步，是列表交互的标杆
4. **选修课操作按钮**：`ElectiveCourseList` 根据课程状态动态显示 Open/Close/Lottery/Delete 按钮，状态机清晰
5. **权限控制**：`usePermission().hasPermission()` 在组件层控制管理按钮显隐，符合项目规范
6. **空状态处理**：大部分列表组件都有 `EmptyState` 兜底
7. **部门管理**：PowerSchool 未提供，本项目提供了部门管理，是功能优势
8. **无障碍**：Dashboard 布局有"跳到主内容"链接、`sr-only` 支持

---

## 十二、总结

### 核心差距

本项目 admin 模块在**架构规范、权限安全、代码质量**方面已达到企业级标准（v1-v3 修复后），但在**产品功能完整性、列表交互能力、数据可视化**方面与成熟 K12 教务产品（校宝在线、智学网）存在明显差距：

1. **功能缺失**：无用户管理列表、无系统设置、考勤仅查看
2. **交互薄弱**：80% 的列表无分页、70% 无搜索、90% 无排序
3. **可视化空白**：全模块无任何图表
4. **引导缺失**：无新手引导、无帮助文档

### 建议路线图

**第一阶段（核心功能补全）**：
- 新增用户管理列表页（F1）
- 新增系统设置页（F2）
- 补充侧边栏缺失入口（N1）
- 为考勤/文件/班级列表增加分页（L1）

**第二阶段（交互能力提升）**：
- 为所有列表增加搜索（L2）
- 为所有列表增加排序（L3）
- 增加批量操作（L4）
- 统一操作反馈 Toast（U2）

**第三阶段（体验优化）**：
- Dashboard 增加快捷操作+图表（F3、V1）
- 排课增加课表网格（F5）
- 考勤增加统计/导出（F4）
- 新手引导（U1）

**第四阶段（功能完善）**：
- 公告已读统计/定时发布（F6）
- 选修实时监控（F7）
- 角色切换（N3）
- 菜单重组（N2）

---

> v4 报告生成完毕。本报告聚焦产品体验与功能完整性，与 v1-v3 的代码规范审查互补。建议优先处理 P0 级别的功能缺失与分页问题。