feat(diagnostic): add export, stats service, and confidence utils

- Add export module for diagnostic report data export

- Add stats-service for diagnostic analytics aggregation

- Add confidence-utils for diagnostic confidence score calculations

src/modules/diagnostic/components/student-diagnostic-view.tsx

@@ -1,28 +1,50 @@
 "use client"
 
 import Link from "next/link"
+import { useTranslations } from "next-intl"
 import { Award, AlertTriangle, Lightbulb, FileText, History, ArrowRight } from "lucide-react"
 
 import { Card, CardContent, CardHeader, CardTitle, CardDescription } from "@/shared/components/ui/card"
 import { Badge } from "@/shared/components/ui/badge"
 import { Button } from "@/shared/components/ui/button"
+import { Tooltip, TooltipContent, TooltipTrigger } from "@/shared/components/ui/tooltip"
 import { EmptyState } from "@/shared/components/ui/empty-state"
 import { formatDate } from "@/shared/lib/utils"
 import { MasteryRadarChart } from "./mastery-radar-chart"
+import {
+  getConfidenceLevel,
+  confidenceBadgeVariant,
+  type ConfidenceLevel,
+} from "./confidence-utils"
 import type { DiagnosticReportWithDetails, MasteryRadarPoint, StudentMasterySummary } from "../types"
 
 interface StudentDiagnosticViewProps {
   summary: StudentMasterySummary | null
   reports: DiagnosticReportWithDetails[]
   classAverageMastery?: MasteryRadarPoint[]
+  /**
+   * v3-P2-6: "练习"按钮的跳转基础路径。
+   * - 学生视角：默认 `/student/learning/assignments`
+   * - 教师视角：传入 `/teacher/questions`（题目库支持 kp 查询参数筛选）
+   * - 家长视角：传入 `null` 隐藏练习按钮（家长无练习入口）
+   * 最终链接会附加 `?kp={knowledgePointId}` 实现个性化练习推荐。
+   */
+  practiceHrefBase?: string | null
 }
 
-export function StudentDiagnosticView({ summary, reports, classAverageMastery }: StudentDiagnosticViewProps) {
+export function StudentDiagnosticView({
+  summary,
+  reports,
+  classAverageMastery,
+  practiceHrefBase = "/student/learning/assignments",
+}: StudentDiagnosticViewProps) {
+  const t = useTranslations("diagnostic")
+
   if (!summary) {
     return (
       <EmptyState
-        title="No diagnostic data"
-        description="Unable to load student mastery data."
+        title={t("empty.noData")}
+        description={t("studentDiagnostic.noDataDescription")}
         icon={FileText}
         className="border-none shadow-none"
       />
@@ -39,7 +61,38 @@ export function StudentDiagnosticView({ summary, reports, classAverageMastery }:
   })
 
   const publishedReports = reports.filter((r) => r.status === "published")
-  const latestReport = publishedReports[0] ?? reports[0] ?? null
+  // v4-P1-3: 移除草稿回退逻辑，仅展示已发布报告
+  // 调用方（学生/家长页面）已传 status: "published" 过滤，此处双重保障
+  const latestReport = publishedReports[0] ?? null
+
+  const statusLabel = (status: string): string => {
+    if (status === "draft") return t("status.draft")
+    if (status === "published") return t("status.published")
+    if (status === "archived") return t("status.archived")
+    return status
+  }
+
+  const typeLabel = (reportType: string): string => {
+    if (reportType === "individual") return t("type.individual")
+    if (reportType === "class") return t("type.class")
+    if (reportType === "grade") return t("type.grade")
+    return reportType
+  }
+
+  // v4-P3-7: 置信度标签与提示
+  const confidenceLabel = (level: ConfidenceLevel): string => {
+    if (level === "high") return t("reportList.confidenceHigh")
+    if (level === "medium") return t("reportList.confidenceMedium")
+    if (level === "low") return t("reportList.confidenceLow")
+    return t("reportList.confidenceInsufficient")
+  }
+
+  const confidenceHint = (level: ConfidenceLevel): string => {
+    if (level === "high") return t("reportList.confidenceHighHint")
+    if (level === "medium") return t("reportList.confidenceMediumHint")
+    if (level === "low") return t("reportList.confidenceLowHint")
+    return t("reportList.confidenceInsufficient")
+  }
 
   return (
     <div className="space-y-6">
@@ -47,7 +100,7 @@ export function StudentDiagnosticView({ summary, reports, classAverageMastery }:
       <div className="grid grid-cols-1 gap-4 md:grid-cols-4">
         <Card>
           <CardHeader className="pb-2">
-            <CardTitle className="text-sm font-medium text-muted-foreground">Student</CardTitle>
+            <CardTitle className="text-sm font-medium text-muted-foreground">{t("summary.student")}</CardTitle>
           </CardHeader>
           <CardContent>
             <p className="text-2xl font-bold">{summary.studentName}</p>
@@ -55,7 +108,7 @@ export function StudentDiagnosticView({ summary, reports, classAverageMastery }:
         </Card>
         <Card>
           <CardHeader className="pb-2">
-            <CardTitle className="text-sm font-medium text-muted-foreground">Overall Mastery</CardTitle>
+            <CardTitle className="text-sm font-medium text-muted-foreground">{t("summary.overallMastery")}</CardTitle>
           </CardHeader>
           <CardContent>
             <p className="text-2xl font-bold">{summary.averageMastery.toFixed(1)}%</p>
@@ -63,7 +116,7 @@ export function StudentDiagnosticView({ summary, reports, classAverageMastery }:
         </Card>
         <Card>
           <CardHeader className="pb-2">
-            <CardTitle className="text-sm font-medium text-muted-foreground">Strengths</CardTitle>
+            <CardTitle className="text-sm font-medium text-muted-foreground">{t("summary.strengths")}</CardTitle>
           </CardHeader>
           <CardContent>
             <p className="text-2xl font-bold text-green-600">{summary.strengths.length}</p>
@@ -71,7 +124,7 @@ export function StudentDiagnosticView({ summary, reports, classAverageMastery }:
         </Card>
         <Card>
           <CardHeader className="pb-2">
-            <CardTitle className="text-sm font-medium text-muted-foreground">Weaknesses</CardTitle>
+            <CardTitle className="text-sm font-medium text-muted-foreground">{t("summary.weaknesses")}</CardTitle>
           </CardHeader>
           <CardContent>
             <p className="text-2xl font-bold text-red-600">{summary.weaknesses.length}</p>
@@ -88,15 +141,15 @@ export function StudentDiagnosticView({ summary, reports, classAverageMastery }:
           <CardHeader>
             <CardTitle className="flex items-center gap-2">
               <Award className="h-4 w-4 text-green-600" />
-              Strengths (≥80%)
+              {t("strengths.title")}
             </CardTitle>
-            <CardDescription>Knowledge points with high mastery.</CardDescription>
+            <CardDescription>{t("studentDiagnostic.strengthsDescription")}</CardDescription>
           </CardHeader>
           <CardContent>
             {summary.strengths.length === 0 ? (
-              <p className="text-sm text-muted-foreground">No strengths identified yet.</p>
+              <p className="text-sm text-muted-foreground">{t("studentDiagnostic.noStrengths")}</p>
             ) : (
-              <ul className="space-y-2" role="list" aria-label="优势知识点列表">
+              <ul className="space-y-2" role="list" aria-label={t("studentDiagnostic.strengthsListAriaLabel")}>
                 {summary.strengths.map((m) => (
                   <li key={m.knowledgePointId} className="flex items-center justify-between">
                     <span className="text-sm">{m.knowledgePointName}</span>
@@ -111,27 +164,29 @@ export function StudentDiagnosticView({ summary, reports, classAverageMastery }:
           <CardHeader>
             <CardTitle className="flex items-center gap-2">
               <AlertTriangle className="h-4 w-4 text-red-600" />
-              Weaknesses (&lt;60%)
+              {t("weaknesses.title")}
             </CardTitle>
-            <CardDescription>Knowledge points needing attention.</CardDescription>
+            <CardDescription>{t("studentDiagnostic.weaknessesDescription")}</CardDescription>
           </CardHeader>
           <CardContent>
             {summary.weaknesses.length === 0 ? (
-              <p className="text-sm text-muted-foreground">No weaknesses identified.</p>
+              <p className="text-sm text-muted-foreground">{t("studentDiagnostic.noWeaknesses")}</p>
             ) : (
-              <ul className="space-y-2" role="list" aria-label="薄弱知识点列表">
+              <ul className="space-y-2" role="list" aria-label={t("studentDiagnostic.weaknessesListAriaLabel")}>
                 {summary.weaknesses.map((m) => (
                   <li key={m.knowledgePointId} className="flex items-center justify-between gap-2">
                     <div className="flex items-center gap-2 min-w-0">
                       <span className="text-sm truncate">{m.knowledgePointName}</span>
                       <Badge variant="destructive" className="shrink-0">{m.masteryLevel.toFixed(1)}%</Badge>
                     </div>
-                    <Button asChild variant="ghost" size="sm" className="h-7 shrink-0 text-xs">
-                      <Link href="/student/learning/assignments">
-                        Practice
-                        <ArrowRight className="ml-1 h-3 w-3" />
-                      </Link>
-                    </Button>
+                    {practiceHrefBase ? (
+                      <Button asChild variant="ghost" size="sm" className="h-7 shrink-0 text-xs" aria-label={t("studentDiagnostic.practiceAriaLabel", { name: m.knowledgePointName })}>
+                        <Link href={`${practiceHrefBase}?kp=${m.knowledgePointId}`}>
+                          {t("weaknesses.practice")}
+                          <ArrowRight className="ml-1 h-3 w-3" />
+                        </Link>
+                      </Button>
+                    ) : null}
                   </li>
                 ))}
               </ul>
@@ -146,13 +201,32 @@ export function StudentDiagnosticView({ summary, reports, classAverageMastery }:
           <CardHeader>
             <CardTitle className="flex items-center gap-2">
               <Lightbulb className="h-4 w-4" />
-              Diagnostic Report
+              {t("studentDiagnostic.diagnosticReportTitle")}
               <Badge variant={latestReport.status === "published" ? "default" : "secondary"}>
-                {latestReport.status}
+                {statusLabel(latestReport.status)}
               </Badge>
+              {(() => {
+                const level = getConfidenceLevel(latestReport)
+                return (
+                  <Tooltip>
+                    <TooltipTrigger asChild>
+                      <Badge
+                        variant={confidenceBadgeVariant[level]}
+                        aria-label={t("reportList.confidenceAriaLabel", { level: confidenceLabel(level) })}
+                      >
+                        {confidenceLabel(level)}
+                      </Badge>
+                    </TooltipTrigger>
+                    <TooltipContent>{confidenceHint(level)}</TooltipContent>
+                  </Tooltip>
+                )
+              })()}
             </CardTitle>
             <CardDescription>
-              Period: {latestReport.period ?? "-"} · Overall: {latestReport.overallScore?.toFixed(1) ?? "-"}%
+              {t("studentDiagnostic.reportMeta", {
+                period: latestReport.period ?? "-",
+                score: latestReport.overallScore?.toFixed(1) ?? "-",
+              })}
             </CardDescription>
           </CardHeader>
           <CardContent className="space-y-4">
@@ -161,10 +235,10 @@ export function StudentDiagnosticView({ summary, reports, classAverageMastery }:
             ) : null}
             {latestReport.recommendations && latestReport.recommendations.length > 0 ? (
               <div>
-                <h4 className="mb-2 text-sm font-semibold">Recommendations</h4>
-                <ul className="space-y-1.5" role="list" aria-label="学习建议列表">
+                <h4 className="mb-2 text-sm font-semibold">{t("report.recommendations")}</h4>
+                <ul className="space-y-1.5" role="list" aria-label={t("studentDiagnostic.recommendationsListAriaLabel")}>
                   {latestReport.recommendations.map((rec, i) => (
-                    <li key={i} className="text-sm text-muted-foreground">• {rec}</li>
+                    <li key={rec || `rec-${i}`} className="text-sm text-muted-foreground">• {rec}</li>
                   ))}
                 </ul>
               </div>
@@ -179,9 +253,9 @@ export function StudentDiagnosticView({ summary, reports, classAverageMastery }:
           <CardHeader>
             <CardTitle className="flex items-center gap-2">
               <History className="h-4 w-4" />
-              Report History
+              {t("report.history")}
             </CardTitle>
-            <CardDescription>Past diagnostic reports (newest first).</CardDescription>
+            <CardDescription>{t("studentDiagnostic.historyDescription")}</CardDescription>
           </CardHeader>
           <CardContent>
             <div className="space-y-2">
@@ -193,15 +267,19 @@ export function StudentDiagnosticView({ summary, reports, classAverageMastery }:
                   <div className="min-w-0 space-y-1">
                     <div className="flex items-center gap-2">
                       <span className="text-sm font-medium">
-                        {r.period ?? "Untitled period"}
+                        {r.period ?? t("studentDiagnostic.untitledPeriod")}
                       </span>
                       <Badge variant="outline" className="text-xs">
-                        {r.reportType}
+                        {typeLabel(r.reportType)}
                       </Badge>
                     </div>
                     <p className="text-xs text-muted-foreground">
-                      {formatDate(r.createdAt)}
-                      {r.overallScore !== null ? ` · Overall: ${r.overallScore.toFixed(1)}%` : ""}
+                      {r.overallScore !== null
+                        ? t("studentDiagnostic.historyReportMeta", {
+                            date: formatDate(r.createdAt),
+                            score: r.overallScore.toFixed(1),
+                          })
+                        : formatDate(r.createdAt)}
                     </p>
                   </div>
                 </div>