feat(zone): add Cloudflare-style traffic overview charts

Expose Zone stats API with multi-host access-log aggregates and time series, and render unique visitors, requests and data served on the Zone overview with 24h/7d/30d range controls.
2026-10-05 07:26:36 +08:00 · 2026-07-12 16:38:35 +08:00
parent efcf61e32d
commit 31b4886a14
20 changed files with 1026 additions and 32 deletions
@@ -1,14 +1,317 @@
-import {Card, CardContent, CardDescription, CardHeader, CardTitle} from '@/components/ui/card'
-import type {ZoneOverview} from '@/lib/services/openflare'
-import {formatDateTime} from '@/lib/utils'
+'use client';

-export function ZoneOverviewPanel({overview}: {overview: ZoneOverview}) {
-  const boundRoutes = new Set(overview.domains.flatMap((domain) => domain.proxy_route_id ? [domain.proxy_route_id] : [])).size
-  const certificates = overview.domains.filter((domain) => domain.cert_id !== null).length
-  return <div className="grid gap-4 md:grid-cols-3">
-    <Card className="shadow-none"><CardHeader className="pb-2"><CardTitle className="text-sm">域名</CardTitle><CardDescription>显式 FQDN</CardDescription></CardHeader><CardContent className="text-2xl font-semibold">{overview.domains.length}</CardContent></Card>
-    <Card className="shadow-none"><CardHeader className="pb-2"><CardTitle className="text-sm">关联路由</CardTitle><CardDescription>已绑定的不同规则</CardDescription></CardHeader><CardContent className="text-2xl font-semibold">{boundRoutes}</CardContent></Card>
-    <Card className="shadow-none"><CardHeader className="pb-2"><CardTitle className="text-sm">已配证书</CardTitle><CardDescription>域名级 TLS 绑定</CardDescription></CardHeader><CardContent className="text-2xl font-semibold">{certificates}</CardContent></Card>
-    <Card className="shadow-none md:col-span-3"><CardHeader className="pb-2"><CardTitle className="text-sm">Zone 信息</CardTitle></CardHeader><CardContent className="grid gap-3 text-sm sm:grid-cols-2"><div><p className="text-xs text-muted-foreground">根域</p><p className="mt-1 font-medium">{overview.zone.domain}</p></div><div><p className="text-xs text-muted-foreground">创建时间</p><p className="mt-1">{formatDateTime(overview.zone.created_at)}</p></div></CardContent></Card>
-  </div>
+import {useMemo, useState} from 'react';
+import {useQuery} from '@tanstack/react-query';
+import {Activity, HardDrive, Link2, ShieldCheck, Users} from 'lucide-react';
+import {Area, AreaChart, CartesianGrid, XAxis, YAxis} from 'recharts';
+
+import {Button} from '@/components/ui/button';
+import {Card, CardContent, CardDescription, CardHeader, CardTitle} from '@/components/ui/card';
+import {
+  ChartContainer,
+  ChartTooltip,
+  ChartTooltipContent,
+  type ChartConfig,
+} from '@/components/ui/chart';
+import {Skeleton} from '@/components/ui/skeleton';
+import {
+  ZoneService,
+  zoneQueryKey,
+  type ZoneOverview,
+  type ZoneStatsRange,
+} from '@/lib/services/openflare';
+import {formatDateTime} from '@/lib/utils';
+import {formatBytes, formatCompactNumber} from '@/lib/utils/metrics';
+import {cn} from '@/lib/utils';
+
+const rangeOptions: Array<{value: ZoneStatsRange; label: string}> = [
+  {value: '24h', label: '24 小时'},
+  {value: '7d', label: '7 天'},
+  {value: '30d', label: '30 天'},
+];
+
+const visitorsChartConfig = {
+  value: {label: '唯一访问者', color: 'hsl(217 91% 60%)'},
+} satisfies ChartConfig;
+
+const requestsChartConfig = {
+  value: {label: '请求总数', color: 'hsl(217 91% 60%)'},
+} satisfies ChartConfig;
+
+const bytesChartConfig = {
+  value: {label: '已提供数据', color: 'hsl(217 91% 60%)'},
+} satisfies ChartConfig;
+
+function formatAxisLabel(iso: string, range: ZoneStatsRange) {
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) {
+    return '';
+  }
+  if (range === '24h') {
+    return date.toLocaleTimeString('en-US', {
+      hour: 'numeric',
+      minute: undefined,
+      hour12: true,
+    });
+  }
+  return date.toLocaleDateString('en-GB', {
+    day: 'numeric',
+    month: 'short',
+  });
+}
+
+function formatWindowLabel(startedAt?: string, endedAt?: string) {
+  if (!startedAt || !endedAt) {
+    return '—';
+  }
+  const start = new Date(startedAt);
+  const end = new Date(endedAt);
+  if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime())) {
+    return '—';
+  }
+  const fmt = (value: Date) =>
+    value
+      .toLocaleDateString('en-GB', {day: 'numeric', month: 'long'})
+      .toUpperCase();
+  return `${fmt(start)} — ${fmt(end)}`;
+}
+
+export function ZoneOverviewPanel({
+  overview,
+  zoneId,
+}: {
+  overview: ZoneOverview;
+  zoneId: number;
+}) {
+  const [range, setRange] = useState<ZoneStatsRange>('24h');
+  const boundRoutes = new Set(
+    overview.domains.flatMap((domain) =>
+      domain.proxy_route_id ? [domain.proxy_route_id] : [],
+    ),
+  ).size;
+  const certificates = overview.domains.filter(
+    (domain) => domain.cert_id !== null,
+  ).length;
+
+  const statsQuery = useQuery({
+    queryKey: [...zoneQueryKey, zoneId, 'stats', range],
+    queryFn: () => ZoneService.getStats(zoneId, range),
+    enabled: zoneId > 0,
+  });
+
+  const stats = statsQuery.data;
+  const chartData = useMemo(
+    () =>
+      (stats?.series ?? []).map((point) => ({
+        label: formatAxisLabel(point.bucket_started_at, range),
+        at: point.bucket_started_at,
+        visitors: point.unique_visitors,
+        requests: point.request_count,
+        bytes: point.bytes_sent,
+      })),
+    [range, stats?.series],
+  );
+
+  return (
+    <div className="space-y-6">
+      <div className="space-y-4">
+        <div className="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
+          <div className="inline-flex rounded-lg border bg-muted/40 p-0.5">
+            {rangeOptions.map((option) => (
+              <Button
+                key={option.value}
+                type="button"
+                size="sm"
+                variant="ghost"
+                className={cn(
+                  'h-7 rounded-md px-3 text-xs font-medium shadow-none',
+                  range === option.value
+                    ? 'bg-background text-foreground shadow-sm'
+                    : 'text-muted-foreground hover:text-foreground',
+                )}
+                onClick={() => setRange(option.value)}
+              >
+                {option.label}
+              </Button>
+            ))}
+          </div>
+          <p className="text-xs font-medium tracking-wide text-muted-foreground">
+            {formatWindowLabel(stats?.window_started_at, stats?.window_ended_at)}
+          </p>
+        </div>
+
+        {statsQuery.isLoading ? (
+          <div className="space-y-3">
+            {Array.from({length: 3}).map((_, index) => (
+              <Skeleton key={index} className="h-36 w-full rounded-xl" />
+            ))}
+          </div>
+        ) : statsQuery.isError ? (
+          <div className="rounded-xl border border-dashed p-6 text-center text-sm text-muted-foreground">
+            加载流量统计失败
+            <div className="mt-3">
+              <Button
+                size="sm"
+                variant="outline"
+                className="h-7 text-xs"
+                onClick={() => void statsQuery.refetch()}
+              >
+                重试
+              </Button>
+            </div>
+          </div>
+        ) : (
+          <div className="space-y-3">
+            {!stats?.available ? (
+              <p className="text-xs text-muted-foreground">
+                分析存储暂不可用，图表可能为空。请确认 ClickHouse 已启用。
+              </p>
+            ) : null}
+
+            <MetricTrendCard
+              icon={Users}
+              label="唯一访问者"
+              value={formatCompactNumber(stats?.unique_visitors ?? 0)}
+              data={chartData}
+              dataKey="visitors"
+              config={visitorsChartConfig}
+              gradientId="zone-visitors"
+            />
+            <MetricTrendCard
+              icon={Activity}
+              label="请求总数"
+              value={formatCompactNumber(stats?.request_count ?? 0)}
+              data={chartData}
+              dataKey="requests"
+              config={requestsChartConfig}
+              gradientId="zone-requests"
+            />
+            <MetricTrendCard
+              icon={HardDrive}
+              label="已提供的数据总计"
+              value={formatBytes(stats?.bytes_sent ?? 0, {zeroText: '0 B'})}
+              data={chartData}
+              dataKey="bytes"
+              config={bytesChartConfig}
+              gradientId="zone-bytes"
+              valueFormatter={(value) => formatBytes(value, {zeroText: '0 B'})}
+            />
+          </div>
+        )}
+      </div>
+
+      <div className="grid gap-4 md:grid-cols-3">
+        <Card className="border-dashed shadow-none md:col-span-3">
+          <CardHeader className="pb-2">
+            <CardTitle className="text-sm">Zone 信息</CardTitle>
+          </CardHeader>
+          <CardContent className="grid gap-3 text-sm sm:grid-cols-2">
+            <div>
+              <p className="text-xs text-muted-foreground">根域</p>
+              <p className="mt-1 font-medium">{overview.zone.domain}</p>
+            </div>
+            <div>
+              <p className="text-xs text-muted-foreground">创建时间</p>
+              <p className="mt-1">{formatDateTime(overview.zone.created_at)}</p>
+            </div>
+          </CardContent>
+        </Card>
+      </div>
+    </div>
+  );
+}
+
+function MetricTrendCard({
+  icon: Icon,
+  label,
+  value,
+  data,
+  dataKey,
+  config,
+  gradientId,
+  valueFormatter,
+}: {
+  icon: typeof Users;
+  label: string;
+  value: string;
+  data: Array<Record<string, string | number>>;
+  dataKey: string;
+  config: ChartConfig;
+  gradientId: string;
+  valueFormatter?: (value: number) => string;
+}) {
+  return (
+    <Card className="overflow-hidden border shadow-none">
+      <CardContent className="p-0">
+        <div className="grid gap-0 md:grid-cols-[minmax(140px,200px)_1fr]">
+          <div className="flex flex-col justify-between gap-3 border-b p-4 md:border-b-0 md:border-r">
+            <div className="flex items-center gap-1.5 text-xs text-muted-foreground">
+              <Icon className="size-3.5 text-primary" />
+              <span>{label}</span>
+            </div>
+            <p className="text-3xl font-semibold tracking-tight">{value}</p>
+          </div>
+          <div className="h-36 min-h-[9rem] w-full px-2 py-3 md:h-40">
+            <ChartContainer config={config} className="h-full w-full aspect-auto">
+              <AreaChart data={data} margin={{top: 8, right: 12, left: 0, bottom: 0}}>
+                <defs>
+                  <linearGradient id={gradientId} x1="0" y1="0" x2="0" y2="1">
+                    <stop offset="5%" stopColor="var(--color-value)" stopOpacity={0.28} />
+                    <stop offset="95%" stopColor="var(--color-value)" stopOpacity={0.02} />
+                  </linearGradient>
+                </defs>
+                <CartesianGrid
+                  strokeDasharray="3 3"
+                  vertical={false}
+                  className="stroke-border/60"
+                />
+                <XAxis
+                  dataKey="label"
+                  tickLine={false}
+                  axisLine={false}
+                  minTickGap={28}
+                  tickMargin={8}
+                  className="text-[10px]"
+                />
+                <YAxis
+                  tickLine={false}
+                  axisLine={false}
+                  width={36}
+                  tickMargin={4}
+                  className="text-[10px]"
+                  allowDecimals={false}
+                  tickFormatter={(tick) =>
+                    valueFormatter
+                      ? valueFormatter(Number(tick))
+                      : formatCompactNumber(Number(tick))
+                  }
+                />
+                <ChartTooltip
+                  content={
+                    <ChartTooltipContent
+                      formatter={(raw) => {
+                        const numeric = Number(raw);
+                        return valueFormatter
+                          ? valueFormatter(numeric)
+                          : formatCompactNumber(numeric);
+                      }}
+                    />
+                  }
+                />
+                <Area
+                  type="monotone"
+                  dataKey={dataKey}
+                  name="value"
+                  stroke="var(--color-value)"
+                  strokeWidth={2}
+                  fill={`url(#${gradientId})`}
+                  isAnimationActive={false}
+                />
+              </AreaChart>
+            </ChartContainer>
+          </div>
+        </div>
+      </CardContent>
+    </Card>
+  );
 }
@@ -180,7 +180,7 @@ export function ZonePageClient({zoneId}: {zoneId: number}) {
        </TabsList>

        <TabsContent value="overview">
-          <ZoneOverviewPanel overview={overview} />
+          <ZoneOverviewPanel overview={overview} zoneId={zoneId} />
        </TabsContent>
        <TabsContent value="domains">
          <ZoneDomainsTable
@@ -108,6 +108,9 @@ export type {
  ZoneItem,
  ZoneMutationPayload,
  ZoneOverview,
+  ZoneStats,
+  ZoneStatsPoint,
+  ZoneStatsRange,
  TlsCertificateApplyPayload,
  TlsCertificateContentItem,
  TlsCertificateDetailItem,
@@ -988,6 +988,29 @@ export interface ZoneOverview {
  domains: ZoneDomainItem[];
 }

+export type ZoneStatsRange = '24h' | '7d' | '30d';
+
+export interface ZoneStatsPoint {
+  bucket_started_at: string;
+  request_count: number;
+  unique_visitors: number;
+  bytes_sent: number;
+}
+
+export interface ZoneStats {
+  range: ZoneStatsRange;
+  range_hours: number;
+  window_started_at: string;
+  window_ended_at: string;
+  bucket_minutes: number;
+  unique_visitors: number;
+  request_count: number;
+  bytes_sent: number;
+  domain_count: number;
+  available: boolean;
+  series: ZoneStatsPoint[];
+}
+



@@ -1,5 +1,13 @@
 import {OpenFlareBaseService} from './base.service'
-import type {ZoneDomainItem, ZoneDomainMutationPayload, ZoneItem, ZoneMutationPayload, ZoneOverview} from './types'
+import type {
+  ZoneDomainItem,
+  ZoneDomainMutationPayload,
+  ZoneItem,
+  ZoneMutationPayload,
+  ZoneOverview,
+  ZoneStats,
+  ZoneStatsRange,
+} from './types'

 export const zoneQueryKey = ['openflare', 'zones'] as const

@@ -8,6 +16,9 @@ export class ZoneService extends OpenFlareBaseService {

  static list(): Promise<ZoneItem[]> { return this.get<ZoneItem[]>('/') }
  static getOverview(id: number): Promise<ZoneOverview> { return this.get<ZoneOverview>(`/${id}/overview`) }
+  static getStats(id: number, range: ZoneStatsRange = '24h'): Promise<ZoneStats> {
+    return this.get<ZoneStats>(`/${id}/stats`, {range})
+  }
  static create(payload: ZoneMutationPayload): Promise<ZoneItem> { return this.post<ZoneItem>('/', payload) }
  static update(id: number, payload: ZoneMutationPayload): Promise<ZoneItem> { return this.post<ZoneItem>(`/${id}/update`, payload) }
  static deleteById(id: number): Promise<void> { return this.post<void>(`/${id}/delete`) }
@@ -5,6 +5,14 @@ import {beforeEach, describe, expect, it, vi} from 'vitest';
 import {ZonePageClient} from '@/app/(main)/websites/[zoneId]/page-client';
 import {ProxyRouteService, TlsCertificateService, ZoneService} from '@/lib/services/openflare';

+class ResizeObserverMock {
+  observe() {}
+  unobserve() {}
+  disconnect() {}
+}
+
+vi.stubGlobal('ResizeObserver', ResizeObserverMock);
+
 const replaceMock = vi.fn();

 vi.mock('next/link', () => ({
@@ -25,6 +33,7 @@ vi.mock('@/lib/services/openflare', async (importOriginal) => {
    ...actual,
    ZoneService: {
      getOverview: vi.fn(),
+      getStats: vi.fn(),
      deleteById: vi.fn(),
      list: vi.fn(),
    },
@@ -53,6 +62,20 @@ function renderPage(zoneId: number) {
 describe('ZonePageClient', () => {
  beforeEach(() => {
    vi.mocked(ZoneService.getOverview).mockReset();
+    vi.mocked(ZoneService.getStats).mockReset();
+    vi.mocked(ZoneService.getStats).mockResolvedValue({
+      range: '24h',
+      range_hours: 24,
+      window_started_at: new Date().toISOString(),
+      window_ended_at: new Date().toISOString(),
+      bucket_minutes: 60,
+      unique_visitors: 0,
+      request_count: 0,
+      bytes_sent: 0,
+      domain_count: 0,
+      available: true,
+      series: [],
+    });
    vi.mocked(ZoneService.deleteById).mockReset();
    vi.mocked(TlsCertificateService.list).mockReset();
    vi.mocked(TlsCertificateService.list).mockResolvedValue([]);
@@ -72,6 +95,9 @@ describe('ZonePageClient', () => {
      expect(ZoneService.getOverview).toHaveBeenCalledWith(42);
    });
    expect(await screen.findByRole('heading', {name: 'arctel.de'})).toBeVisible();
+    expect(await screen.findByText('唯一访问者')).toBeVisible();
+    expect(screen.getByText('请求总数')).toBeVisible();
+    expect(screen.getByText('已提供的数据总计')).toBeVisible();
    expect(screen.getByRole('tab', {name: '域名 (0)'})).toBeVisible();
    expect(screen.getByRole('tab', {name: '证书 (0)'})).toBeVisible();
    expect(screen.queryByRole('tab', {name: '路由'})).not.toBeInTheDocument();