commit b719b358f85b9d61d9b946d3b27506079c5ec3a7 Author: shangzy Date: Thu Apr 2 12:47:50 2026 +0800 feat: API analytics dashboard with i18n and theme support Next.js full-stack analytics dashboard for new-api. - Direct PostgreSQL readonly queries on logs table - 5 pages: Dashboard, Rankings, Aggregation, Logs, Detail - Dark/Light/System theme with CSS variables - Chinese/English i18n (default Chinese) - Recharts with dual Y-axis for input/output tokens - Lucide icons + Motion animations - Docker + docker-compose with external sinobridge network, port 8019 diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..87dc6da --- /dev/null +++ b/.dockerignore @@ -0,0 +1,7 @@ +node_modules +.next +.git +.env +.env.local +*.md +.playwright-mcp diff --git a/.env.production b/.env.production new file mode 100644 index 0000000..66ab899 --- /dev/null +++ b/.env.production @@ -0,0 +1 @@ +PG_CONNECTION_STRING=postgresql://postgres:EUWqvk39FRHeoP8l262icXvi0ktrkejECUUSxdmKozrSeqpGyPSXTSmNTaTc4KD0@192.168.111.90:5433/new-api diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..4eb5b3e --- /dev/null +++ b/.gitignore @@ -0,0 +1,43 @@ +# See https://help.github.com/articles/ignoring-files/ for more about ignoring files. + +# dependencies +/node_modules +/.pnp +.pnp.* +.yarn/* +!.yarn/patches +!.yarn/plugins +!.yarn/releases +!.yarn/versions + +# testing +/coverage + +# next.js +/.next/ +/out/ + +# production +/build + +# misc +.DS_Store +*.pem + +# debug +npm-debug.log* +yarn-debug.log* +yarn-error.log* +.pnpm-debug.log* + +# env files +.env +.env.local +!.env.production + +# vercel +.vercel + +# typescript +*.tsbuildinfo +next-env.d.ts diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..e2dc9b7 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,33 @@ +FROM node:22-alpine AS base + +# --- Dependencies --- +FROM base AS deps +WORKDIR /app +COPY package.json bun.lock ./ +RUN npm install --frozen-lockfile + +# --- Build --- +FROM base AS builder +WORKDIR /app +COPY --from=deps /app/node_modules ./node_modules +COPY . . +RUN npm run build + +# --- Production --- +FROM base AS runner +WORKDIR /app +ENV NODE_ENV=production +ENV PORT=8019 +ENV HOSTNAME=0.0.0.0 + +RUN addgroup --system --gid 1001 nodejs && \ + adduser --system --uid 1001 nextjs + +COPY --from=builder /app/public ./public +COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./ +COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static + +USER nextjs +EXPOSE 8019 + +CMD ["node", "server.js"] diff --git a/app/aggregation/page.tsx b/app/aggregation/page.tsx new file mode 100644 index 0000000..7c66c2f --- /dev/null +++ b/app/aggregation/page.tsx @@ -0,0 +1,140 @@ +"use client"; + +import { useEffect, useState, useCallback } from "react"; +import { motion } from "motion/react"; +import { Users, Calendar, Hash, Zap, ArrowUpDown, ArrowDown, ArrowUp } from "lucide-react"; +import { TimeRangeSelector } from "@/components/TimeRangeSelector"; +import { type TimeRange, getTimeRange, buildQuery, formatNumber, formatTokens } from "@/lib/utils"; +import { useI18n } from "@/lib/i18n"; + +interface AggItem { + rank: number; name: string; calls: number; + prompt_tokens: number; completion_tokens: number; total_tokens: number; +} + +type SortKey = "total_tokens" | "calls" | "prompt_tokens" | "completion_tokens"; + +export default function AggregationPage() { + const { t } = useI18n(); + const [range, setRange] = useState("30d"); + const [data, setData] = useState([]); + const [loading, setLoading] = useState(true); + const [sortKey, setSortKey] = useState("total_tokens"); + const [sortAsc, setSortAsc] = useState(false); + + const fetchData = useCallback(async () => { + setLoading(true); + const { start, end } = getTimeRange(range); + const res = await fetch(buildQuery("/api/aggregation", { start, end })); + setData(await res.json()); + setLoading(false); + }, [range]); + + useEffect(() => { fetchData(); }, [fetchData]); + + const sorted = [...data].sort((a, b) => { + const diff = (a[sortKey] as number) - (b[sortKey] as number); + return sortAsc ? diff : -diff; + }); + + const totals = data.reduce( + (acc, d) => ({ calls: acc.calls + d.calls, tokens: acc.tokens + d.total_tokens }), + { calls: 0, tokens: 0 } + ); + + function handleSort(key: SortKey) { + if (sortKey === key) setSortAsc(!sortAsc); + else { setSortKey(key); setSortAsc(false); } + } + + function SortIcon({ col }: { col: SortKey }) { + if (sortKey !== col) return ; + return sortAsc + ? + : ; + } + + const sortHeaders: { key: SortKey; label: string }[] = [ + { key: "calls", label: t("th.calls") }, + { key: "prompt_tokens", label: t("th.input") }, + { key: "completion_tokens", label: t("th.output") }, + { key: "total_tokens", label: t("th.totalToken") }, + ]; + + return ( +
+
+ + +

{t("agg.title")}

+ + +
+ + {!loading && data.length > 0 && ( + +
+ + {t("agg.userCount")} + {data.length} +
+
+ + {t("agg.totalCalls")} + {formatNumber(totals.calls)} +
+
+ + {t("agg.totalToken")} + {formatTokens(totals.tokens)} +
+ + )} + + + + + + + + {sortHeaders.map(h => ( + + ))} + + + + + {loading ? ( + + ) : sorted.map((item, i) => { + const pct = totals.tokens > 0 ? (item.total_tokens / totals.tokens * 100) : 0; + return ( + + + + + + + + + + ); + })} + +
#{t("th.user")} handleSort(h.key)}> + {h.label} + {t("common.share")}
{i + 1}{item.name}{formatNumber(item.calls)}{formatTokens(item.prompt_tokens)}{formatTokens(item.completion_tokens)}{formatTokens(item.total_tokens)} +
+
+ +
+ {pct.toFixed(1)}% +
+
+ +
+ ); +} diff --git a/app/api/aggregation/route.ts b/app/api/aggregation/route.ts new file mode 100644 index 0000000..26eef4a --- /dev/null +++ b/app/api/aggregation/route.ts @@ -0,0 +1,12 @@ +import { NextRequest, NextResponse } from "next/server"; +import { getUserRanking } from "@/lib/queries"; + +export async function GET(req: NextRequest) { + const sp = req.nextUrl.searchParams; + const startTs = sp.get("start") ? Number(sp.get("start")) : undefined; + const endTs = sp.get("end") ? Number(sp.get("end")) : undefined; + + // Get ALL users (no limit) for aggregation view + const data = await getUserRanking(startTs, endTs, 500); + return NextResponse.json(data); +} diff --git a/app/api/detail/[type]/[id]/route.ts b/app/api/detail/[type]/[id]/route.ts new file mode 100644 index 0000000..86d1f36 --- /dev/null +++ b/app/api/detail/[type]/[id]/route.ts @@ -0,0 +1,29 @@ +import { NextRequest, NextResponse } from "next/server"; +import { getUserDetail, getModelDetail, getChannelDetail } from "@/lib/queries"; + +export async function GET( + req: NextRequest, + { params }: { params: Promise<{ type: string; id: string }> } +) { + const { type, id } = await params; + const sp = req.nextUrl.searchParams; + const startTs = sp.get("start") ? Number(sp.get("start")) : undefined; + const endTs = sp.get("end") ? Number(sp.get("end")) : undefined; + + let data; + switch (type) { + case "user": + data = await getUserDetail(decodeURIComponent(id), startTs, endTs); + break; + case "model": + data = await getModelDetail(decodeURIComponent(id), startTs, endTs); + break; + case "channel": + data = await getChannelDetail(Number(id), startTs, endTs); + break; + default: + return NextResponse.json({ error: "Invalid type" }, { status: 400 }); + } + + return NextResponse.json(data); +} diff --git a/app/api/logs/route.ts b/app/api/logs/route.ts new file mode 100644 index 0000000..7e7c9a9 --- /dev/null +++ b/app/api/logs/route.ts @@ -0,0 +1,19 @@ +import { NextRequest, NextResponse } from "next/server"; +import { getLogs } from "@/lib/queries"; + +export async function GET(req: NextRequest) { + const sp = req.nextUrl.searchParams; + + const data = await getLogs({ + page: sp.get("page") ? Number(sp.get("page")) : 1, + pageSize: sp.get("page_size") ? Number(sp.get("page_size")) : 100, + startTs: sp.get("start") ? Number(sp.get("start")) : undefined, + endTs: sp.get("end") ? Number(sp.get("end")) : undefined, + username: sp.get("username") || undefined, + model: sp.get("model") || undefined, + channelId: sp.get("channel_id") ? Number(sp.get("channel_id")) : undefined, + tokenName: sp.get("token_name") || undefined, + }); + + return NextResponse.json(data); +} diff --git a/app/api/overview/route.ts b/app/api/overview/route.ts new file mode 100644 index 0000000..f4d34cb --- /dev/null +++ b/app/api/overview/route.ts @@ -0,0 +1,11 @@ +import { NextRequest, NextResponse } from "next/server"; +import { getOverview } from "@/lib/queries"; + +export async function GET(req: NextRequest) { + const sp = req.nextUrl.searchParams; + const startTs = sp.get("start") ? Number(sp.get("start")) : undefined; + const endTs = sp.get("end") ? Number(sp.get("end")) : undefined; + + const data = await getOverview(startTs, endTs); + return NextResponse.json(data); +} diff --git a/app/api/rankings/route.ts b/app/api/rankings/route.ts new file mode 100644 index 0000000..29875f0 --- /dev/null +++ b/app/api/rankings/route.ts @@ -0,0 +1,24 @@ +import { NextRequest, NextResponse } from "next/server"; +import { getUserRanking, getModelRanking, getChannelRanking } from "@/lib/queries"; + +export async function GET(req: NextRequest) { + const sp = req.nextUrl.searchParams; + const type = sp.get("type") || "user"; + const startTs = sp.get("start") ? Number(sp.get("start")) : undefined; + const endTs = sp.get("end") ? Number(sp.get("end")) : undefined; + const limit = sp.get("limit") ? Number(sp.get("limit")) : 50; + + let data; + switch (type) { + case "model": + data = await getModelRanking(startTs, endTs, limit); + break; + case "channel": + data = await getChannelRanking(startTs, endTs, limit); + break; + default: + data = await getUserRanking(startTs, endTs, limit); + } + + return NextResponse.json(data); +} diff --git a/app/api/trends/route.ts b/app/api/trends/route.ts new file mode 100644 index 0000000..c37ca77 --- /dev/null +++ b/app/api/trends/route.ts @@ -0,0 +1,12 @@ +import { NextRequest, NextResponse } from "next/server"; +import { getTrends } from "@/lib/queries"; + +export async function GET(req: NextRequest) { + const sp = req.nextUrl.searchParams; + const granularity = (sp.get("granularity") || "day") as "day" | "week" | "month"; + const startTs = sp.get("start") ? Number(sp.get("start")) : undefined; + const endTs = sp.get("end") ? Number(sp.get("end")) : undefined; + + const data = await getTrends(granularity, startTs, endTs); + return NextResponse.json(data); +} diff --git a/app/detail/[...slug]/page.tsx b/app/detail/[...slug]/page.tsx new file mode 100644 index 0000000..f6fa2ea --- /dev/null +++ b/app/detail/[...slug]/page.tsx @@ -0,0 +1,114 @@ +"use client"; + +import { useEffect, useState, useCallback } from "react"; +import { useParams } from "next/navigation"; +import { motion } from "motion/react"; +import { ArrowLeft, Hash, Zap, MessageSquare } from "lucide-react"; +import Link from "next/link"; +import { StatsCard } from "@/components/StatsCard"; +import { TimeRangeSelector } from "@/components/TimeRangeSelector"; +import { TrendChart } from "@/components/charts/TrendChart"; +import { type TimeRange, getTimeRange, buildQuery, formatNumber, formatTokens } from "@/lib/utils"; +import { useI18n } from "@/lib/i18n"; + +interface DetailData { + calls: number; prompt_tokens: number; completion_tokens: number; + total_tokens: number; quota: number; + models?: { name: string; calls: number; total_tokens: number; quota: number }[]; + users?: { name: string; calls: number; total_tokens: number; quota: number }[]; + channel_name?: string; +} + +export default function DetailPage() { + const { t } = useI18n(); + const params = useParams(); + const segments = Array.isArray(params.slug) ? params.slug : []; + const type = segments[0] || ""; + const id = segments[1] || ""; + const decodedId = decodeURIComponent(id); + + const [range, setRange] = useState("30d"); + const [data, setData] = useState(null); + const [trends, setTrends] = useState([]); + const [loading, setLoading] = useState(true); + + const fetchData = useCallback(async () => { + setLoading(true); + const { start, end } = getTimeRange(range); + const tp = { start, end }; + const [detail, tr] = await Promise.all([ + fetch(buildQuery(`/api/detail/${type}/${encodeURIComponent(decodedId)}`, tp)).then(r => r.json()), + fetch(buildQuery("/api/trends", { ...tp, granularity: "day", + ...(type === "user" ? { username: decodedId } : {}), + ...(type === "model" ? { model: decodedId } : {}), + ...(type === "channel" ? { channel_id: decodedId } : {}), + })).then(r => r.json()), + ]); + setData(detail); setTrends(tr); setLoading(false); + }, [range, type, decodedId]); + + useEffect(() => { fetchData(); }, [fetchData]); + + const title = type === "channel" ? (data?.channel_name || decodedId) : decodedId; + const typeLabel = { user: t("detail.user"), model: t("detail.model"), channel: t("detail.channel") }[type] || type; + const breakdownItems = data?.models || data?.users || []; + const breakdownLabel = data?.models ? t("detail.modelDist") : t("detail.userDist"); + + return ( +
+
+ + + {t("common.backToRankings")} + +
+ {typeLabel} +

{title}

+
+ + +
+ + {loading ? ( +
+ ) : data ? ( + <> +
+ + + +
+ + +

{t("detail.trend")}

+ + + + {breakdownItems.length > 0 && ( + +

{breakdownLabel}

+ + + + + + + + + + {breakdownItems.map((item) => ( + + + + + + ))} + +
{t("th.name")}{t("th.calls")}{t("th.totalToken")}
{item.name}{formatNumber(item.calls)}{formatTokens(item.total_tokens)}
+ + )} + + ) : null} +
+ ); +} diff --git a/app/favicon.ico b/app/favicon.ico new file mode 100644 index 0000000..718d6fe Binary files /dev/null and b/app/favicon.ico differ diff --git a/app/globals.css b/app/globals.css new file mode 100644 index 0000000..4692890 --- /dev/null +++ b/app/globals.css @@ -0,0 +1,196 @@ +@import "tailwindcss"; + +@theme inline { + --color-background: var(--background); + --color-foreground: var(--foreground); + --font-sans: var(--font-geist-sans); + --font-mono: var(--font-geist-mono); +} + +/* ═══ DARK THEME ═══ */ +:root, [data-theme="dark"] { + --background: #06080d; + --foreground: #c8d6e5; + --accent: #00e5ff; + --accent-dim: #0097a7; + --accent-purple: #7c4dff; + --accent-pink: #ff4081; + --surface: rgba(12, 18, 30, 0.7); + --surface-border: rgba(0, 229, 255, 0.08); + --surface-hover: rgba(0, 229, 255, 0.04); + --text-primary: #ffffff; + --text-secondary: #c8d6e5; + --text-muted: #6b7280; + --text-accent: #00e5ff; + --text-accent-hover: #67edff; + --glow-cyan: 0 0 20px rgba(0, 229, 255, 0.15); + --grid-color: rgba(0, 229, 255, 0.03); + --row-hover: rgba(0, 229, 255, 0.04); + --input-bg: rgba(12, 18, 30, 0.6); + --input-border: rgba(0, 229, 255, 0.1); + --input-focus: rgba(0, 229, 255, 0.4); + --chart-grid: rgba(0, 229, 255, 0.06); + --btn-active-bg: rgba(0, 229, 255, 0.2); + --btn-active-border: rgba(0, 229, 255, 0.5); + --progress-bg: rgba(0, 229, 255, 0.08); + --spinner-track: rgba(0, 229, 255, 0.3); + --spinner-head: #00e5ff; + color-scheme: dark; +} + +/* ═══ LIGHT THEME ═══ */ +[data-theme="light"] { + --background: #f7f8fc; + --foreground: #1e293b; + --accent: #0284c7; + --accent-dim: #0369a1; + --accent-purple: #7c3aed; + --accent-pink: #db2777; + --surface: rgba(255, 255, 255, 0.85); + --surface-border: rgba(2, 132, 199, 0.12); + --surface-hover: rgba(2, 132, 199, 0.04); + --text-primary: #0f172a; + --text-secondary: #475569; + --text-muted: #94a3b8; + --text-accent: #0284c7; + --text-accent-hover: #0369a1; + --glow-cyan: 0 4px 20px rgba(2, 132, 199, 0.08); + --grid-color: rgba(2, 132, 199, 0.04); + --row-hover: rgba(2, 132, 199, 0.05); + --input-bg: rgba(255, 255, 255, 0.8); + --input-border: rgba(2, 132, 199, 0.15); + --input-focus: rgba(2, 132, 199, 0.4); + --chart-grid: rgba(2, 132, 199, 0.08); + --btn-active-bg: rgba(2, 132, 199, 0.12); + --btn-active-border: rgba(2, 132, 199, 0.3); + --progress-bg: rgba(2, 132, 199, 0.1); + --spinner-track: rgba(2, 132, 199, 0.3); + --spinner-head: #0284c7; + color-scheme: light; +} + +body { + background: var(--background); + color: var(--foreground); + font-family: var(--font-sans), system-ui, sans-serif; + transition: background 0.3s, color 0.3s; +} + +/* Grid background — dark only */ +[data-theme="dark"] body::before { + content: ''; + position: fixed; + inset: 0; + z-index: -1; + background-image: + linear-gradient(var(--grid-color) 1px, transparent 1px), + linear-gradient(90deg, var(--grid-color) 1px, transparent 1px); + background-size: 60px 60px; + mask-image: radial-gradient(ellipse 80% 60% at 50% 0%, black 20%, transparent 100%); +} + +/* Top ambient glow — dark only */ +[data-theme="dark"] body::after { + content: ''; + position: fixed; + top: -200px; + left: 50%; + transform: translateX(-50%); + width: 800px; + height: 500px; + border-radius: 50%; + background: radial-gradient(ellipse, rgba(0, 229, 255, 0.06) 0%, transparent 70%); + z-index: -1; + pointer-events: none; +} + +/* Light theme subtle background */ +[data-theme="light"] body::before { + content: ''; + position: fixed; + inset: 0; + z-index: -1; + background: radial-gradient(ellipse at 50% 0%, rgba(2, 132, 199, 0.03) 0%, transparent 60%); +} + +/* Glass card */ +.glass { + background: var(--surface); + backdrop-filter: blur(16px); + border: 1px solid var(--surface-border); + border-radius: 12px; + transition: border-color 0.2s, background 0.3s; +} +.glass:hover { + border-color: var(--input-border); +} + +/* Gradient heading */ +.gradient-text { + background: linear-gradient(135deg, var(--accent) 0%, var(--accent-purple) 50%, var(--accent-pink) 100%); + -webkit-background-clip: text; + background-clip: text; + -webkit-text-fill-color: transparent; +} + +/* Table row glow on hover */ +.row-glow:hover { + background: var(--row-hover); +} + +/* Accent button */ +.btn-accent { + background: var(--btn-active-bg); + border: 1px solid var(--surface-border); + color: var(--text-accent); + transition: all 0.2s; +} +.btn-accent:hover { + border-color: var(--btn-active-border); + box-shadow: var(--glow-cyan); +} + +/* Input style */ +.input-glass { + background: var(--input-bg); + border: 1px solid var(--input-border); + color: var(--foreground); + transition: border-color 0.2s; +} +.input-glass::placeholder { + color: var(--text-muted); +} +.input-glass:focus { + outline: none; + border-color: var(--input-focus); + box-shadow: 0 0 12px rgba(2, 132, 199, 0.1); +} + +/* Spinner */ +.spinner { + border: 2px solid var(--spinner-track); + border-top-color: var(--spinner-head); +} + +/* Themed text utility classes */ +.text-t-primary { color: var(--text-primary); } +.text-t-secondary { color: var(--text-secondary); } +.text-t-muted { color: var(--text-muted); } +.text-t-accent { color: var(--text-accent); } +.text-t-accent:hover { color: var(--text-accent-hover); } +.border-t { border-color: var(--surface-border); } + +/* Scrollbar */ +::-webkit-scrollbar { width: 6px; height: 6px; } +::-webkit-scrollbar-track { background: transparent; } +::-webkit-scrollbar-thumb { background: var(--surface-border); border-radius: 3px; } +::-webkit-scrollbar-thumb:hover { background: var(--input-border); } + +/* Recharts overrides */ +.recharts-cartesian-grid-horizontal line, +.recharts-cartesian-grid-vertical line { + stroke: var(--chart-grid) !important; +} +.recharts-text { + fill: var(--text-muted) !important; +} diff --git a/app/layout.tsx b/app/layout.tsx new file mode 100644 index 0000000..e70a5e7 --- /dev/null +++ b/app/layout.tsx @@ -0,0 +1,45 @@ +import type { Metadata } from "next"; +import { Outfit, JetBrains_Mono } from "next/font/google"; +import "./globals.css"; +import { ClientProviders } from "@/components/ClientProviders"; + +const outfit = Outfit({ + variable: "--font-geist-sans", + subsets: ["latin"], + weight: ["300", "400", "500", "600", "700", "800"], +}); + +const jetbrains = JetBrains_Mono({ + variable: "--font-geist-mono", + subsets: ["latin"], + weight: ["400", "500", "600"], +}); + +export const metadata: Metadata = { + title: "API Analytics — Neural Pulse", + description: "Real-time API usage analytics dashboard", +}; + +export default function RootLayout({ + children, +}: Readonly<{ + children: React.ReactNode; +}>) { + return ( + + +