Primitive + Semantic 双层令牌架构,HEX->HSL,明暗双份,@theme inline 暴露为 Tailwind 类。 - 新建 src/app/styles/tokens/ 6 个令牌文件(primitive/semantic-light/semantic-dark/lesson-preparation/tailwind-theme/index) - globals.css 改为 @import 引入,477->258 行 - 清理 91 处 #hex 硬编码颜色 -> hsl(var(--*)) - 清理 10 处硬编码字体 -> var(--font-family-*) - 清理 100 文件 Tailwind 任意值(Tier 1 映射/Tier 3 注释豁免) - 清理 M3 Surface 死代码,升级 --lp-* 令牌(HEX->HSL + 暗色补全) - 新建 ESLint 自定义规则 no-hardcoded-design-tokens(单词边界正则) - eslint.config.mjs 新增 no-restricted-syntax 禁止 #hex + 自定义规则加载(pathToFileURL) - 项目规则新增设计令牌规范强制章节 - 架构图 004/005 同步设计令牌体系节点 - known-issues.md 追加设计令牌问题分类(7 个规则表) 验证: tsc --noEmit 0 errors, npm run lint 0 errors/12 warnings(均为既有问题)
116 lines
4.3 KiB
TypeScript
116 lines
4.3 KiB
TypeScript
import type { Metadata } from "next"
|
|
import type { JSX } from "react"
|
|
import { Suspense } from "react"
|
|
import { User } from "lucide-react"
|
|
import { getTranslations } from "next-intl/server"
|
|
|
|
import { requirePermission } from "@/shared/lib/auth-guard"
|
|
import { Permissions } from "@/shared/types/permissions"
|
|
import { getClassStudents, getTeacherClasses, getStudentsSubjectScores } from "@/modules/classes/data-access"
|
|
import { StudentsFilters } from "@/modules/classes/components/students-filters"
|
|
import { StudentsTable } from "@/modules/classes/components/students-table"
|
|
import { ClassErrorBoundary } from "@/modules/classes/components/class-error-boundary"
|
|
import { EmptyState } from "@/shared/components/ui/empty-state"
|
|
import { Skeleton } from "@/shared/components/ui/skeleton"
|
|
import { getParam, type SearchParams } from "@/shared/lib/search-params"
|
|
|
|
export const dynamic = "force-dynamic"
|
|
|
|
export async function generateMetadata(): Promise<Metadata> {
|
|
const t = await getTranslations("classes")
|
|
return {
|
|
title: `${t("metadata.students")} - Next_Edu`,
|
|
description: t("metadata.students"),
|
|
}
|
|
}
|
|
|
|
async function StudentsResults({ searchParams, defaultClassId }: { searchParams: Promise<SearchParams>, defaultClassId?: string }): Promise<JSX.Element> {
|
|
const params = await searchParams
|
|
const t = await getTranslations("classes")
|
|
|
|
const q = getParam(params, "q") || undefined
|
|
const classId = getParam(params, "classId")
|
|
const status = getParam(params, "status")
|
|
|
|
// If classId is explicit in URL, use it (unless "all"). If not, use defaultClassId.
|
|
// If user explicitly selects "all", classId will be "all".
|
|
// However, the requirement is "Default to showing the first class".
|
|
// If classId param is missing, we use defaultClassId.
|
|
const targetClassId = classId ? (classId !== "all" ? classId : undefined) : defaultClassId
|
|
|
|
const filteredStudents = await getClassStudents({
|
|
q,
|
|
classId: targetClassId,
|
|
status: status && status !== "all" ? status : undefined,
|
|
})
|
|
|
|
// Fetch subject scores for all filtered students
|
|
if (filteredStudents.length > 0) {
|
|
const studentIds = filteredStudents.map(s => s.id)
|
|
const scores = await getStudentsSubjectScores(studentIds)
|
|
for (const student of filteredStudents) {
|
|
student.subjectScores = scores.get(student.id)
|
|
}
|
|
}
|
|
|
|
const hasFilters = Boolean(q || (classId && classId !== "all") || (status && status !== "all"))
|
|
|
|
if (filteredStudents.length === 0) {
|
|
return (
|
|
// arbitrary-value: empty state fixed size
|
|
<EmptyState
|
|
icon={User}
|
|
title={hasFilters ? t("students.empty.noMatch") : t("students.empty.title")}
|
|
description={hasFilters ? t("students.empty.noMatchDescription") : t("students.empty.description")}
|
|
action={hasFilters ? { label: t("filters.reset"), href: "/teacher/classes/students" } : undefined}
|
|
className="h-[360px] bg-card"
|
|
/>
|
|
)
|
|
}
|
|
|
|
return (
|
|
<div className="rounded-md border bg-card">
|
|
<StudentsTable students={filteredStudents} />
|
|
</div>
|
|
)
|
|
}
|
|
|
|
function StudentsResultsFallback() {
|
|
return (
|
|
<div className="rounded-md border bg-card">
|
|
<div className="p-4">
|
|
<Skeleton className="h-8 w-full" />
|
|
</div>
|
|
<div className="space-y-2 p-4 pt-0">
|
|
{Array.from({ length: 8 }).map((_, idx) => (
|
|
<Skeleton key={idx} className="h-10 w-full" />
|
|
))}
|
|
</div>
|
|
</div>
|
|
)
|
|
}
|
|
|
|
export default async function StudentsPage({ searchParams }: { searchParams: Promise<SearchParams> }): Promise<JSX.Element> {
|
|
await requirePermission(Permissions.CLASS_READ)
|
|
const classes = await getTeacherClasses()
|
|
|
|
// Logic to determine default class (first one available)
|
|
const defaultClassId = classes.length > 0 ? classes[0].id : undefined
|
|
|
|
return (
|
|
<div className="flex h-full flex-col space-y-4 p-8">
|
|
<div className="space-y-4">
|
|
<ClassErrorBoundary>
|
|
<Suspense fallback={<div className="h-10 w-full animate-pulse rounded-md bg-muted" />}>
|
|
<StudentsFilters classes={classes} defaultClassId={defaultClassId} />
|
|
</Suspense>
|
|
|
|
<Suspense fallback={<StudentsResultsFallback />}>
|
|
<StudentsResults searchParams={searchParams} defaultClassId={defaultClassId} />
|
|
</Suspense>
|
|
</ClassErrorBoundary>
|
|
</div>
|
|
</div>
|
|
)
|
|
}
|