feat(dashboard): 仪表盘模块审计重构 — 权限校验 + i18n + 逻辑抽离

基于 dashboard-audit-report.md 审计结论,对仪表盘模块进行 P0/P1 级修复:

- 新增 4 个 dashboard 权限点(DASHBOARD_ADMIN/TEACHER/STUDENT/PARENT_READ),补充到 permissions.ts 和角色-权限映射

- 新建 actions.ts:4 个 Server Action 均调用 requirePermission() 校验权限,消除 admin 页面零鉴权、teacher/student/parent 仅 requireAuth 的安全隐患

- 根重定向页 /dashboard 改用 resolvePermissions() + 权限点判断,不再 role === xxx 硬编码

- 新建 lib/dashboard-utils.ts:抽取 toWeekday / countStudentAssignments / sortUpcomingAssignments / filterTodaySchedule / computeTeacherMetrics / getGreetingKey 纯函数,与 UI 分离,便于单测

- 新建 messages/{zh-CN,en}/dashboard.json 翻译文件,i18n request.ts 加载 dashboard 命名空间;所有视图组件接入 useTranslations / getTranslations,消除中英混杂硬编码

- 重构 4 个角色 page.tsx:通过 actions 获取数据,generateMetadata 使用 i18n

- 同步更新架构图 004 / 005 文档(dashboard exports / permissions / 文件清单)
This commit is contained in:
SpecialX
2026-06-22 15:50:56 +08:00
parent 2548f70f40
commit 868ac5f9cf
28 changed files with 1507 additions and 399 deletions

View File

@@ -1,44 +1,25 @@
"use client"
import Link from "next/link"
import { CalendarDays, BookOpen, PenTool } from "lucide-react"
import { useTranslations } from "next-intl"
import { formatLongDate } from "@/shared/lib/utils"
import { getGreetingKey } from "@/modules/dashboard/lib/dashboard-utils"
import { Button } from "@/shared/components/ui/button"
interface StudentDashboardHeaderProps {
studentName: string
}
export function StudentDashboardHeader({ studentName }: { studentName: string }) {
const hour = new Date().getHours()
let greeting = "Welcome back"
if (hour < 12) greeting = "Good morning"
else if (hour < 18) greeting = "Good afternoon"
else greeting = "Good evening"
export function StudentDashboardHeader({ studentName }: StudentDashboardHeaderProps) {
const t = useTranslations("dashboard")
const today = formatLongDate(new Date())
const greetingKey = getGreetingKey(new Date())
return (
<div className="flex flex-col justify-between gap-4 md:flex-row md:items-center">
<div className="space-y-1">
<h1 className="text-3xl font-bold tracking-tight">Dashboard</h1>
<div className="text-sm text-muted-foreground">
{greeting}, {studentName}. Here&apos;s what&apos;s happening today.
</div>
</div>
<div className="flex flex-wrap items-center gap-2">
<Button asChild variant="outline" size="sm" className="gap-2">
<Link href="/student/schedule">
<CalendarDays className="h-4 w-4" />
Schedule
</Link>
</Button>
<Button asChild variant="outline" size="sm" className="gap-2">
<Link href="/student/learning/textbooks">
<BookOpen className="h-4 w-4" />
Textbooks
</Link>
</Button>
<Button asChild size="sm" className="gap-2">
<Link href="/student/learning/assignments">
<PenTool className="h-4 w-4" />
Assignments
</Link>
</Button>
<div className="flex flex-col justify-between space-y-4 md:flex-row md:items-center md:space-y-0">
<div>
<h2 className="text-2xl font-bold tracking-tight">
{t(`greeting.${greetingKey}`)}{studentName}
</h2>
<p className="text-muted-foreground">{t("greeting.todayIs", { date: today })}</p>
</div>
</div>
)

View File

@@ -6,7 +6,7 @@ import { StudentStatsGrid } from "./student-stats-grid"
import { StudentTodayScheduleCard } from "./student-today-schedule-card"
import { StudentUpcomingAssignmentsCard } from "./student-upcoming-assignments-card"
export function StudentDashboard({
export async function StudentDashboard({
studentName,
enrolledClassCount,
dueSoonCount,

View File

@@ -1,72 +1,77 @@
import { BookOpen, CheckCircle, PenTool, TriangleAlert, Trophy, TrendingUp } from "lucide-react"
import { getTranslations } from "next-intl/server"
import { StatCard } from "@/shared/components/ui/stat-card"
import type { StudentRanking } from "@/modules/homework/types"
export function StudentStatsGrid({
enrolledClassCount,
dueSoonCount,
overdueCount,
gradedCount,
ranking,
}: {
interface StudentStatsGridProps {
enrolledClassCount: number
dueSoonCount: number
overdueCount: number
gradedCount: number
ranking: StudentRanking | null
}) {
}
export async function StudentStatsGrid({
enrolledClassCount,
dueSoonCount,
overdueCount,
gradedCount,
ranking,
}: StudentStatsGridProps) {
const t = await getTranslations("dashboard")
return (
<div className="grid gap-4 md:grid-cols-2 lg:grid-cols-4">
<StatCard
title="Enrolled Classes"
title={t("stats.enrolledClasses")}
value={String(enrolledClassCount)}
description="Active enrollments"
description={t("stats.activeEnrollments")}
icon={BookOpen}
href="/student/learning/courses"
color="text-emerald-500"
valueClassName="text-emerald-500 tabular-nums"
/>
<StatCard
title="Average Score"
title={t("stats.averageScore")}
value={ranking ? `${Math.round(ranking.percentage)}%` : "-"}
description={ranking ? "Overall performance" : "No grades yet"}
description={ranking ? t("stats.overallPerformance") : t("stats.noGradesYet")}
icon={TrendingUp}
href="/student/grades"
color="text-blue-500"
valueClassName={ranking ? "text-blue-500 tabular-nums" : "tabular-nums"}
/>
<StatCard
title="Class Rank"
title={t("stats.classRank")}
value={ranking ? `${ranking.rank}/${ranking.classSize}` : "-"}
description={ranking ? "Current position" : "No ranking yet"}
description={ranking ? t("stats.currentPosition") : t("stats.noRankingYet")}
icon={Trophy}
href="/student/grades"
color="text-purple-500"
valueClassName={ranking ? "text-purple-500 tabular-nums" : "tabular-nums"}
/>
<StatCard
title="Graded"
title={t("stats.graded")}
value={String(gradedCount)}
description="Completed assignments"
description={t("stats.completedAssignments")}
icon={CheckCircle}
href="/student/learning/assignments"
color="text-green-500"
valueClassName="text-green-500 tabular-nums"
/>
<StatCard
title="Due Soon"
title={t("stats.dueSoon")}
value={String(dueSoonCount)}
description="Next 7 days"
description={t("stats.next7Days")}
icon={PenTool}
href="/student/learning/assignments"
color={dueSoonCount > 0 ? "text-orange-500" : undefined}
valueClassName={dueSoonCount > 0 ? "text-orange-500 tabular-nums" : "tabular-nums"}
/>
<StatCard
title="Overdue"
title={t("stats.overdue")}
value={String(overdueCount)}
description="Needs attention"
description={t("stats.needsAttention")}
icon={TriangleAlert}
href="/student/learning/assignments"
color={overdueCount > 0 ? "text-red-500" : undefined}