Files
NextEdu/src/app/(dashboard)/teacher/attendance/page.tsx
SpecialX f62b8c0f86 refactor(attendance,elective): 审计第二轮 — 全量完成 P0/P1 改进项
P0 修复:
- 页面层 i18n 全量补齐(admin/teacher/parent/student × attendance/elective)
- types.ts 状态标签常量迁移至 constants.ts(i18n key + Badge variant)
- 修复 getTranslations 导入路径(next-intl → next-intl/server)

P1 改进:
- 解耦 parent 模块对 attendance 类型的直接依赖(本地 view-model 类型)
- 导出纯函数(computeStats/buildWarnings/buildLotteryRankCase 等)
- 统一空状态为 EmptyState 组件
- 清理死代码读 Action(attendance 5 个 + elective 3 个)
- 预留监控埋点接口(trackEvent 13 个新事件名)
- 补齐骨架屏 loading.tsx(8 个页面)
- AlertDialog 替换 window.confirm(student-selection-view)
- a11y 改进(aria-label/role/键盘导航)

修复:
- AttendanceStatus 从 constants.ts 重导出,消除 types/constants 双源混乱
- buildWarnings 的 Translator 类型改用 ReturnType<typeof useTranslations>
2026-06-22 17:33:29 +08:00

119 lines
4.1 KiB
TypeScript

import type { JSX } from "react"
import Link from "next/link"
import { PlusCircle, BarChart3, ClipboardList } from "lucide-react"
import { getTranslations } from "next-intl/server"
import { Button } from "@/shared/components/ui/button"
import { EmptyState } from "@/shared/components/ui/empty-state"
import { ListPagination, computePagination, paginate } from "@/shared/components/ui/list-pagination"
import { getAuthContext } from "@/shared/lib/auth-guard"
import { getParam, type SearchParams } from "@/shared/lib/search-params"
import { getTeacherClasses } from "@/modules/classes/data-access"
import { getAttendanceRecords } from "@/modules/attendance/data-access"
import { AttendanceFilters } from "@/modules/attendance/components/attendance-filters"
import { AttendanceRecordList } from "@/modules/attendance/components/attendance-record-list"
import type { AttendanceStatus } from "@/modules/attendance/types"
export const dynamic = "force-dynamic"
const VALID_STATUSES: ReadonlySet<string> = new Set([
"present",
"absent",
"late",
"early_leave",
"excused",
])
function parseAttendanceStatus(v?: string): AttendanceStatus | undefined {
return v && VALID_STATUSES.has(v) ? (v as AttendanceStatus) : undefined
}
const PAGE_SIZE = 20
export default async function TeacherAttendancePage({
searchParams,
}: {
searchParams: Promise<SearchParams>
}): Promise<JSX.Element> {
const sp = await searchParams
const ctx = await getAuthContext()
const t = await getTranslations("attendance")
const classId = getParam(sp, "classId")
const status = getParam(sp, "status")
const date = getParam(sp, "date")
const [classes, result] = await Promise.all([
getTeacherClasses(),
getAttendanceRecords({
scope: ctx.dataScope,
currentUserId: ctx.userId,
classId: classId && classId !== "all" ? classId : undefined,
status: status && status !== "all" ? parseAttendanceStatus(status) : undefined,
date: date && date.length > 0 ? date : undefined,
}),
])
const classOptions = classes.map((c) => ({ id: c.id, name: c.name }))
// 分页计算
const { page } = computePagination(sp, PAGE_SIZE)
const total = result.items.length
const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE))
const currentPage = Math.min(page, totalPages)
const pagedRecords = paginate(result.items, currentPage, PAGE_SIZE)
const hasFilters = Boolean(classId || status || date)
return (
<div className="h-full flex-1 flex-col space-y-8 p-8 md:flex">
<div className="flex items-center justify-between space-y-2">
<div>
<h1 className="text-2xl font-bold tracking-tight">{t("title.teacherRecords")}</h1>
<p className="text-muted-foreground">{t("description.teacherRecords")}</p>
</div>
<div className="flex items-center gap-2">
<Button asChild variant="outline">
<Link href="/teacher/attendance/stats">
<BarChart3 className="mr-2 h-4 w-4" aria-hidden="true" />
{t("actions.stats")}
</Link>
</Button>
<Button asChild>
<Link href="/teacher/attendance/sheet">
<PlusCircle className="mr-2 h-4 w-4" aria-hidden="true" />
{t("actions.record")}
</Link>
</Button>
</div>
</div>
<AttendanceFilters classes={classOptions} />
{result.items.length === 0 && !hasFilters ? (
<EmptyState
title={t("list.empty")}
description={t("list.emptyTeacherDescription")}
icon={ClipboardList}
action={{
label: t("actions.record"),
href: "/teacher/attendance/sheet",
}}
/>
) : (
<div className="space-y-4">
<AttendanceRecordList records={pagedRecords} />
{total > 0 ? (
<ListPagination
page={currentPage}
pageSize={PAGE_SIZE}
total={total}
totalPages={totalPages}
basePath="/teacher/attendance"
searchParams={sp}
itemLabel={t("stats.totalRecords")}
/>
) : null}
</div>
)}
</div>
)
}