feat(announcements,messaging): 公告与消息模块审计重构 — i18n + Error Boundary + a11y

- 新增审计报告 docs/architecture/audit/announcements-messages-audit-report.md
- 新增中英双语 i18n 字典 announcements.json / messages.json(11/13 个命名空间)
- 重构所有 announcements 和 messaging 组件接入 next-intl(useTranslations)
- 所有页面 page.tsx 使用 generateMetadata + getTranslations 替代硬编码 metadata
- 新增 7 个 error.tsx 错误边界(4 公告 + 3 消息),统一 EmptyState + i18n + 重试
- a11y 改进:announcement-card / message-list / notification-dropdown 添加 aria-label
- 同步架构图 004 和 005:i18n.messages 清单 + 已知问题修复记录
This commit is contained in:
SpecialX
2026-06-22 16:02:07 +08:00
parent 21c1e7a286
commit fde711ce46
30 changed files with 1085 additions and 261 deletions

View File

@@ -4,6 +4,7 @@ import { useState } from "react"
import Link from "next/link"
import { useRouter } from "next/navigation"
import { toast } from "sonner"
import { useTranslations } from "next-intl"
import {
Archive,
ArrowLeft,
@@ -16,16 +17,7 @@ import {
import { Badge } from "@/shared/components/ui/badge"
import { Button } from "@/shared/components/ui/button"
import { Card, CardContent, CardHeader, CardTitle } from "@/shared/components/ui/card"
import {
AlertDialog,
AlertDialogAction,
AlertDialogCancel,
AlertDialogContent,
AlertDialogDescription,
AlertDialogFooter,
AlertDialogHeader,
AlertDialogTitle,
} from "@/shared/components/ui/alert-dialog"
import { ConfirmDeleteDialog } from "@/shared/components/ui/confirm-delete-dialog"
import { formatDate } from "@/shared/lib/utils"
import {
@@ -35,18 +27,6 @@ import {
} from "../actions"
import type { Announcement } from "../types"
const STATUS_LABEL: Record<Announcement["status"], string> = {
draft: "Draft",
published: "Published",
archived: "Archived",
}
const TYPE_LABEL: Record<Announcement["type"], string> = {
school: "School",
grade: "Grade",
class: "Class",
}
export function AnnouncementDetail({
announcement,
canManage,
@@ -58,6 +38,7 @@ export function AnnouncementDetail({
editHref?: string
backHref?: string
}) {
const t = useTranslations("announcements")
const router = useRouter()
const [isWorking, setIsWorking] = useState(false)
const [deleteOpen, setDeleteOpen] = useState(false)
@@ -70,10 +51,10 @@ export function AnnouncementDetail({
toast.success(res.message)
router.refresh()
} else {
toast.error(res.message || "Failed to publish")
toast.error(res.message || t("messages.publishFailed"))
}
} catch {
toast.error("Failed to publish")
toast.error(t("messages.publishFailed"))
} finally {
setIsWorking(false)
}
@@ -87,10 +68,10 @@ export function AnnouncementDetail({
toast.success(res.message)
router.refresh()
} else {
toast.error(res.message || "Failed to archive")
toast.error(res.message || t("messages.archiveFailed"))
}
} catch {
toast.error("Failed to archive")
toast.error(t("messages.archiveFailed"))
} finally {
setIsWorking(false)
}
@@ -105,10 +86,10 @@ export function AnnouncementDetail({
router.push("/admin/announcements")
router.refresh()
} else {
toast.error(res.message || "Failed to delete")
toast.error(res.message || t("messages.deleteFailed"))
}
} catch {
toast.error("Failed to delete")
toast.error(t("messages.deleteFailed"))
} finally {
setIsWorking(false)
setDeleteOpen(false)
@@ -120,33 +101,33 @@ export function AnnouncementDetail({
<div className="flex items-center justify-between gap-2">
<div className="flex items-center gap-2">
{backHref ? (
<Button asChild variant="ghost" size="icon">
<Button asChild variant="ghost" size="icon" aria-label={t("actions.back")}>
<Link href={backHref}>
<ArrowLeft className="h-4 w-4" />
</Link>
</Button>
) : null}
<h2 className="text-2xl font-bold tracking-tight">Announcement</h2>
<h2 className="text-2xl font-bold tracking-tight">{t("title.detail")}</h2>
</div>
{canManage ? (
<div className="flex flex-wrap items-center gap-2">
{announcement.status !== "published" ? (
<Button onClick={handlePublish} disabled={isWorking} variant="outline">
<Send className="mr-2 h-4 w-4" />
Publish
{t("actions.publish")}
</Button>
) : null}
{announcement.status !== "archived" ? (
<Button onClick={handleArchive} disabled={isWorking} variant="outline">
<Archive className="mr-2 h-4 w-4" />
Archive
{t("actions.archive")}
</Button>
) : null}
{editHref ? (
<Button asChild>
<Link href={editHref}>
<Pencil className="mr-2 h-4 w-4" />
Edit
{t("actions.edit")}
</Link>
</Button>
) : null}
@@ -156,7 +137,7 @@ export function AnnouncementDetail({
variant="destructive"
>
<Trash2 className="mr-2 h-4 w-4" />
Delete
{t("actions.delete")}
</Button>
</div>
) : null}
@@ -166,19 +147,19 @@ export function AnnouncementDetail({
<CardHeader className="space-y-2">
<div className="flex flex-wrap items-center gap-2">
<Badge variant="outline" className="capitalize">
{TYPE_LABEL[announcement.type]}
{t(`type.${announcement.type}`)}
</Badge>
<Badge className="capitalize">{STATUS_LABEL[announcement.status]}</Badge>
<Badge className="capitalize">{t(`status.${announcement.status}`)}</Badge>
</div>
<CardTitle className="text-2xl">{announcement.title}</CardTitle>
<div className="flex flex-wrap items-center gap-2 text-xs text-muted-foreground">
<Megaphone className="h-3 w-3" />
<span>
{announcement.publishedAt
? `Published ${formatDate(announcement.publishedAt)}`
: `Created ${formatDate(announcement.createdAt)}`}
? t("meta.publishedAt", { date: formatDate(announcement.publishedAt) })
: t("meta.createdAt", { date: formatDate(announcement.createdAt) })}
</span>
{announcement.authorName ? <span>by {announcement.authorName}</span> : null}
{announcement.authorName ? <span>{t("meta.author", { name: announcement.authorName })}</span> : null}
</div>
</CardHeader>
<CardContent>
@@ -186,22 +167,14 @@ export function AnnouncementDetail({
</CardContent>
</Card>
<AlertDialog open={deleteOpen} onOpenChange={setDeleteOpen}>
<AlertDialogContent>
<AlertDialogHeader>
<AlertDialogTitle>Delete announcement</AlertDialogTitle>
<AlertDialogDescription>
This will permanently delete &quot;{announcement.title}&quot;.
</AlertDialogDescription>
</AlertDialogHeader>
<AlertDialogFooter>
<AlertDialogCancel disabled={isWorking}>Cancel</AlertDialogCancel>
<AlertDialogAction onClick={handleDelete} disabled={isWorking}>
Delete
</AlertDialogAction>
</AlertDialogFooter>
</AlertDialogContent>
</AlertDialog>
<ConfirmDeleteDialog
open={deleteOpen}
onOpenChange={setDeleteOpen}
title={t("empty.deleteTitle")}
description={t("empty.deleteDesc", { title: announcement.title })}
onConfirm={handleDelete}
isWorking={isWorking}
/>
</div>
)
}