feat(platform): add online vehicle statistics detail

vehicle-data-platform/apps/web/src/api/client.test.ts

@@ -198,6 +198,39 @@ test('qualityNotificationPlan reads alert rules and priority issues from backend
   expect(result.priorityIssues[0].notificationText).toContain('告警通知');
 });
 
+test('onlineVehicleStatuses reads paged online vehicle status rows', async () => {
+  const fetchMock = vi.spyOn(globalThis, 'fetch').mockResolvedValue({
+    ok: true,
+    json: async () => ({
+      data: {
+        items: [{
+          vin: 'LB9A32A24R0LS1426',
+          plate: '粤AG18312',
+          phone: '13307795425',
+          oem: 'G7s',
+          protocols: ['JT808', 'GB32960'],
+          online: false,
+          lastSeen: '2026-07-03 20:12:10',
+          offlineDurationMinutes: 18,
+          sourceCount: 2,
+          onlineSourceCount: 0,
+          bindingStatus: 'bound'
+        }],
+        total: 1,
+        limit: 10,
+        offset: 0
+      },
+      traceId: 'trace-test',
+      timestamp: 1783094400000
+    })
+  } as Response);
+
+  const result = await api.onlineVehicleStatuses(new URLSearchParams({ keyword: '粤AG18312', limit: '10' }));
+
+  expect(fetchMock).toHaveBeenCalledWith('/api/statistics/online-vehicles?keyword=%E7%B2%A4AG18312&limit=10', undefined);
+  expect(result.items[0].offlineDurationMinutes).toBe(18);
+});
+
 test('api errors include backend message, detail, and trace id', async () => {
   vi.spyOn(globalThis, 'fetch').mockResolvedValue({
     ok: false,

vehicle-data-platform/apps/web/src/api/client.ts

@@ -5,6 +5,7 @@ import type {
   HistoryLocationRow,
   MileageSummary,
   OnlineStatisticsSummary,
+  OnlineVehicleStatusRow,
   OpsHealth,
   QualityNotificationPlan,
   Page,
@@ -107,6 +108,7 @@ export const api = {
   mileageSummary: (params = new URLSearchParams()) => request<MileageSummary>(`/api/mileage/summary?${params.toString()}`),
   dailyMileage: (params = new URLSearchParams()) => request<Page<DailyMileageRow>>(`/api/mileage/daily?${params.toString()}`),
   onlineStatisticsSummary: (params = new URLSearchParams()) => request<OnlineStatisticsSummary>(`/api/statistics/online-summary?${params.toString()}`),
+  onlineVehicleStatuses: (params = new URLSearchParams()) => request<Page<OnlineVehicleStatusRow>>(`/api/statistics/online-vehicles?${params.toString()}`),
   qualitySummary: (params = new URLSearchParams()) => request<QualitySummary>(`/api/quality/summary?${params.toString()}`),
   qualityIssues: (params = new URLSearchParams()) => request<Page<QualityIssueRow>>(`/api/quality/issues?${params.toString()}`),
   qualityNotificationPlan: (params = new URLSearchParams()) => request<QualityNotificationPlan>(`/api/quality/notification-plan?${params.toString()}`),

vehicle-data-platform/apps/web/src/api/types.ts

@@ -265,6 +265,20 @@ export interface OnlineStatisticsSummary {
   evidence: string;
 }
 
+export interface OnlineVehicleStatusRow {
+  vin: string;
+  plate: string;
+  phone: string;
+  oem: string;
+  protocols: string[];
+  online: boolean;
+  lastSeen: string;
+  offlineDurationMinutes?: number | null;
+  sourceCount: number;
+  onlineSourceCount: number;
+  bindingStatus: string;
+}
+
 export interface QualityIssueRow {
   vin: string;
   plate: string;