Files
OmniRoute/src/shared/components/UsageAnalytics.tsx
nguyenha935 4012bac41d fix(i18n): preserve remaining Vietnamese localization (#7935)
* fix(i18n): preserve remaining Vietnamese localization

* chore(quality): rebaseline file-size cap for 9 dashboard components (i18n wiring)

Restoring the Vietnamese localization on 9 dashboard components (useTranslations
wiring + t()/tc() call-site swaps for previously hardcoded strings) grows each
file by a small, irreducible amount. Bumps the frozen file-size-baseline.json
caps to match, with a justification entry per the project's own ratchet policy.

Co-authored-by: diegosouzapw <8016841+diegosouzapw@users.noreply.github.com>

* fix(i18n): wire weekday localization + add missing qwen CLI description

Two gaps left by this PR's own new contract tests, caught while
reconciling the branch against the release tip:

- CostOverviewTab.tsx added formatWeekdayLabel() but never called it;
  the Weekly Usage Pattern chart still showed raw English day
  abbreviations regardless of locale. Now maps weeklyPattern rows
  through it before handing them to WeeklyPatternCard.
- cliTools.toolDescriptions was missing an entry for "qwen" (a
  baseUrlSupport:"full" tool) in both en.json and vi.json, failing
  the PR's own cli-catalog-display-contract.test.ts.

Covered by the PR's existing tests/unit/dashboard-localization-contract.test.ts
and tests/unit/cli-catalog-display-contract.test.ts (both now pass).

Co-authored-by: diegosouzapw <8016841+diegosouzapw@users.noreply.github.com>

* i18n(vi): backfill the 4 proxySubscription keys #7299 added to en.json

#7299 (proxy subscriptions) merged while this branch was rebasing, adding
settings.proxySubscriptionsTab and settings.proxySubscription.error.{LOCAL_CORE_ENDPOINT_INVALID,
NEEDS_CORE_NOT_CONFIGURED,NO_USABLE_NODES} to en.json. This PR's own
i18n-vi-completeness contract asserts full en↔vi key parity, so the merge of the
current release tip surfaced them as missing. Adds the Vietnamese translations,
keeping the SS/VMess/Trojan/VLESS/SOCKS5 technical terms verbatim.

Co-authored-by: diegosouzapw <8016841+diegosouzapw@users.noreply.github.com>

---------

Co-authored-by: nguyenha935 <208228297+nguyenha935@users.noreply.github.com>
Co-authored-by: Diego Rodrigues de Sa e Souza <diegosouza.pw@gmail.com>
Co-authored-by: diegosouzapw <8016841+diegosouzapw@users.noreply.github.com>
Co-authored-by: nguyenha935 <nguyenha935@users.noreply.github.com>
2026-07-21 13:41:02 -03:00

426 lines
14 KiB
TypeScript

"use client";
import { useState, useEffect, useCallback, useMemo, useRef } from "react";
import { useLocale, useTranslations } from "next-intl";
import Card from "./Card";
import { CardSkeleton } from "./Loading";
import { fmtCompact as fmt, fmtFull, fmtCost } from "@/shared/utils/formatting";
import { readFetchErrorMessage } from "@/shared/utils/fetchError";
import {
StatCard,
CompactStatGrid,
ActivityHeatmap,
DailyTrendChart,
AccountDonut,
ApiKeyDonut,
ApiKeyTable,
MostActiveDay7d,
WeeklySquares7d,
ModelTable,
ProviderCostDonut,
ModelOverTimeChart,
ProviderTable,
ServiceTierBreakdown,
ApiKeyFilterDropdown,
CustomRangePicker,
RequestCountByProviderDateTable,
} from "./analytics";
// ============================================================================
// Main Component
// ============================================================================
export default function UsageAnalytics() {
const locale = useLocale();
const t = useTranslations("analytics");
const tCommon = useTranslations("common");
const [range, setRange] = useState("30d");
const [analytics, setAnalytics] = useState<any>(null);
const [loading, setLoading] = useState(true);
const [error, setError] = useState<string | null>(null);
// Custom date range state
const [customStart, setCustomStart] = useState("");
const [customEnd, setCustomEnd] = useState("");
const [showCustomPicker, setShowCustomPicker] = useState(false);
const customPickerAnchorRef = useRef<HTMLDivElement>(null);
// API key filter state
const [selectedApiKeys, setSelectedApiKeys] = useState<string[]>([]);
const [availableApiKeys, setAvailableApiKeys] = useState<{ id: string; name: string }[]>([]);
const fetchAnalytics = useCallback(async () => {
try {
setLoading(true);
const params = new URLSearchParams();
params.set("range", range);
if (range === "custom" && customStart && customEnd) {
params.set("startDate", customStart);
params.set("endDate", customEnd);
}
if (selectedApiKeys.length > 0) {
params.set("apiKeyIds", selectedApiKeys.join(","));
}
const res = await fetch(`/api/usage/analytics?${params.toString()}`);
if (!res.ok) throw new Error(await readFetchErrorMessage(res, tCommon("error")));
const data = await res.json();
setAnalytics(data);
setError(null);
// Update available keys from unfiltered data (only when no filter is active).
if (selectedApiKeys.length === 0 && data.byApiKey?.length > 0) {
const seen = new Set<string>();
const keys: { id: string; name: string }[] = [];
for (const k of data.byApiKey) {
const id = k.apiKeyId || k.apiKeyName || tCommon("unknownProvider");
const name = k.apiKeyName || k.apiKeyId || tCommon("unknownProvider");
if (seen.has(id)) continue;
seen.add(id);
keys.push({ id, name });
}
setAvailableApiKeys(keys);
}
} catch (err) {
setError((err as any).message);
} finally {
setLoading(false);
}
}, [range, customStart, customEnd, selectedApiKeys, tCommon]);
useEffect(() => {
const timer = window.setTimeout(() => void fetchAnalytics(), 0);
return () => window.clearTimeout(timer);
}, [fetchAnalytics]);
const handleRangeSelect = useCallback((value: string) => {
if (value === "custom") {
setShowCustomPicker(true);
} else {
setRange(value);
setShowCustomPicker(false);
}
}, []);
const handleCustomApply = useCallback((start: string, end: string) => {
setCustomStart(start);
setCustomEnd(end);
setRange("custom");
setShowCustomPicker(false);
}, []);
// Format custom range label for display
const customRangeLabel = useMemo(() => {
if (range !== "custom" || !customStart || !customEnd) return null;
const fmt = (iso: string) => {
const d = new Date(iso);
return d.toLocaleDateString(locale, {
month: "short",
day: "numeric",
hour: "2-digit",
minute: "2-digit",
});
};
return `${fmt(customStart)}${fmt(customEnd)}`;
}, [range, customStart, customEnd, locale]);
const ranges = [
{ value: "1d", label: t("period1D") },
{ value: "7d", label: t("period7D") },
{ value: "30d", label: t("period30D") },
{ value: "90d", label: t("period90D") },
{ value: "ytd", label: t("periodYTD") },
{ value: "all", label: t("periodAll") },
];
const topModel = useMemo(() => {
const models = analytics?.byModel || [];
return models.length > 0 ? models[0].model : "—";
}, [analytics]);
const topProvider = useMemo(() => {
const providers = analytics?.byProvider || [];
return providers.length > 0 ? providers[0].provider : "—";
}, [analytics]);
const busiestDay = useMemo(() => {
const wp = analytics?.weeklyPattern || [];
if (!wp.length) return "—";
const max = wp.reduce((a, b) => (a.avgTokens > b.avgTokens ? a : b), wp[0]);
if (max.avgTokens <= 0) return "—";
const weekdayIndex = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"].indexOf(max.day);
if (weekdayIndex < 0) return max.day;
return new Intl.DateTimeFormat(locale, { weekday: "short" }).format(
new Date(2024, 0, 7 + weekdayIndex)
);
}, [analytics, locale]);
const providerCount = useMemo(() => {
return (analytics?.byProvider || []).length;
}, [analytics]);
const providerDiversity = useMemo(() => {
const providers = analytics?.byProvider || [];
if (providers.length <= 1) return 0;
let totalCalls = 0;
for (const p of providers) {
totalCalls += p.totalRequests || p.apiCalls || 0;
}
if (totalCalls === 0) return 0;
let h = 0;
for (const p of providers) {
const p_i = (p.totalRequests || p.apiCalls || 0) / totalCalls;
if (p_i > 0) h -= p_i * Math.log2(p_i);
}
const maxH = Math.log2(providers.length);
return maxH > 0 ? (h / maxH) * 100 : 0;
}, [analytics]);
if (loading && !analytics) return <CardSkeleton />;
if (error)
return (
<Card className="p-6 text-center text-red-500">
{tCommon("errorShort")}: {error}
</Card>
);
const s = analytics?.summary || {};
// ── Derived insight values ──
const avgTokensPerReq = s.totalRequests > 0 ? Math.round(s.totalTokens / s.totalRequests) : 0;
const costPerReq = s.totalRequests > 0 ? s.totalCost / s.totalRequests : 0;
const ioRatio = s.completionTokens > 0 ? (s.promptTokens / s.completionTokens).toFixed(1) : "—";
return (
<div className="flex flex-col gap-5 min-w-0">
{/* Header + Filters */}
<div className="flex items-center justify-between flex-wrap gap-3">
<h2 className="text-xl font-semibold flex items-center gap-2">
<span className="material-symbols-outlined text-primary text-[22px]">analytics</span>
{t("usageAnalyticsTitle")}
</h2>
<div className="flex items-center gap-2.5">
{/* API Key Filter */}
<ApiKeyFilterDropdown
available={availableApiKeys}
selected={selectedApiKeys}
onChange={setSelectedApiKeys}
/>
{/* Period Selector + Custom */}
<div
className="relative flex items-center gap-1 bg-black/[0.03] dark:bg-white/[0.03] rounded-lg p-1 border border-black/5 dark:border-white/5"
ref={customPickerAnchorRef}
>
{ranges.map((r) => (
<button
key={r.value}
onClick={() => handleRangeSelect(r.value)}
className={`px-3 py-1 rounded-md text-xs font-semibold transition-all ${
range === r.value
? "bg-primary text-white shadow-sm"
: "text-text-muted hover:text-text-main hover:bg-black/5 dark:hover:bg-white/5"
}`}
>
{r.label}
</button>
))}
<button
onClick={() => handleRangeSelect("custom")}
className={`px-3 py-1 rounded-md text-xs font-semibold transition-all flex items-center gap-1 ${
range === "custom"
? "bg-primary text-white shadow-sm"
: "text-text-muted hover:text-text-main hover:bg-black/5 dark:hover:bg-white/5"
}`}
>
<span className="material-symbols-outlined text-[13px]">date_range</span>
{customRangeLabel || t("customRange")}
{range === "custom" && customRangeLabel && (
<span
role="button"
onClick={(e) => {
e.stopPropagation();
setRange("30d");
setCustomStart("");
setCustomEnd("");
}}
className="ml-0.5 opacity-70 hover:opacity-100"
>
<span className="material-symbols-outlined text-[11px]">close</span>
</span>
)}
</button>
{/* Custom Range Picker Popover */}
{showCustomPicker && (
<CustomRangePicker
start={customStart}
end={customEnd}
onApply={handleCustomApply}
onClose={() => setShowCustomPicker(false)}
/>
)}
</div>
</div>
</div>
{/* Primary KPI Cards */}
<div className="grid grid-cols-2 md:grid-cols-4 gap-3">
<StatCard
icon="generating_tokens"
label={t("totalTokens")}
value={fmt(s.totalTokens)}
subValue={`${fmtFull(s.totalRequests)} ${t("chartRequests")}`}
/>
<StatCard
icon="input"
label={t("inputTokens")}
value={fmt(s.promptTokens)}
color="text-primary"
/>
<StatCard
icon="output"
label={t("outputTokens")}
value={fmt(s.completionTokens)}
color="text-emerald-500"
/>
<StatCard
icon="payments"
label={t("estCost")}
value={fmtCost(s.totalCost)}
color="text-amber-500"
/>
</div>
{/* Secondary Metrics — compact grid with sections */}
<CompactStatGrid
sections={[
{
title: t("infraTitle"),
items: [
{ icon: "group", label: t("infraAccounts"), value: s.uniqueAccounts || 0 },
{
icon: "dns",
label: t("infraProviders"),
value: providerCount,
color: "text-indigo-500",
},
{ icon: "vpn_key", label: t("infraApiKeys"), value: s.uniqueApiKeys || 0 },
{ icon: "model_training", label: t("infraModels"), value: s.uniqueModels || 0 },
],
},
{
title: t("perfTitle"),
items: [
{
icon: "speed",
label: t("perfAvgTokens"),
value: fmt(avgTokensPerReq),
color: "text-cyan-500",
},
{
icon: "request_quote",
label: t("perfCostReq"),
value: fmtCost(costPerReq),
color: "text-orange-500",
},
{
icon: "compare_arrows",
label: t("perfIoRatio"),
value: `${ioRatio}x`,
color: "text-violet-500",
},
{
icon: "bolt",
label: t("perfFastReq"),
value: fmt(s.fastRequests || 0),
color: "text-sky-500",
},
],
},
{
title: t("highlightsTitle"),
wideValues: true,
items: [
{
icon: "star",
label: t("highlightsTopModel"),
value: topModel,
color: "text-pink-500",
},
{
icon: "cloud",
label: t("highlightsTopProvider"),
value: topProvider,
color: "text-teal-500",
},
{
icon: "today",
label: t("highlightsBusiestDay"),
value: busiestDay,
color: "text-rose-500",
},
{
icon: "network_node",
label: t("highlightsDiversity"),
value: `${providerDiversity.toFixed(1)}%`,
color: "text-sky-500",
},
{
icon: "swap_horiz",
label: t("highlightsFallbackRate"),
value: `${Number(s.fallbackRatePct || 0).toFixed(1)}%`,
color: "text-amber-500",
},
],
},
]}
/>
{/* Activity Heatmap + Weekly Widgets */}
<div className="grid grid-cols-1 lg:grid-cols-[2fr_1fr] gap-4 items-stretch">
<ActivityHeatmap activityMap={analytics?.activityMap} />
<div className="flex flex-col gap-4">
<MostActiveDay7d activityMap={analytics?.activityMap} />
<WeeklySquares7d activityMap={analytics?.activityMap} />
</div>
</div>
{/* Token & Cost Trend + Provider Cost Donut */}
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
<DailyTrendChart dailyTrend={analytics?.dailyTrend} />
<ProviderCostDonut byProvider={analytics?.byProvider} />
</div>
{/* Fast / Standard service tier split */}
<ServiceTierBreakdown byServiceTier={analytics?.byServiceTier} summary={s} />
{/* Model Usage Over Time (stacked area) */}
<ModelOverTimeChart
dailyByModel={analytics?.dailyByModel}
modelNames={analytics?.modelNames}
/>
{/* Account Donut + API Key Donut */}
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
<AccountDonut byAccount={analytics?.byAccount} />
<ApiKeyDonut byApiKey={analytics?.byApiKey} />
</div>
{/* Provider Breakdown Table */}
<ProviderTable byProvider={analytics?.byProvider} />
{/* Request Count by Provider & Date — #4009 (some providers bill per-request) */}
<RequestCountByProviderDateTable range={range} />
{/* API Key Table */}
<ApiKeyTable byApiKey={analytics?.byApiKey} />
{/* Model Breakdown Table */}
<ModelTable byModel={analytics?.byModel} summary={s} />
</div>
);
}