feat(adaptive-practice): add new adaptive practice module
- Add adaptive practice module with data-access, schema, types, and components - Provides personalized practice based on student performance and error patterns
This commit is contained in:
SpecialX
267
src/modules/adaptive-practice/actions.ts
Normal file
267
src/modules/adaptive-practice/actions.ts
Normal file
@@ -0,0 +1,267 @@
|
|||||||
|
"use server"
|
||||||
|
|
||||||
|
import { revalidatePath } from "next/cache"
|
||||||
|
|
||||||
|
import { requirePermission, PermissionDeniedError } from "@/shared/lib/auth-guard"
|
||||||
|
import { Permissions } from "@/shared/types/permissions"
|
||||||
|
import type { ActionState } from "@/shared/types/action-state"
|
||||||
|
import { handleActionError } from "@/shared/lib/action-utils"
|
||||||
|
|
||||||
|
import {
|
||||||
|
CreatePracticeSessionSchema,
|
||||||
|
SubmitPracticeAnswerSchema,
|
||||||
|
CompletePracticeSessionSchema,
|
||||||
|
AbandonPracticeSessionSchema,
|
||||||
|
} from "./schema"
|
||||||
|
import {
|
||||||
|
createPracticeSession,
|
||||||
|
submitPracticeAnswer,
|
||||||
|
completePracticeSession,
|
||||||
|
abandonPracticeSession,
|
||||||
|
getPracticeSessionById,
|
||||||
|
getPracticeSessions,
|
||||||
|
getPracticeStats,
|
||||||
|
} from "./data-access"
|
||||||
|
import type { PracticeSessionDetail, PracticeSessionSummary, PracticeStats, PracticeSourceMeta } from "./types"
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 查询 Actions
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export async function getPracticeSessionsAction(
|
||||||
|
studentId?: string,
|
||||||
|
): Promise<ActionState<{ data: PracticeSessionSummary[]; total: number }>> {
|
||||||
|
try {
|
||||||
|
const ctx = await requirePermission(Permissions.ADAPTIVE_PRACTICE_READ)
|
||||||
|
|
||||||
|
let targetStudentId = ctx.userId
|
||||||
|
if (studentId && studentId !== ctx.userId) {
|
||||||
|
if (ctx.dataScope.type !== "children" || !ctx.dataScope.childrenIds.includes(studentId)) {
|
||||||
|
throw new PermissionDeniedError(Permissions.ADAPTIVE_PRACTICE_READ)
|
||||||
|
}
|
||||||
|
targetStudentId = studentId
|
||||||
|
} else if (ctx.dataScope.type === "children") {
|
||||||
|
targetStudentId = ctx.dataScope.childrenIds[0] ?? ctx.userId
|
||||||
|
}
|
||||||
|
|
||||||
|
const result = await getPracticeSessions(targetStudentId)
|
||||||
|
return { success: true, data: result }
|
||||||
|
} catch (e) {
|
||||||
|
if (e instanceof PermissionDeniedError) {
|
||||||
|
return { success: false, message: e.message }
|
||||||
|
}
|
||||||
|
const message = e instanceof Error ? e.message : "获取练习列表失败"
|
||||||
|
return { success: false, message }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function getPracticeSessionDetailAction(
|
||||||
|
sessionId: string,
|
||||||
|
studentId?: string,
|
||||||
|
): Promise<ActionState<PracticeSessionDetail>> {
|
||||||
|
try {
|
||||||
|
const ctx = await requirePermission(Permissions.ADAPTIVE_PRACTICE_READ)
|
||||||
|
|
||||||
|
let targetStudentId = ctx.userId
|
||||||
|
if (studentId && studentId !== ctx.userId) {
|
||||||
|
if (ctx.dataScope.type !== "children" || !ctx.dataScope.childrenIds.includes(studentId)) {
|
||||||
|
throw new PermissionDeniedError(Permissions.ADAPTIVE_PRACTICE_READ)
|
||||||
|
}
|
||||||
|
targetStudentId = studentId
|
||||||
|
} else if (ctx.dataScope.type === "children") {
|
||||||
|
targetStudentId = ctx.dataScope.childrenIds[0] ?? ctx.userId
|
||||||
|
}
|
||||||
|
|
||||||
|
const data = await getPracticeSessionById(sessionId, targetStudentId)
|
||||||
|
if (!data) {
|
||||||
|
return { success: false, message: "练习会话不存在或无权访问" }
|
||||||
|
}
|
||||||
|
return { success: true, data }
|
||||||
|
} catch (e) {
|
||||||
|
if (e instanceof PermissionDeniedError) {
|
||||||
|
return { success: false, message: e.message }
|
||||||
|
}
|
||||||
|
const message = e instanceof Error ? e.message : "获取练习详情失败"
|
||||||
|
return { success: false, message }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function getPracticeStatsAction(
|
||||||
|
studentId?: string,
|
||||||
|
): Promise<ActionState<PracticeStats>> {
|
||||||
|
try {
|
||||||
|
const ctx = await requirePermission(Permissions.ADAPTIVE_PRACTICE_READ)
|
||||||
|
|
||||||
|
let targetStudentId = ctx.userId
|
||||||
|
if (studentId && studentId !== ctx.userId) {
|
||||||
|
if (ctx.dataScope.type !== "children" || !ctx.dataScope.childrenIds.includes(studentId)) {
|
||||||
|
throw new PermissionDeniedError(Permissions.ADAPTIVE_PRACTICE_READ)
|
||||||
|
}
|
||||||
|
targetStudentId = studentId
|
||||||
|
} else if (ctx.dataScope.type === "children") {
|
||||||
|
targetStudentId = ctx.dataScope.childrenIds[0] ?? ctx.userId
|
||||||
|
}
|
||||||
|
|
||||||
|
const data = await getPracticeStats(targetStudentId)
|
||||||
|
return { success: true, data }
|
||||||
|
} catch (e) {
|
||||||
|
if (e instanceof PermissionDeniedError) {
|
||||||
|
return { success: false, message: e.message }
|
||||||
|
}
|
||||||
|
const message = e instanceof Error ? e.message : "获取练习统计失败"
|
||||||
|
return { success: false, message }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 写入 Actions
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export async function createPracticeSessionAction(
|
||||||
|
prevState: ActionState<{ sessionId: string; selectedCount: number }> | undefined,
|
||||||
|
formData: FormData,
|
||||||
|
): Promise<ActionState<{ sessionId: string; selectedCount: number }>> {
|
||||||
|
try {
|
||||||
|
const ctx = await requirePermission(Permissions.ADAPTIVE_PRACTICE_MANAGE)
|
||||||
|
|
||||||
|
const jsonString = formData.get("json")
|
||||||
|
if (typeof jsonString !== "string") {
|
||||||
|
return { success: false, message: "提交格式错误，需要 JSON 字段" }
|
||||||
|
}
|
||||||
|
|
||||||
|
const parsed = CreatePracticeSessionSchema.safeParse(JSON.parse(jsonString))
|
||||||
|
if (!parsed.success) {
|
||||||
|
return {
|
||||||
|
success: false,
|
||||||
|
message: "输入验证失败",
|
||||||
|
errors: parsed.error.flatten().fieldErrors,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 从 JSON 解析的 sourceMeta 需要经过 unknown 中间转换
|
||||||
|
// 因为 Zod 的 z.record(z.string(), z.unknown()) 返回 Record<string, unknown>
|
||||||
|
// 而实际运行时结构由前端按练习类型构建，此处做类型收窄
|
||||||
|
const sourceMeta = parsed.data.sourceMeta as unknown as PracticeSourceMeta
|
||||||
|
|
||||||
|
const result = await createPracticeSession(ctx.userId, {
|
||||||
|
practiceType: parsed.data.practiceType,
|
||||||
|
subjectId: parsed.data.subjectId,
|
||||||
|
sourceMeta,
|
||||||
|
questionCount: parsed.data.questionCount,
|
||||||
|
})
|
||||||
|
|
||||||
|
if (result.selectedCount === 0) {
|
||||||
|
return { success: false, message: "未找到符合条件的题目，请尝试其他筛选条件" }
|
||||||
|
}
|
||||||
|
|
||||||
|
revalidatePath("/student/practice")
|
||||||
|
|
||||||
|
return {
|
||||||
|
success: true,
|
||||||
|
message: `已创建练习会话，共 ${result.selectedCount} 道题目`,
|
||||||
|
data: result,
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
return handleActionError(e)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function submitPracticeAnswerAction(
|
||||||
|
prevState: ActionState<{ isCorrect: boolean | null; score: number | null }> | undefined,
|
||||||
|
formData: FormData,
|
||||||
|
): Promise<ActionState<{ isCorrect: boolean | null; score: number | null }>> {
|
||||||
|
try {
|
||||||
|
const ctx = await requirePermission(Permissions.ADAPTIVE_PRACTICE_MANAGE)
|
||||||
|
|
||||||
|
const jsonString = formData.get("json")
|
||||||
|
if (typeof jsonString !== "string") {
|
||||||
|
return { success: false, message: "提交格式错误" }
|
||||||
|
}
|
||||||
|
|
||||||
|
const parsed = SubmitPracticeAnswerSchema.safeParse(JSON.parse(jsonString))
|
||||||
|
if (!parsed.success) {
|
||||||
|
return {
|
||||||
|
success: false,
|
||||||
|
message: "输入验证失败",
|
||||||
|
errors: parsed.error.flatten().fieldErrors,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const { sessionId, answerId, answer, skip } = parsed.data
|
||||||
|
|
||||||
|
const result = await submitPracticeAnswer(
|
||||||
|
sessionId,
|
||||||
|
ctx.userId,
|
||||||
|
answerId,
|
||||||
|
answer,
|
||||||
|
skip ?? false,
|
||||||
|
)
|
||||||
|
|
||||||
|
revalidatePath(`/student/practice/${sessionId}`)
|
||||||
|
|
||||||
|
return {
|
||||||
|
success: true,
|
||||||
|
message: skip ? "已跳过此题" : (result.isCorrect === true ? "回答正确" : result.isCorrect === false ? "回答错误" : "答案已提交"),
|
||||||
|
data: result,
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
return handleActionError(e)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function completePracticeSessionAction(
|
||||||
|
prevState: ActionState<void> | undefined,
|
||||||
|
formData: FormData,
|
||||||
|
): Promise<ActionState<void>> {
|
||||||
|
try {
|
||||||
|
const ctx = await requirePermission(Permissions.ADAPTIVE_PRACTICE_MANAGE)
|
||||||
|
|
||||||
|
const parsed = CompletePracticeSessionSchema.safeParse({
|
||||||
|
sessionId: formData.get("sessionId"),
|
||||||
|
})
|
||||||
|
if (!parsed.success) {
|
||||||
|
return {
|
||||||
|
success: false,
|
||||||
|
message: "输入验证失败",
|
||||||
|
errors: parsed.error.flatten().fieldErrors,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
await completePracticeSession(parsed.data.sessionId, ctx.userId)
|
||||||
|
|
||||||
|
revalidatePath("/student/practice")
|
||||||
|
revalidatePath(`/student/practice/${parsed.data.sessionId}`)
|
||||||
|
|
||||||
|
return { success: true, message: "练习已完成" }
|
||||||
|
} catch (e) {
|
||||||
|
return handleActionError(e)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function abandonPracticeSessionAction(
|
||||||
|
prevState: ActionState<void> | undefined,
|
||||||
|
formData: FormData,
|
||||||
|
): Promise<ActionState<void>> {
|
||||||
|
try {
|
||||||
|
const ctx = await requirePermission(Permissions.ADAPTIVE_PRACTICE_MANAGE)
|
||||||
|
|
||||||
|
const parsed = AbandonPracticeSessionSchema.safeParse({
|
||||||
|
sessionId: formData.get("sessionId"),
|
||||||
|
})
|
||||||
|
if (!parsed.success) {
|
||||||
|
return {
|
||||||
|
success: false,
|
||||||
|
message: "输入验证失败",
|
||||||
|
errors: parsed.error.flatten().fieldErrors,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
await abandonPracticeSession(parsed.data.sessionId, ctx.userId)
|
||||||
|
|
||||||
|
revalidatePath("/student/practice")
|
||||||
|
|
||||||
|
return { success: true, message: "练习已放弃" }
|
||||||
|
} catch (e) {
|
||||||
|
return handleActionError(e)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,144 @@
|
|||||||
|
"use client"
|
||||||
|
|
||||||
|
import { Bar, BarChart, CartesianGrid, XAxis, YAxis, Cell } from "recharts"
|
||||||
|
import { useTranslations } from "next-intl"
|
||||||
|
import { BarChart3 } from "lucide-react"
|
||||||
|
|
||||||
|
import {
|
||||||
|
ChartContainer,
|
||||||
|
ChartTooltip,
|
||||||
|
ChartTooltipContent,
|
||||||
|
type ChartConfig,
|
||||||
|
} from "@/shared/components/ui/chart"
|
||||||
|
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/shared/components/ui/card"
|
||||||
|
import { EmptyState } from "@/shared/components/ui/empty-state"
|
||||||
|
import { cn } from "@/shared/lib/utils"
|
||||||
|
|
||||||
|
import type { ClassKnowledgePointWeakness } from "@/modules/adaptive-practice/data-access-analytics"
|
||||||
|
|
||||||
|
interface ClassKnowledgePointWeaknessChartProps {
|
||||||
|
data: ClassKnowledgePointWeakness[]
|
||||||
|
className?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
const CHART_COLORS = [
|
||||||
|
"var(--color-chart-1)",
|
||||||
|
"var(--color-chart-2)",
|
||||||
|
"var(--color-chart-3)",
|
||||||
|
"var(--color-chart-4)",
|
||||||
|
"var(--color-chart-5)",
|
||||||
|
]
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 班级知识点薄弱度柱状图（教师视图）
|
||||||
|
*
|
||||||
|
* 横轴：知识点名称，纵轴：错误率
|
||||||
|
* tooltip 显示答题数、错题数、错误率
|
||||||
|
*/
|
||||||
|
export function ClassKnowledgePointWeaknessChart({
|
||||||
|
data,
|
||||||
|
className,
|
||||||
|
}: ClassKnowledgePointWeaknessChartProps) {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
|
||||||
|
if (data.length === 0) {
|
||||||
|
return (
|
||||||
|
<Card className={cn("shadow-none", className)}>
|
||||||
|
<CardHeader>
|
||||||
|
<CardTitle className="text-base">{t("teacher.knowledgePointWeakness.title")}</CardTitle>
|
||||||
|
<CardDescription>{t("teacher.knowledgePointWeakness.description")}</CardDescription>
|
||||||
|
</CardHeader>
|
||||||
|
<CardContent>
|
||||||
|
<EmptyState
|
||||||
|
icon={BarChart3}
|
||||||
|
title={t("teacher.knowledgePointWeakness.noData")}
|
||||||
|
description={t("teacher.knowledgePointWeakness.noDataDescription")}
|
||||||
|
className="h-[280px] bg-card"
|
||||||
|
/>
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
const chartData = data.map((d) => ({
|
||||||
|
name: d.knowledgePointName,
|
||||||
|
errorRate: Number((d.errorRate * 100).toFixed(0)),
|
||||||
|
totalAnswers: d.totalAnswers,
|
||||||
|
wrongAnswers: d.wrongAnswers,
|
||||||
|
}))
|
||||||
|
|
||||||
|
const chartConfig: ChartConfig = {
|
||||||
|
errorRate: {
|
||||||
|
label: t("teacher.knowledgePointWeakness.errorRate"),
|
||||||
|
color: "var(--color-chart-1)",
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
<Card className={cn("overflow-hidden shadow-none", className)}>
|
||||||
|
<CardHeader>
|
||||||
|
<CardTitle className="text-base">{t("teacher.knowledgePointWeakness.title")}</CardTitle>
|
||||||
|
<CardDescription>{t("teacher.knowledgePointWeakness.description")}</CardDescription>
|
||||||
|
</CardHeader>
|
||||||
|
<CardContent>
|
||||||
|
<ChartContainer config={chartConfig} className="h-[280px] w-full">
|
||||||
|
<BarChart data={chartData} margin={{ left: 8, right: 8, top: 8, bottom: 8 }}>
|
||||||
|
<CartesianGrid vertical={false} strokeDasharray="4 4" strokeOpacity={0.4} />
|
||||||
|
<XAxis
|
||||||
|
dataKey="name"
|
||||||
|
tickLine={false}
|
||||||
|
axisLine={false}
|
||||||
|
tickMargin={8}
|
||||||
|
tickFormatter={(value: string) =>
|
||||||
|
value.length > 8 ? `${value.slice(0, 8)}...` : value
|
||||||
|
}
|
||||||
|
/>
|
||||||
|
<YAxis
|
||||||
|
tickLine={false}
|
||||||
|
axisLine={false}
|
||||||
|
width={40}
|
||||||
|
tickFormatter={(value: number) => `${value}%`}
|
||||||
|
/>
|
||||||
|
<ChartTooltip
|
||||||
|
content={
|
||||||
|
<ChartTooltipContent
|
||||||
|
className="w-[220px]"
|
||||||
|
formatter={(payload: unknown) => {
|
||||||
|
const p = payload as unknown as {
|
||||||
|
name: string
|
||||||
|
errorRate: number
|
||||||
|
totalAnswers: number
|
||||||
|
wrongAnswers: number
|
||||||
|
}
|
||||||
|
return (
|
||||||
|
<div className="space-y-1.5">
|
||||||
|
<div className="font-medium">{p.name}</div>
|
||||||
|
<div className="text-muted-foreground">
|
||||||
|
{t("teacher.knowledgePointWeakness.totalAnswers")}：
|
||||||
|
<span className="font-medium text-foreground">{p.totalAnswers}</span>
|
||||||
|
</div>
|
||||||
|
<div className="text-muted-foreground">
|
||||||
|
{t("teacher.knowledgePointWeakness.wrongAnswers")}：
|
||||||
|
<span className="font-medium text-rose-600">{p.wrongAnswers}</span>
|
||||||
|
</div>
|
||||||
|
<div className="text-muted-foreground">
|
||||||
|
{t("teacher.knowledgePointWeakness.errorRate")}：
|
||||||
|
<span className="font-medium text-rose-600">{p.errorRate}%</span>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}}
|
||||||
|
/>
|
||||||
|
}
|
||||||
|
/>
|
||||||
|
<Bar dataKey="errorRate" radius={[4, 4, 0, 0]}>
|
||||||
|
{chartData.map((_, idx) => (
|
||||||
|
<Cell key={idx} fill={CHART_COLORS[idx % CHART_COLORS.length]} />
|
||||||
|
))}
|
||||||
|
</Bar>
|
||||||
|
</BarChart>
|
||||||
|
</ChartContainer>
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,88 @@
|
|||||||
|
import { useTranslations } from "next-intl"
|
||||||
|
|
||||||
|
import { Badge } from "@/shared/components/ui/badge"
|
||||||
|
import { Card, CardContent, CardHeader, CardTitle } from "@/shared/components/ui/card"
|
||||||
|
import { Progress } from "@/shared/components/ui/progress"
|
||||||
|
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/shared/components/ui/table"
|
||||||
|
import { cn } from "@/shared/lib/utils"
|
||||||
|
|
||||||
|
import type { TeacherClassPracticeOverview } from "@/modules/adaptive-practice/data-access-analytics"
|
||||||
|
|
||||||
|
interface ClassPracticeComparisonTableProps {
|
||||||
|
data: TeacherClassPracticeOverview[] | import("@/modules/adaptive-practice/data-access-analytics").GradeClassPracticeComparison[]
|
||||||
|
className?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 班级练习对比表格（教师/年级视图）
|
||||||
|
*
|
||||||
|
* 显示每个班级的参与率、练习数、完成数、答题数、正确率。
|
||||||
|
* 支持教师视图（TeacherClassPracticeOverview）和年级视图（GradeClassPracticeComparison）。
|
||||||
|
*/
|
||||||
|
export function ClassPracticeComparisonTable({
|
||||||
|
data,
|
||||||
|
className,
|
||||||
|
}: ClassPracticeComparisonTableProps) {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
|
||||||
|
if (data.length === 0) return null
|
||||||
|
|
||||||
|
return (
|
||||||
|
<Card className={cn("shadow-none", className)}>
|
||||||
|
<CardHeader className="flex flex-row items-center justify-between space-y-0">
|
||||||
|
<CardTitle className="text-base">{t("teacher.classComparison.title")}</CardTitle>
|
||||||
|
<Badge variant="secondary" className="tabular-nums">
|
||||||
|
{data.length}
|
||||||
|
</Badge>
|
||||||
|
</CardHeader>
|
||||||
|
<CardContent>
|
||||||
|
<div className="rounded-md border">
|
||||||
|
{/* 移动端表格水平滚动 */}
|
||||||
|
<div className="overflow-x-auto">
|
||||||
|
<Table>
|
||||||
|
<TableHeader>
|
||||||
|
<TableRow className="bg-muted/50">
|
||||||
|
<TableHead>{t("teacher.classComparison.className")}</TableHead>
|
||||||
|
<TableHead className="text-right">{t("teacher.classComparison.totalStudents")}</TableHead>
|
||||||
|
<TableHead className="text-right">{t("teacher.classComparison.activeStudents")}</TableHead>
|
||||||
|
<TableHead>{t("teacher.classComparison.participationRate")}</TableHead>
|
||||||
|
<TableHead className="text-right">{t("teacher.classComparison.totalSessions")}</TableHead>
|
||||||
|
<TableHead className="text-right">{t("teacher.classComparison.completedSessions")}</TableHead>
|
||||||
|
<TableHead className="text-right">{t("teacher.classComparison.totalAnswered")}</TableHead>
|
||||||
|
<TableHead className="text-right">{t("teacher.classComparison.averageAccuracy")}</TableHead>
|
||||||
|
</TableRow>
|
||||||
|
</TableHeader>
|
||||||
|
<TableBody>
|
||||||
|
{data.map((row) => {
|
||||||
|
const participationPct = Math.round(row.participationRate * 100)
|
||||||
|
const accuracyPct = Math.round(row.averageAccuracy * 100)
|
||||||
|
return (
|
||||||
|
<TableRow key={row.classId}>
|
||||||
|
<TableCell className="font-medium">{row.className}</TableCell>
|
||||||
|
<TableCell className="text-right tabular-nums">{row.totalStudents}</TableCell>
|
||||||
|
<TableCell className="text-right tabular-nums">{row.activeStudents}</TableCell>
|
||||||
|
<TableCell>
|
||||||
|
<div className="flex items-center gap-2">
|
||||||
|
<Progress value={participationPct} className="h-1.5 w-16" />
|
||||||
|
<span className="text-xs text-muted-foreground tabular-nums">{participationPct}%</span>
|
||||||
|
</div>
|
||||||
|
</TableCell>
|
||||||
|
<TableCell className="text-right tabular-nums">{row.totalSessions}</TableCell>
|
||||||
|
<TableCell className="text-right tabular-nums">{row.completedSessions}</TableCell>
|
||||||
|
<TableCell className="text-right tabular-nums">{row.totalQuestionsAnswered}</TableCell>
|
||||||
|
<TableCell className="text-right tabular-nums">
|
||||||
|
<span className={cn(accuracyPct >= 60 ? "text-emerald-600 dark:text-emerald-400" : "text-rose-600 dark:text-rose-400")}>
|
||||||
|
{accuracyPct}%
|
||||||
|
</span>
|
||||||
|
</TableCell>
|
||||||
|
</TableRow>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
</TableBody>
|
||||||
|
</Table>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,64 @@
|
|||||||
|
import { useTranslations } from "next-intl"
|
||||||
|
import { AlertTriangle, CheckCircle2 } from "lucide-react"
|
||||||
|
|
||||||
|
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/shared/components/ui/card"
|
||||||
|
import { Badge } from "@/shared/components/ui/badge"
|
||||||
|
import { cn } from "@/shared/lib/utils"
|
||||||
|
|
||||||
|
interface InactiveStudentsAlertProps {
|
||||||
|
inactiveStudentIds: string[]
|
||||||
|
studentNames: Map<string, string>
|
||||||
|
className?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 未参与练习学生提醒卡片（教师视图）
|
||||||
|
*
|
||||||
|
* 当班级中有学生未参与任何专项练习时，显示提醒列表，
|
||||||
|
* 帮助教师识别需要主动引导的学生。
|
||||||
|
*/
|
||||||
|
export function InactiveStudentsAlert({
|
||||||
|
inactiveStudentIds,
|
||||||
|
studentNames,
|
||||||
|
className,
|
||||||
|
}: InactiveStudentsAlertProps) {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
|
||||||
|
const isEmpty = inactiveStudentIds.length === 0
|
||||||
|
|
||||||
|
return (
|
||||||
|
<Card className={cn("shadow-none", className)}>
|
||||||
|
<CardHeader className="flex flex-row items-center justify-between space-y-0">
|
||||||
|
<div className="space-y-1">
|
||||||
|
<CardTitle className="flex items-center gap-2 text-base">
|
||||||
|
{isEmpty ? (
|
||||||
|
<CheckCircle2 className="h-4 w-4 text-emerald-600 dark:text-emerald-400" />
|
||||||
|
) : (
|
||||||
|
<AlertTriangle className="h-4 w-4 text-amber-600 dark:text-amber-400" />
|
||||||
|
)}
|
||||||
|
{t("teacher.inactiveStudents.title")}
|
||||||
|
</CardTitle>
|
||||||
|
<CardDescription>{t("teacher.inactiveStudents.description")}</CardDescription>
|
||||||
|
</div>
|
||||||
|
<Badge variant={isEmpty ? "secondary" : "destructive"} className="tabular-nums">
|
||||||
|
{inactiveStudentIds.length}
|
||||||
|
</Badge>
|
||||||
|
</CardHeader>
|
||||||
|
<CardContent>
|
||||||
|
{isEmpty ? (
|
||||||
|
<div className="flex h-[120px] items-center justify-center text-sm text-muted-foreground">
|
||||||
|
{t("teacher.inactiveStudents.empty")}
|
||||||
|
</div>
|
||||||
|
) : (
|
||||||
|
<div className="flex flex-wrap gap-2">
|
||||||
|
{inactiveStudentIds.map((studentId) => (
|
||||||
|
<Badge key={studentId} variant="outline" className="text-xs">
|
||||||
|
{studentNames.get(studentId) ?? "Unknown"}
|
||||||
|
</Badge>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,95 @@
|
|||||||
|
"use client"
|
||||||
|
|
||||||
|
import { useTranslations } from "next-intl"
|
||||||
|
import Link from "next/link"
|
||||||
|
import { Target, Clock, CheckCircle2, XCircle } from "lucide-react"
|
||||||
|
|
||||||
|
import { Card, CardContent } from "@/shared/components/ui/card"
|
||||||
|
import { Badge } from "@/shared/components/ui/badge"
|
||||||
|
import { Progress } from "@/shared/components/ui/progress"
|
||||||
|
import { formatDate } from "@/shared/lib/utils"
|
||||||
|
|
||||||
|
import type { PracticeSessionSummary, PracticeStatus } from "../types"
|
||||||
|
|
||||||
|
interface PracticeHistoryProps {
|
||||||
|
sessions: PracticeSessionSummary[]
|
||||||
|
}
|
||||||
|
|
||||||
|
const STATUS_VARIANTS: Record<PracticeStatus, "default" | "secondary" | "outline"> = {
|
||||||
|
in_progress: "default",
|
||||||
|
completed: "secondary",
|
||||||
|
abandoned: "outline",
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 专项练习历史列表
|
||||||
|
*/
|
||||||
|
export function PracticeHistory({ sessions }: PracticeHistoryProps): React.ReactNode {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
|
||||||
|
if (sessions.length === 0) {
|
||||||
|
return (
|
||||||
|
<Card>
|
||||||
|
<CardContent className="py-12 text-center text-muted-foreground">
|
||||||
|
<Target className="mx-auto mb-2 h-8 w-8 opacity-50" />
|
||||||
|
{t("history.empty")}
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="space-y-3">
|
||||||
|
{sessions.map((session) => {
|
||||||
|
const accuracy = session.answeredQuestions > 0
|
||||||
|
? Math.round((session.correctCount / session.answeredQuestions) * 100)
|
||||||
|
: 0
|
||||||
|
const progress = session.totalQuestions > 0
|
||||||
|
? (session.answeredQuestions / session.totalQuestions) * 100
|
||||||
|
: 0
|
||||||
|
|
||||||
|
return (
|
||||||
|
<Link key={session.id} href={`/student/practice/${session.id}`}>
|
||||||
|
<Card className="transition-colors hover:bg-muted/30">
|
||||||
|
<CardContent className="p-4">
|
||||||
|
<div className="flex items-center justify-between gap-3">
|
||||||
|
<div className="flex-1 space-y-1">
|
||||||
|
<div className="flex items-center gap-2">
|
||||||
|
<Badge variant={STATUS_VARIANTS[session.status]}>
|
||||||
|
{t(`status.${session.status}`)}
|
||||||
|
</Badge>
|
||||||
|
<Badge variant="outline">
|
||||||
|
{t(`types.${session.practiceType}`)}
|
||||||
|
</Badge>
|
||||||
|
</div>
|
||||||
|
<div className="flex items-center gap-3 text-xs text-muted-foreground">
|
||||||
|
<span className="flex items-center gap-1">
|
||||||
|
<Clock className="h-3 w-3" />
|
||||||
|
{formatDate(session.startedAt)}
|
||||||
|
</span>
|
||||||
|
<span className="flex items-center gap-1">
|
||||||
|
<CheckCircle2 className="h-3 w-3 text-emerald-500" />
|
||||||
|
{session.correctCount}
|
||||||
|
</span>
|
||||||
|
<span className="flex items-center gap-1">
|
||||||
|
<XCircle className="h-3 w-3 text-rose-500" />
|
||||||
|
{session.answeredQuestions - session.correctCount}
|
||||||
|
</span>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div className="text-right">
|
||||||
|
<div className="text-lg font-bold">{accuracy}%</div>
|
||||||
|
<div className="text-xs text-muted-foreground">
|
||||||
|
{session.answeredQuestions}/{session.totalQuestions}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<Progress value={progress} className="mt-2 h-1" />
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
</Link>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,99 @@
|
|||||||
|
import { Activity, BookOpen, CheckCircle2, Target, Users } from "lucide-react"
|
||||||
|
import { useTranslations } from "next-intl"
|
||||||
|
|
||||||
|
import { Card, CardContent } from "@/shared/components/ui/card"
|
||||||
|
import { cn } from "@/shared/lib/utils"
|
||||||
|
|
||||||
|
interface PracticeOverviewStatsCardsProps {
|
||||||
|
totalClasses: number
|
||||||
|
totalSessions: number
|
||||||
|
totalAnswered: number
|
||||||
|
averageAccuracy: number
|
||||||
|
participationRate: number
|
||||||
|
className?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 专项练习概览统计卡片（教师视图）
|
||||||
|
*
|
||||||
|
* 5 个卡片：覆盖班级 / 练习总数 / 答题总数 / 平均正确率 / 参与率
|
||||||
|
*/
|
||||||
|
export function PracticeOverviewStatsCards({
|
||||||
|
totalClasses,
|
||||||
|
totalSessions,
|
||||||
|
totalAnswered,
|
||||||
|
averageAccuracy,
|
||||||
|
participationRate,
|
||||||
|
className,
|
||||||
|
}: PracticeOverviewStatsCardsProps) {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
|
||||||
|
const cards = [
|
||||||
|
{
|
||||||
|
label: t("teacher.overview.totalClasses"),
|
||||||
|
value: totalClasses,
|
||||||
|
sub: "",
|
||||||
|
icon: BookOpen,
|
||||||
|
color: "text-blue-600 dark:text-blue-400",
|
||||||
|
bg: "bg-blue-50 dark:bg-blue-950/30",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
label: t("teacher.overview.totalSessions"),
|
||||||
|
value: totalSessions,
|
||||||
|
sub: "",
|
||||||
|
icon: Activity,
|
||||||
|
color: "text-purple-600 dark:text-purple-400",
|
||||||
|
bg: "bg-purple-50 dark:bg-purple-950/30",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
label: t("teacher.overview.totalAnswered"),
|
||||||
|
value: totalAnswered,
|
||||||
|
sub: "",
|
||||||
|
icon: Target,
|
||||||
|
color: "text-amber-600 dark:text-amber-400",
|
||||||
|
bg: "bg-amber-50 dark:bg-amber-950/30",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
label: t("teacher.overview.averageAccuracy"),
|
||||||
|
value: `${Math.round(averageAccuracy * 100)}%`,
|
||||||
|
sub: averageAccuracy >= 0.6 ? "" : "",
|
||||||
|
icon: CheckCircle2,
|
||||||
|
color: "text-emerald-600 dark:text-emerald-400",
|
||||||
|
bg: "bg-emerald-50 dark:bg-emerald-950/30",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
label: t("teacher.overview.participationRate"),
|
||||||
|
value: `${Math.round(participationRate * 100)}%`,
|
||||||
|
sub: participationRate >= 0.5 ? "" : "",
|
||||||
|
icon: Users,
|
||||||
|
color: "text-rose-600 dark:text-rose-400",
|
||||||
|
bg: "bg-rose-50 dark:bg-rose-950/30",
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className={cn("grid gap-3 sm:grid-cols-2 lg:grid-cols-5", className)}>
|
||||||
|
{cards.map((card) => {
|
||||||
|
const Icon = card.icon
|
||||||
|
return (
|
||||||
|
<Card key={card.label} className="overflow-hidden">
|
||||||
|
<CardContent className="p-4">
|
||||||
|
<div className="flex items-start justify-between">
|
||||||
|
<div className="min-w-0 flex-1">
|
||||||
|
<div className="text-xs text-muted-foreground">{card.label}</div>
|
||||||
|
<div className={cn("mt-1 text-2xl font-bold tabular-nums", card.color)}>
|
||||||
|
{card.value}
|
||||||
|
</div>
|
||||||
|
{card.sub ? <div className="mt-0.5 text-xs text-muted-foreground">{card.sub}</div> : null}
|
||||||
|
</div>
|
||||||
|
<div className={cn("rounded-lg p-2", card.bg)}>
|
||||||
|
<Icon className={cn("h-4 w-4", card.color)} />
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,550 @@
|
|||||||
|
"use client"
|
||||||
|
|
||||||
|
import { useState, useTransition, useMemo } from "react"
|
||||||
|
import { useRouter } from "next/navigation"
|
||||||
|
import { useTranslations } from "next-intl"
|
||||||
|
import { CheckCircle2, XCircle, ChevronLeft, ChevronRight, Flag, Trophy } from "lucide-react"
|
||||||
|
import { toast } from "sonner"
|
||||||
|
|
||||||
|
import { Button } from "@/shared/components/ui/button"
|
||||||
|
import { Card, CardContent, CardHeader, CardTitle } from "@/shared/components/ui/card"
|
||||||
|
import { Progress } from "@/shared/components/ui/progress"
|
||||||
|
import { Badge } from "@/shared/components/ui/badge"
|
||||||
|
import { RadioGroup, RadioGroupItem } from "@/shared/components/ui/radio-group"
|
||||||
|
import { Label } from "@/shared/components/ui/label"
|
||||||
|
import { Checkbox } from "@/shared/components/ui/checkbox"
|
||||||
|
import {
|
||||||
|
AlertDialog,
|
||||||
|
AlertDialogAction,
|
||||||
|
AlertDialogCancel,
|
||||||
|
AlertDialogContent,
|
||||||
|
AlertDialogDescription,
|
||||||
|
AlertDialogFooter,
|
||||||
|
AlertDialogHeader,
|
||||||
|
AlertDialogTitle,
|
||||||
|
AlertDialogTrigger,
|
||||||
|
} from "@/shared/components/ui/alert-dialog"
|
||||||
|
|
||||||
|
import { submitPracticeAnswerAction, completePracticeSessionAction, abandonPracticeSessionAction } from "../actions"
|
||||||
|
import type { PracticeSessionDetail, PracticeAnswerRecord } from "../types"
|
||||||
|
|
||||||
|
interface PracticeSessionViewProps {
|
||||||
|
session: PracticeSessionDetail
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 专项练习答题界面
|
||||||
|
*
|
||||||
|
* 功能：
|
||||||
|
* 1. 逐题作答，支持上一题/下一题导航
|
||||||
|
* 2. 自动判分（选择题/判断题）
|
||||||
|
* 3. 跳过题目
|
||||||
|
* 4. 完成练习后展示结果摘要
|
||||||
|
*/
|
||||||
|
export function PracticeSessionView({ session }: PracticeSessionViewProps): React.ReactNode {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
const router = useRouter()
|
||||||
|
const [isPending, startTransition] = useTransition()
|
||||||
|
const [currentIndex, setCurrentIndex] = useState(0)
|
||||||
|
const [answers, setAnswers] = useState<Record<string, unknown>>({})
|
||||||
|
const [results, setResults] = useState<Record<string, { isCorrect: boolean | null; score: number | null }>>({})
|
||||||
|
|
||||||
|
const answersList = session.answers
|
||||||
|
const total = answersList.length
|
||||||
|
const current = answersList[currentIndex]
|
||||||
|
const progress = total > 0 ? ((currentIndex + 1) / total) * 100 : 0
|
||||||
|
|
||||||
|
// 已答题数和正确数
|
||||||
|
const answeredCount = useMemo(
|
||||||
|
() => answersList.filter((a) => a.status === "answered" || a.status === "skipped").length,
|
||||||
|
[answersList],
|
||||||
|
)
|
||||||
|
const correctCount = useMemo(
|
||||||
|
() => answersList.filter((a) => a.isCorrect === true).length,
|
||||||
|
[answersList],
|
||||||
|
)
|
||||||
|
|
||||||
|
if (session.status !== "in_progress") {
|
||||||
|
return <PracticeResultView session={session} />
|
||||||
|
}
|
||||||
|
|
||||||
|
if (total === 0) {
|
||||||
|
return (
|
||||||
|
<Card>
|
||||||
|
<CardContent className="py-12 text-center text-muted-foreground">
|
||||||
|
{t("session.empty")}
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
function handleSubmit(answer: unknown, skip: boolean = false): void {
|
||||||
|
if (!current) return
|
||||||
|
|
||||||
|
startTransition(async () => {
|
||||||
|
const formData = new FormData()
|
||||||
|
formData.append(
|
||||||
|
"json",
|
||||||
|
JSON.stringify({
|
||||||
|
sessionId: session.id,
|
||||||
|
answerId: current.id,
|
||||||
|
answer,
|
||||||
|
skip,
|
||||||
|
}),
|
||||||
|
)
|
||||||
|
const res = await submitPracticeAnswerAction(undefined, formData)
|
||||||
|
if (res.success && res.data) {
|
||||||
|
setResults((prev) => ({ ...prev, [current.id]: res.data! }))
|
||||||
|
toast.success(res.message ?? t("toasts.submitted"))
|
||||||
|
// 自动跳到下一题
|
||||||
|
if (currentIndex < total - 1) {
|
||||||
|
setCurrentIndex(currentIndex + 1)
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
toast.error(res.message ?? t("toasts.submitFailed"))
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
function handleComplete(): void {
|
||||||
|
startTransition(async () => {
|
||||||
|
const formData = new FormData()
|
||||||
|
formData.append("sessionId", session.id)
|
||||||
|
const res = await completePracticeSessionAction(undefined, formData)
|
||||||
|
if (res.success) {
|
||||||
|
toast.success(res.message ?? t("toasts.completed"))
|
||||||
|
router.refresh()
|
||||||
|
} else {
|
||||||
|
toast.error(res.message ?? t("toasts.completeFailed"))
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
function handleAbandon(): void {
|
||||||
|
startTransition(async () => {
|
||||||
|
const formData = new FormData()
|
||||||
|
formData.append("sessionId", session.id)
|
||||||
|
const res = await abandonPracticeSessionAction(undefined, formData)
|
||||||
|
if (res.success) {
|
||||||
|
toast.success(res.message ?? t("toasts.abandoned"))
|
||||||
|
router.push("/student/practice")
|
||||||
|
} else {
|
||||||
|
toast.error(res.message ?? t("toasts.abandonFailed"))
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
const currentResult = current ? results[current.id] : undefined
|
||||||
|
const isAnswered = current?.status === "answered" || current?.status === "skipped"
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="space-y-6">
|
||||||
|
{/* 顶部进度条 */}
|
||||||
|
<Card>
|
||||||
|
<CardHeader>
|
||||||
|
<div className="flex items-center justify-between">
|
||||||
|
<CardTitle className="text-lg">
|
||||||
|
{t("session.progress")}: {currentIndex + 1} / {total}
|
||||||
|
</CardTitle>
|
||||||
|
<div className="flex items-center gap-3 text-sm text-muted-foreground">
|
||||||
|
<span className="flex items-center gap-1">
|
||||||
|
<CheckCircle2 className="h-4 w-4 text-emerald-500" />
|
||||||
|
{correctCount}
|
||||||
|
</span>
|
||||||
|
<span>{answeredCount}/{total}</span>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<Progress value={progress} className="mt-2" />
|
||||||
|
</CardHeader>
|
||||||
|
</Card>
|
||||||
|
|
||||||
|
{/* 题目内容 */}
|
||||||
|
{current ? (
|
||||||
|
<QuestionCard
|
||||||
|
answer={current}
|
||||||
|
index={currentIndex}
|
||||||
|
total={total}
|
||||||
|
userAnswer={answers[current.id]}
|
||||||
|
onAnswerChange={(ans) => setAnswers((prev) => ({ ...prev, [current.id]: ans }))}
|
||||||
|
onSubmit={(ans) => handleSubmit(ans)}
|
||||||
|
onSkip={() => handleSubmit(null, true)}
|
||||||
|
isAnswered={isAnswered}
|
||||||
|
result={currentResult}
|
||||||
|
isPending={isPending}
|
||||||
|
/>
|
||||||
|
) : null}
|
||||||
|
|
||||||
|
{/* 底部导航 */}
|
||||||
|
<div className="flex items-center justify-between">
|
||||||
|
<Button
|
||||||
|
variant="outline"
|
||||||
|
onClick={() => setCurrentIndex(Math.max(0, currentIndex - 1))}
|
||||||
|
disabled={currentIndex === 0}
|
||||||
|
>
|
||||||
|
<ChevronLeft className="h-4 w-4" />
|
||||||
|
{t("session.previous")}
|
||||||
|
</Button>
|
||||||
|
|
||||||
|
<div className="flex gap-2">
|
||||||
|
<AlertDialog>
|
||||||
|
<AlertDialogTrigger asChild>
|
||||||
|
<Button variant="ghost" size="sm">
|
||||||
|
<Flag className="h-4 w-4" />
|
||||||
|
{t("session.abandon")}
|
||||||
|
</Button>
|
||||||
|
</AlertDialogTrigger>
|
||||||
|
<AlertDialogContent>
|
||||||
|
<AlertDialogHeader>
|
||||||
|
<AlertDialogTitle>{t("session.abandonConfirm")}</AlertDialogTitle>
|
||||||
|
<AlertDialogDescription>{t("session.abandonDescription")}</AlertDialogDescription>
|
||||||
|
</AlertDialogHeader>
|
||||||
|
<AlertDialogFooter>
|
||||||
|
<AlertDialogCancel>{t("session.cancel")}</AlertDialogCancel>
|
||||||
|
<AlertDialogAction onClick={handleAbandon} disabled={isPending}>
|
||||||
|
{t("session.confirmAbandon")}
|
||||||
|
</AlertDialogAction>
|
||||||
|
</AlertDialogFooter>
|
||||||
|
</AlertDialogContent>
|
||||||
|
</AlertDialog>
|
||||||
|
|
||||||
|
{currentIndex < total - 1 ? (
|
||||||
|
<Button
|
||||||
|
variant="outline"
|
||||||
|
onClick={() => setCurrentIndex(currentIndex + 1)}
|
||||||
|
>
|
||||||
|
{t("session.next")}
|
||||||
|
<ChevronRight className="h-4 w-4" />
|
||||||
|
</Button>
|
||||||
|
) : (
|
||||||
|
<Button onClick={handleComplete} disabled={isPending || answeredCount < total}>
|
||||||
|
<Trophy className="h-4 w-4" />
|
||||||
|
{t("session.complete")}
|
||||||
|
</Button>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 题目卡片
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
interface QuestionCardProps {
|
||||||
|
answer: PracticeAnswerRecord
|
||||||
|
index: number
|
||||||
|
total: number
|
||||||
|
userAnswer: unknown
|
||||||
|
onAnswerChange: (answer: unknown) => void
|
||||||
|
onSubmit: (answer: unknown) => void
|
||||||
|
onSkip: () => void
|
||||||
|
isAnswered: boolean
|
||||||
|
result?: { isCorrect: boolean | null; score: number | null }
|
||||||
|
isPending: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
function QuestionCard({
|
||||||
|
answer,
|
||||||
|
index,
|
||||||
|
total,
|
||||||
|
userAnswer,
|
||||||
|
onAnswerChange,
|
||||||
|
onSubmit,
|
||||||
|
onSkip,
|
||||||
|
isAnswered,
|
||||||
|
result,
|
||||||
|
isPending,
|
||||||
|
}: QuestionCardProps): React.ReactNode {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
|
||||||
|
const question = answer.question
|
||||||
|
const content = answer.variantContent ?? question?.content
|
||||||
|
const questionType = question?.type ?? "unknown"
|
||||||
|
|
||||||
|
return (
|
||||||
|
<Card>
|
||||||
|
<CardHeader>
|
||||||
|
<div className="flex items-center justify-between">
|
||||||
|
<CardTitle className="text-base">
|
||||||
|
{t("session.question")} {index + 1}/{total}
|
||||||
|
</CardTitle>
|
||||||
|
<div className="flex items-center gap-2">
|
||||||
|
<Badge variant="outline">{questionType}</Badge>
|
||||||
|
{question?.difficulty ? (
|
||||||
|
<Badge variant="secondary">
|
||||||
|
{t("session.difficulty")}: {question.difficulty}
|
||||||
|
</Badge>
|
||||||
|
) : null}
|
||||||
|
{answer.isVariant ? (
|
||||||
|
<Badge variant="default">{t("session.variant")}</Badge>
|
||||||
|
) : null}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</CardHeader>
|
||||||
|
<CardContent className="space-y-4">
|
||||||
|
{/* 题目内容 */}
|
||||||
|
<div className="rounded-md border bg-muted/30 p-4 text-sm">
|
||||||
|
<pre className="whitespace-pre-wrap break-words font-sans">
|
||||||
|
{typeof content === "string"
|
||||||
|
? content
|
||||||
|
: JSON.stringify(content, null, 2)}
|
||||||
|
</pre>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* 作答区域 */}
|
||||||
|
{!isAnswered ? (
|
||||||
|
<AnswerInput
|
||||||
|
questionType={questionType}
|
||||||
|
content={content}
|
||||||
|
userAnswer={userAnswer}
|
||||||
|
onAnswerChange={onAnswerChange}
|
||||||
|
/>
|
||||||
|
) : (
|
||||||
|
<AnswerResult
|
||||||
|
answer={answer}
|
||||||
|
result={result}
|
||||||
|
/>
|
||||||
|
)}
|
||||||
|
|
||||||
|
{/* 操作按钮 */}
|
||||||
|
{!isAnswered ? (
|
||||||
|
<div className="flex justify-end gap-2">
|
||||||
|
<Button variant="ghost" onClick={onSkip} disabled={isPending}>
|
||||||
|
{t("session.skip")}
|
||||||
|
</Button>
|
||||||
|
<Button onClick={() => onSubmit(userAnswer)} disabled={isPending || userAnswer === undefined}>
|
||||||
|
{isPending ? t("session.submitting") : t("session.submit")}
|
||||||
|
</Button>
|
||||||
|
</div>
|
||||||
|
) : null}
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 答题输入组件
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
interface AnswerInputProps {
|
||||||
|
questionType: string
|
||||||
|
content: unknown
|
||||||
|
userAnswer: unknown
|
||||||
|
onAnswerChange: (answer: unknown) => void
|
||||||
|
}
|
||||||
|
|
||||||
|
function AnswerInput({ questionType, content, userAnswer, onAnswerChange }: AnswerInputProps): React.ReactNode {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
|
||||||
|
if (questionType === "single_choice") {
|
||||||
|
const options = extractOptions(content)
|
||||||
|
const selectedId = typeof userAnswer === "string" ? userAnswer : ""
|
||||||
|
|
||||||
|
return (
|
||||||
|
<RadioGroup value={selectedId} onValueChange={onAnswerChange}>
|
||||||
|
<div className="space-y-2">
|
||||||
|
{options.map((opt) => (
|
||||||
|
<div key={opt.id} className="flex items-center space-x-2">
|
||||||
|
<RadioGroupItem value={opt.id} id={opt.id} />
|
||||||
|
<Label htmlFor={opt.id}>{opt.text}</Label>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
</RadioGroup>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (questionType === "multiple_choice") {
|
||||||
|
const options = extractOptions(content)
|
||||||
|
const selectedIds = Array.isArray(userAnswer) ? userAnswer as string[] : []
|
||||||
|
|
||||||
|
function toggle(id: string): void {
|
||||||
|
const newIds = selectedIds.includes(id)
|
||||||
|
? selectedIds.filter((v) => v !== id)
|
||||||
|
: [...selectedIds, id]
|
||||||
|
onAnswerChange(newIds)
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="space-y-2">
|
||||||
|
{options.map((opt) => (
|
||||||
|
<div key={opt.id} className="flex items-center space-x-2">
|
||||||
|
<Checkbox
|
||||||
|
checked={selectedIds.includes(opt.id)}
|
||||||
|
onCheckedChange={() => toggle(opt.id)}
|
||||||
|
id={opt.id}
|
||||||
|
/>
|
||||||
|
<Label htmlFor={opt.id}>{opt.text}</Label>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (questionType === "judgment") {
|
||||||
|
const value = typeof userAnswer === "string" ? userAnswer : ""
|
||||||
|
|
||||||
|
return (
|
||||||
|
<RadioGroup value={value} onValueChange={onAnswerChange}>
|
||||||
|
<div className="space-y-2">
|
||||||
|
<div className="flex items-center space-x-2">
|
||||||
|
<RadioGroupItem value="true" id="judgment-true" />
|
||||||
|
<Label htmlFor="judgment-true">{t("session.true")}</Label>
|
||||||
|
</div>
|
||||||
|
<div className="flex items-center space-x-2">
|
||||||
|
<RadioGroupItem value="false" id="judgment-false" />
|
||||||
|
<Label htmlFor="judgment-false">{t("session.false")}</Label>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</RadioGroup>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// text 题型
|
||||||
|
return (
|
||||||
|
<textarea
|
||||||
|
value={typeof userAnswer === "string" ? userAnswer : ""}
|
||||||
|
onChange={(e) => onAnswerChange(e.target.value)}
|
||||||
|
placeholder={t("session.textPlaceholder")}
|
||||||
|
className="w-full min-h-[120px] rounded-md border bg-background p-3 text-sm resize-y focus:outline-none focus:ring-2 focus:ring-ring"
|
||||||
|
/>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 答题结果展示
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
interface AnswerResultProps {
|
||||||
|
answer: PracticeAnswerRecord
|
||||||
|
result?: { isCorrect: boolean | null; score: number | null }
|
||||||
|
}
|
||||||
|
|
||||||
|
function AnswerResult({ answer, result }: AnswerResultProps): React.ReactNode {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
const isCorrect = result?.isCorrect ?? answer.isCorrect
|
||||||
|
const isSkipped = answer.status === "skipped"
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="space-y-3">
|
||||||
|
{/* 判分结果 */}
|
||||||
|
{isSkipped ? (
|
||||||
|
<div className="rounded-md border border-muted bg-muted/30 p-3 text-sm text-muted-foreground">
|
||||||
|
{t("session.skipped")}
|
||||||
|
</div>
|
||||||
|
) : isCorrect === true ? (
|
||||||
|
<div className="flex items-center gap-2 rounded-md border border-emerald-200 bg-emerald-50/50 p-3 text-sm text-emerald-700 dark:border-emerald-900 dark:bg-emerald-950/20 dark:text-emerald-400">
|
||||||
|
<CheckCircle2 className="h-5 w-5" />
|
||||||
|
{t("session.correct")}
|
||||||
|
</div>
|
||||||
|
) : isCorrect === false ? (
|
||||||
|
<div className="flex items-center gap-2 rounded-md border border-rose-200 bg-rose-50/50 p-3 text-sm text-rose-700 dark:border-rose-900 dark:bg-rose-950/20 dark:text-rose-400">
|
||||||
|
<XCircle className="h-5 w-5" />
|
||||||
|
{t("session.incorrect")}
|
||||||
|
</div>
|
||||||
|
) : (
|
||||||
|
<div className="rounded-md border border-amber-200 bg-amber-50/50 p-3 text-sm text-amber-700 dark:border-amber-900 dark:bg-amber-950/20 dark:text-amber-400">
|
||||||
|
{t("session.pendingReview")}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
|
||||||
|
{/* 学生答案 */}
|
||||||
|
{answer.studentAnswer !== null && answer.studentAnswer !== undefined ? (
|
||||||
|
<div>
|
||||||
|
<h4 className="mb-1 text-sm font-medium">{t("session.yourAnswer")}</h4>
|
||||||
|
<pre className="whitespace-pre-wrap break-words rounded-md border bg-muted/30 p-2 text-xs font-sans">
|
||||||
|
{typeof answer.studentAnswer === "string"
|
||||||
|
? answer.studentAnswer
|
||||||
|
: JSON.stringify(answer.studentAnswer, null, 2)}
|
||||||
|
</pre>
|
||||||
|
</div>
|
||||||
|
) : null}
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 练习结果视图
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
function PracticeResultView({ session }: { session: PracticeSessionDetail }): React.ReactNode {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
|
||||||
|
const total = session.totalQuestions
|
||||||
|
const answered = session.answeredQuestions
|
||||||
|
const correct = session.correctCount
|
||||||
|
const accuracy = answered > 0 ? Math.round((correct / answered) * 100) : 0
|
||||||
|
|
||||||
|
return (
|
||||||
|
<Card>
|
||||||
|
<CardHeader>
|
||||||
|
<CardTitle className="flex items-center gap-2">
|
||||||
|
<Trophy className="h-5 w-5 text-amber-500" />
|
||||||
|
{t("result.title")}
|
||||||
|
</CardTitle>
|
||||||
|
</CardHeader>
|
||||||
|
<CardContent className="space-y-4">
|
||||||
|
<div className="grid grid-cols-3 gap-4">
|
||||||
|
<div className="rounded-md border p-4 text-center">
|
||||||
|
<div className="text-2xl font-bold">{answered}</div>
|
||||||
|
<div className="text-xs text-muted-foreground">{t("result.answered")}</div>
|
||||||
|
</div>
|
||||||
|
<div className="rounded-md border p-4 text-center">
|
||||||
|
<div className="text-2xl font-bold text-emerald-600">{correct}</div>
|
||||||
|
<div className="text-xs text-muted-foreground">{t("result.correct")}</div>
|
||||||
|
</div>
|
||||||
|
<div className="rounded-md border p-4 text-center">
|
||||||
|
<div className="text-2xl font-bold">{accuracy}%</div>
|
||||||
|
<div className="text-xs text-muted-foreground">{t("result.accuracy")}</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* 逐题回顾 */}
|
||||||
|
<div className="space-y-2">
|
||||||
|
<h4 className="text-sm font-medium">{t("result.review")}</h4>
|
||||||
|
{session.answers.map((a, idx) => (
|
||||||
|
<div
|
||||||
|
key={a.id}
|
||||||
|
className="flex items-center justify-between rounded-md border px-3 py-2 text-sm"
|
||||||
|
>
|
||||||
|
<span className="flex items-center gap-2">
|
||||||
|
{a.isCorrect === true ? (
|
||||||
|
<CheckCircle2 className="h-4 w-4 text-emerald-500" />
|
||||||
|
) : a.isCorrect === false ? (
|
||||||
|
<XCircle className="h-4 w-4 text-rose-500" />
|
||||||
|
) : (
|
||||||
|
<span className="text-muted-foreground">—</span>
|
||||||
|
)}
|
||||||
|
{t("session.question")} {idx + 1}
|
||||||
|
</span>
|
||||||
|
<Badge variant="outline">
|
||||||
|
{a.status === "answered" ? (a.isCorrect === true ? t("session.correct") : a.isCorrect === false ? t("session.incorrect") : t("session.pendingReview")) : t("session.skipped")}
|
||||||
|
</Badge>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 辅助函数
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
function extractOptions(content: unknown): Array<{ id: string; text: string }> {
|
||||||
|
if (typeof content !== "object" || content === null) return []
|
||||||
|
const record = content as Record<string, unknown>
|
||||||
|
const options = record.options
|
||||||
|
if (!Array.isArray(options)) return []
|
||||||
|
|
||||||
|
return options
|
||||||
|
.filter((opt): opt is Record<string, unknown> =>
|
||||||
|
typeof opt === "object" && opt !== null && typeof opt.id === "string",
|
||||||
|
)
|
||||||
|
.map((opt) => ({
|
||||||
|
id: opt.id as string,
|
||||||
|
text: typeof opt.text === "string" ? opt.text : String(opt.text ?? ""),
|
||||||
|
}))
|
||||||
|
}
|
||||||
263
src/modules/adaptive-practice/components/practice-starter.tsx
Normal file
263
src/modules/adaptive-practice/components/practice-starter.tsx
Normal file
@@ -0,0 +1,263 @@
|
|||||||
|
"use client"
|
||||||
|
|
||||||
|
import { useState, useTransition } from "react"
|
||||||
|
import { useRouter } from "next/navigation"
|
||||||
|
import { useTranslations } from "next-intl"
|
||||||
|
import { Target, BookOpen, AlertCircle, Sparkles } from "lucide-react"
|
||||||
|
import { toast } from "sonner"
|
||||||
|
|
||||||
|
import { Button } from "@/shared/components/ui/button"
|
||||||
|
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/shared/components/ui/card"
|
||||||
|
import { Label } from "@/shared/components/ui/label"
|
||||||
|
import {
|
||||||
|
Select,
|
||||||
|
SelectContent,
|
||||||
|
SelectItem,
|
||||||
|
SelectTrigger,
|
||||||
|
SelectValue,
|
||||||
|
} from "@/shared/components/ui/select"
|
||||||
|
|
||||||
|
import { createPracticeSessionAction } from "../actions"
|
||||||
|
import type { PracticeType } from "../types"
|
||||||
|
|
||||||
|
interface PracticeStarterProps {
|
||||||
|
/** 知识点选项列表 */
|
||||||
|
knowledgePoints: Array<{ id: string; name: string }>
|
||||||
|
/** 预设模式（从错题本发起时传入） */
|
||||||
|
presetMode?: {
|
||||||
|
type: PracticeType
|
||||||
|
sourceMeta: Record<string, unknown>
|
||||||
|
subjectId?: string
|
||||||
|
}
|
||||||
|
/** 是否禁用类型选择（预设模式时） */
|
||||||
|
lockType?: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
const QUESTION_COUNT_OPTIONS = [5, 10, 15, 20, 30] as const
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 专项练习发起器
|
||||||
|
*
|
||||||
|
* 支持四种练习模式：
|
||||||
|
* 1. 错题变式练习：从错题本发起
|
||||||
|
* 2. 知识点专项：选择知识点后抽题
|
||||||
|
* 3. 薄弱章节：自动识别薄弱知识点
|
||||||
|
* 4. AI 推荐：AI 根据学情推荐
|
||||||
|
*/
|
||||||
|
export function PracticeStarter({ knowledgePoints, presetMode, lockType }: PracticeStarterProps): React.ReactNode {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
const router = useRouter()
|
||||||
|
const [isPending, startTransition] = useTransition()
|
||||||
|
|
||||||
|
const [practiceType, setPracticeType] = useState<PracticeType>(
|
||||||
|
presetMode?.type ?? "knowledge_point",
|
||||||
|
)
|
||||||
|
const [selectedKpIds, setSelectedKpIds] = useState<string[]>([])
|
||||||
|
const [questionCount, setQuestionCount] = useState<number>(10)
|
||||||
|
const [difficulty, setDifficulty] = useState<number>(0)
|
||||||
|
|
||||||
|
function toggleKp(kpId: string): void {
|
||||||
|
setSelectedKpIds((prev) =>
|
||||||
|
prev.includes(kpId) ? prev.filter((id) => id !== kpId) : [...prev, kpId],
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
function handleStart(): void {
|
||||||
|
if (presetMode) {
|
||||||
|
// 预设模式：直接使用传入的 sourceMeta
|
||||||
|
startTransition(async () => {
|
||||||
|
const formData = new FormData()
|
||||||
|
formData.append(
|
||||||
|
"json",
|
||||||
|
JSON.stringify({
|
||||||
|
practiceType: presetMode.type,
|
||||||
|
subjectId: presetMode.subjectId,
|
||||||
|
sourceMeta: presetMode.sourceMeta,
|
||||||
|
questionCount,
|
||||||
|
}),
|
||||||
|
)
|
||||||
|
const res = await createPracticeSessionAction(undefined, formData)
|
||||||
|
if (res.success && res.data) {
|
||||||
|
toast.success(res.message ?? t("toasts.created"))
|
||||||
|
router.push(`/student/practice/${res.data.sessionId}`)
|
||||||
|
} else {
|
||||||
|
toast.error(res.message ?? t("toasts.createFailed"))
|
||||||
|
}
|
||||||
|
})
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
// 自定义模式：根据类型构建 sourceMeta
|
||||||
|
let sourceMeta: Record<string, unknown> = {}
|
||||||
|
|
||||||
|
if (practiceType === "knowledge_point") {
|
||||||
|
if (selectedKpIds.length === 0) {
|
||||||
|
toast.error(t("toasts.selectKnowledgePoint"))
|
||||||
|
return
|
||||||
|
}
|
||||||
|
sourceMeta = {
|
||||||
|
knowledgePointIds: selectedKpIds,
|
||||||
|
difficulty: difficulty > 0 ? difficulty : undefined,
|
||||||
|
}
|
||||||
|
} else if (practiceType === "weak_chapter") {
|
||||||
|
// 薄弱章节模式：传入选中的知识点作为薄弱知识点
|
||||||
|
if (selectedKpIds.length === 0) {
|
||||||
|
toast.error(t("toasts.selectWeakKnowledgePoint"))
|
||||||
|
return
|
||||||
|
}
|
||||||
|
sourceMeta = {
|
||||||
|
chapterId: "",
|
||||||
|
weakKnowledgePointIds: selectedKpIds,
|
||||||
|
}
|
||||||
|
} else if (practiceType === "ai_recommended") {
|
||||||
|
sourceMeta = {
|
||||||
|
recommendedKnowledgePointIds: selectedKpIds,
|
||||||
|
reason: t("toasts.aiRecommendedReason"),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
startTransition(async () => {
|
||||||
|
const formData = new FormData()
|
||||||
|
formData.append(
|
||||||
|
"json",
|
||||||
|
JSON.stringify({
|
||||||
|
practiceType,
|
||||||
|
sourceMeta,
|
||||||
|
questionCount,
|
||||||
|
}),
|
||||||
|
)
|
||||||
|
const res = await createPracticeSessionAction(undefined, formData)
|
||||||
|
if (res.success && res.data) {
|
||||||
|
toast.success(res.message ?? t("toasts.created"))
|
||||||
|
router.push(`/student/practice/${res.data.sessionId}`)
|
||||||
|
} else {
|
||||||
|
toast.error(res.message ?? t("toasts.createFailed"))
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
const showKpSelector = !presetMode || practiceType === "knowledge_point" || practiceType === "weak_chapter" || practiceType === "ai_recommended"
|
||||||
|
|
||||||
|
return (
|
||||||
|
<Card>
|
||||||
|
<CardHeader>
|
||||||
|
<CardTitle className="flex items-center gap-2">
|
||||||
|
<Target className="h-5 w-5 text-primary" />
|
||||||
|
{t("starter.title")}
|
||||||
|
</CardTitle>
|
||||||
|
<CardDescription>{t("starter.description")}</CardDescription>
|
||||||
|
</CardHeader>
|
||||||
|
<CardContent className="space-y-4">
|
||||||
|
{/* 练习类型选择 */}
|
||||||
|
{!lockType ? (
|
||||||
|
<div className="space-y-2">
|
||||||
|
<Label>{t("starter.type")}</Label>
|
||||||
|
<Select
|
||||||
|
value={practiceType}
|
||||||
|
onValueChange={(v: string) => setPracticeType(v as PracticeType)}
|
||||||
|
>
|
||||||
|
<SelectTrigger>
|
||||||
|
<SelectValue />
|
||||||
|
</SelectTrigger>
|
||||||
|
<SelectContent>
|
||||||
|
<SelectItem value="knowledge_point">
|
||||||
|
<span className="flex items-center gap-2">
|
||||||
|
<BookOpen className="h-4 w-4" />
|
||||||
|
{t("types.knowledge_point")}
|
||||||
|
</span>
|
||||||
|
</SelectItem>
|
||||||
|
<SelectItem value="weak_chapter">
|
||||||
|
<span className="flex items-center gap-2">
|
||||||
|
<AlertCircle className="h-4 w-4" />
|
||||||
|
{t("types.weak_chapter")}
|
||||||
|
</span>
|
||||||
|
</SelectItem>
|
||||||
|
<SelectItem value="ai_recommended">
|
||||||
|
<span className="flex items-center gap-2">
|
||||||
|
<Sparkles className="h-4 w-4" />
|
||||||
|
{t("types.ai_recommended")}
|
||||||
|
</span>
|
||||||
|
</SelectItem>
|
||||||
|
</SelectContent>
|
||||||
|
</Select>
|
||||||
|
</div>
|
||||||
|
) : null}
|
||||||
|
|
||||||
|
{/* 知识点选择 */}
|
||||||
|
{showKpSelector && knowledgePoints.length > 0 ? (
|
||||||
|
<div className="space-y-2">
|
||||||
|
<Label>{t("starter.knowledgePoints")}</Label>
|
||||||
|
<div className="grid grid-cols-2 gap-2 max-h-48 overflow-y-auto rounded-md border p-2">
|
||||||
|
{knowledgePoints.map((kp) => (
|
||||||
|
<label
|
||||||
|
key={kp.id}
|
||||||
|
className="flex items-center gap-2 rounded-md p-2 hover:bg-muted/50 cursor-pointer"
|
||||||
|
>
|
||||||
|
<input
|
||||||
|
type="checkbox"
|
||||||
|
checked={selectedKpIds.includes(kp.id)}
|
||||||
|
onChange={() => toggleKp(kp.id)}
|
||||||
|
className="rounded border-input"
|
||||||
|
/>
|
||||||
|
<span className="text-sm">{kp.name}</span>
|
||||||
|
</label>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
) : null}
|
||||||
|
|
||||||
|
{/* 难度选择（仅知识点专项） */}
|
||||||
|
{practiceType === "knowledge_point" && !presetMode ? (
|
||||||
|
<div className="space-y-2">
|
||||||
|
<Label>{t("starter.difficulty")}</Label>
|
||||||
|
<Select
|
||||||
|
value={String(difficulty)}
|
||||||
|
onValueChange={(v: string) => setDifficulty(Number(v))}
|
||||||
|
>
|
||||||
|
<SelectTrigger>
|
||||||
|
<SelectValue />
|
||||||
|
</SelectTrigger>
|
||||||
|
<SelectContent>
|
||||||
|
<SelectItem value="0">{t("starter.anyDifficulty")}</SelectItem>
|
||||||
|
<SelectItem value="1">1</SelectItem>
|
||||||
|
<SelectItem value="2">2</SelectItem>
|
||||||
|
<SelectItem value="3">3</SelectItem>
|
||||||
|
<SelectItem value="4">4</SelectItem>
|
||||||
|
<SelectItem value="5">5</SelectItem>
|
||||||
|
</SelectContent>
|
||||||
|
</Select>
|
||||||
|
</div>
|
||||||
|
) : null}
|
||||||
|
|
||||||
|
{/* 题目数量 */}
|
||||||
|
<div className="space-y-2">
|
||||||
|
<Label>{t("starter.questionCount")}</Label>
|
||||||
|
<Select
|
||||||
|
value={String(questionCount)}
|
||||||
|
onValueChange={(v: string) => setQuestionCount(Number(v))}
|
||||||
|
>
|
||||||
|
<SelectTrigger>
|
||||||
|
<SelectValue />
|
||||||
|
</SelectTrigger>
|
||||||
|
<SelectContent>
|
||||||
|
{QUESTION_COUNT_OPTIONS.map((count) => (
|
||||||
|
<SelectItem key={count} value={String(count)}>
|
||||||
|
{count}
|
||||||
|
</SelectItem>
|
||||||
|
))}
|
||||||
|
</SelectContent>
|
||||||
|
</Select>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* 开始按钮 */}
|
||||||
|
<Button
|
||||||
|
onClick={handleStart}
|
||||||
|
disabled={isPending}
|
||||||
|
className="w-full"
|
||||||
|
>
|
||||||
|
{isPending ? t("starter.creating") : t("starter.start")}
|
||||||
|
</Button>
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,73 @@
|
|||||||
|
"use client"
|
||||||
|
|
||||||
|
import { useTranslations } from "next-intl"
|
||||||
|
import { Target, CheckCircle2, TrendingUp, Award } from "lucide-react"
|
||||||
|
|
||||||
|
import { Card, CardContent } from "@/shared/components/ui/card"
|
||||||
|
|
||||||
|
import type { PracticeStats } from "../types"
|
||||||
|
|
||||||
|
interface PracticeStatsCardsProps {
|
||||||
|
stats: PracticeStats
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 专项练习统计卡片
|
||||||
|
*/
|
||||||
|
export function PracticeStatsCards({ stats }: PracticeStatsCardsProps): React.ReactNode {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
|
||||||
|
const accuracyPercent = Math.round(stats.overallAccuracy * 100)
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="grid gap-4 md:grid-cols-4">
|
||||||
|
<Card>
|
||||||
|
<CardContent className="p-4">
|
||||||
|
<div className="flex items-center justify-between">
|
||||||
|
<div>
|
||||||
|
<p className="text-xs text-muted-foreground">{t("stats.totalSessions")}</p>
|
||||||
|
<p className="text-2xl font-bold">{stats.totalSessions}</p>
|
||||||
|
</div>
|
||||||
|
<Target className="h-8 w-8 text-primary opacity-80" />
|
||||||
|
</div>
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
|
||||||
|
<Card>
|
||||||
|
<CardContent className="p-4">
|
||||||
|
<div className="flex items-center justify-between">
|
||||||
|
<div>
|
||||||
|
<p className="text-xs text-muted-foreground">{t("stats.completed")}</p>
|
||||||
|
<p className="text-2xl font-bold">{stats.completedSessions}</p>
|
||||||
|
</div>
|
||||||
|
<CheckCircle2 className="h-8 w-8 text-emerald-500 opacity-80" />
|
||||||
|
</div>
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
|
||||||
|
<Card>
|
||||||
|
<CardContent className="p-4">
|
||||||
|
<div className="flex items-center justify-between">
|
||||||
|
<div>
|
||||||
|
<p className="text-xs text-muted-foreground">{t("stats.totalAnswered")}</p>
|
||||||
|
<p className="text-2xl font-bold">{stats.totalQuestionsAnswered}</p>
|
||||||
|
</div>
|
||||||
|
<Award className="h-8 w-8 text-amber-500 opacity-80" />
|
||||||
|
</div>
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
|
||||||
|
<Card>
|
||||||
|
<CardContent className="p-4">
|
||||||
|
<div className="flex items-center justify-between">
|
||||||
|
<div>
|
||||||
|
<p className="text-xs text-muted-foreground">{t("stats.accuracy")}</p>
|
||||||
|
<p className="text-2xl font-bold">{accuracyPercent}%</p>
|
||||||
|
</div>
|
||||||
|
<TrendingUp className="h-8 w-8 text-blue-500 opacity-80" />
|
||||||
|
</div>
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,123 @@
|
|||||||
|
"use client"
|
||||||
|
|
||||||
|
import { Bar, BarChart, CartesianGrid, XAxis, YAxis, Cell } from "recharts"
|
||||||
|
import { useTranslations } from "next-intl"
|
||||||
|
|
||||||
|
import {
|
||||||
|
ChartContainer,
|
||||||
|
ChartTooltip,
|
||||||
|
ChartTooltipContent,
|
||||||
|
type ChartConfig,
|
||||||
|
} from "@/shared/components/ui/chart"
|
||||||
|
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/shared/components/ui/card"
|
||||||
|
import { cn } from "@/shared/lib/utils"
|
||||||
|
|
||||||
|
import type { PracticeTypeBreakdown } from "@/modules/adaptive-practice/data-access-analytics"
|
||||||
|
|
||||||
|
interface PracticeTypeBreakdownChartProps {
|
||||||
|
data: PracticeTypeBreakdown[]
|
||||||
|
className?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
const CHART_COLORS = [
|
||||||
|
"var(--color-chart-1)",
|
||||||
|
"var(--color-chart-2)",
|
||||||
|
"var(--color-chart-3)",
|
||||||
|
"var(--color-chart-4)",
|
||||||
|
"var(--color-chart-5)",
|
||||||
|
]
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 练习类型分布柱状图（教师视图）
|
||||||
|
*
|
||||||
|
* 横轴：练习类型，纵轴：会话数
|
||||||
|
* tooltip 显示答题数、正确数、正确率
|
||||||
|
*/
|
||||||
|
export function PracticeTypeBreakdownChart({
|
||||||
|
data,
|
||||||
|
className,
|
||||||
|
}: PracticeTypeBreakdownChartProps) {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
|
||||||
|
if (data.length === 0) return null
|
||||||
|
|
||||||
|
const chartData = data.map((d) => ({
|
||||||
|
name: t(`types.${d.practiceType}` as const),
|
||||||
|
sessionCount: d.sessionCount,
|
||||||
|
totalQuestions: d.totalQuestions,
|
||||||
|
correctCount: d.correctCount,
|
||||||
|
accuracy: Number((d.accuracy * 100).toFixed(0)),
|
||||||
|
}))
|
||||||
|
|
||||||
|
const chartConfig: ChartConfig = {
|
||||||
|
sessionCount: {
|
||||||
|
label: t("teacher.classComparison.totalSessions"),
|
||||||
|
color: "var(--color-chart-1)",
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
<Card className={cn("overflow-hidden", className)}>
|
||||||
|
<CardHeader>
|
||||||
|
<CardTitle className="text-base">{t("teacher.typeBreakdown.title")}</CardTitle>
|
||||||
|
<CardDescription>{t("teacher.typeBreakdown.description")}</CardDescription>
|
||||||
|
</CardHeader>
|
||||||
|
<CardContent>
|
||||||
|
<ChartContainer config={chartConfig} className="h-[280px] w-full">
|
||||||
|
<BarChart data={chartData} margin={{ left: 8, right: 8, top: 8, bottom: 8 }}>
|
||||||
|
<CartesianGrid vertical={false} strokeDasharray="4 4" strokeOpacity={0.4} />
|
||||||
|
<XAxis
|
||||||
|
dataKey="name"
|
||||||
|
tickLine={false}
|
||||||
|
axisLine={false}
|
||||||
|
tickMargin={8}
|
||||||
|
/>
|
||||||
|
<YAxis tickLine={false} axisLine={false} width={36} />
|
||||||
|
<ChartTooltip
|
||||||
|
content={
|
||||||
|
<ChartTooltipContent
|
||||||
|
className="w-[220px]"
|
||||||
|
formatter={(payload: unknown) => {
|
||||||
|
const p = payload as unknown as {
|
||||||
|
name: string
|
||||||
|
sessionCount: number
|
||||||
|
totalQuestions: number
|
||||||
|
correctCount: number
|
||||||
|
accuracy: number
|
||||||
|
}
|
||||||
|
return (
|
||||||
|
<div className="space-y-1.5">
|
||||||
|
<div className="font-medium">{p.name}</div>
|
||||||
|
<div className="text-muted-foreground">
|
||||||
|
{t("teacher.classComparison.totalSessions")}：
|
||||||
|
<span className="font-medium text-foreground">{p.sessionCount}</span>
|
||||||
|
</div>
|
||||||
|
<div className="text-muted-foreground">
|
||||||
|
{t("teacher.classComparison.totalAnswered")}：
|
||||||
|
<span className="font-medium text-foreground">{p.totalQuestions}</span>
|
||||||
|
</div>
|
||||||
|
<div className="text-muted-foreground">
|
||||||
|
{t("teacher.knowledgePointWeakness.wrongAnswers")}：
|
||||||
|
<span className="font-medium text-rose-600">{p.totalQuestions - p.correctCount}</span>
|
||||||
|
</div>
|
||||||
|
<div className="text-muted-foreground">
|
||||||
|
{t("teacher.classComparison.averageAccuracy")}：
|
||||||
|
<span className="font-medium text-emerald-600">{p.accuracy}%</span>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}}
|
||||||
|
/>
|
||||||
|
}
|
||||||
|
/>
|
||||||
|
<Bar dataKey="sessionCount" radius={[4, 4, 0, 0]}>
|
||||||
|
{chartData.map((_, idx) => (
|
||||||
|
<Cell key={idx} fill={CHART_COLORS[idx % CHART_COLORS.length]} />
|
||||||
|
))}
|
||||||
|
</Bar>
|
||||||
|
</BarChart>
|
||||||
|
</ChartContainer>
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,112 @@
|
|||||||
|
import { useTranslations } from "next-intl"
|
||||||
|
|
||||||
|
import { Badge } from "@/shared/components/ui/badge"
|
||||||
|
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/shared/components/ui/card"
|
||||||
|
import { Progress } from "@/shared/components/ui/progress"
|
||||||
|
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/shared/components/ui/table"
|
||||||
|
import { cn, formatDate } from "@/shared/lib/utils"
|
||||||
|
|
||||||
|
import type { StudentPracticeSummary } from "@/modules/adaptive-practice/data-access-analytics"
|
||||||
|
|
||||||
|
interface StudentPracticeRankingTableProps {
|
||||||
|
data: StudentPracticeSummary[]
|
||||||
|
studentNames: Map<string, string>
|
||||||
|
className?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 学生练习排名表格（教师视图）
|
||||||
|
*
|
||||||
|
* 按练习数降序排列，显示每个学生的练习数、完成数、答题数、正确率、最近练习时间。
|
||||||
|
* 用于识别活跃学生与待引导学生。
|
||||||
|
*/
|
||||||
|
export function StudentPracticeRankingTable({
|
||||||
|
data,
|
||||||
|
studentNames,
|
||||||
|
className,
|
||||||
|
}: StudentPracticeRankingTableProps) {
|
||||||
|
const t = useTranslations("practice")
|
||||||
|
|
||||||
|
if (data.length === 0) return null
|
||||||
|
|
||||||
|
// 按练习数降序排列
|
||||||
|
const sorted = [...data].sort((a, b) => b.totalSessions - a.totalSessions)
|
||||||
|
|
||||||
|
return (
|
||||||
|
<Card className={cn("shadow-none", className)}>
|
||||||
|
<CardHeader>
|
||||||
|
<CardTitle className="text-base">{t("teacher.studentRanking.title")}</CardTitle>
|
||||||
|
<CardDescription>{t("teacher.studentRanking.description")}</CardDescription>
|
||||||
|
</CardHeader>
|
||||||
|
<CardContent>
|
||||||
|
<div className="rounded-md border">
|
||||||
|
{/* 移动端表格水平滚动 */}
|
||||||
|
<div className="overflow-x-auto">
|
||||||
|
<Table>
|
||||||
|
<TableHeader>
|
||||||
|
<TableRow className="bg-muted/50">
|
||||||
|
<TableHead className="w-12">{t("teacher.studentRanking.rank")}</TableHead>
|
||||||
|
<TableHead>{t("teacher.studentRanking.student")}</TableHead>
|
||||||
|
<TableHead className="text-right">{t("teacher.studentRanking.totalSessions")}</TableHead>
|
||||||
|
<TableHead className="text-right">{t("teacher.studentRanking.completedSessions")}</TableHead>
|
||||||
|
<TableHead className="text-right">{t("teacher.studentRanking.totalAnswered")}</TableHead>
|
||||||
|
<TableHead>{t("teacher.studentRanking.accuracy")}</TableHead>
|
||||||
|
<TableHead className="text-right">{t("teacher.studentRanking.lastPractice")}</TableHead>
|
||||||
|
</TableRow>
|
||||||
|
</TableHeader>
|
||||||
|
<TableBody>
|
||||||
|
{sorted.map((student, idx) => {
|
||||||
|
const name = studentNames.get(student.studentId) ?? "Unknown"
|
||||||
|
const accuracyPct = Math.round(student.accuracy * 100)
|
||||||
|
const hasPractice = student.totalSessions > 0
|
||||||
|
return (
|
||||||
|
<TableRow
|
||||||
|
key={student.studentId}
|
||||||
|
className={cn(!hasPractice && "opacity-50")}
|
||||||
|
>
|
||||||
|
<TableCell className="text-muted-foreground tabular-nums">{idx + 1}</TableCell>
|
||||||
|
<TableCell className="font-medium">{name}</TableCell>
|
||||||
|
<TableCell className="text-right tabular-nums">
|
||||||
|
{student.totalSessions > 0 ? (
|
||||||
|
<Badge variant="secondary" className="tabular-nums">
|
||||||
|
{student.totalSessions}
|
||||||
|
</Badge>
|
||||||
|
) : (
|
||||||
|
<span className="text-muted-foreground">-</span>
|
||||||
|
)}
|
||||||
|
</TableCell>
|
||||||
|
<TableCell className="text-right tabular-nums">{student.completedSessions}</TableCell>
|
||||||
|
<TableCell className="text-right tabular-nums">{student.totalQuestionsAnswered}</TableCell>
|
||||||
|
<TableCell>
|
||||||
|
{hasPractice ? (
|
||||||
|
<div className="flex items-center gap-2">
|
||||||
|
<Progress value={accuracyPct} className="h-1.5 w-16" />
|
||||||
|
<span
|
||||||
|
className={cn(
|
||||||
|
"text-xs tabular-nums",
|
||||||
|
accuracyPct >= 60
|
||||||
|
? "text-emerald-600 dark:text-emerald-400"
|
||||||
|
: "text-rose-600 dark:text-rose-400",
|
||||||
|
)}
|
||||||
|
>
|
||||||
|
{accuracyPct}%
|
||||||
|
</span>
|
||||||
|
</div>
|
||||||
|
) : (
|
||||||
|
<span className="text-muted-foreground">-</span>
|
||||||
|
)}
|
||||||
|
</TableCell>
|
||||||
|
<TableCell className="text-right text-muted-foreground">
|
||||||
|
{student.lastPracticeAt ? formatDate(student.lastPracticeAt) : "-"}
|
||||||
|
</TableCell>
|
||||||
|
</TableRow>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
</TableBody>
|
||||||
|
</Table>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</CardContent>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
}
|
||||||
634
src/modules/adaptive-practice/data-access-analytics.ts
Normal file
634
src/modules/adaptive-practice/data-access-analytics.ts
Normal file
@@ -0,0 +1,634 @@
|
|||||||
|
import "server-only"
|
||||||
|
|
||||||
|
import { cache } from "react"
|
||||||
|
import { and, count, desc, eq, inArray, sql } from "drizzle-orm"
|
||||||
|
|
||||||
|
import { db } from "@/shared/db"
|
||||||
|
import { practiceAnswers, practiceSessions, questions, questionsToKnowledgePoints, knowledgePoints } from "@/shared/db/schema"
|
||||||
|
import { getActiveStudentIdsByClassId, getClassNameById, getClassesByGradeId } from "@/modules/classes/data-access"
|
||||||
|
import { getUserIdsByGradeId, getUserNamesByIds } from "@/modules/users/data-access"
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 类型定义
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/** 班级专项练习统计 */
|
||||||
|
export interface ClassPracticeStats {
|
||||||
|
classId: string
|
||||||
|
className: string
|
||||||
|
totalSessions: number
|
||||||
|
completedSessions: number
|
||||||
|
totalQuestionsAnswered: number
|
||||||
|
totalCorrect: number
|
||||||
|
averageAccuracy: number
|
||||||
|
/** 参与练习的学生数 */
|
||||||
|
activeStudents: number
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 学生专项练习摘要 */
|
||||||
|
export interface StudentPracticeSummary {
|
||||||
|
studentId: string
|
||||||
|
studentName: string | null
|
||||||
|
totalSessions: number
|
||||||
|
completedSessions: number
|
||||||
|
totalQuestionsAnswered: number
|
||||||
|
totalCorrect: number
|
||||||
|
accuracy: number
|
||||||
|
lastPracticeAt: Date | null
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 按练习类型分组的统计 */
|
||||||
|
export interface PracticeTypeBreakdown {
|
||||||
|
practiceType: string
|
||||||
|
sessionCount: number
|
||||||
|
totalQuestions: number
|
||||||
|
correctCount: number
|
||||||
|
accuracy: number
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 查询函数
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取班级专项练习统计。
|
||||||
|
*
|
||||||
|
* 汇总班级所有学生的练习数据，包括会话数、完成数、正确率等。
|
||||||
|
*
|
||||||
|
* @param classId 班级 ID
|
||||||
|
*/
|
||||||
|
export const getClassPracticeStats = cache(async (
|
||||||
|
classId: string,
|
||||||
|
): Promise<ClassPracticeStats | null> => {
|
||||||
|
const studentIds = await getActiveStudentIdsByClassId(classId)
|
||||||
|
if (studentIds.length === 0) return null
|
||||||
|
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
totalSessions: count(),
|
||||||
|
completedSessions: count(sql`CASE WHEN ${practiceSessions.status} = 'completed' THEN 1 END`),
|
||||||
|
totalQuestionsAnswered: sql<number>`COALESCE(SUM(${practiceSessions.answeredQuestions}), 0)`,
|
||||||
|
totalCorrect: sql<number>`COALESCE(SUM(${practiceSessions.correctCount}), 0)`,
|
||||||
|
})
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(inArray(practiceSessions.studentId, studentIds))
|
||||||
|
|
||||||
|
const row = rows[0]
|
||||||
|
if (!row) return null
|
||||||
|
|
||||||
|
const totalQuestionsAnswered = Number(row.totalQuestionsAnswered)
|
||||||
|
const totalCorrect = Number(row.totalCorrect)
|
||||||
|
|
||||||
|
// 统计参与练习的学生数
|
||||||
|
const activeStudentsResult = await db
|
||||||
|
.select({ count: sql<number>`COUNT(DISTINCT ${practiceSessions.studentId})` })
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(inArray(practiceSessions.studentId, studentIds))
|
||||||
|
|
||||||
|
const activeStudents = Number(activeStudentsResult[0]?.count ?? 0)
|
||||||
|
|
||||||
|
return {
|
||||||
|
classId,
|
||||||
|
className: "", // 由调用方填充
|
||||||
|
totalSessions: Number(row.totalSessions),
|
||||||
|
completedSessions: Number(row.completedSessions),
|
||||||
|
totalQuestionsAnswered,
|
||||||
|
totalCorrect,
|
||||||
|
averageAccuracy: totalQuestionsAnswered > 0 ? totalCorrect / totalQuestionsAnswered : 0,
|
||||||
|
activeStudents,
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取班级所有学生的专项练习摘要。
|
||||||
|
*
|
||||||
|
* @param classId 班级 ID
|
||||||
|
*/
|
||||||
|
export const getClassStudentPracticeSummaries = cache(async (
|
||||||
|
classId: string,
|
||||||
|
): Promise<StudentPracticeSummary[]> => {
|
||||||
|
const studentIds = await getActiveStudentIdsByClassId(classId)
|
||||||
|
if (studentIds.length === 0) return []
|
||||||
|
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
studentId: practiceSessions.studentId,
|
||||||
|
totalSessions: count(),
|
||||||
|
completedSessions: count(sql`CASE WHEN ${practiceSessions.status} = 'completed' THEN 1 END`),
|
||||||
|
totalQuestionsAnswered: sql<number>`COALESCE(SUM(${practiceSessions.answeredQuestions}), 0)`,
|
||||||
|
totalCorrect: sql<number>`COALESCE(SUM(${practiceSessions.correctCount}), 0)`,
|
||||||
|
lastPracticeAt: sql<Date | null>`MAX(${practiceSessions.startedAt})`,
|
||||||
|
})
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(inArray(practiceSessions.studentId, studentIds))
|
||||||
|
.groupBy(practiceSessions.studentId)
|
||||||
|
.orderBy(desc(sql`MAX(${practiceSessions.startedAt})`))
|
||||||
|
|
||||||
|
return rows.map((r) => ({
|
||||||
|
studentId: r.studentId,
|
||||||
|
studentName: null, // 由调用方填充
|
||||||
|
totalSessions: Number(r.totalSessions),
|
||||||
|
completedSessions: Number(r.completedSessions),
|
||||||
|
totalQuestionsAnswered: Number(r.totalQuestionsAnswered),
|
||||||
|
totalCorrect: Number(r.totalCorrect),
|
||||||
|
accuracy: Number(r.totalQuestionsAnswered) > 0
|
||||||
|
? Number(r.totalCorrect) / Number(r.totalQuestionsAnswered)
|
||||||
|
: 0,
|
||||||
|
lastPracticeAt: r.lastPracticeAt,
|
||||||
|
}))
|
||||||
|
})
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取年级专项练习统计。
|
||||||
|
*
|
||||||
|
* @param gradeId 年级 ID
|
||||||
|
*/
|
||||||
|
export const getGradePracticeStats = cache(async (
|
||||||
|
gradeId: string,
|
||||||
|
): Promise<{
|
||||||
|
totalSessions: number
|
||||||
|
completedSessions: number
|
||||||
|
totalQuestionsAnswered: number
|
||||||
|
totalCorrect: number
|
||||||
|
averageAccuracy: number
|
||||||
|
activeStudents: number
|
||||||
|
} | null> => {
|
||||||
|
const studentIds = await getUserIdsByGradeId(gradeId)
|
||||||
|
if (studentIds.length === 0) return null
|
||||||
|
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
totalSessions: count(),
|
||||||
|
completedSessions: count(sql`CASE WHEN ${practiceSessions.status} = 'completed' THEN 1 END`),
|
||||||
|
totalQuestionsAnswered: sql<number>`COALESCE(SUM(${practiceSessions.answeredQuestions}), 0)`,
|
||||||
|
totalCorrect: sql<number>`COALESCE(SUM(${practiceSessions.correctCount}), 0)`,
|
||||||
|
})
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(inArray(practiceSessions.studentId, studentIds))
|
||||||
|
|
||||||
|
const row = rows[0]
|
||||||
|
if (!row) return null
|
||||||
|
|
||||||
|
const totalQuestionsAnswered = Number(row.totalQuestionsAnswered)
|
||||||
|
const totalCorrect = Number(row.totalCorrect)
|
||||||
|
|
||||||
|
const activeStudentsResult = await db
|
||||||
|
.select({ count: sql<number>`COUNT(DISTINCT ${practiceSessions.studentId})` })
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(inArray(practiceSessions.studentId, studentIds))
|
||||||
|
|
||||||
|
return {
|
||||||
|
totalSessions: Number(row.totalSessions),
|
||||||
|
completedSessions: Number(row.completedSessions),
|
||||||
|
totalQuestionsAnswered,
|
||||||
|
totalCorrect,
|
||||||
|
averageAccuracy: totalQuestionsAnswered > 0 ? totalCorrect / totalQuestionsAnswered : 0,
|
||||||
|
activeStudents: Number(activeStudentsResult[0]?.count ?? 0),
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取按练习类型分组的统计（班级或年级维度）。
|
||||||
|
*
|
||||||
|
* @param studentIds 学生 ID 列表
|
||||||
|
*/
|
||||||
|
export const getPracticeTypeBreakdown = cache(async (
|
||||||
|
studentIds: string[],
|
||||||
|
): Promise<PracticeTypeBreakdown[]> => {
|
||||||
|
if (studentIds.length === 0) return []
|
||||||
|
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
practiceType: practiceSessions.practiceType,
|
||||||
|
sessionCount: count(),
|
||||||
|
totalQuestions: sql<number>`COALESCE(SUM(${practiceSessions.totalQuestions}), 0)`,
|
||||||
|
correctCount: sql<number>`COALESCE(SUM(${practiceSessions.correctCount}), 0)`,
|
||||||
|
})
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(inArray(practiceSessions.studentId, studentIds))
|
||||||
|
.groupBy(practiceSessions.practiceType)
|
||||||
|
|
||||||
|
return rows.map((r) => ({
|
||||||
|
practiceType: r.practiceType,
|
||||||
|
sessionCount: Number(r.sessionCount),
|
||||||
|
totalQuestions: Number(r.totalQuestions),
|
||||||
|
correctCount: Number(r.correctCount),
|
||||||
|
accuracy: Number(r.totalQuestions) > 0
|
||||||
|
? Number(r.correctCount) / Number(r.totalQuestions)
|
||||||
|
: 0,
|
||||||
|
}))
|
||||||
|
})
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取班级中未参与专项练习的学生列表。
|
||||||
|
*
|
||||||
|
* 用于教师识别"从未使用专项练习功能"的学生，
|
||||||
|
* 这些学生可能缺乏自主学习意识，需要教师引导。
|
||||||
|
*
|
||||||
|
* @param classId 班级 ID
|
||||||
|
*/
|
||||||
|
export const getStudentsWithoutPractice = cache(async (
|
||||||
|
classId: string,
|
||||||
|
): Promise<string[]> => {
|
||||||
|
const studentIds = await getActiveStudentIdsByClassId(classId)
|
||||||
|
if (studentIds.length === 0) return []
|
||||||
|
|
||||||
|
// 查询有练习记录的学生
|
||||||
|
const activeRows = await db
|
||||||
|
.select({ studentId: practiceSessions.studentId })
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(inArray(practiceSessions.studentId, studentIds))
|
||||||
|
.groupBy(practiceSessions.studentId)
|
||||||
|
|
||||||
|
const activeSet = new Set(activeRows.map((r) => r.studentId))
|
||||||
|
|
||||||
|
// 返回没有练习记录的学生
|
||||||
|
return studentIds.filter((id) => !activeSet.has(id))
|
||||||
|
})
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 教师视图：所教班级练习概览
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/** 教师所教班级的练习概览（每个班级一行） */
|
||||||
|
export interface TeacherClassPracticeOverview {
|
||||||
|
classId: string
|
||||||
|
className: string
|
||||||
|
totalSessions: number
|
||||||
|
completedSessions: number
|
||||||
|
totalQuestionsAnswered: number
|
||||||
|
totalCorrect: number
|
||||||
|
averageAccuracy: number
|
||||||
|
activeStudents: number
|
||||||
|
/** 该班级学生总数 */
|
||||||
|
totalStudents: number
|
||||||
|
/** 参与率 0-1 */
|
||||||
|
participationRate: number
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取教师所教所有班级的专项练习概览。
|
||||||
|
*
|
||||||
|
* 用于教师端分析页面顶部展示每个班级的练习情况。
|
||||||
|
*
|
||||||
|
* @param classIds 教师/年级主任可访问的班级 ID 列表
|
||||||
|
*/
|
||||||
|
export const getTeacherClassPracticeOverviews = cache(async (
|
||||||
|
classIds: string[],
|
||||||
|
): Promise<TeacherClassPracticeOverview[]> => {
|
||||||
|
if (classIds.length === 0) return []
|
||||||
|
|
||||||
|
const results = await Promise.all(
|
||||||
|
classIds.map(async (classId): Promise<TeacherClassPracticeOverview | null> => {
|
||||||
|
const className = await getClassNameById(classId)
|
||||||
|
const studentIds = await getActiveStudentIdsByClassId(classId)
|
||||||
|
const totalStudents = studentIds.length
|
||||||
|
if (totalStudents === 0) {
|
||||||
|
return {
|
||||||
|
classId,
|
||||||
|
className: className ?? "",
|
||||||
|
totalSessions: 0,
|
||||||
|
completedSessions: 0,
|
||||||
|
totalQuestionsAnswered: 0,
|
||||||
|
totalCorrect: 0,
|
||||||
|
averageAccuracy: 0,
|
||||||
|
activeStudents: 0,
|
||||||
|
totalStudents: 0,
|
||||||
|
participationRate: 0,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
totalSessions: count(),
|
||||||
|
completedSessions: count(sql`CASE WHEN ${practiceSessions.status} = 'completed' THEN 1 END`),
|
||||||
|
totalQuestionsAnswered: sql<number>`COALESCE(SUM(${practiceSessions.answeredQuestions}), 0)`,
|
||||||
|
totalCorrect: sql<number>`COALESCE(SUM(${practiceSessions.correctCount}), 0)`,
|
||||||
|
})
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(inArray(practiceSessions.studentId, studentIds))
|
||||||
|
|
||||||
|
const row = rows[0]
|
||||||
|
if (!row) return null
|
||||||
|
|
||||||
|
const totalQuestionsAnswered = Number(row.totalQuestionsAnswered)
|
||||||
|
const totalCorrect = Number(row.totalCorrect)
|
||||||
|
|
||||||
|
const activeStudentsResult = await db
|
||||||
|
.select({ count: sql<number>`COUNT(DISTINCT ${practiceSessions.studentId})` })
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(inArray(practiceSessions.studentId, studentIds))
|
||||||
|
|
||||||
|
const activeStudents = Number(activeStudentsResult[0]?.count ?? 0)
|
||||||
|
|
||||||
|
return {
|
||||||
|
classId,
|
||||||
|
className: className ?? "",
|
||||||
|
totalSessions: Number(row.totalSessions),
|
||||||
|
completedSessions: Number(row.completedSessions),
|
||||||
|
totalQuestionsAnswered,
|
||||||
|
totalCorrect,
|
||||||
|
averageAccuracy: totalQuestionsAnswered > 0 ? totalCorrect / totalQuestionsAnswered : 0,
|
||||||
|
activeStudents,
|
||||||
|
totalStudents,
|
||||||
|
participationRate: totalStudents > 0 ? activeStudents / totalStudents : 0,
|
||||||
|
}
|
||||||
|
}),
|
||||||
|
)
|
||||||
|
|
||||||
|
return results.filter((r): r is TeacherClassPracticeOverview => r !== null)
|
||||||
|
})
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 班级知识点薄弱度（基于练习答题数据）
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/** 班级知识点薄弱度 */
|
||||||
|
export interface ClassKnowledgePointWeakness {
|
||||||
|
knowledgePointId: string
|
||||||
|
knowledgePointName: string
|
||||||
|
/** 该知识点总答题数 */
|
||||||
|
totalAnswers: number
|
||||||
|
/** 该知识点答错数 */
|
||||||
|
wrongAnswers: number
|
||||||
|
/** 错误率 0-1 */
|
||||||
|
errorRate: number
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取班级在专项练习中暴露的知识点薄弱度。
|
||||||
|
*
|
||||||
|
* 通过分析 practiceAnswers 表中 isCorrect = false 的记录，
|
||||||
|
* 关联题目到知识点，统计每个知识点的错误率。
|
||||||
|
*
|
||||||
|
* @param classId 班级 ID
|
||||||
|
* @param limit 返回条数（默认 10）
|
||||||
|
*/
|
||||||
|
export const getClassKnowledgePointWeakness = cache(async (
|
||||||
|
classId: string,
|
||||||
|
limit = 10,
|
||||||
|
): Promise<ClassKnowledgePointWeakness[]> => {
|
||||||
|
const studentIds = await getActiveStudentIdsByClassId(classId)
|
||||||
|
if (studentIds.length === 0) return []
|
||||||
|
|
||||||
|
// 查询该班级学生在练习中的答题记录（联表题目→知识点）
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
knowledgePointId: knowledgePoints.id,
|
||||||
|
knowledgePointName: knowledgePoints.name,
|
||||||
|
totalAnswers: count(),
|
||||||
|
wrongAnswers: count(sql`CASE WHEN ${practiceAnswers.isCorrect} = false THEN 1 END`),
|
||||||
|
})
|
||||||
|
.from(practiceAnswers)
|
||||||
|
.innerJoin(questions, eq(questions.id, practiceAnswers.questionId))
|
||||||
|
.innerJoin(questionsToKnowledgePoints, eq(questionsToKnowledgePoints.questionId, questions.id))
|
||||||
|
.innerJoin(knowledgePoints, eq(knowledgePoints.id, questionsToKnowledgePoints.knowledgePointId))
|
||||||
|
.where(
|
||||||
|
and(
|
||||||
|
inArray(practiceAnswers.studentId, studentIds),
|
||||||
|
eq(practiceAnswers.status, "answered"),
|
||||||
|
),
|
||||||
|
)
|
||||||
|
.groupBy(knowledgePoints.id, knowledgePoints.name)
|
||||||
|
.orderBy(desc(count()))
|
||||||
|
.limit(limit)
|
||||||
|
|
||||||
|
return rows.map((r) => {
|
||||||
|
const totalAnswers = Number(r.totalAnswers)
|
||||||
|
const wrongAnswers = Number(r.wrongAnswers)
|
||||||
|
return {
|
||||||
|
knowledgePointId: r.knowledgePointId,
|
||||||
|
knowledgePointName: r.knowledgePointName,
|
||||||
|
totalAnswers,
|
||||||
|
wrongAnswers,
|
||||||
|
errorRate: totalAnswers > 0 ? wrongAnswers / totalAnswers : 0,
|
||||||
|
}
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 年级视图：各班级练习对比
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/** 年级各班级练习对比 */
|
||||||
|
export interface GradeClassPracticeComparison {
|
||||||
|
classId: string
|
||||||
|
className: string
|
||||||
|
totalSessions: number
|
||||||
|
completedSessions: number
|
||||||
|
totalQuestionsAnswered: number
|
||||||
|
totalCorrect: number
|
||||||
|
averageAccuracy: number
|
||||||
|
activeStudents: number
|
||||||
|
totalStudents: number
|
||||||
|
participationRate: number
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取年级各班级专项练习对比数据。
|
||||||
|
*
|
||||||
|
* @param gradeId 年级 ID
|
||||||
|
*/
|
||||||
|
export const getGradeClassPracticeComparison = cache(async (
|
||||||
|
gradeId: string,
|
||||||
|
): Promise<GradeClassPracticeComparison[]> => {
|
||||||
|
const classList = await getClassesByGradeId(gradeId)
|
||||||
|
if (classList.length === 0) return []
|
||||||
|
|
||||||
|
const results = await Promise.all(
|
||||||
|
classList.map(async (cls): Promise<GradeClassPracticeComparison> => {
|
||||||
|
const studentIds = await getActiveStudentIdsByClassId(cls.id)
|
||||||
|
const totalStudents = studentIds.length
|
||||||
|
|
||||||
|
if (totalStudents === 0) {
|
||||||
|
return {
|
||||||
|
classId: cls.id,
|
||||||
|
className: cls.name,
|
||||||
|
totalSessions: 0,
|
||||||
|
completedSessions: 0,
|
||||||
|
totalQuestionsAnswered: 0,
|
||||||
|
totalCorrect: 0,
|
||||||
|
averageAccuracy: 0,
|
||||||
|
activeStudents: 0,
|
||||||
|
totalStudents: 0,
|
||||||
|
participationRate: 0,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
totalSessions: count(),
|
||||||
|
completedSessions: count(sql`CASE WHEN ${practiceSessions.status} = 'completed' THEN 1 END`),
|
||||||
|
totalQuestionsAnswered: sql<number>`COALESCE(SUM(${practiceSessions.answeredQuestions}), 0)`,
|
||||||
|
totalCorrect: sql<number>`COALESCE(SUM(${practiceSessions.correctCount}), 0)`,
|
||||||
|
})
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(inArray(practiceSessions.studentId, studentIds))
|
||||||
|
|
||||||
|
const row = rows[0]
|
||||||
|
const totalQuestionsAnswered = Number(row?.totalQuestionsAnswered ?? 0)
|
||||||
|
const totalCorrect = Number(row?.totalCorrect ?? 0)
|
||||||
|
|
||||||
|
const activeStudentsResult = await db
|
||||||
|
.select({ count: sql<number>`COUNT(DISTINCT ${practiceSessions.studentId})` })
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(inArray(practiceSessions.studentId, studentIds))
|
||||||
|
|
||||||
|
const activeStudents = Number(activeStudentsResult[0]?.count ?? 0)
|
||||||
|
|
||||||
|
return {
|
||||||
|
classId: cls.id,
|
||||||
|
className: cls.name,
|
||||||
|
totalSessions: Number(row?.totalSessions ?? 0),
|
||||||
|
completedSessions: Number(row?.completedSessions ?? 0),
|
||||||
|
totalQuestionsAnswered,
|
||||||
|
totalCorrect,
|
||||||
|
averageAccuracy: totalQuestionsAnswered > 0 ? totalCorrect / totalQuestionsAnswered : 0,
|
||||||
|
activeStudents,
|
||||||
|
totalStudents,
|
||||||
|
participationRate: totalStudents > 0 ? activeStudents / totalStudents : 0,
|
||||||
|
}
|
||||||
|
}),
|
||||||
|
)
|
||||||
|
|
||||||
|
// 按参与率降序排列
|
||||||
|
return results.sort((a, b) => b.participationRate - a.participationRate)
|
||||||
|
})
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 综合宏观数据分析：跨模块整合（错题 + 掌握度 + 练习）
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/** 班级综合学习画像（整合错题、练习、掌握度） */
|
||||||
|
export interface ClassLearningProfile {
|
||||||
|
classId: string
|
||||||
|
className: string
|
||||||
|
totalStudents: number
|
||||||
|
activeStudents: number
|
||||||
|
participationRate: number
|
||||||
|
totalSessions: number
|
||||||
|
completedSessions: number
|
||||||
|
totalQuestionsAnswered: number
|
||||||
|
totalCorrect: number
|
||||||
|
averageAccuracy: number
|
||||||
|
/** 未参与练习的学生 ID 列表 */
|
||||||
|
inactiveStudentIds: string[]
|
||||||
|
/** 知识点薄弱度 Top N */
|
||||||
|
weakKnowledgePoints: ClassKnowledgePointWeakness[]
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取班级综合学习画像。
|
||||||
|
*
|
||||||
|
* 整合专项练习数据、知识点薄弱度、未参与学生识别，
|
||||||
|
* 为班主任提供宏观决策依据。
|
||||||
|
*
|
||||||
|
* @param classId 班级 ID
|
||||||
|
* @param weakKpLimit 知识点薄弱度返回条数（默认 5）
|
||||||
|
*/
|
||||||
|
export const getClassLearningProfile = cache(async (
|
||||||
|
classId: string,
|
||||||
|
weakKpLimit = 5,
|
||||||
|
): Promise<ClassLearningProfile | null> => {
|
||||||
|
const [className, studentIds, stats, weakKps, inactiveIds] = await Promise.all([
|
||||||
|
getClassNameById(classId),
|
||||||
|
getActiveStudentIdsByClassId(classId),
|
||||||
|
getClassPracticeStats(classId),
|
||||||
|
getClassKnowledgePointWeakness(classId, weakKpLimit),
|
||||||
|
getStudentsWithoutPractice(classId),
|
||||||
|
])
|
||||||
|
|
||||||
|
if (studentIds.length === 0) return null
|
||||||
|
|
||||||
|
return {
|
||||||
|
classId,
|
||||||
|
className: className ?? "",
|
||||||
|
totalStudents: studentIds.length,
|
||||||
|
activeStudents: stats?.activeStudents ?? 0,
|
||||||
|
participationRate: studentIds.length > 0
|
||||||
|
? (stats?.activeStudents ?? 0) / studentIds.length
|
||||||
|
: 0,
|
||||||
|
totalSessions: stats?.totalSessions ?? 0,
|
||||||
|
completedSessions: stats?.completedSessions ?? 0,
|
||||||
|
totalQuestionsAnswered: stats?.totalQuestionsAnswered ?? 0,
|
||||||
|
totalCorrect: stats?.totalCorrect ?? 0,
|
||||||
|
averageAccuracy: stats?.averageAccuracy ?? 0,
|
||||||
|
inactiveStudentIds: inactiveIds,
|
||||||
|
weakKnowledgePoints: weakKps,
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 批量获取学生姓名映射。
|
||||||
|
*
|
||||||
|
* 跨模块封装 users/data-access 的 getUserNamesByIds，
|
||||||
|
* 返回简化的 Map<studentId, name> 供分析页面使用。
|
||||||
|
*
|
||||||
|
* @param studentIds 学生 ID 列表
|
||||||
|
*/
|
||||||
|
export const getStudentNameMap = cache(async (
|
||||||
|
studentIds: string[],
|
||||||
|
): Promise<Map<string, string>> => {
|
||||||
|
if (studentIds.length === 0) return new Map()
|
||||||
|
const nameMap = await getUserNamesByIds(studentIds)
|
||||||
|
const result = new Map<string, string>()
|
||||||
|
for (const [id, info] of nameMap.entries()) {
|
||||||
|
result.set(id, info.name ?? "Unknown")
|
||||||
|
}
|
||||||
|
return result
|
||||||
|
})
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取年级所有班级的练习统计概览。
|
||||||
|
*
|
||||||
|
* 用于年级主任宏观数据分析页面，一次性获取年级所有班级的练习数据。
|
||||||
|
*
|
||||||
|
* @param gradeId 年级 ID
|
||||||
|
*/
|
||||||
|
export const getGradeClassOverviews = cache(async (
|
||||||
|
gradeId: string,
|
||||||
|
): Promise<GradeClassPracticeComparison[]> => {
|
||||||
|
return getGradeClassPracticeComparison(gradeId)
|
||||||
|
})
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取年级综合练习统计（聚合所有班级）。
|
||||||
|
*
|
||||||
|
* @param gradeId 年级 ID
|
||||||
|
*/
|
||||||
|
export const getGradePracticeOverview = cache(async (
|
||||||
|
gradeId: string,
|
||||||
|
): Promise<{
|
||||||
|
totalClasses: number
|
||||||
|
totalStudents: number
|
||||||
|
activeStudents: number
|
||||||
|
participationRate: number
|
||||||
|
totalSessions: number
|
||||||
|
completedSessions: number
|
||||||
|
totalQuestionsAnswered: number
|
||||||
|
totalCorrect: number
|
||||||
|
averageAccuracy: number
|
||||||
|
} | null> => {
|
||||||
|
const classComparisons = await getGradeClassPracticeComparison(gradeId)
|
||||||
|
if (classComparisons.length === 0) return null
|
||||||
|
|
||||||
|
const totalClasses = classComparisons.length
|
||||||
|
const totalStudents = classComparisons.reduce((sum, c) => sum + c.totalStudents, 0)
|
||||||
|
const activeStudents = classComparisons.reduce((sum, c) => sum + c.activeStudents, 0)
|
||||||
|
const totalSessions = classComparisons.reduce((sum, c) => sum + c.totalSessions, 0)
|
||||||
|
const completedSessions = classComparisons.reduce((sum, c) => sum + c.completedSessions, 0)
|
||||||
|
const totalQuestionsAnswered = classComparisons.reduce((sum, c) => sum + c.totalQuestionsAnswered, 0)
|
||||||
|
const totalCorrect = classComparisons.reduce((sum, c) => sum + c.totalCorrect, 0)
|
||||||
|
|
||||||
|
return {
|
||||||
|
totalClasses,
|
||||||
|
totalStudents,
|
||||||
|
activeStudents,
|
||||||
|
participationRate: totalStudents > 0 ? activeStudents / totalStudents : 0,
|
||||||
|
totalSessions,
|
||||||
|
completedSessions,
|
||||||
|
totalQuestionsAnswered,
|
||||||
|
totalCorrect,
|
||||||
|
averageAccuracy: totalQuestionsAnswered > 0 ? totalCorrect / totalQuestionsAnswered : 0,
|
||||||
|
}
|
||||||
|
})
|
||||||
343
src/modules/adaptive-practice/data-access-strategy.ts
Normal file
343
src/modules/adaptive-practice/data-access-strategy.ts
Normal file
@@ -0,0 +1,343 @@
|
|||||||
|
import "server-only"
|
||||||
|
|
||||||
|
import { and, eq, inArray, notInArray, sql } from "drizzle-orm"
|
||||||
|
|
||||||
|
import { db } from "@/shared/db"
|
||||||
|
import {
|
||||||
|
knowledgePointMastery,
|
||||||
|
practiceAnswers,
|
||||||
|
questions,
|
||||||
|
questionsToKnowledgePoints,
|
||||||
|
} from "@/shared/db/schema"
|
||||||
|
|
||||||
|
import type { PracticeSourceMeta, QuestionSelectionResult } from "./types"
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 常量
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/** 默认出题数量 */
|
||||||
|
const DEFAULT_QUESTION_COUNT = 10
|
||||||
|
|
||||||
|
/** 薄弱知识点掌握度阈值（低于此值视为薄弱） */
|
||||||
|
const WEAK_MASTERY_THRESHOLD = 60
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 出题策略
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 错题变式练习出题策略。
|
||||||
|
*
|
||||||
|
* 从错题本中选取错题，直接使用原题进行练习（不依赖 AI 生成变式题，
|
||||||
|
* 确保即使 AI 不可用也能练习）。
|
||||||
|
*
|
||||||
|
* 策略：
|
||||||
|
* 1. 从 sourceQuestionIds 中查询题库中存在的题目
|
||||||
|
* 2. 排除已在该练习会话中的题目（由调用方保证）
|
||||||
|
* 3. 按难度升序排列（先易后难，建立信心）
|
||||||
|
*/
|
||||||
|
async function selectForErrorVariant(
|
||||||
|
sourceMeta: PracticeSourceMeta,
|
||||||
|
questionCount: number,
|
||||||
|
): Promise<QuestionSelectionResult> {
|
||||||
|
if (!isErrorVariantSourceMeta(sourceMeta)) {
|
||||||
|
return { questionIds: [], variants: new Map() }
|
||||||
|
}
|
||||||
|
|
||||||
|
const sourceQuestionIds = sourceMeta.sourceQuestionIds
|
||||||
|
if (sourceQuestionIds.length === 0) {
|
||||||
|
return { questionIds: [], variants: new Map() }
|
||||||
|
}
|
||||||
|
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
id: questions.id,
|
||||||
|
difficulty: questions.difficulty,
|
||||||
|
})
|
||||||
|
.from(questions)
|
||||||
|
.where(and(
|
||||||
|
inArray(questions.id, sourceQuestionIds),
|
||||||
|
sql`${questions.parentId} IS NULL`,
|
||||||
|
))
|
||||||
|
.orderBy(questions.difficulty)
|
||||||
|
.limit(questionCount)
|
||||||
|
|
||||||
|
return {
|
||||||
|
questionIds: rows.map((r) => r.id),
|
||||||
|
variants: new Map(),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 知识点专项练习出题策略。
|
||||||
|
*
|
||||||
|
* 从题库中按知识点筛选题目，支持难度过滤。
|
||||||
|
*
|
||||||
|
* 策略：
|
||||||
|
* 1. 按知识点 ID 查询关联题目
|
||||||
|
* 2. 按难度筛选（如指定）
|
||||||
|
* 3. 随机抽取指定数量
|
||||||
|
*/
|
||||||
|
async function selectForKnowledgePoint(
|
||||||
|
sourceMeta: PracticeSourceMeta,
|
||||||
|
questionCount: number,
|
||||||
|
): Promise<QuestionSelectionResult> {
|
||||||
|
if (!isKnowledgePointSourceMeta(sourceMeta)) {
|
||||||
|
return { questionIds: [], variants: new Map() }
|
||||||
|
}
|
||||||
|
|
||||||
|
const { knowledgePointIds, difficulty } = sourceMeta
|
||||||
|
if (knowledgePointIds.length === 0) {
|
||||||
|
return { questionIds: [], variants: new Map() }
|
||||||
|
}
|
||||||
|
|
||||||
|
const conditions = [
|
||||||
|
inArray(questionsToKnowledgePoints.knowledgePointId, knowledgePointIds),
|
||||||
|
sql`${questions.parentId} IS NULL`,
|
||||||
|
]
|
||||||
|
|
||||||
|
if (difficulty !== undefined) {
|
||||||
|
conditions.push(eq(questions.difficulty, difficulty))
|
||||||
|
}
|
||||||
|
|
||||||
|
// 使用子查询获取题目 ID，然后随机排序
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
id: questions.id,
|
||||||
|
})
|
||||||
|
.from(questions)
|
||||||
|
.innerJoin(
|
||||||
|
questionsToKnowledgePoints,
|
||||||
|
eq(questionsToKnowledgePoints.questionId, questions.id),
|
||||||
|
)
|
||||||
|
.where(and(...conditions))
|
||||||
|
.groupBy(questions.id)
|
||||||
|
.orderBy(sql`RAND()`)
|
||||||
|
.limit(questionCount)
|
||||||
|
|
||||||
|
return {
|
||||||
|
questionIds: rows.map((r) => r.id),
|
||||||
|
variants: new Map(),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 薄弱章节练习出题策略。
|
||||||
|
*
|
||||||
|
* 根据学生掌握度自动识别薄弱知识点，从这些知识点中抽题。
|
||||||
|
*
|
||||||
|
* 策略：
|
||||||
|
* 1. 查询学生在指定章节知识点上的掌握度
|
||||||
|
* 2. 筛选掌握度低于阈值的知识点
|
||||||
|
* 3. 从薄弱知识点中抽题
|
||||||
|
*/
|
||||||
|
async function selectForWeakChapter(
|
||||||
|
studentId: string,
|
||||||
|
sourceMeta: PracticeSourceMeta,
|
||||||
|
questionCount: number,
|
||||||
|
): Promise<QuestionSelectionResult> {
|
||||||
|
if (!isWeakChapterSourceMeta(sourceMeta)) {
|
||||||
|
return { questionIds: [], variants: new Map() }
|
||||||
|
}
|
||||||
|
|
||||||
|
const { weakKnowledgePointIds } = sourceMeta
|
||||||
|
if (weakKnowledgePointIds.length === 0) {
|
||||||
|
return { questionIds: [], variants: new Map() }
|
||||||
|
}
|
||||||
|
|
||||||
|
// 查询学生已做过的题目（避免重复）
|
||||||
|
const answeredQuestionIds = await getStudentAnsweredQuestionIds(studentId)
|
||||||
|
|
||||||
|
// 从薄弱知识点中抽题
|
||||||
|
const conditions = [
|
||||||
|
inArray(questionsToKnowledgePoints.knowledgePointId, weakKnowledgePointIds),
|
||||||
|
sql`${questions.parentId} IS NULL`,
|
||||||
|
]
|
||||||
|
|
||||||
|
if (answeredQuestionIds.length > 0) {
|
||||||
|
conditions.push(notInArray(questions.id, answeredQuestionIds))
|
||||||
|
}
|
||||||
|
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
id: questions.id,
|
||||||
|
})
|
||||||
|
.from(questions)
|
||||||
|
.innerJoin(
|
||||||
|
questionsToKnowledgePoints,
|
||||||
|
eq(questionsToKnowledgePoints.questionId, questions.id),
|
||||||
|
)
|
||||||
|
.where(and(...conditions))
|
||||||
|
.groupBy(questions.id)
|
||||||
|
.orderBy(sql`RAND()`)
|
||||||
|
.limit(questionCount)
|
||||||
|
|
||||||
|
return {
|
||||||
|
questionIds: rows.map((r) => r.id),
|
||||||
|
variants: new Map(),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* AI 推荐练习出题策略。
|
||||||
|
*
|
||||||
|
* AI 推荐的知识点列表由上层（AI 分析）提供，
|
||||||
|
* 此函数仅负责从推荐知识点中抽题。
|
||||||
|
*/
|
||||||
|
async function selectForAiRecommended(
|
||||||
|
studentId: string,
|
||||||
|
sourceMeta: PracticeSourceMeta,
|
||||||
|
questionCount: number,
|
||||||
|
): Promise<QuestionSelectionResult> {
|
||||||
|
if (!isAiRecommendedSourceMeta(sourceMeta)) {
|
||||||
|
return { questionIds: [], variants: new Map() }
|
||||||
|
}
|
||||||
|
|
||||||
|
const { recommendedKnowledgePointIds } = sourceMeta
|
||||||
|
if (recommendedKnowledgePointIds.length === 0) {
|
||||||
|
return { questionIds: [], variants: new Map() }
|
||||||
|
}
|
||||||
|
|
||||||
|
// 查询学生已做过的题目
|
||||||
|
const answeredQuestionIds = await getStudentAnsweredQuestionIds(studentId)
|
||||||
|
|
||||||
|
const conditions = [
|
||||||
|
inArray(questionsToKnowledgePoints.knowledgePointId, recommendedKnowledgePointIds),
|
||||||
|
sql`${questions.parentId} IS NULL`,
|
||||||
|
]
|
||||||
|
|
||||||
|
if (answeredQuestionIds.length > 0) {
|
||||||
|
conditions.push(notInArray(questions.id, answeredQuestionIds))
|
||||||
|
}
|
||||||
|
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
id: questions.id,
|
||||||
|
})
|
||||||
|
.from(questions)
|
||||||
|
.innerJoin(
|
||||||
|
questionsToKnowledgePoints,
|
||||||
|
eq(questionsToKnowledgePoints.questionId, questions.id),
|
||||||
|
)
|
||||||
|
.where(and(...conditions))
|
||||||
|
.groupBy(questions.id)
|
||||||
|
.orderBy(sql`RAND()`)
|
||||||
|
.limit(questionCount)
|
||||||
|
|
||||||
|
return {
|
||||||
|
questionIds: rows.map((r) => r.id),
|
||||||
|
variants: new Map(),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 主入口
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 根据练习类型选择题目。
|
||||||
|
*
|
||||||
|
* @param studentId 学生 ID
|
||||||
|
* @param practiceType 练习类型
|
||||||
|
* @param sourceMeta 来源元数据
|
||||||
|
* @param questionCount 题目数量
|
||||||
|
* @returns 选中的题目 ID 列表和变式题映射
|
||||||
|
*/
|
||||||
|
export async function selectQuestionsForPractice(
|
||||||
|
studentId: string,
|
||||||
|
practiceType: string,
|
||||||
|
sourceMeta: PracticeSourceMeta,
|
||||||
|
questionCount: number = DEFAULT_QUESTION_COUNT,
|
||||||
|
): Promise<QuestionSelectionResult> {
|
||||||
|
switch (practiceType) {
|
||||||
|
case "error_variant":
|
||||||
|
return selectForErrorVariant(sourceMeta, questionCount)
|
||||||
|
case "knowledge_point":
|
||||||
|
return selectForKnowledgePoint(sourceMeta, questionCount)
|
||||||
|
case "weak_chapter":
|
||||||
|
return selectForWeakChapter(studentId, sourceMeta, questionCount)
|
||||||
|
case "ai_recommended":
|
||||||
|
return selectForAiRecommended(studentId, sourceMeta, questionCount)
|
||||||
|
default:
|
||||||
|
return { questionIds: [], variants: new Map() }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 辅助函数
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取学生已答过的题目 ID 列表（避免重复练习）。
|
||||||
|
*
|
||||||
|
* 从专项练习中汇总已答题目。
|
||||||
|
* 为控制查询量，仅查询最近 1000 条记录。
|
||||||
|
*/
|
||||||
|
async function getStudentAnsweredQuestionIds(studentId: string): Promise<string[]> {
|
||||||
|
const rows = await db
|
||||||
|
.select({ questionId: practiceAnswers.questionId })
|
||||||
|
.from(practiceAnswers)
|
||||||
|
.where(eq(practiceAnswers.studentId, studentId))
|
||||||
|
.limit(1000)
|
||||||
|
|
||||||
|
return Array.from(new Set(rows.map((r) => r.questionId)))
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 自动识别学生的薄弱知识点。
|
||||||
|
*
|
||||||
|
* 查询掌握度低于阈值的知识点，按掌握度升序排列。
|
||||||
|
* 用于"薄弱章节练习"的自动推荐。
|
||||||
|
*
|
||||||
|
* @param studentId 学生 ID
|
||||||
|
* @param chapterId 章节 ID（可选，不传则查询所有章节）
|
||||||
|
* @param limit 返回数量限制
|
||||||
|
* @returns 薄弱知识点 ID 列表
|
||||||
|
*/
|
||||||
|
export async function identifyWeakKnowledgePoints(
|
||||||
|
studentId: string,
|
||||||
|
chapterId?: string,
|
||||||
|
limit: number = 5,
|
||||||
|
): Promise<string[]> {
|
||||||
|
const conditions = [
|
||||||
|
eq(knowledgePointMastery.studentId, studentId),
|
||||||
|
sql`${knowledgePointMastery.masteryLevel} < ${WEAK_MASTERY_THRESHOLD}`,
|
||||||
|
]
|
||||||
|
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
knowledgePointId: knowledgePointMastery.knowledgePointId,
|
||||||
|
masteryLevel: knowledgePointMastery.masteryLevel,
|
||||||
|
})
|
||||||
|
.from(knowledgePointMastery)
|
||||||
|
.where(and(...conditions))
|
||||||
|
.orderBy(knowledgePointMastery.masteryLevel)
|
||||||
|
.limit(limit)
|
||||||
|
|
||||||
|
return rows.map((r) => r.knowledgePointId)
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 类型守卫
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
function isErrorVariantSourceMeta(meta: PracticeSourceMeta): meta is { errorBookItemIds: string[]; sourceQuestionIds: string[] } {
|
||||||
|
return typeof meta === "object" && meta !== null &&
|
||||||
|
"errorBookItemIds" in meta && "sourceQuestionIds" in meta
|
||||||
|
}
|
||||||
|
|
||||||
|
function isKnowledgePointSourceMeta(meta: PracticeSourceMeta): meta is { knowledgePointIds: string[]; difficulty?: number } {
|
||||||
|
return typeof meta === "object" && meta !== null &&
|
||||||
|
"knowledgePointIds" in meta
|
||||||
|
}
|
||||||
|
|
||||||
|
function isWeakChapterSourceMeta(meta: PracticeSourceMeta): meta is { chapterId: string; weakKnowledgePointIds: string[] } {
|
||||||
|
return typeof meta === "object" && meta !== null &&
|
||||||
|
"chapterId" in meta && "weakKnowledgePointIds" in meta
|
||||||
|
}
|
||||||
|
|
||||||
|
function isAiRecommendedSourceMeta(meta: PracticeSourceMeta): meta is { recommendedKnowledgePointIds: string[]; reason: string } {
|
||||||
|
return typeof meta === "object" && meta !== null &&
|
||||||
|
"recommendedKnowledgePointIds" in meta && "reason" in meta
|
||||||
|
}
|
||||||
619
src/modules/adaptive-practice/data-access.ts
Normal file
619
src/modules/adaptive-practice/data-access.ts
Normal file
@@ -0,0 +1,619 @@
|
|||||||
|
import "server-only"
|
||||||
|
|
||||||
|
import { cache } from "react"
|
||||||
|
import { and, count, desc, eq, inArray } from "drizzle-orm"
|
||||||
|
import { createId } from "@paralleldrive/cuid2"
|
||||||
|
|
||||||
|
import { db } from "@/shared/db"
|
||||||
|
import {
|
||||||
|
practiceAnswers,
|
||||||
|
practiceSessions,
|
||||||
|
questions,
|
||||||
|
} from "@/shared/db/schema"
|
||||||
|
import { selectQuestionsForPractice } from "./data-access-strategy"
|
||||||
|
|
||||||
|
import type {
|
||||||
|
PracticeAnswerRecord,
|
||||||
|
PracticeAnswerStatus,
|
||||||
|
PracticeSessionDetail,
|
||||||
|
PracticeSessionSummary,
|
||||||
|
PracticeSourceMeta,
|
||||||
|
PracticeStats,
|
||||||
|
PracticeStatus,
|
||||||
|
PracticeType,
|
||||||
|
} from "./types"
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 行映射
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
function mapSessionRow(row: typeof practiceSessions.$inferSelect): PracticeSessionSummary {
|
||||||
|
const answeredQuestions = row.answeredQuestions
|
||||||
|
const correctCount = row.correctCount
|
||||||
|
return {
|
||||||
|
id: row.id,
|
||||||
|
studentId: row.studentId,
|
||||||
|
subjectId: row.subjectId,
|
||||||
|
practiceType: row.practiceType as PracticeType,
|
||||||
|
status: row.status as PracticeStatus,
|
||||||
|
totalQuestions: row.totalQuestions,
|
||||||
|
answeredQuestions,
|
||||||
|
correctCount,
|
||||||
|
accuracy: answeredQuestions > 0 ? correctCount / answeredQuestions : 0,
|
||||||
|
startedAt: row.startedAt,
|
||||||
|
completedAt: row.completedAt,
|
||||||
|
createdAt: row.createdAt,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function mapAnswerRow(row: typeof practiceAnswers.$inferSelect & {
|
||||||
|
question?: typeof questions.$inferSelect | null
|
||||||
|
}): PracticeAnswerRecord {
|
||||||
|
return {
|
||||||
|
id: row.id,
|
||||||
|
sessionId: row.sessionId,
|
||||||
|
questionId: row.questionId,
|
||||||
|
variantContent: row.variantContent,
|
||||||
|
isVariant: row.isVariant,
|
||||||
|
orderIndex: row.orderIndex,
|
||||||
|
status: row.status as PracticeAnswerStatus,
|
||||||
|
studentAnswer: row.studentAnswer,
|
||||||
|
isCorrect: row.isCorrect,
|
||||||
|
score: row.score,
|
||||||
|
maxScore: row.maxScore,
|
||||||
|
answeredAt: row.answeredAt,
|
||||||
|
question: row.question
|
||||||
|
? {
|
||||||
|
id: row.question.id,
|
||||||
|
content: row.question.content,
|
||||||
|
type: row.question.type,
|
||||||
|
difficulty: row.question.difficulty,
|
||||||
|
}
|
||||||
|
: null,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 查询：练习会话列表
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export const getPracticeSessions = cache(async (
|
||||||
|
studentId: string,
|
||||||
|
options?: {
|
||||||
|
status?: PracticeStatus
|
||||||
|
practiceType?: PracticeType
|
||||||
|
page?: number
|
||||||
|
pageSize?: number
|
||||||
|
},
|
||||||
|
): Promise<{ data: PracticeSessionSummary[]; total: number }> => {
|
||||||
|
const page = options?.page ?? 1
|
||||||
|
const pageSize = options?.pageSize ?? 20
|
||||||
|
const offset = (page - 1) * pageSize
|
||||||
|
|
||||||
|
const conditions = [eq(practiceSessions.studentId, studentId)]
|
||||||
|
|
||||||
|
if (options?.status) {
|
||||||
|
conditions.push(eq(practiceSessions.status, options.status))
|
||||||
|
}
|
||||||
|
|
||||||
|
if (options?.practiceType) {
|
||||||
|
conditions.push(eq(practiceSessions.practiceType, options.practiceType))
|
||||||
|
}
|
||||||
|
|
||||||
|
const whereClause = and(...conditions)
|
||||||
|
|
||||||
|
const [totalResult] = await db
|
||||||
|
.select({ value: count() })
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(whereClause)
|
||||||
|
|
||||||
|
const total = Number(totalResult?.value ?? 0)
|
||||||
|
|
||||||
|
const rows = await db
|
||||||
|
.select()
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(whereClause)
|
||||||
|
.orderBy(desc(practiceSessions.createdAt))
|
||||||
|
.limit(pageSize)
|
||||||
|
.offset(offset)
|
||||||
|
|
||||||
|
return {
|
||||||
|
data: rows.map(mapSessionRow),
|
||||||
|
total,
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 查询：练习会话详情（含答题记录）
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export const getPracticeSessionById = cache(async (
|
||||||
|
sessionId: string,
|
||||||
|
studentId: string,
|
||||||
|
): Promise<PracticeSessionDetail | null> => {
|
||||||
|
const session = await db.query.practiceSessions.findFirst({
|
||||||
|
where: and(
|
||||||
|
eq(practiceSessions.id, sessionId),
|
||||||
|
eq(practiceSessions.studentId, studentId),
|
||||||
|
),
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!session) return null
|
||||||
|
|
||||||
|
const answers = await db
|
||||||
|
.select()
|
||||||
|
.from(practiceAnswers)
|
||||||
|
.where(eq(practiceAnswers.sessionId, sessionId))
|
||||||
|
.orderBy(practiceAnswers.orderIndex)
|
||||||
|
|
||||||
|
// 批量查询题目内容
|
||||||
|
const questionIds = answers.map((a) => a.questionId)
|
||||||
|
const questionMap = new Map<string, typeof questions.$inferSelect>()
|
||||||
|
|
||||||
|
if (questionIds.length > 0) {
|
||||||
|
const questionRows = await db
|
||||||
|
.select()
|
||||||
|
.from(questions)
|
||||||
|
.where(inArray(questions.id, questionIds))
|
||||||
|
|
||||||
|
for (const q of questionRows) {
|
||||||
|
questionMap.set(q.id, q)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const mappedAnswers: PracticeAnswerRecord[] = answers.map((a) => {
|
||||||
|
const question = questionMap.get(a.questionId) ?? null
|
||||||
|
return mapAnswerRow({ ...a, question })
|
||||||
|
})
|
||||||
|
|
||||||
|
const summary = mapSessionRow(session)
|
||||||
|
|
||||||
|
return {
|
||||||
|
...summary,
|
||||||
|
sourceMeta: session.sourceMeta as PracticeSourceMeta | null,
|
||||||
|
answers: mappedAnswers,
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 查询：练习统计
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export const getPracticeStats = cache(async (studentId: string): Promise<PracticeStats> => {
|
||||||
|
const rows = await db
|
||||||
|
.select({
|
||||||
|
practiceType: practiceSessions.practiceType,
|
||||||
|
status: practiceSessions.status,
|
||||||
|
totalQuestions: practiceSessions.totalQuestions,
|
||||||
|
answeredQuestions: practiceSessions.answeredQuestions,
|
||||||
|
correctCount: practiceSessions.correctCount,
|
||||||
|
})
|
||||||
|
.from(practiceSessions)
|
||||||
|
.where(eq(practiceSessions.studentId, studentId))
|
||||||
|
|
||||||
|
const totalSessions = rows.length
|
||||||
|
let completedSessions = 0
|
||||||
|
let totalQuestionsAnswered = 0
|
||||||
|
let totalCorrect = 0
|
||||||
|
|
||||||
|
const byTypeMap = new Map<string, { sessionCount: number; totalQuestions: number; correctCount: number }>()
|
||||||
|
|
||||||
|
for (const row of rows) {
|
||||||
|
if (row.status === "completed") {
|
||||||
|
completedSessions++
|
||||||
|
}
|
||||||
|
totalQuestionsAnswered += row.answeredQuestions
|
||||||
|
totalCorrect += row.correctCount
|
||||||
|
|
||||||
|
const stat = byTypeMap.get(row.practiceType) ?? { sessionCount: 0, totalQuestions: 0, correctCount: 0 }
|
||||||
|
stat.sessionCount++
|
||||||
|
stat.totalQuestions += row.totalQuestions
|
||||||
|
stat.correctCount += row.correctCount
|
||||||
|
byTypeMap.set(row.practiceType, stat)
|
||||||
|
}
|
||||||
|
|
||||||
|
const byType = Array.from(byTypeMap.entries()).map(([type, stat]) => ({
|
||||||
|
practiceType: type as PracticeType,
|
||||||
|
sessionCount: stat.sessionCount,
|
||||||
|
totalQuestions: stat.totalQuestions,
|
||||||
|
correctCount: stat.correctCount,
|
||||||
|
accuracy: stat.totalQuestions > 0 ? stat.correctCount / stat.totalQuestions : 0,
|
||||||
|
}))
|
||||||
|
|
||||||
|
return {
|
||||||
|
totalSessions,
|
||||||
|
completedSessions,
|
||||||
|
totalQuestionsAnswered,
|
||||||
|
totalCorrect,
|
||||||
|
overallAccuracy: totalQuestionsAnswered > 0 ? totalCorrect / totalQuestionsAnswered : 0,
|
||||||
|
byType,
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 写入：创建练习会话
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 创建练习会话。
|
||||||
|
*
|
||||||
|
* 1. 根据练习类型调用出题策略选择题目
|
||||||
|
* 2. 创建会话记录
|
||||||
|
* 3. 创建答题记录（初始状态为 pending）
|
||||||
|
*
|
||||||
|
* @returns 会话 ID 和选中的题目数量
|
||||||
|
*/
|
||||||
|
export async function createPracticeSession(
|
||||||
|
studentId: string,
|
||||||
|
input: {
|
||||||
|
practiceType: PracticeType
|
||||||
|
subjectId?: string
|
||||||
|
sourceMeta: PracticeSourceMeta
|
||||||
|
questionCount?: number
|
||||||
|
},
|
||||||
|
): Promise<{ sessionId: string; selectedCount: number }> {
|
||||||
|
const { practiceType, sourceMeta, questionCount = 10 } = input
|
||||||
|
|
||||||
|
// 调用出题策略选择题目
|
||||||
|
const selection = await selectQuestionsForPractice(
|
||||||
|
studentId,
|
||||||
|
practiceType,
|
||||||
|
sourceMeta,
|
||||||
|
questionCount,
|
||||||
|
)
|
||||||
|
|
||||||
|
if (selection.questionIds.length === 0) {
|
||||||
|
return { sessionId: "", selectedCount: 0 }
|
||||||
|
}
|
||||||
|
|
||||||
|
const sessionId = createId()
|
||||||
|
const now = new Date()
|
||||||
|
|
||||||
|
// 事务：创建会话 + 答题记录
|
||||||
|
await db.transaction(async (tx) => {
|
||||||
|
await tx.insert(practiceSessions).values({
|
||||||
|
id: sessionId,
|
||||||
|
studentId,
|
||||||
|
subjectId: input.subjectId ?? null,
|
||||||
|
practiceType,
|
||||||
|
sourceMeta: sourceMeta as unknown,
|
||||||
|
status: "in_progress",
|
||||||
|
totalQuestions: selection.questionIds.length,
|
||||||
|
answeredQuestions: 0,
|
||||||
|
correctCount: 0,
|
||||||
|
startedAt: now,
|
||||||
|
})
|
||||||
|
|
||||||
|
// 批量插入答题记录
|
||||||
|
const answerRows = selection.questionIds.map((questionId, index) => ({
|
||||||
|
id: createId(),
|
||||||
|
sessionId,
|
||||||
|
studentId,
|
||||||
|
questionId,
|
||||||
|
variantContent: selection.variants.get(questionId) ?? null,
|
||||||
|
isVariant: selection.variants.has(questionId),
|
||||||
|
orderIndex: index,
|
||||||
|
status: "pending" as const,
|
||||||
|
maxScore: 1,
|
||||||
|
}))
|
||||||
|
|
||||||
|
await tx.insert(practiceAnswers).values(answerRows)
|
||||||
|
})
|
||||||
|
|
||||||
|
return { sessionId, selectedCount: selection.questionIds.length }
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 写入：提交单题答案
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提交单题答案并自动判分。
|
||||||
|
*
|
||||||
|
* 自动判分逻辑：
|
||||||
|
* - 选择题/判断题：通过 extractCorrectAnswer 比对答案
|
||||||
|
* - 填空题：暂不自动判分（isCorrect = null）
|
||||||
|
*
|
||||||
|
* @returns 是否判分成功
|
||||||
|
*/
|
||||||
|
export async function submitPracticeAnswer(
|
||||||
|
sessionId: string,
|
||||||
|
studentId: string,
|
||||||
|
answerId: string,
|
||||||
|
answer: unknown,
|
||||||
|
skip: boolean = false,
|
||||||
|
): Promise<{ isCorrect: boolean | null; score: number | null }> {
|
||||||
|
// 校验会话归属
|
||||||
|
const session = await db.query.practiceSessions.findFirst({
|
||||||
|
where: and(
|
||||||
|
eq(practiceSessions.id, sessionId),
|
||||||
|
eq(practiceSessions.studentId, studentId),
|
||||||
|
),
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!session) {
|
||||||
|
throw new Error("练习会话不存在或无权访问")
|
||||||
|
}
|
||||||
|
|
||||||
|
if (session.status !== "in_progress") {
|
||||||
|
throw new Error("练习会话已结束")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 查询答题记录
|
||||||
|
const answerRecord = await db.query.practiceAnswers.findFirst({
|
||||||
|
where: and(
|
||||||
|
eq(practiceAnswers.id, answerId),
|
||||||
|
eq(practiceAnswers.sessionId, sessionId),
|
||||||
|
),
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!answerRecord) {
|
||||||
|
throw new Error("答题记录不存在")
|
||||||
|
}
|
||||||
|
|
||||||
|
if (answerRecord.status === "answered") {
|
||||||
|
throw new Error("此题已作答")
|
||||||
|
}
|
||||||
|
|
||||||
|
const now = new Date()
|
||||||
|
|
||||||
|
if (skip) {
|
||||||
|
// 跳过此题
|
||||||
|
await db
|
||||||
|
.update(practiceAnswers)
|
||||||
|
.set({
|
||||||
|
status: "skipped",
|
||||||
|
answeredAt: now,
|
||||||
|
})
|
||||||
|
.where(eq(practiceAnswers.id, answerId))
|
||||||
|
|
||||||
|
// 更新会话统计
|
||||||
|
await updateSessionStats(sessionId, 0, false)
|
||||||
|
return { isCorrect: null, score: null }
|
||||||
|
}
|
||||||
|
|
||||||
|
// 自动判分：查询题目内容并提取正确答案
|
||||||
|
const question = await db.query.questions.findFirst({
|
||||||
|
where: eq(questions.id, answerRecord.questionId),
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!question) {
|
||||||
|
throw new Error("题目不存在")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 如果是变式题，使用变式题内容
|
||||||
|
const contentToUse = answerRecord.variantContent ?? question.content
|
||||||
|
const isCorrect = autoGradeAnswer(question.type, contentToUse, answer)
|
||||||
|
|
||||||
|
const score = isCorrect === true ? answerRecord.maxScore : (isCorrect === false ? 0 : null)
|
||||||
|
|
||||||
|
await db
|
||||||
|
.update(practiceAnswers)
|
||||||
|
.set({
|
||||||
|
status: "answered",
|
||||||
|
studentAnswer: answer,
|
||||||
|
isCorrect,
|
||||||
|
score,
|
||||||
|
answeredAt: now,
|
||||||
|
})
|
||||||
|
.where(eq(practiceAnswers.id, answerId))
|
||||||
|
|
||||||
|
// 更新会话统计
|
||||||
|
await updateSessionStats(
|
||||||
|
sessionId,
|
||||||
|
1,
|
||||||
|
isCorrect === true,
|
||||||
|
)
|
||||||
|
|
||||||
|
return { isCorrect, score }
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 写入：完成/放弃练习会话
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export async function completePracticeSession(
|
||||||
|
sessionId: string,
|
||||||
|
studentId: string,
|
||||||
|
): Promise<void> {
|
||||||
|
const session = await db.query.practiceSessions.findFirst({
|
||||||
|
where: and(
|
||||||
|
eq(practiceSessions.id, sessionId),
|
||||||
|
eq(practiceSessions.studentId, studentId),
|
||||||
|
),
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!session) {
|
||||||
|
throw new Error("练习会话不存在或无权访问")
|
||||||
|
}
|
||||||
|
|
||||||
|
if (session.status !== "in_progress") {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
await db
|
||||||
|
.update(practiceSessions)
|
||||||
|
.set({
|
||||||
|
status: "completed",
|
||||||
|
completedAt: new Date(),
|
||||||
|
})
|
||||||
|
.where(eq(practiceSessions.id, sessionId))
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function abandonPracticeSession(
|
||||||
|
sessionId: string,
|
||||||
|
studentId: string,
|
||||||
|
): Promise<void> {
|
||||||
|
const session = await db.query.practiceSessions.findFirst({
|
||||||
|
where: and(
|
||||||
|
eq(practiceSessions.id, sessionId),
|
||||||
|
eq(practiceSessions.studentId, studentId),
|
||||||
|
),
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!session) {
|
||||||
|
throw new Error("练习会话不存在或无权访问")
|
||||||
|
}
|
||||||
|
|
||||||
|
if (session.status !== "in_progress") {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
await db
|
||||||
|
.update(practiceSessions)
|
||||||
|
.set({
|
||||||
|
status: "abandoned",
|
||||||
|
completedAt: new Date(),
|
||||||
|
})
|
||||||
|
.where(eq(practiceSessions.id, sessionId))
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 内部辅助函数
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 更新会话统计（已答题数、正确数）。
|
||||||
|
*/
|
||||||
|
async function updateSessionStats(
|
||||||
|
sessionId: string,
|
||||||
|
newlyAnswered: number,
|
||||||
|
newlyCorrect: boolean,
|
||||||
|
): Promise<void> {
|
||||||
|
const session = await db.query.practiceSessions.findFirst({
|
||||||
|
where: eq(practiceSessions.id, sessionId),
|
||||||
|
columns: {
|
||||||
|
answeredQuestions: true,
|
||||||
|
correctCount: true,
|
||||||
|
},
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!session) return
|
||||||
|
|
||||||
|
await db
|
||||||
|
.update(practiceSessions)
|
||||||
|
.set({
|
||||||
|
answeredQuestions: session.answeredQuestions + newlyAnswered,
|
||||||
|
correctCount: session.correctCount + (newlyCorrect ? 1 : 0),
|
||||||
|
})
|
||||||
|
.where(eq(practiceSessions.id, sessionId))
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 自动判分：比对学生答案与正确答案。
|
||||||
|
*
|
||||||
|
* 支持题型：
|
||||||
|
* - single_choice: 比对选中选项 ID
|
||||||
|
* - multiple_choice: 比对选中选项 ID 集合（顺序无关）
|
||||||
|
* - judgment: 比对布尔值
|
||||||
|
* - text: 不自动判分（返回 null）
|
||||||
|
*
|
||||||
|
* @param questionType 题目类型
|
||||||
|
* @param content 题目内容（或变式题内容）
|
||||||
|
* @param studentAnswer 学生答案
|
||||||
|
* @returns 是否正确（null 表示无法自动判分）
|
||||||
|
*/
|
||||||
|
function autoGradeAnswer(
|
||||||
|
questionType: string,
|
||||||
|
content: unknown,
|
||||||
|
studentAnswer: unknown,
|
||||||
|
): boolean | null {
|
||||||
|
if (questionType === "single_choice" || questionType === "multiple_choice") {
|
||||||
|
const correctIds = extractChoiceCorrectIds(content)
|
||||||
|
if (correctIds.length === 0) return null
|
||||||
|
|
||||||
|
const studentIds = normalizeAnswerToIds(studentAnswer)
|
||||||
|
if (studentIds.length === 0) return false
|
||||||
|
|
||||||
|
if (questionType === "single_choice") {
|
||||||
|
return studentIds.length === 1 && studentIds[0] === correctIds[0]
|
||||||
|
}
|
||||||
|
|
||||||
|
// multiple_choice: 集合比对
|
||||||
|
if (studentIds.length !== correctIds.length) return false
|
||||||
|
const correctSet = new Set(correctIds)
|
||||||
|
return studentIds.every((id) => correctSet.has(id))
|
||||||
|
}
|
||||||
|
|
||||||
|
if (questionType === "judgment") {
|
||||||
|
const correctAnswer = extractJudgmentCorrectAnswer(content)
|
||||||
|
if (correctAnswer === null) return null
|
||||||
|
|
||||||
|
const studentBool = normalizeAnswerToBool(studentAnswer)
|
||||||
|
if (studentBool === null) return null
|
||||||
|
|
||||||
|
return studentBool === correctAnswer
|
||||||
|
}
|
||||||
|
|
||||||
|
// text 题型不自动判分
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从题目内容中提取选择题正确选项 ID 列表。
|
||||||
|
*/
|
||||||
|
function extractChoiceCorrectIds(content: unknown): string[] {
|
||||||
|
if (!isRecord(content)) return []
|
||||||
|
|
||||||
|
const options = content.options
|
||||||
|
if (!Array.isArray(options)) return []
|
||||||
|
|
||||||
|
return options
|
||||||
|
.filter((opt: unknown) => isRecord(opt) && opt.isCorrect === true)
|
||||||
|
.map((opt: unknown) => {
|
||||||
|
const record = opt as Record<string, unknown>
|
||||||
|
return typeof record.id === "string" ? record.id : ""
|
||||||
|
})
|
||||||
|
.filter((id: string) => id.length > 0)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从题目内容中提取判断题正确答案。
|
||||||
|
*/
|
||||||
|
function extractJudgmentCorrectAnswer(content: unknown): boolean | null {
|
||||||
|
if (!isRecord(content)) return null
|
||||||
|
|
||||||
|
const answer = content.answer
|
||||||
|
if (typeof answer === "boolean") return answer
|
||||||
|
if (typeof answer === "string") {
|
||||||
|
const lower = answer.toLowerCase()
|
||||||
|
if (lower === "true" || lower === "correct" || lower === "对" || lower === "正确") return true
|
||||||
|
if (lower === "false" || lower === "incorrect" || lower === "wrong" || lower === "错" || lower === "错误") return false
|
||||||
|
}
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将学生答案归一化为选项 ID 列表。
|
||||||
|
*/
|
||||||
|
function normalizeAnswerToIds(answer: unknown): string[] {
|
||||||
|
if (typeof answer === "string") return [answer]
|
||||||
|
if (Array.isArray(answer)) {
|
||||||
|
return answer.filter((v): v is string => typeof v === "string")
|
||||||
|
}
|
||||||
|
if (isRecord(answer)) {
|
||||||
|
const ids = answer.selectedIds
|
||||||
|
if (Array.isArray(ids)) {
|
||||||
|
return ids.filter((v): v is string => typeof v === "string")
|
||||||
|
}
|
||||||
|
if (typeof answer.id === "string") return [answer.id]
|
||||||
|
}
|
||||||
|
return []
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将学生答案归一化为布尔值。
|
||||||
|
*/
|
||||||
|
function normalizeAnswerToBool(answer: unknown): boolean | null {
|
||||||
|
if (typeof answer === "boolean") return answer
|
||||||
|
if (typeof answer === "string") {
|
||||||
|
const lower = answer.toLowerCase()
|
||||||
|
if (lower === "true" || lower === "correct" || lower === "对" || lower === "正确") return true
|
||||||
|
if (lower === "false" || lower === "incorrect" || lower === "wrong" || lower === "错" || lower === "错误") return false
|
||||||
|
}
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
|
function isRecord(value: unknown): value is Record<string, unknown> {
|
||||||
|
return typeof value === "object" && value !== null
|
||||||
|
}
|
||||||
74
src/modules/adaptive-practice/schema.ts
Normal file
74
src/modules/adaptive-practice/schema.ts
Normal file
@@ -0,0 +1,74 @@
|
|||||||
|
import { z } from "zod"
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 枚举验证
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export const PracticeTypeSchema = z.enum([
|
||||||
|
"error_variant",
|
||||||
|
"knowledge_point",
|
||||||
|
"weak_chapter",
|
||||||
|
"ai_recommended",
|
||||||
|
])
|
||||||
|
|
||||||
|
export const PracticeAnswerStatusSchema = z.enum(["pending", "answered", "skipped"])
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 来源元数据验证
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export const ErrorVariantSourceMetaSchema = z.object({
|
||||||
|
errorBookItemIds: z.array(z.string().min(1)).min(1),
|
||||||
|
sourceQuestionIds: z.array(z.string().min(1)).min(1),
|
||||||
|
})
|
||||||
|
|
||||||
|
export const KnowledgePointSourceMetaSchema = z.object({
|
||||||
|
knowledgePointIds: z.array(z.string().min(1)).min(1),
|
||||||
|
difficulty: z.number().int().min(1).max(5).optional(),
|
||||||
|
})
|
||||||
|
|
||||||
|
export const WeakChapterSourceMetaSchema = z.object({
|
||||||
|
chapterId: z.string().min(1),
|
||||||
|
weakKnowledgePointIds: z.array(z.string().min(1)).min(1),
|
||||||
|
})
|
||||||
|
|
||||||
|
export const AiRecommendedSourceMetaSchema = z.object({
|
||||||
|
recommendedKnowledgePointIds: z.array(z.string().min(1)).min(1),
|
||||||
|
reason: z.string().min(1),
|
||||||
|
})
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// Action 输入验证
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export const CreatePracticeSessionSchema = z.object({
|
||||||
|
practiceType: PracticeTypeSchema,
|
||||||
|
subjectId: z.string().min(1).optional(),
|
||||||
|
sourceMeta: z.record(z.string(), z.unknown()),
|
||||||
|
questionCount: z.number().int().min(1).max(50).default(10),
|
||||||
|
})
|
||||||
|
|
||||||
|
export const SubmitPracticeAnswerSchema = z.object({
|
||||||
|
sessionId: z.string().min(1),
|
||||||
|
answerId: z.string().min(1),
|
||||||
|
answer: z.unknown(),
|
||||||
|
/** 跳过此题 */
|
||||||
|
skip: z.boolean().optional(),
|
||||||
|
})
|
||||||
|
|
||||||
|
export const CompletePracticeSessionSchema = z.object({
|
||||||
|
sessionId: z.string().min(1),
|
||||||
|
})
|
||||||
|
|
||||||
|
export const AbandonPracticeSessionSchema = z.object({
|
||||||
|
sessionId: z.string().min(1),
|
||||||
|
})
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 类型导出
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export type CreatePracticeSessionInput = z.infer<typeof CreatePracticeSessionSchema>
|
||||||
|
export type SubmitPracticeAnswerInput = z.infer<typeof SubmitPracticeAnswerSchema>
|
||||||
|
export type CompletePracticeSessionInput = z.infer<typeof CompletePracticeSessionSchema>
|
||||||
|
export type AbandonPracticeSessionInput = z.infer<typeof AbandonPracticeSessionSchema>
|
||||||
143
src/modules/adaptive-practice/types.ts
Normal file
143
src/modules/adaptive-practice/types.ts
Normal file
@@ -0,0 +1,143 @@
|
|||||||
|
/**
|
||||||
|
* Adaptive Practice 模块类型定义
|
||||||
|
*
|
||||||
|
* 专项练习闭环：错题变式 → 知识点专项 → 薄弱章节 → AI 推荐
|
||||||
|
*/
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 枚举类型（与 schema 保持一致）
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export type PracticeType = "error_variant" | "knowledge_point" | "weak_chapter" | "ai_recommended"
|
||||||
|
export type PracticeStatus = "in_progress" | "completed" | "abandoned"
|
||||||
|
export type PracticeAnswerStatus = "pending" | "answered" | "skipped"
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 来源元数据
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/** 错题变式练习来源 */
|
||||||
|
export interface ErrorVariantSourceMeta {
|
||||||
|
/** 触发练习的错题 ID 列表 */
|
||||||
|
errorBookItemIds: string[]
|
||||||
|
/** 关联的原题 ID 列表 */
|
||||||
|
sourceQuestionIds: string[]
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 知识点专项练习来源 */
|
||||||
|
export interface KnowledgePointSourceMeta {
|
||||||
|
knowledgePointIds: string[]
|
||||||
|
/** 难度筛选（1-5，不传则不限） */
|
||||||
|
difficulty?: number
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 薄弱章节练习来源 */
|
||||||
|
export interface WeakChapterSourceMeta {
|
||||||
|
chapterId: string
|
||||||
|
/** 自动识别的薄弱知识点 */
|
||||||
|
weakKnowledgePointIds: string[]
|
||||||
|
}
|
||||||
|
|
||||||
|
/** AI 推荐练习来源 */
|
||||||
|
export interface AiRecommendedSourceMeta {
|
||||||
|
/** AI 推荐的知识点列表 */
|
||||||
|
recommendedKnowledgePointIds: string[]
|
||||||
|
/** 推荐理由 */
|
||||||
|
reason: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export type PracticeSourceMeta =
|
||||||
|
| ErrorVariantSourceMeta
|
||||||
|
| KnowledgePointSourceMeta
|
||||||
|
| WeakChapterSourceMeta
|
||||||
|
| AiRecommendedSourceMeta
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 数据传输类型
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/** 练习会话（列表视图） */
|
||||||
|
export interface PracticeSessionSummary {
|
||||||
|
id: string
|
||||||
|
studentId: string
|
||||||
|
subjectId: string | null
|
||||||
|
practiceType: PracticeType
|
||||||
|
status: PracticeStatus
|
||||||
|
totalQuestions: number
|
||||||
|
answeredQuestions: number
|
||||||
|
correctCount: number
|
||||||
|
/** 正确率 0-1 */
|
||||||
|
accuracy: number
|
||||||
|
startedAt: Date
|
||||||
|
completedAt: Date | null
|
||||||
|
createdAt: Date
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 练习答题记录 */
|
||||||
|
export interface PracticeAnswerRecord {
|
||||||
|
id: string
|
||||||
|
sessionId: string
|
||||||
|
questionId: string
|
||||||
|
variantContent: unknown | null
|
||||||
|
isVariant: boolean
|
||||||
|
orderIndex: number
|
||||||
|
status: PracticeAnswerStatus
|
||||||
|
studentAnswer: unknown | null
|
||||||
|
isCorrect: boolean | null
|
||||||
|
score: number | null
|
||||||
|
maxScore: number
|
||||||
|
answeredAt: Date | null
|
||||||
|
/** 关联题目内容（联表查询） */
|
||||||
|
question: {
|
||||||
|
id: string
|
||||||
|
content: unknown
|
||||||
|
type: string
|
||||||
|
difficulty: number | null
|
||||||
|
} | null
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 练习会话详情（含答题记录） */
|
||||||
|
export interface PracticeSessionDetail extends PracticeSessionSummary {
|
||||||
|
sourceMeta: PracticeSourceMeta | null
|
||||||
|
answers: PracticeAnswerRecord[]
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 练习统计 */
|
||||||
|
export interface PracticeStats {
|
||||||
|
totalSessions: number
|
||||||
|
completedSessions: number
|
||||||
|
totalQuestionsAnswered: number
|
||||||
|
totalCorrect: number
|
||||||
|
/** 总体正确率 0-1 */
|
||||||
|
overallAccuracy: number
|
||||||
|
/** 按练习类型分组统计 */
|
||||||
|
byType: Array<{
|
||||||
|
practiceType: PracticeType
|
||||||
|
sessionCount: number
|
||||||
|
totalQuestions: number
|
||||||
|
correctCount: number
|
||||||
|
accuracy: number
|
||||||
|
}>
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// 出题策略输入
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/** 创建练习会话的输入 */
|
||||||
|
export interface CreatePracticeSessionInput {
|
||||||
|
practiceType: PracticeType
|
||||||
|
subjectId?: string
|
||||||
|
/** 来源元数据（类型不同则结构不同） */
|
||||||
|
sourceMeta: PracticeSourceMeta
|
||||||
|
/** 题目数量（默认 10） */
|
||||||
|
questionCount?: number
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 出题策略结果 */
|
||||||
|
export interface QuestionSelectionResult {
|
||||||
|
/** 选中的题目 ID 列表 */
|
||||||
|
questionIds: string[]
|
||||||
|
/** 变式题映射：原题 ID → 变式题内容（AI 生成时使用） */
|
||||||
|
variants: Map<string, unknown>
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user