feat: 完成 P1 全部功能 + 修复 proxy 导出 + 切换 MySQL 端口至 14013

## P1 功能（20 项） - 站内消息系统、家长仪表盘、学生考勤管理 - Excel 导入导出、用户批量导入、成绩导出 - 排课规则+自动排课+课表调整 - 成绩趋势+对比分析、密码安全策略、速率限制 - 数据变更日志、文件预览+存储策略、全文检索 - 依赖审计集成 CI、数据库定时备份、E2E 测试完善 - 通知偏好管理 ## 基础设施修复 - src/proxy.ts: 将 middleware 导出重命名为 proxy（Next.js 16 要求） - .env: MySQL 端口从 13002 切换至 14013 - scripts/create-db.ts: 新增数据库初始化脚本 ## 架构文档同步 - 004_architecture_impact_map.md 和 005_architecture_data.json 完整记录所有新增表、模块、路由、权限、依赖关系
2026-06-17 13:44:37 +08:00
parent 125f7ec54c
commit 3b6272c99d
195 changed files with 27274 additions and 416 deletions
--- a/src/app/(dashboard)/teacher/attendance/stats/page.tsx
+++ b/src/app/(dashboard)/teacher/attendance/stats/page.tsx
@@ -0,0 +1,120 @@
+import { getTeacherClasses } from "@/modules/classes/data-access"
+import { getClassAttendanceStats } from "@/modules/attendance/data-access-stats"
+import { AttendanceStatsCard } from "@/modules/attendance/components/attendance-stats-card"
+import { AttendanceRecordList } from "@/modules/attendance/components/attendance-record-list"
+import { EmptyState } from "@/shared/components/ui/empty-state"
+import { BarChart3 } from "lucide-react"
+
+export const dynamic = "force-dynamic"
+
+type SearchParams = { [key: string]: string | string[] | undefined }
+
+const getParam = (params: SearchParams, key: string) => {
+  const v = params[key]
+  return Array.isArray(v) ? v[0] : v
+}
+
+export default async function AttendanceStatsPage({
+  searchParams,
+}: {
+  searchParams: Promise<SearchParams>
+}) {
+  const sp = await searchParams
+
+  const classId = getParam(sp, "classId")
+  const startDate = getParam(sp, "startDate")
+  const endDate = getParam(sp, "endDate")
+
+  const classes = await getTeacherClasses()
+
+  if (classes.length === 0) {
+    return (
+      <div className="h-full flex-1 flex-col space-y-8 p-8 md:flex">
+        <div>
+          <h2 className="text-2xl font-bold tracking-tight">Attendance Statistics</h2>
+          <p className="text-muted-foreground">View class attendance statistics.</p>
+        </div>
+        <EmptyState
+          title="No classes"
+          description="You don't have any classes yet."
+          icon={BarChart3}
+          className="border-none shadow-none"
+        />
+      </div>
+    )
+  }
+
+  const targetClassId = classId ?? classes[0].id
+
+  const summary = await getClassAttendanceStats(
+    targetClassId,
+    startDate,
+    endDate
+  )
+
+  const classOptions = classes.map((c) => ({ id: c.id, name: c.name }))
+
+  return (
+    <div className="h-full flex-1 flex-col space-y-8 p-8 md:flex">
+      <div>
+        <h2 className="text-2xl font-bold tracking-tight">Attendance Statistics</h2>
+        <p className="text-muted-foreground">View class attendance statistics and trends.</p>
+      </div>
+
+      <StatsClassSelector
+        classes={classOptions}
+        currentClassId={targetClassId}
+        startDate={startDate ?? ""}
+        endDate={endDate ?? ""}
+      />
+
+      {summary ? (
+        <>
+          <AttendanceStatsCard stats={summary.stats} />
+          <div>
+            <h3 className="mb-4 text-lg font-semibold">Student Records</h3>
+            <AttendanceRecordList records={summary.studentRecords} />
+          </div>
+        </>
+      ) : (
+        <EmptyState
+          title="No data"
+          description="No attendance data available for this class."
+          icon={BarChart3}
+          className="border-none shadow-none"
+        />
+      )}
+    </div>
+  )
+}
+
+function StatsClassSelector({
+  classes,
+  currentClassId,
+  startDate,
+  endDate,
+}: {
+  classes: Array<{ id: string; name: string }>
+  currentClassId: string
+  startDate: string
+  endDate: string
+}) {
+  const dateParams = `${startDate ? `&startDate=${startDate}` : ""}${endDate ? `&endDate=${endDate}` : ""}`
+  return (
+    <div className="flex flex-wrap gap-2">
+      {classes.map((c) => (
+        <a
+          key={c.id}
+          href={`/teacher/attendance/stats?classId=${c.id}${dateParams}`}
+          className={`rounded-md border px-3 py-1.5 text-sm transition-colors ${
+            c.id === currentClassId
+              ? "border-primary bg-primary text-primary-foreground"
+              : "bg-card hover:bg-accent"
+          }`}
+        >
+          {c.name}
+        </a>
+      ))}
+    </div>
+  )
+}