refactor(frontend): colocate admin components and split service layer

Move route-specific admin components from components/common/admin into
app/(main)/admin/<feature>/components/. Split AdminService god object into
domain services, fix UploadService to use BaseService, add AdminUploadService,
consolidate DB export into DbManageService, and migrate consumers to the
unified services entry.

frontend/app/(main)/admin/push/components/histories-tab.tsx

@@ -0,0 +1,312 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
+"use client"
+
+import * as React from "react"
+import {useQuery} from "@tanstack/react-query"
+import {ChevronLeft, ChevronRight, History, RefreshCw, Search,} from "lucide-react"
+
+import {Button} from "@/components/ui/button"
+import {Input} from "@/components/ui/input"
+import {Badge} from "@/components/ui/badge"
+import {Table, TableBody, TableCell, TableHead, TableHeader, TableRow,} from "@/components/ui/table"
+import {Select, SelectContent, SelectItem, SelectTrigger, SelectValue,} from "@/components/ui/select"
+
+import {ErrorInline} from "@/components/layout/error"
+import {LoadingStateWithBorder} from "@/components/layout/loading"
+import {cn} from "@/lib/utils"
+
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog"
+
+import {PushService} from "@/lib/services/push"
+import type {PushHistory} from "@/lib/services/push"
+
+function getLevelBadgeVariant(level: string): "outline" | "secondary" | "destructive" | "default" {
+  switch (level) {
+    case "CRITICAL":
+      return "destructive"
+    case "IMPORTANT":
+      return "default"
+    default:
+      return "outline"
+  }
+}
+
+export function HistoriesTab() {
+  const [historyPage, setHistoryPage] = React.useState(1)
+  const [historySearch, setHistorySearch] = React.useState("")
+  const [historyStatus, setHistoryStatus] = React.useState("all")
+
+  const [detailOpen, setDetailOpen] = React.useState(false)
+  const [selectedHistory, setSelectedHistory] = React.useState<PushHistory | null>(null)
+
+  const handleRowClick = (hist: PushHistory) => {
+    setSelectedHistory(hist)
+    setDetailOpen(true)
+  }
+
+  const historiesQuery = useQuery({
+    queryKey: ["admin", "push-histories", historyPage, historySearch, historyStatus],
+    queryFn: () =>
+      PushService.listHistories({
+        page: historyPage,
+        page_size: 10,
+        event_key: historySearch || undefined,
+        status: historyStatus === "all" ? undefined : historyStatus,
+      }),
+  })
+
+  return (
+    <div className="pt-4 space-y-4">
+      <div className="flex flex-col sm:flex-row gap-2">
+        <div className="relative flex-1">
+          <Search className="absolute left-2.5 top-2.5 size-4 text-muted-foreground" />
+          <Input
+            type="text"
+            placeholder="输入事件键过滤..."
+            className="pl-8 text-xs h-9"
+            value={historySearch}
+            onChange={e => {
+              setHistorySearch(e.target.value)
+              setHistoryPage(1)
+            }}
+          />
+        </div>
+        <div className="w-[150px]">
+          <Select
+            value={historyStatus}
+            onValueChange={val => {
+              setHistoryStatus(val)
+              setHistoryPage(1)
+            }}
+          >
+            <SelectTrigger className="text-xs h-9">
+              <SelectValue placeholder="发送状态" />
+            </SelectTrigger>
+            <SelectContent>
+              <SelectItem value="all" className="text-xs">全部状态</SelectItem>
+              <SelectItem value="success" className="text-xs">发送成功</SelectItem>
+              <SelectItem value="failed" className="text-xs">发送失败</SelectItem>
+            </SelectContent>
+          </Select>
+        </div>
+        <Button
+          variant="outline"
+          size="icon"
+          className="h-9 w-9 shrink-0"
+          onClick={() => historiesQuery.refetch()}
+        >
+          <RefreshCw className={cn("size-3.5", historiesQuery.isFetching && "animate-spin")} />
+        </Button>
+      </div>
+
+      <div className="border rounded-lg overflow-hidden">
+        <Table>
+          <TableHeader>
+            <TableRow className="bg-muted/30">
+              <TableHead className="text-xs font-semibold">事件</TableHead>
+              <TableHead className="text-xs font-semibold">渠道</TableHead>
+              <TableHead className="text-xs font-semibold">目标</TableHead>
+              <TableHead className="text-xs font-semibold">标题</TableHead>
+              <TableHead className="text-xs font-semibold">等级</TableHead>
+              <TableHead className="text-xs font-semibold">状态</TableHead>
+              <TableHead className="text-xs font-semibold">时间</TableHead>
+            </TableRow>
+          </TableHeader>
+          <TableBody>
+            {historiesQuery.isLoading ? (
+              <TableRow>
+                <TableCell colSpan={7} className="h-32">
+                  <LoadingStateWithBorder icon={History} description="加载推送历史记录中..." className="border-0 shadow-none" />
+                </TableCell>
+              </TableRow>
+            ) : historiesQuery.isError ? (
+              <TableRow>
+                <TableCell colSpan={7} className="h-32">
+                  <ErrorInline error={historiesQuery.error} onRetry={() => historiesQuery.refetch()} className="justify-center" />
+                </TableCell>
+              </TableRow>
+            ) : (historiesQuery.data?.results ?? []).length === 0 ? (
+              <TableRow>
+                <TableCell colSpan={7} className="h-32 text-center text-xs text-muted-foreground">
+                  无推送历史数据
+                </TableCell>
+              </TableRow>
+            ) : (
+              (historiesQuery.data?.results ?? []).map(hist => (
+                <TableRow
+                  key={hist.id}
+                  className="hover:bg-muted/10 cursor-pointer transition-colors"
+                  onClick={() => handleRowClick(hist)}
+                >
+                  <TableCell className="text-xs font-mono font-medium">{hist.event_key}</TableCell>
+                  <TableCell className="text-xs uppercase font-semibold text-muted-foreground">
+                    {hist.channel === "email" ? "邮件" : hist.channel}
+                  </TableCell>
+                  <TableCell className="text-xs font-mono text-muted-foreground max-w-[120px] truncate" title={hist.target}>
+                    {hist.target}
+                  </TableCell>
+                  <TableCell className="text-xs max-w-[180px] truncate" title={hist.content}>{hist.title}</TableCell>
+                  <TableCell className="text-xs">
+                    <Badge variant={getLevelBadgeVariant(hist.level)} className="text-[10px] font-semibold">
+                      {hist.level}
+                    </Badge>
+                  </TableCell>
+                  <TableCell className="text-xs">
+                    <Badge
+                      variant={hist.status === "success" ? "secondary" : "destructive"}
+                      className="text-[10px] font-semibold"
+                    >
+                      {hist.status === "success" ? "成功" : "失败"}
+                    </Badge>
+                    {hist.status !== "success" && hist.error_msg && (
+                      <div className="text-[10px] text-muted-foreground font-mono truncate max-w-[180px] mt-1" title={hist.error_msg}>
+                        {hist.error_msg}
+                      </div>
+                    )}
+                  </TableCell>
+                  <TableCell className="text-[11px] text-muted-foreground whitespace-nowrap">
+                    {new Date(hist.created_at).toLocaleString()}
+                  </TableCell>
+                </TableRow>
+              ))
+            )}
+          </TableBody>
+        </Table>
+      </div>
+
+      {historiesQuery.data && historiesQuery.data.total > 0 && (
+        <div className="flex justify-between items-center text-xs text-muted-foreground">
+          <span>共 {historiesQuery.data.total} 条历史记录</span>
+          <div className="flex items-center gap-1.5">
+            <Button
+              variant="outline"
+              size="icon"
+              disabled={historyPage === 1}
+              onClick={() => setHistoryPage(p => Math.max(1, p - 1))}
+              className="h-8 w-8"
+            >
+              <ChevronLeft className="size-4" />
+            </Button>
+            <span className="text-xs font-medium px-2">{historyPage}</span>
+            <Button
+              variant="outline"
+              size="icon"
+              disabled={historyPage * 10 >= historiesQuery.data.total}
+              onClick={() => setHistoryPage(p => p + 1)}
+              className="h-8 w-8"
+            >
+              <ChevronRight className="size-4" />
+            </Button>
+          </div>
+        </div>
+      )}
+
+      {/* ==================== 对话框：推送详情 ==================== */}
+      <Dialog open={detailOpen} onOpenChange={setDetailOpen}>
+        <DialogContent className="sm:max-w-[550px] max-h-[85vh] overflow-y-auto">
+          <DialogHeader>
+            <DialogTitle className="flex items-center gap-2">
+              <History className="size-5 text-primary" />
+              推送通知详情
+            </DialogTitle>
+            <DialogDescription>
+              查看该条通知发送的详细审计信息与内容
+            </DialogDescription>
+          </DialogHeader>
+
+          {selectedHistory && (
+            <div className="space-y-4 py-4 text-xs">
+              <div className="grid grid-cols-2 gap-4">
+                <div className="space-y-1.5">
+                  <span className="font-semibold text-muted-foreground block">事件标识</span>
+                  <div className="font-mono bg-muted/40 p-2 rounded border">{selectedHistory.event_key}</div>
+                </div>
+                <div className="space-y-1.5">
+                  <span className="font-semibold text-muted-foreground block">发送渠道</span>
+                  <div className="bg-muted/40 p-2 rounded border uppercase font-medium">
+                    {selectedHistory.channel === "email" ? "邮件推送" : selectedHistory.channel}
+                  </div>
+                </div>
+              </div>
+
+              <div className="grid grid-cols-2 gap-4">
+                <div className="space-y-1.5">
+                  <span className="font-semibold text-muted-foreground block">推送目标</span>
+                  <div className="font-mono bg-muted/40 p-2 rounded border truncate" title={selectedHistory.target}>
+                    {selectedHistory.target}
+                  </div>
+                </div>
+                <div className="space-y-1.5">
+                  <span className="font-semibold text-muted-foreground block">发送时间</span>
+                  <div className="bg-muted/40 p-2 rounded border">
+                    {new Date(selectedHistory.created_at).toLocaleString()}
+                  </div>
+                </div>
+              </div>
+
+              <div className="grid grid-cols-2 gap-4">
+                <div className="space-y-1.5">
+                  <span className="font-semibold text-muted-foreground block">通知等级</span>
+                  <div>
+                    <Badge variant={getLevelBadgeVariant(selectedHistory.level)} className="text-[10px] font-semibold py-0.5 px-2">
+                      {selectedHistory.level}
+                    </Badge>
+                  </div>
+                </div>
+                <div className="space-y-1.5">
+                  <span className="font-semibold text-muted-foreground block">发送状态</span>
+                  <div>
+                    <Badge
+                      variant={selectedHistory.status === "success" ? "secondary" : "destructive"}
+                      className="text-[10px] font-semibold py-0.5 px-2"
+                    >
+                      {selectedHistory.status === "success" ? "成功" : "失败"}
+                    </Badge>
+                  </div>
+                </div>
+              </div>
+
+              {selectedHistory.status === "failed" && selectedHistory.error_msg && (
+                <div className="space-y-1.5">
+                  <span className="font-semibold text-destructive block">失败原因</span>
+                  <div className="font-mono text-destructive bg-destructive/10 p-2.5 rounded border border-destructive/20 whitespace-pre-wrap break-all">
+                    {selectedHistory.error_msg}
+                  </div>
+                </div>
+              )}
+
+              <div className="space-y-1.5">
+                <span className="font-semibold text-muted-foreground block">通知标题</span>
+                <div className="bg-muted/30 p-2.5 rounded border font-medium text-[13px]">
+                  {selectedHistory.title}
+                </div>
+              </div>
+
+              <div className="space-y-1.5">
+                <span className="font-semibold text-muted-foreground block">通知内容</span>
+                <div className="bg-muted/30 p-3 rounded border whitespace-pre-wrap break-all leading-relaxed font-sans text-xs">
+                  {selectedHistory.content}
+                </div>
+              </div>
+            </div>
+          )}
+
+          <DialogFooter>
+            <Button variant="outline" size="sm" onClick={() => setDetailOpen(false)} className="h-9 text-xs">
+              关闭
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+    </div>
+  )
+}