feat(teacher): 题库模块（QuestionBank）

工作内容

- 新增 /teacher/questions 页面，支持 Suspense/空状态/加载态

- 题库 CRUD Server Actions：创建/更新/递归删除子题，变更后 revalidatePath

- getQuestions 支持 q/type/difficulty/knowledgePointId 筛选与分页返回 meta

- UI：表格列/筛选器/创建编辑弹窗，content JSON 兼容组卷

- 更新中文设计文档：docs/design/004_question_bank_implementation.md

src/modules/questions/components/create-question-dialog.tsx

@@ -5,8 +5,10 @@ import { useForm, type SubmitHandler } from "react-hook-form"
 import { zodResolver } from "@hookform/resolvers/zod"
 import { z } from "zod"
 import { Plus, Trash2, GripVertical } from "lucide-react"
+import { useRouter } from "next/navigation"
 
 import { Button } from "@/shared/components/ui/button"
+import { Checkbox } from "@/shared/components/ui/checkbox"
 import {
   Dialog,
   DialogContent,
@@ -34,19 +36,22 @@ import {
 } from "@/shared/components/ui/select"
 import { Textarea } from "@/shared/components/ui/textarea"
 import { BaseQuestionSchema } from "../schema"
-import { createNestedQuestion } from "../actions"
+import { createNestedQuestion, updateQuestionAction } from "../actions"
 import { toast } from "sonner"
 import { Question } from "../types"
 
-// Extend schema for form usage (e.g. handling options for choice questions)
 const QuestionFormSchema = BaseQuestionSchema.extend({
   difficulty: z.number().min(1).max(5),
   content: z.string().min(1, "Question content is required"),
-  options: z.array(z.object({
-    label: z.string(),
-    value: z.string(),
-    isCorrect: z.boolean().default(false)
-  })).optional(),
+  options: z
+    .array(
+      z.object({
+        label: z.string(),
+        value: z.string(),
+        isCorrect: z.boolean().default(false),
+      })
+    )
+    .optional(),
 })
 
 type QuestionFormValues = z.input<typeof QuestionFormSchema>
@@ -57,7 +62,43 @@ interface CreateQuestionDialogProps {
   initialData?: Question | null
 }
 
+function getInitialTextFromContent(content: unknown) {
+  if (typeof content === "string") return content
+  if (content && typeof content === "object") {
+    const text = (content as { text?: unknown }).text
+    if (typeof text === "string") return text
+  }
+  if (content == null) return ""
+  return JSON.stringify(content)
+}
+
+function getInitialOptionsFromContent(content: unknown) {
+  if (!content || typeof content !== "object") return undefined
+  const rawOptions = (content as { options?: unknown }).options
+  if (!Array.isArray(rawOptions)) return undefined
+
+  const mapped = rawOptions
+    .map((opt) => {
+      if (!opt || typeof opt !== "object") return null
+      const id =
+        (opt as { id?: unknown; value?: unknown }).id ?? (opt as { value?: unknown }).value
+      const text =
+        (opt as { text?: unknown; label?: unknown }).text ??
+        (opt as { label?: unknown }).label
+      const isCorrect = (opt as { isCorrect?: unknown }).isCorrect
+      return {
+        value: typeof id === "string" ? id : "",
+        label: typeof text === "string" ? text : "",
+        isCorrect: typeof isCorrect === "boolean" ? isCorrect : false,
+      }
+    })
+    .filter((v): v is NonNullable<typeof v> => Boolean(v && v.value && v.label))
+
+  return mapped.length > 0 ? mapped : undefined
+}
+
 export function CreateQuestionDialog({ open, onOpenChange, initialData }: CreateQuestionDialogProps) {
+  const router = useRouter()
   const [isPending, setIsPending] = useState(false)
   const isEdit = !!initialData
 
@@ -66,63 +107,101 @@ export function CreateQuestionDialog({ open, onOpenChange, initialData }: Create
     defaultValues: {
       type: initialData?.type || "single_choice",
       difficulty: initialData?.difficulty || 1,
-      content: (typeof initialData?.content === 'string' ? initialData.content : "") || "",
-      options: [
-        { label: "Option A", value: "A", isCorrect: true },
-        { label: "Option B", value: "B", isCorrect: false },
-      ],
+      content: getInitialTextFromContent(initialData?.content),
+      options:
+        getInitialOptionsFromContent(initialData?.content) ?? [
+          { label: "Option A", value: "A", isCorrect: true },
+          { label: "Option B", value: "B", isCorrect: false },
+        ],
     },
   })
 
-  // Reset form when initialData changes
   useEffect(() => {
     if (initialData) {
-        form.reset({
-            type: initialData.type,
-            difficulty: initialData.difficulty,
-            content: typeof initialData.content === 'string' ? initialData.content : JSON.stringify(initialData.content),
-            options: [
-                { label: "Option A", value: "A", isCorrect: true },
-                { label: "Option B", value: "B", isCorrect: false },
-            ]
-        })
+      form.reset({
+        type: initialData.type,
+        difficulty: initialData.difficulty,
+        content: getInitialTextFromContent(initialData.content),
+        options:
+          getInitialOptionsFromContent(initialData.content) ?? [
+            { label: "Option A", value: "A", isCorrect: true },
+            { label: "Option B", value: "B", isCorrect: false },
+          ],
+      })
     } else {
-        form.reset({
-             type: "single_choice",
-             difficulty: 1,
-             content: "",
-             options: [
-                 { label: "Option A", value: "A", isCorrect: true },
-                 { label: "Option B", value: "B", isCorrect: false },
-             ]
-        })
+      form.reset({
+        type: "single_choice",
+        difficulty: 1,
+        content: "",
+        options: [
+          { label: "Option A", value: "A", isCorrect: true },
+          { label: "Option B", value: "B", isCorrect: false },
+        ],
+      })
     }
-  }, [initialData, form])
+  }, [initialData, form, open])
 
   const questionType = form.watch("type")
 
+  const buildContent = (data: QuestionFormValues) => {
+    const text = data.content.trim()
+    if (data.type === "single_choice" || data.type === "multiple_choice") {
+      const rawOptions = (data.options ?? []).filter((o) => o.label.trim().length > 0)
+      const base = rawOptions.map((o) => ({
+        id: o.value,
+        text: o.label.trim(),
+        isCorrect: o.isCorrect,
+      }))
+
+      if (base.length === 0) return { text }
+
+      if (data.type === "single_choice") {
+        let selectedIndex = base.findIndex((o) => o.isCorrect)
+        if (selectedIndex === -1) selectedIndex = 0
+        return {
+          text,
+          options: base.map((o, idx) => ({ ...o, isCorrect: idx === selectedIndex })),
+        }
+      }
+
+      const hasCorrect = base.some((o) => o.isCorrect)
+      const options = hasCorrect ? base : [{ ...base[0], isCorrect: true }, ...base.slice(1)]
+      return { text, options }
+    }
+
+    return { text }
+  }
+
   const onSubmit: SubmitHandler<QuestionFormValues> = async (data) => {
     setIsPending(true)
     try {
+      if (isEdit && !initialData?.id) {
+        toast.error("Missing question id")
+        return
+      }
       const payload = {
+        ...(isEdit && initialData ? { id: initialData.id } : {}),
         type: data.type,
         difficulty: data.difficulty,
-        content: data.content,
+        content: buildContent(data),
         knowledgePointIds: [],
       }
       const fd = new FormData()
       fd.set("json", JSON.stringify(payload))
-      const res = await createNestedQuestion(undefined, fd)
+      const res = isEdit
+        ? await updateQuestionAction(undefined, fd)
+        : await createNestedQuestion(undefined, fd)
       if (res.success) {
         toast.success(isEdit ? "Updated question" : "Created question")
         onOpenChange(false)
+        router.refresh()
         if (!isEdit) {
           form.reset()
         }
       } else {
         toast.error(res.message || "Operation failed")
       }
-    } catch (error) {
+    } catch {
       toast.error("Unexpected error")
     } finally {
       setIsPending(false)
@@ -148,7 +227,7 @@ export function CreateQuestionDialog({ open, onOpenChange, initialData }: Create
                 render={({ field }) => (
                   <FormItem>
                     <FormLabel>Question Type</FormLabel>
-                    <Select onValueChange={field.onChange} defaultValue={field.value}>
+                    <Select value={field.value} onValueChange={field.onChange}>
                       <FormControl>
                         <SelectTrigger>
                           <SelectValue placeholder="Select type" />
@@ -159,6 +238,7 @@ export function CreateQuestionDialog({ open, onOpenChange, initialData }: Create
                         <SelectItem value="multiple_choice">Multiple Choice</SelectItem>
                         <SelectItem value="judgment">True/False</SelectItem>
                         <SelectItem value="text">Short Answer</SelectItem>
+                        <SelectItem value="composite">Composite</SelectItem>
                       </SelectContent>
                     </Select>
                     <FormMessage />
@@ -173,8 +253,8 @@ export function CreateQuestionDialog({ open, onOpenChange, initialData }: Create
                   <FormItem>
                     <FormLabel>Difficulty (1-5)</FormLabel>
                     <Select 
+                        value={String(field.value)}
                         onValueChange={(val) => field.onChange(parseInt(val))} 
-                        defaultValue={String(field.value)}
                     >
                       <FormControl>
                         <SelectTrigger>
@@ -219,53 +299,76 @@ export function CreateQuestionDialog({ open, onOpenChange, initialData }: Create
             {(questionType === "single_choice" || questionType === "multiple_choice") && (
               <div className="space-y-4">
                 <div className="flex items-center justify-between">
-                    <FormLabel>Options</FormLabel>
-                    <Button 
-                        type="button" 
-                        variant="outline" 
-                        size="sm"
-                        onClick={() => {
-                            const currentOptions = form.getValues("options") || [];
-                            form.setValue("options", [
-                                ...currentOptions, 
-                                { label: `Option ${String.fromCharCode(65 + currentOptions.length)}`, value: String.fromCharCode(65 + currentOptions.length), isCorrect: false }
-                            ]);
-                        }}
-                    >
-                        <Plus className="mr-2 h-3 w-3" /> Add Option
-                    </Button>
+                  <FormLabel>Options</FormLabel>
+                  <Button
+                    type="button"
+                    variant="outline"
+                    size="sm"
+                    onClick={() => {
+                      const currentOptions = form.getValues("options") || []
+                      const nextIndex = currentOptions.length
+                      const nextChar = nextIndex < 26 ? String.fromCharCode(65 + nextIndex) : String(nextIndex + 1)
+                      form.setValue("options", [
+                        ...currentOptions,
+                        {
+                          label: `Option ${nextChar}`,
+                          value: nextChar,
+                          isCorrect: false,
+                        },
+                      ])
+                    }}
+                  >
+                    <Plus className="mr-2 h-3 w-3" /> Add Option
+                  </Button>
                 </div>
                 
                 <div className="space-y-2">
-                    {form.watch("options")?.map((option, index) => (
-                        <div key={index} className="flex items-center gap-2">
-                            <div className="flex h-8 w-8 items-center justify-center text-muted-foreground">
-                                <GripVertical className="h-4 w-4" />
-                            </div>
-                            <Input 
-                                value={option.label} 
-                                onChange={(e) => {
-                                    const newOptions = [...(form.getValues("options") || [])];
-                                    newOptions[index].label = e.target.value;
-                                    form.setValue("options", newOptions);
-                                }}
-                                placeholder={`Option ${index + 1}`}
-                            />
-                            <Button
-                                type="button"
-                                variant="ghost"
-                                size="icon"
-                                className="text-destructive hover:text-destructive/90"
-                                onClick={() => {
-                                    const newOptions = [...(form.getValues("options") || [])];
-                                    newOptions.splice(index, 1);
-                                    form.setValue("options", newOptions);
-                                }}
-                            >
-                                <Trash2 className="h-4 w-4" />
-                            </Button>
-                        </div>
-                    ))}
+                  {form.watch("options")?.map((option, index) => (
+                    <div key={option.value || index} className="flex items-center gap-2">
+                      <div className="flex h-8 w-8 items-center justify-center text-muted-foreground">
+                        <GripVertical className="h-4 w-4" />
+                      </div>
+                      <Checkbox
+                        checked={option.isCorrect}
+                        onCheckedChange={(checked) => {
+                          const next = [...(form.getValues("options") || [])]
+                          if (!next[index]) return
+
+                          const isChecked = checked === true
+                          if (questionType === "single_choice" && isChecked) {
+                            for (let i = 0; i < next.length; i++) next[i].isCorrect = i === index
+                          } else {
+                            next[index].isCorrect = isChecked
+                          }
+                          form.setValue("options", next)
+                        }}
+                        aria-label="Mark correct"
+                      />
+                      <Input
+                        value={option.label}
+                        onChange={(e) => {
+                          const next = [...(form.getValues("options") || [])]
+                          if (!next[index]) return
+                          next[index].label = e.target.value
+                          form.setValue("options", next)
+                        }}
+                        placeholder={`Option ${index + 1}`}
+                      />
+                      <Button
+                        type="button"
+                        variant="ghost"
+                        size="icon"
+                        className="text-destructive hover:text-destructive/90"
+                        onClick={() => {
+                          const next = [...(form.getValues("options") || [])]
+                          next.splice(index, 1)
+                          form.setValue("options", next)
+                        }}
+                      >
+                        <Trash2 className="h-4 w-4" />
+                      </Button>
+                    </div>
+                  ))}
                 </div>
               </div>
             )}
@@ -275,7 +378,7 @@ export function CreateQuestionDialog({ open, onOpenChange, initialData }: Create
                 Cancel
               </Button>
               <Button type="submit" disabled={isPending}>
-                {isPending ? "Creating..." : "Create Question"}
+                {isPending ? (isEdit ? "Updating..." : "Creating...") : (isEdit ? "Update Question" : "Create Question")}
               </Button>
             </DialogFooter>
           </form>