Files
NextEdu/src/modules/dashboard/components/student-dashboard/student-stats-grid.tsx
SpecialX 868ac5f9cf 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 / 文件清单)
2026-06-22 15:50:56 +08:00

83 lines
2.8 KiB
TypeScript

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"
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={t("stats.enrolledClasses")}
value={String(enrolledClassCount)}
description={t("stats.activeEnrollments")}
icon={BookOpen}
href="/student/learning/courses"
color="text-emerald-500"
valueClassName="text-emerald-500 tabular-nums"
/>
<StatCard
title={t("stats.averageScore")}
value={ranking ? `${Math.round(ranking.percentage)}%` : "-"}
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={t("stats.classRank")}
value={ranking ? `${ranking.rank}/${ranking.classSize}` : "-"}
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={t("stats.graded")}
value={String(gradedCount)}
description={t("stats.completedAssignments")}
icon={CheckCircle}
href="/student/learning/assignments"
color="text-green-500"
valueClassName="text-green-500 tabular-nums"
/>
<StatCard
title={t("stats.dueSoon")}
value={String(dueSoonCount)}
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={t("stats.overdue")}
value={String(overdueCount)}
description={t("stats.needsAttention")}
icon={TriangleAlert}
href="/student/learning/assignments"
color={overdueCount > 0 ? "text-red-500" : undefined}
valueClassName={overdueCount > 0 ? "text-red-500 tabular-nums" : "tabular-nums"}
/>
</div>
)
}