# `src/app/(dashboard)/teacher` 前端规范核查报告 v2

> 核查日期：2026-06-18（第二轮）
> 核查范围：`src/app/(dashboard)/teacher/` 目录下所有前端文件（page.tsx / loading.tsx）
> 依据文档：项目规则、编码规范 `docs/standards/coding-standards.md`、架构影响地图 004、架构数据 005
> 应用技能：`vercel-react-best-practices`（性能优化）、`web-artifacts-builder`（界面优化）、`web-design-guidelines`（Web 界面规范审查）
> 对比基准：[v1 报告](./teacher_bug.md)

---

## 一、v1 → v2 修复状态总览

### 1.1 修复进度统计

| 状态 | 数量 | 占比 |
|------|------|------|
| 已修复 | 3 | 4.7% |
| 部分修复 | 1 | 1.6% |
| 未修复 | 60 | 93.7% |
| **合计** | **64** | **100%** |

### 1.2 已修复问题清单

| v1 BUG ID | 问题摘要 | 修复方式 |
|-----------|----------|----------|
| T29 | schedule-changes/page.tsx 通过 actions 调用 | 改为从 `@/modules/scheduling/data-access` 导入 `getAdminClassesForScheduling` / `getTeachersForScheduling` / `getScheduleChanges` |
| T57 | exams/all/page.tsx 缺少 `export const dynamic` | 当前仍缺少，但使用 Suspense 模式可接受（**部分修复**，见下方说明） |
| 新增 | lesson-plans 模块新增 | 新增 3 个页面，需审查 |

### 1.3 新增文件清单

| 文件 | 行数 | 类型 | 用途 |
|------|------|------|------|
| [lesson-plans/page.tsx](../src/app/(dashboard)/teacher/lesson-plans/page.tsx) | 32 | 页面 | 课案列表 |
| [lesson-plans/new/page.tsx](../src/app/(dashboard)/teacher/lesson-plans/new/page.tsx) | 10 | 页面 | 新建课案 |
| [lesson-plans/[planId]/edit/page.tsx](../src/app/(dashboard)/teacher/lesson-plans/[planId]/edit/page.tsx) | 36 | 页面 | 编辑课案 |

---

## 二、未修复问题清单（按严重度排序）

### 2.1 架构分层违规 — 严重度：高（P0）

#### BUG-V2-T01：app 层直接访问数据库（dashboard/page.tsx）❌ 未修复
- **位置**：[dashboard/page.tsx:4-6, 18-21](../src/app/(dashboard)/teacher/dashboard/page.tsx)
- **问题**：页面直接 `import { db } from "@/shared/db"` 并调用 `db.query.users.findFirst()`，违反项目规则「`app/` 只能调用 `modules/` 的 Server Actions 和 data-access，不直接访问 DB」
- **现状**：
  ```typescript
  import { db } from "@/shared/db"
  import { users } from "@/shared/db/schema"
  // ...
  db.query.users.findFirst({
    where: eq(users.id, teacherId),
    columns: { name: true },
  })
  ```
- **改进建议**：`modules/users/data-access.ts` 已有 `getUserBasicInfo(userId)` 函数（返回 name/email/image/gradeId），可直接复用：
  ```typescript
  import { getUserBasicInfo } from "@/modules/users/data-access"
  const teacherProfile = await getUserBasicInfo(teacherId)
  // teacherProfile?.name
  ```

#### BUG-V2-T02：app 层直接访问数据库（grades/page.tsx）❌ 未修复
- **位置**：[grades/page.tsx:5-7, 35](../src/app/(dashboard)/teacher/grades/page.tsx)
- **问题**：直接 `db.query.subjects.findMany()` 查询科目列表
- **改进建议**：`modules/school/data-access.ts` 已有 `getSubjectOptions()` 函数（返回 id/name/code/order），可直接复用：
  ```typescript
  import { getSubjectOptions } from "@/modules/school/data-access"
  const allSubjects = await getSubjectOptions()
  ```

#### BUG-V2-T03：app 层直接访问数据库（grades/analytics/page.tsx）❌ 未修复
- **位置**：[grades/analytics/page.tsx:5-6, 48-50](../src/app/(dashboard)/teacher/grades/analytics/page.tsx)
- **问题**：同 V2-T02
- **改进建议**：同 V2-T02

#### BUG-V2-T04：app 层直接访问数据库（grades/entry/page.tsx）❌ 未修复
- **位置**：[grades/entry/page.tsx:1-3, 25](../src/app/(dashboard)/teacher/grades/entry/page.tsx)
- **问题**：同 V2-T02
- **改进建议**：同 V2-T02

#### BUG-V2-T05：app 层直接访问数据库（grades/stats/page.tsx）❌ 未修复
- **位置**：[grades/stats/page.tsx:1-3, 28](../src/app/(dashboard)/teacher/grades/stats/page.tsx)
- **问题**：同 V2-T02
- **改进建议**：同 V2-T02

#### BUG-V2-T06：认证上下文获取方式不一致 ❌ 未修复
- **位置**：
  - [course-plans/page.tsx:1, 23](../src/app/(dashboard)/teacher/course-plans/page.tsx)
  - [elective/page.tsx:1, 23](../src/app/(dashboard)/teacher/elective/page.tsx)
- **问题**：使用 `import { auth } from "@/auth"` + `auth()` 获取 session，而其他页面统一使用 `getAuthContext()`（含 DataScope 解析）
- **影响**：无法获得 `dataScope`，无法做数据范围过滤；与项目其他页面不一致
- **改进建议**：统一改为 `const ctx = await getAuthContext(); const teacherId = ctx.userId`

---

### 2.2 Prettier 配置违规 — 严重度：中（P2）

#### BUG-V2-T07：textbooks/page.tsx 使用分号 ❌ 未修复
- **位置**：[textbooks/page.tsx:3, 73](../src/app/(dashboard)/teacher/textbooks/page.tsx)
- **问题**：`import { TextbookCard } from "...";` 等多处使用分号
- **改进建议**：运行 `npx prettier --write` 统一格式

#### BUG-V2-T08：textbooks/[id]/page.tsx 使用分号 ❌ 未修复
- **位置**：[textbooks/[id]/page.tsx](../src/app/(dashboard)/teacher/textbooks/[id]/page.tsx)（全文）
- **问题**：多处语句使用分号结尾
- **改进建议**：同 V2-T07

#### BUG-V2-T09：textbooks/loading.tsx 使用分号 ❌ 未修复
- **位置**：[textbooks/loading.tsx](../src/app/(dashboard)/teacher/textbooks/loading.tsx)（全文）
- **问题**：同 V2-T07
- **改进建议**：同 V2-T07

#### BUG-V2-T10：textbooks/[id]/loading.tsx 使用分号 ❌ 未修复
- **位置**：[textbooks/[id]/loading.tsx](../src/app/(dashboard)/teacher/textbooks/[id]/loading.tsx)（全文）
- **问题**：同 V2-T07
- **改进建议**：同 V2-T07

#### BUG-V2-T10a：lesson-plans 系列文件使用分号 🆕 新增
- **位置**：
  - [lesson-plans/page.tsx](../src/app/(dashboard)/teacher/lesson-plans/page.tsx)（全文）
  - [lesson-plans/new/page.tsx](../src/app/(dashboard)/teacher/lesson-plans/new/page.tsx)（全文）
  - [lesson-plans/[planId]/edit/page.tsx](../src/app/(dashboard)/teacher/lesson-plans/[planId]/edit/page.tsx)（全文）
- **问题**：新增文件均使用分号结尾，违反 `.prettierrc` 的 `"semi": false`
- **改进建议**：同 V2-T07

---

### 2.3 TypeScript 规范违规 — 严重度：高（P1）

#### BUG-V2-T11：使用 `as` 类型断言（exams/[id]/build/page.tsx）❌ 未修复
- **位置**：[exams/[id]/build/page.tsx:32-34](../src/app/(dashboard)/teacher/exams/[id]/build/page.tsx)
- **问题**：使用 `as` 断言转换类型，违反编码规范「禁止 `as` 断言（除非从 `unknown` 转换）」
- **现状**：
  ```typescript
  content: q.content as Question["content"],
  type: q.type as Question["type"],
  ```
- **改进建议**：在 data-access 层返回正确类型，或使用类型守卫函数

#### BUG-V2-T12：使用 `as` 类型断言（attendance/page.tsx）❌ 未修复
- **位置**：[attendance/page.tsx:39](../src/app/(dashboard)/teacher/attendance/page.tsx)
- **问题**：`status as "present" | "absent" | "late" | "early_leave" | "excused"` 直接断言
- **改进建议**：使用类型守卫函数 `isAttendanceStatus(value): value is AttendanceStatus`

#### BUG-V2-T13：使用 `as` 类型断言（grades/page.tsx）❌ 未修复
- **位置**：[grades/page.tsx:43-44](../src/app/(dashboard)/teacher/grades/page.tsx)
- **问题**：`type as "exam" | "quiz" | "homework" | "other"` 和 `semester as "1" | "2"` 直接断言
- **改进建议**：使用类型守卫

#### BUG-V2-T14：使用 `as` 类型断言（grades/analytics/page.tsx）❌ 未修复
- **位置**：[grades/analytics/page.tsx](../src/app/(dashboard)/teacher/grades/analytics/page.tsx)（多处）
- **问题**：同上模式
- **改进建议**：同上

#### BUG-V2-T15：使用 `as` 类型断言（diagnostic/page.tsx）❌ 未修复
- **位置**：[diagnostic/page.tsx:27-28](../src/app/(dashboard)/teacher/diagnostic/page.tsx)
- **问题**：`reportType as DiagnosticReportType` 和 `status as DiagnosticReportStatus`
- **改进建议**：使用类型守卫

#### BUG-V2-T16：函数返回值未显式标注（getParam 工具函数）❌ 未修复
- **位置**：以下 16 个文件中的 `getParam` 函数均未标注返回类型
  - attendance/page.tsx:15
  - attendance/sheet/page.tsx:9
  - attendance/stats/page.tsx:12
  - classes/schedule/page.tsx:14
  - classes/students/page.tsx:14
  - course-plans/page.tsx:10
  - diagnostic/page.tsx:10
  - elective/page.tsx:10
  - exams/all/page.tsx:16
  - grades/page.tsx:19
  - grades/analytics/page.tsx:28
  - grades/entry/page.tsx:12
  - grades/stats/page.tsx:15
  - homework/assignments/page.tsx:23
  - questions/page.tsx:15
  - textbooks/page.tsx:13
- **问题**：违反编码规范「函数返回值必须显式标注，特别是 `Promise<T>`」
- **改进建议**：`const getParam = (params: SearchParams, key: string): string | undefined => { ... }`

#### BUG-V2-T17：页面默认导出函数未标注返回类型 ❌ 未修复
- **位置**：所有 page.tsx 文件的 `export default async function XxxPage()`
- **问题**：未标注 `Promise<JSX.Element>` 或 `Promise<React.ReactNode>`
- **规范依据**：编码规范 5.2 示例 `export default async function UsersPage(): Promise<JSX.Element>`
- **改进建议**：统一补充返回类型标注

---

### 2.4 DRY 违规（重复代码） — 严重度：中（P2）

#### BUG-V2-T18：`getParam` 工具函数在 16 个文件中重复定义 ❌ 未修复
- **位置**：见 V2-T16 列表
- **问题**：完全相同的工具函数 `getParam` 和类型 `SearchParams` 在 16 个页面文件中复制粘贴
- **改进建议**：提取到 `shared/lib/search-params.ts`：
  ```typescript
  export type SearchParams = { [key: string]: string | string[] | undefined }
  export function getParam(params: SearchParams, key: string): string | undefined {
    const v = params[key]
    return Array.isArray(v) ? v[0] : v
  }
  ```

#### BUG-V2-T19：`StatsClassSelector` 模式重复 ❌ 未修复
- **位置**：
  - [attendance/stats/page.tsx:91-119](../src/app/(dashboard)/teacher/attendance/stats/page.tsx)
  - [grades/stats/page.tsx:86-138](../src/app/(dashboard)/teacher/grades/stats/page.tsx)
  - [grades/analytics/page.tsx:150-258](../src/app/(dashboard)/teacher/grades/analytics/page.tsx)
- **问题**：三处文件都定义了「类筛选按钮组」组件，结构几乎相同（`<a>` 标签 + 条件 className）
- **改进建议**：提取为共享组件 `shared/components/ui/filter-chips.tsx`

---

### 2.5 性能问题（vercel-react-best-practices） — 严重度：高（P1）

#### BUG-V2-T20：串行数据获取 waterfall（attendance/page.tsx）❌ 未修复
- **位置**：[attendance/page.tsx:32-41](../src/app/(dashboard)/teacher/attendance/page.tsx)
- **问题**：`getTeacherClasses()` 与 `getAttendanceRecords()` 串行执行，但二者无依赖关系
- **违反规则**：`async-parallel` - 独立操作应使用 `Promise.all()`
- **改进建议**：
  ```typescript
  const [classes, result] = await Promise.all([
    getTeacherClasses(),
    getAttendanceRecords({ ... }),
  ])
  ```

#### BUG-V2-T21：串行数据获取 waterfall（attendance/sheet/page.tsx）❌ 未修复
- **位置**：[attendance/sheet/page.tsx:24-29](../src/app/(dashboard)/teacher/attendance/sheet/page.tsx)
- **问题**：`getTeacherClasses()` 与 `getClassStudentsForAttendance()` 串行，但 students 依赖 defaultClassId（来自 searchParams），可与 classes 并行
- **改进建议**：使用 `Promise.all` 并行

#### BUG-V2-T22：串行数据获取 waterfall（attendance/stats/page.tsx）❌ 未修复
- **位置**：[attendance/stats/page.tsx:28-53](../src/app/(dashboard)/teacher/attendance/stats/page.tsx)
- **问题**：`getTeacherClasses()` → `getClassAttendanceStats()` 串行
- **改进建议**：先并行获取 classes，再取 targetClassId 后获取 stats（当前逻辑合理但可考虑预取）

#### BUG-V2-T23：串行数据获取 waterfall（grades/page.tsx）❌ 未修复
- **位置**：[grades/page.tsx:33-45](../src/app/(dashboard)/teacher/grades/page.tsx)
- **问题**：`Promise.all([getTeacherClasses, db.query])` 之后串行 `getGradeRecords`，但 `getGradeRecords` 不依赖前两者结果
- **改进建议**：三个查询全部 `Promise.all`

#### BUG-V2-T24：串行数据获取 waterfall（grades/entry/page.tsx）❌ 未修复
- **位置**：[grades/entry/page.tsx:23-34](../src/app/(dashboard)/teacher/grades/entry/page.tsx)
- **问题**：`Promise.all([getTeacherClasses, db.query])` 后串行 `getClassStudentsForEntry`，但 students 依赖 defaultClassId（来自 searchParams），可并行
- **改进建议**：`Promise.all` 三个查询

#### BUG-V2-T25：串行数据获取 waterfall（grades/stats/page.tsx）❌ 未修复
- **位置**：[grades/stats/page.tsx:26-54](../src/app/(dashboard)/teacher/grades/stats/page.tsx)
- **问题**：`Promise.all([getTeacherClasses, db.query])` → `Promise.all([stats, ranking])` 两段串行
- **改进建议**：合并为单个 `Promise.all`

#### BUG-V2-T26：串行数据获取 waterfall（classes/my/[id]/page.tsx）❌ 未修复
- **位置**：[classes/my/[id]/page.tsx:21-30](../src/app/(dashboard)/teacher/classes/my/[id]/page.tsx)
- **问题**：`Promise.all([insights, students, schedule])` 后串行 `getClassStudentSubjectScoresV2`
- **改进建议**：将 `getClassStudentSubjectScoresV2` 加入第一个 `Promise.all`

#### BUG-V2-T27：串行数据获取 waterfall（diagnostic/student/[studentId]/page.tsx）❌ 未修复
- **位置**：[diagnostic/student/[studentId]/page.tsx:30-45](../src/app/(dashboard)/teacher/diagnostic/student/[studentId]/page.tsx)
- **问题**：`Promise.all([summary, reports])` 后串行 `getKnowledgePointStats()`
- **改进建议**：合并为单个 `Promise.all`

#### BUG-V2-T28：串行数据获取 waterfall（exams/[id]/build/page.tsx）❌ 未修复
- **位置**：[exams/[id]/build/page.tsx:12-26](../src/app/(dashboard)/teacher/exams/[id]/build/page.tsx)
- **问题**：`getExamById` → `getQuestions` → `getQuestions(ids)` 三段串行
- **改进建议**：前两个可并行；第三个依赖 exam.questions 的 ID 列表，需串行但可优化

#### BUG-V2-T29：Bundle 优化 - barrel imports（lucide-react）❌ 未修复
- **位置**：几乎所有页面文件
- **问题**：`import { PlusCircle, BarChart3, ClipboardList } from "lucide-react"` 使用 barrel 文件导入，违反 `bundle-barrel-imports` 规则
- **改进建议**：lucide-react 已支持 tree-shaking，但可考虑使用 `lucide-react/icons` 直接导入路径

#### BUG-V2-T30：缺少 `export const dynamic = "force-dynamic"` 声明 ❌ 未修复
- **位置**：
  - [exams/all/page.tsx](../src/app/(dashboard)/teacher/exams/all/page.tsx)（使用 Suspense，可省略）
  - [exams/create/page.tsx](../src/app/(dashboard)/teacher/exams/create/page.tsx)
  - [exams/[id]/build/page.tsx](../src/app/(dashboard)/teacher/exams/[id]/build/page.tsx)
  - [questions/page.tsx](../src/app/(dashboard)/teacher/questions/page.tsx)（使用 Suspense）
  - [textbooks/page.tsx](../src/app/(dashboard)/teacher/textbooks/page.tsx)（使用 Suspense）
  - [lesson-plans/page.tsx](../src/app/(dashboard)/teacher/lesson-plans/page.tsx) 🆕
  - [lesson-plans/new/page.tsx](../src/app/(dashboard)/teacher/lesson-plans/new/page.tsx) 🆕
  - [lesson-plans/[planId]/edit/page.tsx](../src/app/(dashboard)/teacher/lesson-plans/[planId]/edit/page.tsx) 🆕
- **问题**：动态数据页面未声明 `force-dynamic`，可能导致静态生成尝试失败
- **改进建议**：所有含动态数据的页面统一添加 `export const dynamic = "force-dynamic"`

---

### 2.6 Web 界面规范违规（web-design-guidelines） — 严重度：中（P2）

#### BUG-V2-T31：`<a>` 标签缺少 focus-visible 焦点样式 ❌ 未修复
- **位置**：
  - [attendance/stats/page.tsx:106-117](../src/app/(dashboard)/teacher/attendance/stats/page.tsx)
  - [grades/analytics/page.tsx:192-253](../src/app/(dashboard)/teacher/grades/analytics/page.tsx)
  - [grades/stats/page.tsx:100-135](../src/app/(dashboard)/teacher/grades/stats/page.tsx)
- **问题**：筛选按钮使用 `<a>` 标签但仅有 `hover:bg-accent`，缺少 `focus-visible:ring-*` 或 `focus-visible:outline` 焦点样式
- **违反规则**：Focus States - Interactive elements need visible focus
- **改进建议**：添加 `focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2`

#### BUG-V2-T32：`<a>` 标签作为筛选按钮语义不当 ❌ 未修复
- **位置**：同 V2-T31
- **问题**：筛选操作使用 `<a>` 标签导航到带 query 的 URL，虽然支持 Cmd/Ctrl+click，但视觉上是按钮形态，应使用 `<button>` 或添加 `role="button"`
- **违反规则**：`<button>` for actions, `<a>`/`<Link>` for navigation
- **改进建议**：使用 Next.js `<Link>` 并补充焦点样式，或改为 `<button>` + `useRouter` + `useSearchParams`

#### BUG-V2-T33：标题层级缺失（exams/[id]/build/page.tsx）❌ 未修复
- **位置**：[exams/[id]/build/page.tsx:104-118](../src/app/(dashboard)/teacher/exams/[id]/build/page.tsx)
- **问题**：页面无 `<h1>` 标题，直接渲染 `<ExamAssembly>` 组件
- **改进建议**：在页面顶部添加 `<h1>` 标题（如「Build Exam」）

#### BUG-V2-T34：标题层级缺失（exams/[id]/proctoring/page.tsx）❌ 未修复
- **位置**：[exams/[id]/proctoring/page.tsx:50-54](../src/app/(dashboard)/teacher/exams/[id]/proctoring/page.tsx)
- **问题**：同 V2-T33，无 `<h1>`
- **改进建议**：同 V2-T33

#### BUG-V2-T35：标题层级缺失（classes/my/[id]/page.tsx）❌ 未修复
- **位置**：[classes/my/[id]/page.tsx:65-108](../src/app/(dashboard)/teacher/classes/my/[id]/page.tsx)
- **问题**：页面无 `<h1>`，依赖 `<ClassHeader>` 组件渲染标题，需确认组件内是否有 h1
- **改进建议**：确认 `ClassHeader` 包含 `<h1>`

#### BUG-V2-T36：长文本未截断（homework/assignments/page.tsx）❌ 未修复
- **位置**：[homework/assignments/page.tsx:99-101](../src/app/(dashboard)/teacher/homework/assignments/page.tsx)
- **问题**：作业标题 `<Link>{a.title}</Link>` 未限制长度，长标题会破坏表格布局
- **违反规则**：Content Handling - Text containers handle long content
- **改进建议**：添加 `line-clamp-2` 或 `truncate max-w-[200px]`

#### BUG-V2-T37：长文本未截断（homework/submissions/page.tsx）❌ 未修复
- **位置**：[homework/submissions/page.tsx:58-60](../src/app/(dashboard)/teacher/homework/submissions/page.tsx)
- **问题**：同 V2-T36
- **改进建议**：同 V2-T36

#### BUG-V2-T38：长文本未截断（homework/assignments/[id]/submissions/page.tsx）❌ 未修复
- **位置**：[homework/assignments/[id]/submissions/page.tsx:65](../src/app/(dashboard)/teacher/homework/assignments/[id]/submissions/page.tsx)
- **问题**：学生姓名单元格未限制长度
- **改进建议**：添加 `truncate max-w-[160px]`

#### BUG-V2-T39：Flex 子元素缺少 `min-w-0` ❌ 未修复
- **位置**：
  - [homework/assignments/[id]/page.tsx:26-42](../src/app/(dashboard)/teacher/homework/assignments/[id]/page.tsx)
  - [classes/my/[id]/page.tsx:86-104](../src/app/(dashboard)/teacher/classes/my/[id]/page.tsx)
- **问题**：flex 容器内的文本子元素未设置 `min-w-0`，长内容无法正确截断
- **违反规则**：Flex children need `min-w-0` to allow text truncation
- **改进建议**：在 flex 子元素添加 `min-w-0`

#### BUG-V2-T41：硬编码日期/数字格式 ❌ 未修复
- **位置**：所有使用 `formatDate` 的文件
- **问题**：需确认 `formatDate` 内部是否使用 `Intl.DateTimeFormat`
- **改进建议**：检查 `shared/lib/utils.ts` 的 `formatDate` 实现

#### BUG-V2-T42：数字列未使用 `tabular-nums` ❌ 未修复
- **位置**：
  - [exams/all/page.tsx:54-60](../src/app/(dashboard)/teacher/exams/all/page.tsx) - 考试计数
  - [homework/submissions/page.tsx:69-71](../src/app/(dashboard)/teacher/homework/submissions/page.tsx) - 计数列
  - [homework/assignments/[id]/submissions/page.tsx:73](../src/app/(dashboard)/teacher/homework/assignments/[id]/submissions/page.tsx) - 分数
- **问题**：数字列未使用 `font-variant-numeric: tabular-nums`
- **改进建议**：数字单元格添加 `tabular-nums` 类

#### BUG-V2-T43：大列表未虚拟化 ❌ 未修复
- **位置**：
  - [questions/page.tsx:42](../src/app/(dashboard)/teacher/questions/page.tsx) - `pageSize: 200`
  - [exams/all/page.tsx](../src/app/(dashboard)/teacher/exams/all/page.tsx) - ExamDataTable
- **问题**：题库页面一次加载 200 条题目，若渲染全部 DOM 节点会卡顿
- **违反规则**：Performance - Large lists (>50 items): virtualize
- **改进建议**：使用 `virtua` 或 `content-visibility: auto` 虚拟化长列表

---

### 2.7 组件规范违规 — 严重度：中（P2）

#### BUG-V2-T44：不必要的包装组件（classes/my/page.tsx）❌ 未修复
- **位置**：[classes/my/page.tsx:6-17](../src/app/(dashboard)/teacher/classes/my/page.tsx)
- **问题**：默认导出 `MyClassesPage` 仅调用 `MyClassesPageImpl`，多此一举
- **改进建议**：直接默认导出 async 函数

#### BUG-V2-T45：非导出组件定义在 page.tsx 中 ❌ 未修复
- **位置**：
  - [attendance/stats/page.tsx:91-119](../src/app/(dashboard)/teacher/attendance/stats/page.tsx) - `StatsClassSelector`
  - [grades/analytics/page.tsx:150-258](../src/app/(dashboard)/teacher/grades/analytics/page.tsx) - `AnalyticsFilters`
  - [grades/stats/page.tsx:86-138](../src/app/(dashboard)/teacher/grades/stats/page.tsx) - `StatsClassSelector`
  - [classes/schedule/page.tsx:45-63](../src/app/(dashboard)/teacher/classes/schedule/page.tsx) - `ScheduleResultsFallback`
  - [classes/students/page.tsx:68-81](../src/app/(dashboard)/teacher/classes/students/page.tsx) - `StudentsResultsFallback`
  - [exams/all/page.tsx:101-128](../src/app/(dashboard)/teacher/exams/all/page.tsx) - `ExamsResultsFallback`
  - [questions/page.tsx:75-88](../src/app/(dashboard)/teacher/questions/page.tsx) - `QuestionBankResultsFallback`
- **问题**：辅助组件定义在 page.tsx 中，违反「其余所有组件使用具名导出」规范，且无法复用
- **改进建议**：提取到 `components/` 目录或 `shared/components/ui/`

#### BUG-V2-T46：exams/create/page.tsx 顶部多余空行 ❌ 未修复
- **位置**：[exams/create/page.tsx:5](../src/app/(dashboard)/teacher/exams/create/page.tsx)
- **问题**：JSX 开始标签前有多余空行
- **改进建议**：删除空行

---

### 2.8 安全与权限违规 — 严重度：高（P0）

#### BUG-V2-T47：缺少权限校验（course-plans/page.tsx）❌ 未修复
- **位置**：[course-plans/page.tsx](../src/app/(dashboard)/teacher/course-plans/page.tsx)
- **问题**：仅通过 `auth()` 获取 session，未调用 `requirePermission()` 或 `getAuthContext()` 进行权限校验
- **改进建议**：使用 `getAuthContext()` 替代 `auth()`，并在 data-access 层做 DataScope 过滤

#### BUG-V2-T48：缺少权限校验（elective/page.tsx）❌ 未修复
- **位置**：[elective/page.tsx](../src/app/(dashboard)/teacher/elective/page.tsx)
- **问题**：同 V2-T47
- **改进建议**：同 V2-T47

#### BUG-V2-T49：缺少权限校验（dashboard/page.tsx）❌ 未修复
- **位置**：[dashboard/page.tsx](../src/app/(dashboard)/teacher/dashboard/page.tsx)
- **问题**：依赖路由层代理（proxy.ts）做角色路由，但页面本身未做二次权限校验
- **改进建议**：添加 `getAuthContext()` 确认教师身份

#### BUG-V2-T50：权限校验方式不一致 ❌ 未修复
- **位置**：
  - [exams/[id]/proctoring/page.tsx:21](../src/app/(dashboard)/teacher/exams/[id]/proctoring/page.tsx) - 使用 `requirePermission(Permissions.EXAM_PROCTOR)`
  - [diagnostic/class/[classId]/page.tsx:15-23](../src/app/(dashboard)/teacher/diagnostic/class/[classId]/page.tsx) - 使用 `getAuthContext()` + DataScope 校验
  - [grades/page.tsx:26](../src/app/(dashboard)/teacher/grades/page.tsx) - 使用 `getAuthContext()`
- **问题**：权限校验方式不统一
- **改进建议**：统一权限校验策略，页面入口用 `getAuthContext()`，写操作用 `requirePermission()`

#### BUG-V2-T50a：lesson-plans/page.tsx 通过 actions 调用读取操作 🆕 新增
- **位置**：[lesson-plans/page.tsx:1-2](../src/app/(dashboard)/teacher/lesson-plans/page.tsx)
- **问题**：页面读取数据使用 `getLessonPlansAction` 和 `getSubjectsAction`（Server Actions），而非 data-access 函数。Server Actions 应用于写操作（含权限校验 + revalidate），读取操作应直接用 data-access
- **现状**：
  ```typescript
  import { getLessonPlansAction } from "@/modules/lesson-preparation/actions";
  import { getSubjectsAction } from "@/modules/exams/actions";
  ```
- **改进建议**：改为从 data-access 导入：
  ```typescript
  import { getLessonPlans } from "@/modules/lesson-preparation/data-access";
  import { getSubjectOptions } from "@/modules/school/data-access";
  ```

#### BUG-V2-T50b：lesson-plans/[planId]/edit/page.tsx 通过 actions 调用读取操作 🆕 新增
- **位置**：[lesson-plans/[planId]/edit/page.tsx:2](../src/app/(dashboard)/teacher/lesson-plans/[planId]/edit/page.tsx)
- **问题**：同 V2-T50a，使用 `getLessonPlanByIdAction` 读取单条数据
- **改进建议**：改为从 data-access 导入 `getLessonPlanById`

---

### 2.9 加载态缺失 — 严重度：低（P3）

#### BUG-V2-T51：缺少 loading.tsx 的目录 ❌ 未修复
- **位置**：
  - `attendance/`（含 sheet/、stats/）
  - `course-plans/`（含 [id]/）
  - `diagnostic/`（含 class/、student/）
  - `elective/`
  - `exams/[id]/`（含 build/、proctoring/）
  - `grades/`（含 analytics/、entry/、stats/）
  - `homework/`（含 assignments/、submissions/）
  - `schedule-changes/`
  - `lesson-plans/`（含 new/、[planId]/edit/）🆕
- **问题**：以上目录无 `loading.tsx`，导航时无骨架屏反馈
- **改进建议**：为每个动态页面目录添加 `loading.tsx`

#### BUG-V2-T52：exams/grading/loading.tsx 实际无用 ❌ 未修复
- **位置**：[exams/grading/loading.tsx](../src/app/(dashboard)/teacher/exams/grading/loading.tsx)
- **问题**：`exams/grading/page.tsx` 仅做 `redirect()`，loading.tsx 永远不会显示
- **改进建议**：删除该 loading.tsx

---

### 2.10 逻辑与代码质量问题 — 严重度：中（P2）

#### BUG-V2-T53：homework/assignments/page.tsx 条件取数逻辑反直觉 ❌ 未修复
- **位置**：[homework/assignments/page.tsx:33-36](../src/app/(dashboard)/teacher/homework/assignments/page.tsx)
- **问题**：`classId && classId !== "all" ? getTeacherClasses() : Promise.resolve([])` 仅在有 classId 时才获取班级列表，逻辑反直觉
- **改进建议**：始终获取 classes，或添加注释说明

#### BUG-V2-T54：exams/[id]/build/page.tsx `normalizeStructure` 函数过长 ❌ 未修复
- **位置**：[exams/[id]/build/page.tsx:52-91](../src/app/(dashboard)/teacher/exams/[id]/build/page.tsx)
- **问题**：40 行的 `normalizeStructure` 函数定义在组件内部，包含嵌套递归逻辑
- **改进建议**：提取到 `modules/exams/utils/normalize-structure.ts`，并添加单元测试

#### BUG-V2-T55：exams/[id]/build/page.tsx 使用 `satisfies` 但混合 `as` ❌ 未修复
- **位置**：[exams/[id]/build/page.tsx:74, 84, 86](../src/app/(dashboard)/teacher/exams/[id]/build/page.tsx)
- **问题**：同时使用 `satisfies ExamNode`（好）和 `as ExamNode[]`（违规），类型处理不一致
- **改进建议**：移除 `as ExamNode[]`，改用类型守卫或 `Array.from()` 配合 filter

#### BUG-V2-T56：grades/analytics/page.tsx 文件过长 ❌ 未修复
- **位置**：[grades/analytics/page.tsx](../src/app/(dashboard)/teacher/grades/analytics/page.tsx) - 259 行
- **问题**：单文件 259 行，包含页面 + `AnalyticsFilters` 组件
- **改进建议**：将 `AnalyticsFilters` 提取到 `modules/grades/components/analytics-filters.tsx`

#### BUG-V2-T57：exams/all/page.tsx 缺少 `export const dynamic` ⚠️ 部分修复
- **位置**：[exams/all/page.tsx](../src/app/(dashboard)/teacher/exams/all/page.tsx)
- **问题**：使用 Suspense 但未声明 `force-dynamic`
- **说明**：Next.js 16 中使用 Suspense 边界的动态页面可省略 `force-dynamic`，但为一致性建议添加
- **改进建议**：添加 `export const dynamic = "force-dynamic"` 以保持一致性

---

### 2.11 可访问性问题 — 严重度：中（P2）

#### BUG-V2-T58：图标按钮缺少 aria-label ❌ 未修复
- **位置**：
  - [textbooks/[id]/page.tsx:33-36](../src/app/(dashboard)/teacher/textbooks/[id]/page.tsx) - 返回按钮
- **问题**：`textbooks/[id]/page.tsx` 的返回按钮仅含图标，无 `aria-label`
- **违反规则**：Accessibility - Icon-only buttons need `aria-label`
- **改进建议**：添加 `aria-label="Back to textbooks"`

#### BUG-V2-T59：装饰性图标未标记 aria-hidden ❌ 未修复
- **位置**：几乎所有页面中的 lucide 图标
- **问题**：如 `<BarChart3 className="mr-2 h-4 w-4" />` 等装饰性图标未添加 `aria-hidden="true"`
- **违反规则**：Accessibility - Decorative icons need `aria-hidden="true"`
- **改进建议**：装饰性图标添加 `aria-hidden="true"`

#### BUG-V2-T60：缺少 skip link ❌ 未修复
- **位置**：所有页面
- **问题**：页面无「跳到主内容」的 skip link
- **违反规则**：Accessibility - include skip link for main content
- **改进建议**：在 dashboard layout 添加 skip link（应在 layout 层处理）

---

### 2.12 其他问题 — 严重度：低（P3）

#### BUG-V2-T61：homework/assignments/[id]/page.tsx 使用 h1 但其他页面用 h2 ❌ 未修复
- **位置**：
  - [homework/assignments/[id]/page.tsx:36](../src/app/(dashboard)/teacher/homework/assignments/[id]/page.tsx) - `<h1>`
  - [attendance/page.tsx:47](../src/app/(dashboard)/teacher/attendance/page.tsx) - `<h2>`
  - [grades/page.tsx:54](../src/app/(dashboard)/teacher/grades/page.tsx) - `<h2>`
- **问题**：页面主标题层级不统一
- **改进建议**：统一使用 h1 作为页面主标题

#### BUG-V2-T62：textbooks/page.tsx 使用 h1，其他页面用 h2 ❌ 未修复
- **位置**：
  - [textbooks/page.tsx:57](../src/app/(dashboard)/teacher/textbooks/page.tsx) - `<h1>`
  - [textbooks/[id]/page.tsx:45](../src/app/(dashboard)/teacher/textbooks/[id]/page.tsx) - `<h1>`
- **问题**：同 V2-T61
- **改进建议**：统一标题层级策略

#### BUG-V2-T63：exams/create/page.tsx 缺少页面标题 ❌ 未修复
- **位置**：[exams/create/page.tsx:3-9](../src/app/(dashboard)/teacher/exams/create/page.tsx)
- **问题**：页面无任何标题，直接渲染表单
- **改进建议**：添加 `<h1>Create Exam</h1>`

#### BUG-V2-T64：loading.tsx 文件命名风格不一致 ❌ 未修复
- **位置**：
  - [textbooks/loading.tsx](../src/app/(dashboard)/teacher/textbooks/loading.tsx) - 使用 Card 组件
  - [classes/my/loading.tsx](../src/app/(dashboard)/teacher/classes/my/loading.tsx) - 使用纯 div
- **问题**：骨架屏风格不统一
- **改进建议**：统一骨架屏风格

#### BUG-V2-T65：lesson-plans/page.tsx 使用非标准 CSS 类 🆕 新增
- **位置**：[lesson-plans/page.tsx:21, 24](../src/app/(dashboard)/teacher/lesson-plans/page.tsx)
- **问题**：使用 `font-headline-lg text-headline-lg` 类名，这些类名不在标准 Tailwind 配置中，需确认是否在 globals.css 中定义
- **改进建议**：确认设计令牌定义，或改用标准 Tailwind 类名 `text-2xl font-bold tracking-tight`

#### BUG-V2-T66：lesson-plans/page.tsx 缺少页面描述 ❌ 未修复
- **位置**：[lesson-plans/page.tsx:18-31](../src/app/(dashboard)/teacher/lesson-plans/page.tsx)
- **问题**：页面仅有 `<h1>我的课案</h1>`，缺少描述性 `<p>` 标签，与其他页面风格不一致
- **改进建议**：添加描述段落，如 `<p className="text-muted-foreground">管理您的课案和教学准备</p>`

#### BUG-V2-T67：lesson-plans/new/page.tsx 缺少返回链接 🆕 新增
- **位置**：[lesson-plans/new/page.tsx](../src/app/(dashboard)/teacher/lesson-plans/new/page.tsx)
- **问题**：页面无返回到 `/teacher/lesson-plans` 的链接，用户无法导航回去
- **改进建议**：添加返回按钮

#### BUG-V2-T68：lesson-plans/[planId]/edit/page.tsx 缺少页面标题 ❌ 未修复
- **位置**：[lesson-plans/[planId]/edit/page.tsx](../src/app/(dashboard)/teacher/lesson-plans/[planId]/edit/page.tsx)
- **问题**：页面无 `<h1>` 标题，直接渲染 `<LessonPlanEditor>`
- **改进建议**：添加页面标题

#### BUG-V2-T69：lesson-plans 系列文件中英文混用 🆕 新增
- **位置**：
  - [lesson-plans/page.tsx:21, 24](../src/app/(dashboard)/teacher/lesson-plans/page.tsx) - "我的课案"、"新建课案"
  - [lesson-plans/new/page.tsx:6](../src/app/(dashboard)/teacher/lesson-plans/new/page.tsx) - "新建课案"
- **问题**：teacher 模块其他页面均使用英文标题（如 "Attendance"、"Grades"），但 lesson-plans 使用中文，风格不一致
- **改进建议**：统一为英文 "My Lesson Plans" / "New Lesson Plan"，或在 i18n 配置中统一管理

---

## 三、v1 已修复问题确认

### 3.1 已确认修复

| v1 BUG ID | 问题摘要 | 修复确认 |
|-----------|----------|----------|
| T29（部分） | schedule-changes/page.tsx 通过 actions 调用 | ✅ 已改为从 `@/modules/scheduling/data-access` 导入 |

### 3.2 修复说明

**schedule-changes/page.tsx** 的修复：
- v1 状态：`import { getAdminClassesForScheduling, getScheduleChanges, getTeachersForScheduling } from "@/modules/scheduling/actions"`
- v2 状态：`import { getAdminClassesForScheduling, getScheduleChanges, getTeachersForScheduling } from "@/modules/scheduling/data-access"`
- 评价：✅ 正确修复，读取操作应从 data-access 导入，而非 actions

---

## 四、改进优先级汇总（v2）

### P0 - 立即修复（架构与安全）

| BUG ID | 问题 | 影响 | v1 状态 |
|--------|------|------|----------|
| V2-T01 | dashboard/page.tsx 直接访问 DB | 破坏三层架构 | ❌ 未修复 |
| V2-T02 | grades/page.tsx 直接访问 DB | 破坏三层架构 | ❌ 未修复 |
| V2-T03 | grades/analytics/page.tsx 直接访问 DB | 破坏三层架构 | ❌ 未修复 |
| V2-T04 | grades/entry/page.tsx 直接访问 DB | 破坏三层架构 | ❌ 未修复 |
| V2-T05 | grades/stats/page.tsx 直接访问 DB | 破坏三层架构 | ❌ 未修复 |
| V2-T06 | 认证方式不一致 | 数据范围过滤缺失 | ❌ 未修复 |
| V2-T47 | course-plans/page.tsx 缺权限校验 | 越权访问风险 | ❌ 未修复 |
| V2-T48 | elective/page.tsx 缺权限校验 | 越权访问风险 | ❌ 未修复 |
| V2-T49 | dashboard/page.tsx 缺权限校验 | 越权访问风险 | ❌ 未修复 |
| V2-T50 | 权限校验方式不一致 | 安全隐患 | ❌ 未修复 |
| V2-T50a | lesson-plans/page.tsx 通过 actions 读取 🆕 | 架构违规 | 🆕 新增 |
| V2-T50b | lesson-plans/[planId]/edit 通过 actions 读取 🆕 | 架构违规 | 🆕 新增 |

### P1 - 高优先级（TypeScript 与性能）

| BUG ID | 问题 | v1 状态 |
|--------|------|----------|
| V2-T11~T15 | 使用 `as` 类型断言（5 处） | ❌ 未修复 |
| V2-T16~T17 | 函数返回值未标注 | ❌ 未修复 |
| V2-T20~T28 | 串行数据获取 waterfall（9 处） | ❌ 未修复 |
| V2-T43 | 大列表未虚拟化 | ❌ 未修复 |

### P2 - 中优先级（规范与可访问性）

| BUG ID | 问题 | v1 状态 |
|--------|------|----------|
| V2-T07~T10a | Prettier 分号违规 | ❌ 未修复 |
| V2-T18~T19 | DRY 违规 | ❌ 未修复 |
| V2-T31~T32 | 筛选按钮焦点样式/语义 | ❌ 未修复 |
| V2-T36~T39 | 长文本未截断 | ❌ 未修复 |
| V2-T42 | 数字列未用 tabular-nums | ❌ 未修复 |
| V2-T58~T60 | 可访问性缺失 | ❌ 未修复 |
| V2-T65~T69 | lesson-plans 系列问题 🆕 | 🆕 新增 |

### P3 - 低优先级（代码质量）

| BUG ID | 问题 | v1 状态 |
|--------|------|----------|
| V2-T44~T46 | 组件定义问题 | ❌ 未修复 |
| V2-T51~T52 | loading.tsx 缺失/冗余 | ❌ 未修复 |
| V2-T53~T57 | 逻辑与长度问题 | ❌ 未修复 |
| V2-T61~T64 | 标题层级与风格 | ❌ 未修复 |

---

## 五、v1 → v2 改进对比

### 5.1 改进情况

| 维度 | v1 问题数 | v2 已修复 | v2 新增 | v2 总计 | 净变化 |
|------|-----------|-----------|---------|---------|--------|
| 架构分层 | 6 | 0 | 2 | 8 | +2 |
| Prettier | 4 | 0 | 1 | 5 | +1 |
| TypeScript | 7 | 0 | 0 | 7 | 0 |
| DRY | 2 | 0 | 0 | 2 | 0 |
| 性能 | 11 | 0 | 0 | 11 | 0 |
| Web 规范 | 13 | 0 | 0 | 13 | 0 |
| 组件规范 | 3 | 0 | 0 | 3 | 0 |
| 安全权限 | 4 | 0 | 2 | 6 | +2 |
| 加载态 | 2 | 0 | 0 | 2 | 0 |
| 代码质量 | 5 | 0 | 0 | 5 | 0 |
| 可访问性 | 3 | 0 | 0 | 3 | 0 |
| 其他 | 4 | 0 | 5 | 9 | +5 |
| **合计** | **64** | **1** | **10** | **74** | **+10** |

### 5.2 关键观察

1. **修复进度缓慢**：v1 的 64 个问题中仅 1 个确认修复（schedule-changes 的 actions→data-access），修复率 1.6%
2. **新增问题**：lesson-plans 模块新增 10 个问题，主要涉及：
   - 架构违规：通过 Server Actions 读取数据（应使用 data-access）
   - Prettier 违规：使用分号
   - 风格不一致：中英文混用、非标准 CSS 类
   - 缺少基础元素：标题、返回链接、页面描述
3. **P0 问题全部未修复**：5 处 app 层直接访问 DB、3 处权限校验缺失、认证方式不一致等关键问题均未处理
4. **已有可复用函数未利用**：
   - `modules/users/data-access.ts` 已有 `getUserBasicInfo(userId)` 可替代 dashboard/page.tsx 的直接 DB 访问
   - `modules/school/data-access.ts` 已有 `getSubjectOptions()` 可替代 grades 系列页面的直接 DB 访问
   - 但这些现成函数均未被采用

---

## 六、推荐改进方案（v2 更新）

### 6.1 立即修复 P0 问题（架构与安全）

#### 6.1.1 修复 app 层直接访问 DB（V2-T01~T05）

**dashboard/page.tsx** 修复：
```typescript
// 修改前
import { db } from "@/shared/db"
import { users } from "@/shared/db/schema"
import { eq } from "drizzle-orm"
// ...
db.query.users.findFirst({ where: eq(users.id, teacherId), columns: { name: true } })

// 修改后
import { getUserBasicInfo } from "@/modules/users/data-access"
// ...
const teacherProfile = await getUserBasicInfo(teacherId)
```

**grades/page.tsx、grades/analytics/page.tsx、grades/entry/page.tsx、grades/stats/page.tsx** 修复：
```typescript
// 修改前
import { db } from "@/shared/db"
import { subjects } from "@/shared/db/schema"
import { asc } from "drizzle-orm"
// ...
db.query.subjects.findMany({ orderBy: [asc(subjects.order), asc(subjects.name)] })

// 修改后
import { getSubjectOptions } from "@/modules/school/data-access"
// ...
const allSubjects = await getSubjectOptions()
```

#### 6.1.2 修复权限校验（V2-T06, T47~T50）

**course-plans/page.tsx、elective/page.tsx** 修复：
```typescript
// 修改前
import { auth } from "@/auth"
const session = await auth()
const teacherId = String(session?.user?.id ?? "")

// 修改后
import { getAuthContext } from "@/shared/lib/auth-guard"
const ctx = await getAuthContext()
const teacherId = ctx.userId
```

#### 6.1.3 修复 lesson-plans 架构违规（V2-T50a, T50b）

**lesson-plans/page.tsx** 修复：
```typescript
// 修改前
import { getLessonPlansAction } from "@/modules/lesson-preparation/actions";
import { getSubjectsAction } from "@/modules/exams/actions";

// 修改后
import { getLessonPlans } from "@/modules/lesson-preparation/data-access";
import { getSubjectOptions } from "@/modules/school/data-access";
```

### 6.2 提取共享工具（解决 V2-T16, T18）

新建 `src/shared/lib/search-params.ts`：

```typescript
export type SearchParams = { [key: string]: string | string[] | undefined }

export function getParam(params: SearchParams, key: string): string | undefined {
  const v = params[key]
  return Array.isArray(v) ? v[0] : v
}
```

所有页面统一 `import { getParam, type SearchParams } from "@/shared/lib/search-params"`。

### 6.3 提取共享筛选组件（解决 V2-T19, T31, T32）

新建 `src/shared/components/ui/filter-chips.tsx`：

```tsx
import Link from "next/link"
import { cn } from "@/shared/lib/utils"

interface FilterChip {
  id: string
  label: string
  href: string
  active: boolean
}

export function FilterChips({ chips }: { chips: FilterChip[] }) {
  return (
    <div className="flex flex-wrap gap-2">
      {chips.map((c) => (
        <Link
          key={c.id}
          href={c.href}
          className={cn(
            "rounded-md border px-3 py-1.5 text-sm transition-colors",
            "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2",
            c.active
              ? "border-primary bg-primary text-primary-foreground"
              : "bg-card hover:bg-accent"
          )}
        >
          {c.label}
        </Link>
      ))}
    </div>
  )
}
```

### 6.4 并行数据获取优化（解决 V2-T20~T28）

将串行 `await` 改为 `Promise.all`：

```typescript
// 优化前
const classes = await getTeacherClasses()
const records = await getGradeRecords({ ... })

// 优化后
const [classes, records] = await Promise.all([
  getTeacherClasses(),
  getGradeRecords({ ... }),
])
```

### 6.5 统一 lesson-plans 风格（解决 V2-T65~T69）

```typescript
// lesson-plans/page.tsx 修复
export default async function LessonPlansPage() {
  const [items, subjects] = await Promise.all([
    getLessonPlans({}),
    getSubjectOptions(),
  ])

  return (
    <div className="p-6 space-y-4">
      <div className="flex justify-between items-center">
        <div>
          <h1 className="text-2xl font-bold tracking-tight">My Lesson Plans</h1>
          <p className="text-muted-foreground">Manage your lesson preparation and teaching plans.</p>
        </div>
        <Button asChild>
          <Link href="/teacher/lesson-plans/new">
            <Plus className="h-4 w-4 mr-2" />
            New Lesson Plan
          </Link>
        </Button>
      </div>
      <LessonPlanList initialItems={items} subjects={subjects} />
    </div>
  )
}
```

---

## 七、架构图同步建议

本次核查未修改源码，无需同步架构图。但建议在后续修复时：

1. 若新增 `shared/lib/search-params.ts`，需在 005_architecture_data.json 的 `shared.lib.exports` 中添加
2. 若新增 `shared/components/ui/filter-chips.tsx`，需在 005 的 `shared.components.exports` 中添加
3. `lesson-plans` 模块需在 005 的 `modules` 中新增节点，记录其 `data-access` 和 `actions` 导出
4. `modules/school/data-access.ts` 的 `getSubjectOptions` 已存在，确认 005 中已记录
5. `modules/users/data-access.ts` 的 `getUserBasicInfo` 已存在，确认 005 中已记录

---

## 八、总结

本次 v2 核查覆盖 `src/app/(dashboard)/teacher/` 下全部 **48 个前端文件**（37 个 page.tsx + 8 个 loading.tsx + 3 个新增 lesson-plans 页面），共发现 **74 个问题**，分布如下：

| 严重度 | 数量 | 类别 | v1 对比 |
|--------|------|------|---------|
| P0 | 12 | 架构违规、权限缺失 | +3（含 2 个新增） |
| P1 | 16 | TypeScript、性能 | 0 |
| P2 | 23 | 规范、可访问性 | +5（含 5 个新增） |
| P3 | 23 | 代码质量 | +2 |

### 核心问题（v2 更新）

1. **架构层违规加剧**：5 处 app 层直接访问 DB 未修复，新增 2 处 lesson-plans 通过 actions 读取数据
2. **权限校验不一致**：3 处页面无校验未修复，新增 lesson-plans 模块未做权限校验
3. **性能 waterfall 普遍**：9 处串行数据获取未修复
4. **DRY 违规突出**：`getParam` 函数在 16 个文件中重复
5. **可访问性缺失**：焦点样式、aria-label、skip link 普遍缺失
6. **新增模块质量待提升**：lesson-plans 模块存在架构违规、风格不一致、基础元素缺失等问题

### 修复建议优先级

1. **第一优先级**：修复 5 处 app 层直接访问 DB（已有 `getUserBasicInfo` 和 `getSubjectOptions` 可直接复用）
2. **第二优先级**：统一权限校验为 `getAuthContext()`
3. **第三优先级**：修复 lesson-plans 模块的架构违规（actions → data-access）
4. **第四优先级**：提取共享工具 `getParam` 和 `FilterChips` 组件
5. **第五优先级**：并行化数据获取，优化性能

建议按 P0 → P1 → P2 → P3 顺序修复，优先解决架构与安全问题。特别是 app 层直接访问 DB 的问题，已有现成的 data-access 函数可用，修复成本极低。
