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/modules/layout/components/app-sidebar.tsx

@@ -19,7 +19,6 @@ import {
 } from "@/shared/components/ui/tooltip"
 import { cn } from "@/shared/lib/utils"
 import { usePermission } from "@/shared/hooks"
-import { type Permission } from "@/shared/types/permissions"
 import { useSidebar } from "./sidebar-provider"
 import { NAV_CONFIG, Role } from "../config/navigation"
 
@@ -42,17 +41,17 @@ export function AppSidebar({ mode }: AppSidebarProps) {
     currentRole = "parent"
   }
 
-  const allNavItems = NAV_CONFIG[currentRole] ?? NAV_CONFIG.teacher
+  const allNavItems = NAV_CONFIG[currentRole] ?? NAV_CONFIG.teacher ?? []
 
   // Filter nav items by permission
   const navItems = allNavItems.filter((item) => {
     if (!item.permission) return true
-    return permissions.includes(item.permission as Permission)
+    return permissions.includes(item.permission)
   }).map((item) => ({
     ...item,
     items: item.items?.filter((subItem) => {
       if (!subItem.permission) return true
-      return permissions.includes(subItem.permission as Permission)
+      return permissions.includes(subItem.permission)
     }),
   }))
 

src/modules/layout/components/site-header.tsx

@@ -34,7 +34,7 @@ import { NAV_CONFIG } from "../config/navigation"
 // Build lookup map for breadcrumbs
 const BREADCRUMB_MAP = new Map<string, string>()
 Object.values(NAV_CONFIG).forEach((items) => {
-  items.forEach((item) => {
+  items?.forEach((item) => {
     BREADCRUMB_MAP.set(item.href, item.title)
     item.items?.forEach((subItem) => {
       BREADCRUMB_MAP.set(subItem.href, subItem.title)

src/modules/layout/config/navigation.ts

@@ -22,18 +22,19 @@ import {
 } from "lucide-react"
 import type { LucideIcon } from "lucide-react"
 import { Permissions } from "@/shared/types/permissions"
+import type { Permission, Role } from "@/shared/types/permissions"
+
+export type { Role }
 
 export type NavItem = {
   title: string
   icon: LucideIcon
   href: string
-  permission?: string
-  items?: { title: string; href: string; permission?: string }[]
+  permission?: Permission
+  items?: { title: string; href: string; permission?: Permission }[]
 }
 
-export type Role = "admin" | "teacher" | "student" | "parent"
-
-export const NAV_CONFIG: Record<Role, NavItem[]> = {
+export const NAV_CONFIG: Partial<Record<Role, NavItem[]>> = {
   admin: [
     {
       title: "Dashboard",
@@ -171,6 +172,12 @@ export const NAV_CONFIG: Record<Role, NavItem[]> = {
       href: "/teacher/course-plans",
       permission: Permissions.COURSE_PLAN_READ,
     },
+    {
+      title: "Lesson Plans",
+      icon: PenTool,
+      href: "/teacher/lesson-plans",
+      permission: Permissions.LESSON_PLAN_READ,
+    },
     {
       title: "Attendance",
       icon: CalendarCheck,