feat(app): add error/loading boundaries across all dashboard routes and new routes

- Add error.tsx and loading.tsx boundaries for admin, parent, student, teacher routes

- Add admin announcements edit, audit-logs overview, curriculum-map, invitation-codes, permissions, questions, roles routes

- Add admin elective detail and components, files, course-plans, users, scheduling boundaries

- Add messages group-compose route

- Add parent course-plans, elective, grades report-card, practice routes

- Add student course-plans, elective detail, error-book dialogs, grades report-card, learning study-path, leave, schedule boundaries

- Add teacher attendance report, classes boundaries, course-plans boundaries, elective, exams analytics/edit-rich/all/create/new, grades report-card, homework boundaries, leave, lesson-plans calendar

- Add auth loading, onboarding loading, api cron
This commit is contained in:
SpecialX
2026-07-03 10:26:25 +08:00
parent e9a5264fe7
commit 21142f9b99
280 changed files with 7137 additions and 1855 deletions

View File

@@ -0,0 +1,35 @@
"use client"
import type { JSX } from "react"
import { useEffect } from "react"
import { AlertTriangle } from "lucide-react"
import { Button } from "@/shared/components/ui/button"
import { useTranslations } from "next-intl"
export default function Error({
error,
reset,
}: {
error: Error & { digest?: string }
reset: () => void
}): JSX.Element {
const t = useTranslations("grades")
useEffect(() => {
console.error("[ReportCard] Route error:", error)
}, [error])
return (
<div className="flex h-full flex-col items-center justify-center gap-4 p-12">
<AlertTriangle className="h-10 w-10 text-destructive" aria-hidden="true" />
<div className="text-center">
<h2 className="text-lg font-semibold">{t("reportCard.errorTitle")}</h2>
<p className="mt-1 text-sm text-muted-foreground">
{t("reportCard.errorDescription")}
</p>
</div>
<Button onClick={reset} variant="outline">
{t("reportCard.retry")}
</Button>
</div>
)
}

View File

@@ -0,0 +1,12 @@
import { Loader2 } from "lucide-react"
import { getTranslations } from "next-intl/server"
export default async function Loading() {
const t = await getTranslations("grades")
return (
<div className="flex h-full flex-col items-center justify-center gap-3 p-12">
<Loader2 className="h-8 w-8 animate-spin text-muted-foreground" aria-hidden="true" />
<p className="text-sm text-muted-foreground">{t("reportCard.loading")}</p>
</div>
)
}

View File

@@ -0,0 +1,116 @@
import type { JSX } from "react"
import { ArrowLeft } from "lucide-react"
import Link from "next/link"
import { getTranslations } from "next-intl/server"
import { Button } from "@/shared/components/ui/button"
import { EmptyState } from "@/shared/components/ui/empty-state"
import { requirePermission } from "@/shared/lib/auth-guard"
import { Permissions } from "@/shared/types/permissions"
import { getParam, type SearchParams } from "@/shared/lib/search-params"
import { getReportCardData } from "@/modules/grades/lib/report-card"
import { ReportCardView } from "@/modules/grades/components/report-card-view"
import { ReportCardPrintAction } from "@/modules/grades/components/report-card-print-action"
import { getAcademicYears } from "@/modules/school/data-access"
export const dynamic = "force-dynamic"
/**
* P3-1: 教师视角的学生成绩报告卡页面。
*
* 路由:/teacher/grades/report-card?studentId=xxx
* 查询参数:
* - studentId: 必填,目标学生 ID
* - academicYearId?: 指定学年(不传则使用当前活跃学年)
* - semester?: "1" | "2"(不传则全部学期)
*
* 权限GRADE_RECORD_READclass_taught scope 在 data-access 层校验学生归属)
*/
export default async function TeacherReportCardPage({
searchParams,
}: {
searchParams: Promise<SearchParams>
}): Promise<JSX.Element> {
const sp = await searchParams
const ctx = await requirePermission(Permissions.GRADE_RECORD_READ)
const t = await getTranslations("grades")
const studentId = getParam(sp, "studentId")
const academicYearIdParam = getParam(sp, "academicYearId")
const semesterParam = getParam(sp, "semester")
const academicYearId =
academicYearIdParam && academicYearIdParam !== "all"
? academicYearIdParam
: undefined
const semester =
semesterParam === "1" || semesterParam === "2" ? semesterParam : undefined
if (!studentId) {
return (
<div className="h-full flex-1 flex-col space-y-6 p-8 md:flex">
<Button asChild variant="ghost" size="sm" className="w-fit">
<Link href="/teacher/grades">
<ArrowLeft className="mr-2 h-4 w-4" aria-hidden="true" />
{t("reportCard.backToGrades")}
</Link>
</Button>
<EmptyState
title={t("reportCard.missingStudentTitle")}
description={t("reportCard.missingStudentDescription")}
icon={ArrowLeft}
className="border-none shadow-none"
/>
</div>
)
}
const [data, academicYears] = await Promise.all([
getReportCardData(studentId, ctx.dataScope, {
academicYearId,
semester,
}),
getAcademicYears(),
])
if (!data) {
return (
<div className="h-full flex-1 flex-col space-y-6 p-8 md:flex">
<Button asChild variant="ghost" size="sm" className="w-fit">
<Link href="/teacher/grades">
<ArrowLeft className="mr-2 h-4 w-4" aria-hidden="true" />
{t("reportCard.backToGrades")}
</Link>
</Button>
<EmptyState
title={t("reportCard.emptyTitle")}
description={t("reportCard.emptyDescription")}
icon={ArrowLeft}
className="border-none shadow-none"
/>
</div>
)
}
return (
<div className="flex flex-col gap-4 p-6">
<div className="flex items-center justify-between gap-4">
<Button asChild variant="ghost" size="sm">
<Link href="/teacher/grades">
<ArrowLeft className="mr-2 h-4 w-4" aria-hidden="true" />
{t("reportCard.backToGrades")}
</Link>
</Button>
<ReportCardPrintAction />
</div>
<ReportCardView data={data} />
<p className="text-center text-xs text-muted-foreground">
{t("reportCard.academicYearsCount", {
count: academicYears.length,
})}
</p>
</div>
)
}