feat: 新增备课模块并修复全模块 P0/P1/P2 缺陷

主要变更:

- 新增 lesson-preparation 模块: 备课编辑器、节点编辑、AI 建议、知识点选择、版本历史、作业发布

- 新增 shared 通用组件: charts/question-bank-filters/schedule-list/ui (chip-nav/filter-bar/page-header/stat-card/stat-item)

- 新增 student/admin 端 loading.tsx 与 error.tsx, 优化加载与错误态体验

- 新增 teacher/lesson-plans 页面 (列表/新建/编辑)

- 新增 drizzle 迁移 0002_tiny_lionheart 及 snapshot

- 新增 textbooks/schema.ts 与 exams/utils/normalize-structure.ts

- 修复 Tiptap v3 SSR hydration 崩溃 (rich-text-block immediatelyRender: false)

- 重构多模块 data-access/actions/组件, 修复权限校验与类型规范

- 同步架构文档 004/005 反映新增模块、导出、依赖关系

- 归档 bugs/* 测试报告与 e2e 测试脚本 (admin/parent/student/teacher web_test)

src/app/(dashboard)/admin/audit-logs/data-changes/page.tsx

@@ -1,5 +1,9 @@
+import type { Metadata } from "next"
+import type { JSX } from "react"
+
 import { requirePermission } from "@/shared/lib/auth-guard"
 import { Permissions } from "@/shared/types/permissions"
+import { getSearchParam, type SearchParams } from "@/shared/lib/utils"
 import {
   getDataChangeLogs,
   getDataChangeStats,
@@ -9,28 +13,30 @@ import { DataChangeLogTable } from "@/modules/audit/components/data-change-log-t
 import { AuditLogExportButton } from "@/modules/audit/components/audit-log-export-button"
 import type { DataChangeAction } from "@/modules/audit/types"
 
+export const metadata: Metadata = {
+  title: "数据变更日志 - Next_Edu",
+  description: "追踪系统所有数据变更（增删改），保障合规",
+}
+
 export const dynamic = "force-dynamic"
 
-type SearchParams = { [key: string]: string | string[] | undefined }
-
-const getParam = (params: SearchParams, key: string) => {
-  const v = params[key]
-  return Array.isArray(v) ? v[0] : v
-}
+const isValidDataChangeAction = (v?: string): v is DataChangeAction =>
+  v === "create" || v === "update" || v === "delete"
 
 export default async function DataChangeLogsPage({
   searchParams,
 }: {
   searchParams: Promise<SearchParams>
-}) {
+}): Promise<JSX.Element> {
   await requirePermission(Permissions.AUDIT_LOG_READ)
 
   const params = await searchParams
-  const page = Number(getParam(params, "page") ?? "1") || 1
-  const tableName = getParam(params, "tableName") ?? undefined
-  const action = (getParam(params, "action") as DataChangeAction | undefined) ?? undefined
-  const startDate = getParam(params, "startDate") ?? undefined
-  const endDate = getParam(params, "endDate") ?? undefined
+  const page = Number(getSearchParam(params, "page") ?? "1") || 1
+  const tableName = getSearchParam(params, "tableName") ?? undefined
+  const actionParam = getSearchParam(params, "action")
+  const action = isValidDataChangeAction(actionParam) ? actionParam : undefined
+  const startDate = getSearchParam(params, "startDate") ?? undefined
+  const endDate = getSearchParam(params, "endDate") ?? undefined
 
   const [result, tableOptions, stats] = await Promise.all([
     getDataChangeLogs({ page, tableName, action, startDate, endDate }),
@@ -48,9 +54,9 @@ export default async function DataChangeLogsPage({
     <div className="flex h-full flex-col space-y-8 p-8">
       <div className="flex items-start justify-between gap-4">
         <div className="space-y-1">
-          <h2 className="text-2xl font-bold tracking-tight">Data Change Logs</h2>
+          <h2 className="text-2xl font-bold tracking-tight">数据变更日志</h2>
           <p className="text-muted-foreground">
-            Track all data mutations (create/update/delete) across system tables for compliance.
+            追踪系统所有数据变更（增删改），保障合规。
           </p>
         </div>
         <AuditLogExportButton exportType="dataChange" params={exportParams} />

src/app/(dashboard)/admin/audit-logs/login-logs/page.tsx

@@ -1,32 +1,42 @@
+import type { Metadata } from "next"
+import type { JSX } from "react"
+
 import { requirePermission } from "@/shared/lib/auth-guard"
 import { Permissions } from "@/shared/types/permissions"
+import { getSearchParam, type SearchParams } from "@/shared/lib/utils"
 import { getLoginLogs } from "@/modules/audit/data-access"
 import { LoginLogView } from "@/modules/audit/components/login-log-view"
 import { AuditLogExportButton } from "@/modules/audit/components/audit-log-export-button"
 import type { LoginLogAction, LoginLogStatus } from "@/modules/audit/types"
 
+export const metadata: Metadata = {
+  title: "登录日志 - Next_Edu",
+  description: "监控所有认证事件，包括登录、登出与注册",
+}
+
 export const dynamic = "force-dynamic"
 
-type SearchParams = { [key: string]: string | string[] | undefined }
+const isValidLoginLogAction = (v?: string): v is LoginLogAction =>
+  v === "signin" || v === "signout" || v === "signup"
 
-const getParam = (params: SearchParams, key: string) => {
-  const v = params[key]
-  return Array.isArray(v) ? v[0] : v
-}
+const isValidLoginLogStatus = (v?: string): v is LoginLogStatus =>
+  v === "success" || v === "failure"
 
 export default async function LoginLogsPage({
   searchParams,
 }: {
   searchParams: Promise<SearchParams>
-}) {
+}): Promise<JSX.Element> {
   await requirePermission(Permissions.AUDIT_LOG_READ)
 
   const params = await searchParams
-  const page = Number(getParam(params, "page") ?? "1") || 1
-  const action = (getParam(params, "action") as LoginLogAction | undefined) ?? undefined
-  const status = (getParam(params, "status") as LoginLogStatus | undefined) ?? undefined
-  const startDate = getParam(params, "startDate") ?? undefined
-  const endDate = getParam(params, "endDate") ?? undefined
+  const page = Number(getSearchParam(params, "page") ?? "1") || 1
+  const actionParam = getSearchParam(params, "action")
+  const action = isValidLoginLogAction(actionParam) ? actionParam : undefined
+  const statusParam = getSearchParam(params, "status")
+  const status = isValidLoginLogStatus(statusParam) ? statusParam : undefined
+  const startDate = getSearchParam(params, "startDate") ?? undefined
+  const endDate = getSearchParam(params, "endDate") ?? undefined
 
   const result = await getLoginLogs({ page, action, status, startDate, endDate })
 
@@ -40,9 +50,9 @@ export default async function LoginLogsPage({
     <div className="flex h-full flex-col space-y-8 p-8">
       <div className="flex items-start justify-between gap-4">
         <div className="space-y-1">
-          <h2 className="text-2xl font-bold tracking-tight">Login Logs</h2>
+          <h2 className="text-2xl font-bold tracking-tight">登录日志</h2>
           <p className="text-muted-foreground">
-            Monitor all authentication events including sign in, sign out, and sign up.
+            监控所有认证事件，包括登录、登出与注册。
           </p>
         </div>
         <AuditLogExportButton exportType="login" params={exportParams} />

src/app/(dashboard)/admin/audit-logs/page.tsx

@@ -1,33 +1,39 @@
+import type { Metadata } from "next"
+import type { JSX } from "react"
+
 import { requirePermission } from "@/shared/lib/auth-guard"
 import { Permissions } from "@/shared/types/permissions"
+import { getSearchParam, type SearchParams } from "@/shared/lib/utils"
 import { getAuditLogs, getAuditModuleOptions } from "@/modules/audit/data-access"
 import { AuditLogView } from "@/modules/audit/components/audit-log-view"
 import { AuditLogExportButton } from "@/modules/audit/components/audit-log-export-button"
 import type { AuditLogStatus } from "@/modules/audit/types"
 
+export const metadata: Metadata = {
+  title: "审计日志 - Next_Edu",
+  description: "追踪系统内所有用户操作，保障安全与合规",
+}
+
 export const dynamic = "force-dynamic"
 
-type SearchParams = { [key: string]: string | string[] | undefined }
-
-const getParam = (params: SearchParams, key: string) => {
-  const v = params[key]
-  return Array.isArray(v) ? v[0] : v
-}
+const isValidAuditLogStatus = (v?: string): v is AuditLogStatus =>
+  v === "success" || v === "failure"
 
 export default async function AuditLogsPage({
   searchParams,
 }: {
   searchParams: Promise<SearchParams>
-}) {
+}): Promise<JSX.Element> {
   await requirePermission(Permissions.AUDIT_LOG_READ)
 
   const params = await searchParams
-  const page = Number(getParam(params, "page") ?? "1") || 1
-  const moduleFilter = getParam(params, "module") ?? undefined
-  const action = getParam(params, "action") ?? undefined
-  const status = (getParam(params, "status") as AuditLogStatus | undefined) ?? undefined
-  const startDate = getParam(params, "startDate") ?? undefined
-  const endDate = getParam(params, "endDate") ?? undefined
+  const page = Number(getSearchParam(params, "page") ?? "1") || 1
+  const moduleFilter = getSearchParam(params, "module") ?? undefined
+  const action = getSearchParam(params, "action") ?? undefined
+  const statusParam = getSearchParam(params, "status")
+  const status = isValidAuditLogStatus(statusParam) ? statusParam : undefined
+  const startDate = getSearchParam(params, "startDate") ?? undefined
+  const endDate = getSearchParam(params, "endDate") ?? undefined
 
   const [result, moduleOptions] = await Promise.all([
     getAuditLogs({ page, module: moduleFilter, action, status, startDate, endDate }),
@@ -45,9 +51,9 @@ export default async function AuditLogsPage({
     <div className="flex h-full flex-col space-y-8 p-8">
       <div className="flex items-start justify-between gap-4">
         <div className="space-y-1">
-          <h2 className="text-2xl font-bold tracking-tight">Audit Logs</h2>
+          <h2 className="text-2xl font-bold tracking-tight">审计日志</h2>
           <p className="text-muted-foreground">
-            Track all user operations across the system for security and compliance.
+            追踪系统内所有用户操作，保障安全与合规。
           </p>
         </div>
         <AuditLogExportButton exportType="audit" params={exportParams} />