feat: add admin tracking events export

This commit is contained in:
2026-05-07 17:02:31 +08:00
parent 59ef2ab472
commit fd16485827
11 changed files with 1040 additions and 7 deletions

View File

@@ -6,6 +6,8 @@ import type {
AdminLoginResponse,
AdminMeResponse,
AdminOverviewResponse,
AdminTrackingEventListQuery,
AdminTrackingEventListResponse,
AdminUpsertProfileInviteCodeRequest,
AdminUpsertProfileRedeemCodeRequest,
AdminUpsertProfileTaskConfigRequest,
@@ -135,6 +137,16 @@ export function debugAdminHttp(token: string, payload: AdminDebugHttpRequest) {
});
}
export function listAdminTrackingEvents(
token: string,
query: AdminTrackingEventListQuery = {},
) {
return request<AdminTrackingEventListResponse>(
`/admin/api/tracking/events${buildQueryString(query)}`,
{token},
);
}
export function listProfileRedeemCodes(token: string) {
return request<ProfileRedeemCodeAdminListResponse>(
'/admin/api/profile/redeem-codes',
@@ -232,6 +244,30 @@ function buildRequestUrl(path: string) {
return `${ADMIN_API_BASE_URL}${normalizedPath}`;
}
function buildQueryString(query: AdminTrackingEventListQuery) {
const params = new URLSearchParams();
appendQueryParam(params, 'eventKey', query.eventKey);
appendQueryParam(params, 'userId', query.userId);
appendQueryParam(params, 'scopeKind', query.scopeKind);
appendQueryParam(params, 'scopeId', query.scopeId);
if (typeof query.limit === 'number' && Number.isFinite(query.limit)) {
params.set('limit', String(query.limit));
}
const queryString = params.toString();
return queryString ? `?${queryString}` : '';
}
function appendQueryParam(
params: URLSearchParams,
key: string,
value: string | null | undefined,
) {
const trimmed = value?.trim();
if (trimmed) {
params.set(key, trimmed);
}
}
function parseJsonResponse(responseText: string): unknown {
if (!responseText.trim()) {
return null;

View File

@@ -109,6 +109,14 @@ export type ProfileRedeemCodeMode = 'public' | 'unique' | 'private';
export type ProfileTaskCycle = 'daily';
export type TrackingScopeKind = 'site' | 'work' | 'module' | 'user';
export interface AdminTrackingEventListQuery {
eventKey?: string;
userId?: string;
scopeKind?: TrackingScopeKind | '';
scopeId?: string;
limit?: number;
}
export interface AdminUpsertProfileRedeemCodeRequest {
code: string;
mode: ProfileRedeemCodeMode;
@@ -199,3 +207,22 @@ export interface ProfileTaskConfigAdminResponse {
export interface ProfileTaskConfigAdminListResponse {
entries: ProfileTaskConfigAdminResponse[];
}
export interface AdminTrackingEventEntryPayload {
eventId: string;
eventKey: string;
eventTitle: string;
scopeKind: TrackingScopeKind | string;
scopeId: string;
dayKey: number;
userId?: string | null;
ownerUserId?: string | null;
profileId?: string | null;
moduleKey?: string | null;
metadataJson: string;
occurredAt: string;
}
export interface AdminTrackingEventListResponse {
entries: AdminTrackingEventEntryPayload[];
}

View File

@@ -23,6 +23,7 @@ import {AdminLoginPage} from '../pages/AdminLoginPage';
import {AdminOverviewPage} from '../pages/AdminOverviewPage';
import {AdminRedeemCodePage} from '../pages/AdminRedeemCodePage';
import {AdminTaskConfigPage} from '../pages/AdminTaskConfigPage';
import {AdminTrackingEventsPage} from '../pages/AdminTrackingEventsPage';
import {AdminShell} from './AdminShell';
import type {AdminRouteId} from './adminRoutes';
import {resolveAdminRoute, routeHash} from './adminRoutes';
@@ -162,6 +163,12 @@ export function AdminApp() {
{routeId === 'debug' ? (
<AdminDebugHttpPage token={token} onUnauthorized={handleUnauthorized} />
) : null}
{routeId === 'tracking' ? (
<AdminTrackingEventsPage
token={token}
onUnauthorized={handleUnauthorized}
/>
) : null}
{routeId === 'redeem' ? (
<AdminRedeemCodePage
result={redeemResult}

View File

@@ -4,6 +4,7 @@ import {
LogOut,
ShieldCheck,
ListChecks,
Table2,
TicketCheck,
TicketPercent,
} from 'lucide-react';
@@ -24,6 +25,7 @@ interface AdminShellProps {
const routeIcons = {
overview: LayoutDashboard,
debug: Bug,
tracking: Table2,
redeem: TicketPercent,
invite: TicketCheck,
tasks: ListChecks,

View File

@@ -1,4 +1,4 @@
export type AdminRouteId = 'overview' | 'debug' | 'redeem' | 'invite' | 'tasks';
export type AdminRouteId = 'overview' | 'debug' | 'tracking' | 'redeem' | 'invite' | 'tasks';
export interface AdminRouteDefinition {
id: AdminRouteId;
@@ -9,6 +9,7 @@ export interface AdminRouteDefinition {
export const adminRoutes: AdminRouteDefinition[] = [
{id: 'overview', label: '总览', hash: '#overview'},
{id: 'debug', label: 'API 调试', hash: '#debug'},
{id: 'tracking', label: '埋点数据', hash: '#tracking'},
{id: 'redeem', label: '兑换码', hash: '#redeem'},
{id: 'invite', label: '邀请码', hash: '#invite'},
{id: 'tasks', label: '任务配置', hash: '#tasks'},

View File

@@ -0,0 +1,407 @@
import {Download, Eye, RefreshCcw, Search, X} from 'lucide-react';
import {FormEvent, useEffect, useMemo, useState} from 'react';
import {listAdminTrackingEvents} from '../api/adminApiClient';
import type {
AdminTrackingEventEntryPayload,
TrackingScopeKind,
} from '../api/adminApiTypes';
import {
filterAdminTrackingEventDefinitions,
findAdminTrackingEventDefinition,
} from '../config/trackingEventDefinitions';
import {handlePageError} from './pageUtils';
interface AdminTrackingEventsPageProps {
token: string;
onUnauthorized: (message?: string) => void;
}
const scopeKindOptions: Array<{value: TrackingScopeKind | ''; label: string}> = [
{value: '', label: '全部'},
{value: 'site', label: 'site'},
{value: 'work', label: 'work'},
{value: 'module', label: 'module'},
{value: 'user', label: 'user'},
];
const exportColumns: Array<{
key: keyof AdminTrackingEventEntryPayload;
label: string;
}> = [
{key: 'eventId', label: '事件 ID'},
{key: 'eventKey', label: 'Event Key'},
{key: 'eventTitle', label: '事件名称'},
{key: 'scopeKind', label: 'Scope Kind'},
{key: 'scopeId', label: 'Scope ID'},
{key: 'dayKey', label: 'Day Key'},
{key: 'userId', label: 'User ID'},
{key: 'ownerUserId', label: 'Owner User ID'},
{key: 'profileId', label: 'Profile ID'},
{key: 'moduleKey', label: 'Module Key'},
{key: 'metadataJson', label: 'Metadata JSON'},
{key: 'occurredAt', label: '发生时间'},
];
export function AdminTrackingEventsPage({
token,
onUnauthorized,
}: AdminTrackingEventsPageProps) {
const [entries, setEntries] = useState<AdminTrackingEventEntryPayload[]>([]);
const [eventKey, setEventKey] = useState('');
const [userId, setUserId] = useState('');
const [scopeKind, setScopeKind] = useState<TrackingScopeKind | ''>('');
const [scopeId, setScopeId] = useState('');
const [limit, setLimit] = useState('200');
const [errorMessage, setErrorMessage] = useState('');
const [isLoading, setIsLoading] = useState(false);
const [detailEntry, setDetailEntry] =
useState<AdminTrackingEventEntryPayload | null>(null);
useEffect(() => {
void refreshTrackingEvents();
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [token]);
const filteredEventDefinitions = useMemo(
() => filterAdminTrackingEventDefinitions(eventKey),
[eventKey],
);
async function refreshTrackingEvents() {
setIsLoading(true);
setErrorMessage('');
try {
const response = await listAdminTrackingEvents(token, {
eventKey,
userId,
scopeKind,
scopeId,
limit: parseLimit(limit),
});
setEntries(response.entries);
} catch (error: unknown) {
handlePageError(error, onUnauthorized, setErrorMessage);
} finally {
setIsLoading(false);
}
}
function handleSearch(event: FormEvent<HTMLFormElement>) {
event.preventDefault();
void refreshTrackingEvents();
}
function handleExport() {
if (!entries.length) {
setErrorMessage('当前没有可导出的埋点数据');
return;
}
exportTrackingEventsAsExcel(entries);
}
return (
<section className="admin-page admin-page-wide">
<div className="admin-page-heading">
<div>
<h2></h2>
<p></p>
</div>
<div className="admin-action-row">
<button
className="admin-secondary-button"
disabled={isLoading}
type="button"
onClick={refreshTrackingEvents}
>
<RefreshCcw size={17} aria-hidden="true" />
<span>{isLoading ? '刷新中' : '刷新'}</span>
</button>
<button
className="admin-primary-button"
disabled={!entries.length}
type="button"
onClick={handleExport}
>
<Download size={17} aria-hidden="true" />
<span> Excel</span>
</button>
</div>
</div>
<form className="admin-panel admin-form" onSubmit={handleSearch}>
<div className="admin-filter-grid">
<label className="admin-field">
<span>Event Key</span>
<input
list="admin-tracking-event-keys"
placeholder="全部"
value={eventKey}
onChange={(event) => setEventKey(event.target.value)}
/>
<datalist id="admin-tracking-event-keys">
{filteredEventDefinitions.map((definition) => (
<option key={definition.key} value={definition.key}>
{definition.title}
</option>
))}
</datalist>
</label>
<label className="admin-field">
<span>User ID</span>
<input
placeholder="全部"
value={userId}
onChange={(event) => setUserId(event.target.value)}
/>
</label>
<label className="admin-field">
<span>Scope Kind</span>
<select
value={scopeKind}
onChange={(event) =>
setScopeKind(event.target.value as TrackingScopeKind | '')
}
>
{scopeKindOptions.map((option) => (
<option key={option.value || 'all'} value={option.value}>
{option.label}
</option>
))}
</select>
</label>
<label className="admin-field">
<span>Scope ID</span>
<input
placeholder="全部"
value={scopeId}
onChange={(event) => setScopeId(event.target.value)}
/>
</label>
<label className="admin-field">
<span></span>
<input
inputMode="numeric"
value={limit}
onChange={(event) => setLimit(event.target.value)}
/>
</label>
<button className="admin-secondary-button" disabled={isLoading} type="submit">
<Search size={17} aria-hidden="true" />
<span>{isLoading ? '查询中' : '查询'}</span>
</button>
</div>
</form>
{errorMessage ? (
<div className="admin-alert" role="status">
{errorMessage}
</div>
) : null}
<div className="admin-panel">
<div className="admin-panel-heading">
<h3></h3>
<span>{entries.length} </span>
</div>
<div className="admin-table-wrap">
<table className="admin-table admin-table-wide">
<thead>
<tr>
<th></th>
<th>Scope</th>
<th></th>
<th></th>
<th>Metadata</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
{entries.length ? (
entries.map((entry) => (
<tr key={entry.eventId}>
<td>
<strong>{resolveEventTitle(entry)}</strong>
<small>{entry.eventKey}</small>
<small>{entry.eventId}</small>
</td>
<td>
<span className="admin-status admin-status-pending">
{entry.scopeKind}
</span>
<small>{entry.scopeId || '-'}</small>
<small>dayKey: {entry.dayKey}</small>
</td>
<td>
{entry.userId || '-'}
<small>owner: {entry.ownerUserId || '-'}</small>
</td>
<td>
{entry.profileId || '-'}
<small>module: {entry.moduleKey || '-'}</small>
</td>
<td>
<pre className="admin-json-preview">
{formatMetadataJson(entry.metadataJson)}
</pre>
</td>
<td>{entry.occurredAt || '-'}</td>
<td>
<button
className="admin-secondary-button"
type="button"
onClick={() => setDetailEntry(entry)}
>
<Eye size={16} aria-hidden="true" />
<span></span>
</button>
</td>
</tr>
))
) : (
<tr>
<td colSpan={7}>{isLoading ? '正在加载' : '暂无数据'}</td>
</tr>
)}
</tbody>
</table>
</div>
</div>
{detailEntry ? (
<TrackingEventDetailPanel
entry={detailEntry}
onClose={() => setDetailEntry(null)}
/>
) : null}
</section>
);
}
function TrackingEventDetailPanel({
entry,
onClose,
}: {
entry: AdminTrackingEventEntryPayload;
onClose: () => void;
}) {
return (
<div className="admin-confirm-backdrop" role="presentation">
<section
aria-label="埋点详情"
className="admin-detail-panel"
role="dialog"
>
<div className="admin-panel-heading">
<h3>{resolveEventTitle(entry)}</h3>
<button
aria-label="关闭详情"
className="admin-ghost-button"
type="button"
onClick={onClose}
>
<X size={17} aria-hidden="true" />
</button>
</div>
<dl className="admin-info-list admin-detail-list">
{exportColumns.map((column) => (
<div key={column.key}>
<dt>{column.label}</dt>
<dd>
{column.key === 'metadataJson' ? (
<pre className="admin-code-block">
{formatMetadataJson(entry.metadataJson)}
</pre>
) : (
formatExportCell(entry[column.key]) || '-'
)}
</dd>
</div>
))}
</dl>
</section>
</div>
);
}
function parseLimit(value: string) {
const parsed = Number.parseInt(value.trim(), 10);
if (!Number.isFinite(parsed)) {
return 200;
}
return Math.min(Math.max(parsed, 1), 1000);
}
function resolveEventTitle(entry: AdminTrackingEventEntryPayload) {
return (
findAdminTrackingEventDefinition(entry.eventKey)?.title ||
entry.eventTitle ||
entry.eventKey
);
}
function formatMetadataJson(value: string) {
const trimmed = value.trim();
if (!trimmed) {
return '-';
}
try {
return JSON.stringify(JSON.parse(trimmed), null, 2);
} catch {
return trimmed;
}
}
function exportTrackingEventsAsExcel(entries: AdminTrackingEventEntryPayload[]) {
const tableRows = [
exportColumns.map((column) => `<th>${escapeHtml(column.label)}</th>`).join(''),
...entries.map((entry) =>
exportColumns
.map((column) => `<td style="mso-number-format:'\\@';">${escapeHtml(formatExportCell(entry[column.key]))}</td>`)
.join(''),
),
];
const html = `\uFEFF<html><head><meta charset="UTF-8" /></head><body><table>${tableRows
.map((row) => `<tr>${row}</tr>`)
.join('')}</table></body></html>`;
const blob = new Blob([html], {type: 'application/vnd.ms-excel;charset=utf-8'});
const url = URL.createObjectURL(blob);
const link = document.createElement('a');
link.href = url;
link.download = `tracking-events-${buildTimestamp()}.xls`;
document.body.appendChild(link);
link.click();
link.remove();
URL.revokeObjectURL(url);
}
function formatExportCell(value: unknown) {
if (value === null || typeof value === 'undefined') {
return '';
}
return String(value);
}
function escapeHtml(value: string) {
return value
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/"/g, '&quot;')
.replace(/'/g, '&#39;');
}
function buildTimestamp() {
const now = new Date();
const pad = (value: number) => String(value).padStart(2, '0');
return [
now.getFullYear(),
pad(now.getMonth() + 1),
pad(now.getDate()),
'-',
pad(now.getHours()),
pad(now.getMinutes()),
pad(now.getSeconds()),
].join('');
}

View File

@@ -216,6 +216,10 @@ button:disabled {
margin: 0 auto;
}
.admin-page-wide {
max-width: 1480px;
}
.admin-page-heading,
.admin-panel-heading,
.admin-subsection-heading {
@@ -291,6 +295,20 @@ button:disabled {
align-items: end;
}
.admin-filter-grid {
display: grid;
grid-template-columns: repeat(5, minmax(120px, 1fr)) auto;
gap: 12px;
align-items: end;
}
.admin-action-row {
display: flex;
flex-wrap: wrap;
justify-content: flex-end;
gap: 10px;
}
.admin-field {
display: grid;
min-width: 0;
@@ -478,6 +496,23 @@ button:disabled {
padding: 18px;
}
.admin-detail-panel {
display: grid;
width: min(100%, 760px);
max-height: min(90dvh, 760px);
gap: 16px;
overflow: auto;
border: 1px solid #d8e2e8;
border-radius: 10px;
background: #ffffff;
box-shadow: 0 22px 60px rgba(23, 33, 43, 0.24);
padding: 18px;
}
.admin-detail-list .admin-code-block {
max-height: 280px;
}
.admin-confirm-warning {
border: 1px solid #efc894;
border-radius: 8px;
@@ -602,6 +637,24 @@ button:disabled {
min-width: 360px;
}
.admin-table-wide {
min-width: 1180px;
}
.admin-json-preview {
max-width: 360px;
max-height: 160px;
margin: 0;
overflow: auto;
color: #2f4550;
font-family:
"SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace;
font-size: 12px;
line-height: 1.45;
white-space: pre-wrap;
overflow-wrap: anywhere;
}
.admin-status {
display: inline-flex;
max-width: 460px;
@@ -757,7 +810,8 @@ button:disabled {
.admin-overview-grid,
.admin-two-column,
.admin-two-column-wide,
.admin-form-row {
.admin-form-row,
.admin-filter-grid {
grid-template-columns: 1fr;
}