feat(platform): add lightweight vehicle overview api

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

@@ -64,6 +64,38 @@ test('vehicleResolve sends keyword to the identity resolution endpoint', async (
   expect(result.vin).toBe('LB9A32A24R0LS1426');
 });
 
+test('vehicleServiceOverview sends keyword to the lightweight overview endpoint', async () => {
+  const fetchMock = vi.spyOn(globalThis, 'fetch').mockResolvedValue({
+    ok: true,
+    json: async () => ({
+      data: {
+        vin: 'LB9A32A24R0LS1426',
+        plate: '粤AG18312',
+        phone: '13307795425',
+        oem: 'G7s',
+        protocols: ['GB32960', 'JT808'],
+        primaryProtocol: 'JT808',
+        coverageStatus: 'partial',
+        sourceCount: 2,
+        onlineSourceCount: 1,
+        lastSeen: '2026-07-03 20:12:10',
+        realtimeCount: 2,
+        historyCount: 0,
+        rawCount: 0,
+        mileageCount: 0,
+        qualityIssueCount: 0
+      },
+      traceId: 'trace-test',
+      timestamp: 1783094400000
+    })
+  } as Response);
+
+  const result = await api.vehicleServiceOverview(new URLSearchParams({ keyword: '粤AG18312' }));
+
+  expect(fetchMock).toHaveBeenCalledWith('/api/vehicle-service/overview?keyword=%E7%B2%A4AG18312', undefined);
+  expect(result.coverageStatus).toBe('partial');
+});
+
 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

@@ -14,6 +14,7 @@ import type {
   VehicleCoverageRow,
   VehicleDetail,
   VehicleIdentityResolution,
+  VehicleServiceOverview,
   VehicleRow
 } from './types';
 
@@ -75,6 +76,7 @@ export const api = {
   vehicleResolve: (params = new URLSearchParams()) => request<VehicleIdentityResolution>(`/api/vehicles/resolve?${params.toString()}`),
   vehicleCoverage: (params = new URLSearchParams()) => request<Page<VehicleCoverageRow>>(`/api/vehicles/coverage?${params.toString()}`),
   vehicleDetail: (params = new URLSearchParams()) => request<VehicleDetail>(`/api/vehicle-service?${params.toString()}`),
+  vehicleServiceOverview: (params = new URLSearchParams()) => request<VehicleServiceOverview>(`/api/vehicle-service/overview?${params.toString()}`),
   vehicleRealtime: (params = new URLSearchParams()) => request<Page<VehicleRealtimeRow>>(`/api/realtime/vehicles?${params.toString()}`),
   realtimeLocations: (params = new URLSearchParams()) => request<Page<RealtimeLocationRow>>(`/api/realtime/locations?${params.toString()}`),
   historyLocations: (params = new URLSearchParams()) => request<Page<HistoryLocationRow>>(`/api/history/locations?${params.toString()}`),