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/textbooks/data-access.ts

@@ -8,21 +8,25 @@ import { db } from "@/shared/db"
 import { chapters, knowledgePoints, textbooks } from "@/shared/db/schema"
 import type {
   Chapter,
-  CreateChapterInput,
-  CreateTextbookInput,
   KnowledgePoint,
   Textbook,
-  UpdateChapterContentInput,
-  UpdateTextbookInput,
 } from "./types"
+import type {
+  CreateChapterInput,
+  CreateKnowledgePointInput,
+  CreateTextbookInput,
+  UpdateChapterContentInput,
+  UpdateKnowledgePointInput,
+  UpdateTextbookInput,
+} from "./schema"
 
-const normalizeOptional = (v: string | null | undefined) => {
+const normalizeOptional = (v: string | null | undefined): string | null => {
   const trimmed = v?.trim()
   if (!trimmed) return null
   return trimmed
 }
 
-const sortChapters = (a: Chapter, b: Chapter) => {
+const sortChapters = (a: Chapter, b: Chapter): number => {
   const ao = a.order ?? 0
   const bo = b.order ?? 0
   if (ao !== bo) return ao - bo
@@ -308,10 +312,11 @@ export async function deleteChapter(id: string): Promise<void> {
   }
 
   const idsToDelete: string[] = []
-  const stack = [id]
+  const stack: string[] = [id]
   const seen = new Set<string>()
   while (stack.length) {
-    const cur = stack.pop()!
+    const cur = stack.pop()
+    if (!cur) break
     if (seen.has(cur)) continue
     seen.add(cur)
     idsToDelete.push(cur)
@@ -376,7 +381,7 @@ export const getKnowledgePointsByTextbookId = cache(async (textbookId: string):
   }))
 })
 
-export async function createKnowledgePoint(data: { name: string; description?: string; anchorText?: string; chapterId?: string; parentId?: string }): Promise<void> {
+export async function createKnowledgePoint(data: CreateKnowledgePointInput): Promise<void> {
   await db.insert(knowledgePoints).values({
     id: createId(),
     name: data.name,
@@ -389,7 +394,7 @@ export async function createKnowledgePoint(data: { name: string; description?: s
   })
 }
 
-export async function updateKnowledgePoint(data: { id: string; name: string; description?: string; anchorText?: string }): Promise<void> {
+export async function updateKnowledgePoint(data: UpdateKnowledgePointInput): Promise<void> {
   await db
     .update(knowledgePoints)
     .set({
@@ -453,3 +458,57 @@ export const getTextbooksDashboardStats = cache(async (): Promise<TextbooksDashb
     chapterCount: Number(chapterCountRow[0]?.value ?? 0),
   }
 })
+
+// ---------------------------------------------------------------------------
+// Cross-module query interfaces — read-only access for other modules
+// ---------------------------------------------------------------------------
+
+export type KnowledgePointOption = {
+  id: string
+  name: string
+  chapterId: string | null
+  chapterTitle: string | null
+  textbookId: string | null
+  textbookTitle: string | null
+  subject: string | null
+  grade: string | null
+}
+
+/**
+ * 获取所有知识点选项（含章节和教材信息）。
+ * 供 questions 模块跨模块调用使用，避免直接查询 textbooks/chapters/knowledgePoints 表。
+ */
+export const getKnowledgePointOptions = cache(async (): Promise<KnowledgePointOption[]> => {
+  const rows = await db
+    .select({
+      id: knowledgePoints.id,
+      name: knowledgePoints.name,
+      chapterId: chapters.id,
+      chapterTitle: chapters.title,
+      textbookId: textbooks.id,
+      textbookTitle: textbooks.title,
+      subject: textbooks.subject,
+      grade: textbooks.grade,
+    })
+    .from(knowledgePoints)
+    .leftJoin(chapters, eq(chapters.id, knowledgePoints.chapterId))
+    .leftJoin(textbooks, eq(textbooks.id, chapters.textbookId))
+    .orderBy(
+      asc(textbooks.title),
+      asc(chapters.order),
+      asc(chapters.title),
+      asc(knowledgePoints.order),
+      asc(knowledgePoints.name)
+    )
+
+  return rows.map((row) => ({
+    id: row.id,
+    name: row.name,
+    chapterId: row.chapterId ?? null,
+    chapterTitle: row.chapterTitle ?? null,
+    textbookId: row.textbookId ?? null,
+    textbookTitle: row.textbookTitle ?? null,
+    subject: row.subject ?? null,
+    grade: row.grade ?? null,
+  }))
+})