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/shared/lib/utils.ts

@@ -12,3 +12,54 @@ export function formatDate(date: string | Date, locale: string = "zh-CN") {
     day: "numeric",
   }).format(new Date(date))
 }
+
+/** Next.js App Router 搜索参数类型 */
+export type SearchParams = { [key: string]: string | string[] | undefined }
+
+/** 从 SearchParams 中安全提取单个字符串值 */
+export function getSearchParam(params: SearchParams, key: string): string | undefined {
+  const v = params[key]
+  if (typeof v === "string") return v
+  if (Array.isArray(v)) return v[0]
+  return undefined
+}
+
+/** 格式化数字，null/undefined/非有限数返回 "-" */
+export function formatNumber(v: number | null | undefined, digits = 1): string {
+  if (typeof v !== "number" || !Number.isFinite(v)) return "-"
+  return v.toFixed(digits)
+}
+
+/**
+ * 从姓名生成头像占位用的首字母（最多 2 个字符）。
+ * 用于 AvatarFallback 组件。
+ * - 含空格的姓名：取各单词首字母拼接（如 "John Doe" -> "JD"）
+ * - 无空格的姓名：取前 2 个字符（如 "张三" -> "张三"）
+ * - 空值：返回 "U"（User 通用占位）
+ */
+export function getInitials(name: string | null | undefined): string {
+  if (!name) return "U"
+  const trimmed = name.trim()
+  if (!trimmed) return "U"
+  if (trimmed.includes(" ")) {
+    return trimmed
+      .split(/\s+/)
+      .map((n) => n[0])
+      .join("")
+      .toUpperCase()
+      .slice(0, 2)
+  }
+  return trimmed.slice(0, 2).toUpperCase()
+}
+
+/**
+ * 格式化日期为文件名安全的 YYYY-MM-DD 格式。
+ * 用于导出文件名（如 `grades_export_2026-06-20.xlsx`）。
+ * @param d 日期对象，默认为当前时间
+ */
+export function formatDateForFile(d: Date = new Date()): string {
+  const y = d.getFullYear()
+  const m = String(d.getMonth() + 1).padStart(2, "0")
+  const day = String(d.getDate()).padStart(2, "0")
+  return `${y}-${m}-${day}`
+}