feat(platform): add batch vehicle overview api

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

@@ -105,6 +105,42 @@ test('vehicleServiceOverview sends keyword to the lightweight overview endpoint'
   expect(result.serviceStatus?.status).toBe('degraded');
 });
 
+test('vehicleServiceOverviews posts keywords to the batch overview endpoint', async () => {
+  const fetchMock = vi.spyOn(globalThis, 'fetch').mockResolvedValue({
+    ok: true,
+    json: async () => ({
+      data: {
+        items: [
+          { vin: 'VIN001', plate: '粤AG18312', protocols: ['JT808'], coverageStatus: 'online', sourceCount: 1, onlineSourceCount: 1 },
+          { vin: 'VIN002', plate: '豫A88888', protocols: ['YUTONG_MQTT'], coverageStatus: 'online', sourceCount: 1, onlineSourceCount: 1 }
+        ],
+        total: 2,
+        limit: 200,
+        offset: 0
+      },
+      traceId: 'trace-test',
+      timestamp: 1783094400000
+    })
+  } as Response);
+
+  const result = await api.vehicleServiceOverviews({
+    keywords: ['粤AG18312', 'LMRKH9AC2R1004087'],
+    limit: 200,
+    offset: 0
+  });
+
+  expect(fetchMock).toHaveBeenCalledWith('/api/vehicle-service/overviews', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      keywords: ['粤AG18312', 'LMRKH9AC2R1004087'],
+      limit: 200,
+      offset: 0
+    })
+  });
+  expect(result.total).toBe(2);
+});
+
 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

@@ -30,6 +30,13 @@ export type RawFrameQuery = {
   offset?: number;
 };
 
+export type VehicleOverviewBatchQuery = {
+  keywords: string[];
+  protocol?: string;
+  limit?: number;
+  offset?: number;
+};
+
 type ApiErrorEnvelope = {
   error?: {
     code?: string;
@@ -77,6 +84,11 @@ export const api = {
   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()}`),
+  vehicleServiceOverviews: (query: VehicleOverviewBatchQuery) => request<Page<VehicleServiceOverview>>('/api/vehicle-service/overviews', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(query)
+  }),
   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()}`),