feat(platform): add history evidence package

vehicle-data-platform/apps/web/src/pages/History.tsx

@@ -6,6 +6,7 @@ import type { HistoryLocationRow, Page, RawFrameRow } from '../api/types';
 import { VehicleMap, type VehicleMapPoint } from '../components/VehicleMap';
 import { PageHeader } from '../components/PageHeader';
 import { isAMapConfigured } from '../config/appConfig';
+import { buildAppHash } from '../domain/appRoute';
 import { buildCsv, downloadCsv, type CsvColumn } from '../domain/csvExport';
 
 type HistoryFilters = {
@@ -281,6 +282,59 @@ function trajectorySummaryText({
   ].join('\n');
 }
 
+function appURL(hash: string) {
+  return `${window.location.origin}${window.location.pathname}${hash}`;
+}
+
+function historyEvidencePackageText({
+  filters,
+  locationCount,
+  rawCount,
+  fieldCount,
+  validPointCount,
+  mileageDelta,
+  maxSpeed,
+  firstLocation,
+  lastLocation,
+  anomalySummary
+}: {
+  filters: HistoryFilters;
+  locationCount: number;
+  rawCount: number;
+  fieldCount: number;
+  validPointCount: number;
+  mileageDelta?: number;
+  maxSpeed?: number;
+  firstLocation?: HistoryLocationRow;
+  lastLocation?: HistoryLocationRow;
+  anomalySummary: TrajectoryAnomalySummary;
+}) {
+  const vehicle = filters.keyword?.trim() || '';
+  const protocol = filters.protocol?.trim() || '';
+  const evidenceFilters = {
+    ...(filters.dateFrom?.trim() ? { dateFrom: filters.dateFrom.trim() } : {}),
+    ...(filters.dateTo?.trim() ? { dateTo: filters.dateTo.trim() } : {})
+  };
+  return [
+    '【历史证据包】',
+    `车辆：${vehicle || '全部车辆'}`,
+    `数据来源：${protocol || '全部来源'}`,
+    `查询范围：${filters.dateFrom?.trim() || '-'} 至 ${filters.dateTo?.trim() || '-'}`,
+    `位置记录：${locationCount.toLocaleString()}，有效定位：${validPointCount.toLocaleString()}`,
+    `RAW帧：${rawCount.toLocaleString()}，解析字段：${fieldCount.toLocaleString()}`,
+    `区间里程：${formatNumber(mileageDelta, ' km')}，最高速度：${formatNumber(maxSpeed, ' km/h')}`,
+    `起点：${firstLocation?.deviceTime || firstLocation?.serverTime || '-'}`,
+    `终点：${lastLocation?.deviceTime || lastLocation?.serverTime || '-'}`,
+    `异常：断点 ${anomalySummary.gapCount.toLocaleString()} / 里程回退 ${anomalySummary.mileageRollbackCount.toLocaleString()} / 超速 ${anomalySummary.overspeedCount.toLocaleString()}`,
+    `轨迹回放：${appURL(buildAppHash({ page: 'history', keyword: vehicle, protocol, filters: evidenceFilters }))}`,
+    `历史位置：${appURL(buildAppHash({ page: 'history-query', keyword: vehicle, protocol, filters: { ...evidenceFilters, tab: 'location' } }))}`,
+    `RAW证据：${appURL(buildAppHash({ page: 'history-query', keyword: vehicle, protocol, filters: { ...evidenceFilters, tab: 'raw', includeFields: 'true' } }))}`,
+    `解析字段：${appURL(buildAppHash({ page: 'history-query', keyword: vehicle, protocol, filters: { ...evidenceFilters, tab: 'fields', includeFields: 'true', ...(filters.fields?.trim() ? { fields: filters.fields.trim() } : {}) } }))}`,
+    `里程复核：${appURL(buildAppHash({ page: 'mileage', keyword: vehicle, protocol, filters: evidenceFilters }))}`,
+    `车辆服务：${appURL(buildAppHash({ page: 'detail', keyword: vehicle, protocol }))}`
+  ].join('\n');
+}
+
 function amapLocationName(row: HistoryLocationRow, fallback: string) {
   return encodeURIComponent(row.plate || row.vin || fallback);
 }
@@ -454,7 +508,8 @@ export function History({
   };
 
   const rawFieldCount = useMemo(() => Object.keys(selectedRaw?.parsedFields ?? {}).length, [selectedRaw]);
-  const rawFieldRows = useMemo<RawFieldRow[]>(() => rawFrames.items.flatMap((row) => {
+  const rawItems = rawFrames.items ?? [];
+  const rawFieldRows = useMemo<RawFieldRow[]>(() => rawItems.flatMap((row) => {
     const fields = flattenParsedFields(row.parsedFields ?? {});
     return fields.map((field, index) => ({
       id: `${row.id}-${field.path}-${index}`,
@@ -468,8 +523,8 @@ export function History({
       fieldPath: field.path,
       fieldValue: field.value
     }));
-  }), [rawFrames.items]);
+  }), [rawItems]);
-  const locationItems = locations.items;
+  const locationItems = locations.items ?? [];
   const validLocations = locationItems.filter(hasValidCoordinate);
   const mileageValues = locationItems.map((item) => item.totalMileageKm).filter(isFiniteNumber);
   const mileageDelta = mileageValues.length > 1 ? Math.max(...mileageValues) - Math.min(...mileageValues) : undefined;
@@ -556,6 +611,23 @@ export function History({
       '轨迹摘要'
     );
   };
+  const copyHistoryEvidencePackage = () => {
+    copyText(
+      historyEvidencePackageText({
+        filters,
+        locationCount: locations.total ?? 0,
+        rawCount: rawFrames.total ?? 0,
+        fieldCount: rawFieldRows.length,
+        validPointCount: validLocations.length,
+        mileageDelta,
+        maxSpeed,
+        firstLocation,
+        lastLocation,
+        anomalySummary: trajectoryAnomalies
+      }),
+      '历史证据包'
+    );
+  };
   const openAmapTrajectory = () => {
     const url = amapTrajectoryURL(validLocations);
     if (!url) {
@@ -643,9 +715,12 @@ export function History({
         title={pageTitle}
         description={pageDescription}
         actions={(
-          <Button disabled={!currentVehicleKeyword} onClick={() => onOpenVehicle(currentVehicleKeyword, currentProtocol)}>
+          <Space>
-            当前车辆服务
+            <Button icon={<IconCopy />} onClick={copyHistoryEvidencePackage}>复制历史证据包</Button>
-          </Button>
+            <Button disabled={!currentVehicleKeyword} onClick={() => onOpenVehicle(currentVehicleKeyword, currentProtocol)}>
+              当前车辆服务
+            </Button>
+          </Space>
         )}
       />
       <div className="vp-scope-bar">
@@ -695,6 +770,7 @@ export function History({
           <Space>
             <span>轨迹回放作业台</span>
             <Button size="small" theme="light" icon={<IconCopy />} onClick={copyTrajectorySummary}>复制轨迹摘要</Button>
+            <Button size="small" theme="light" icon={<IconCopy />} onClick={copyHistoryEvidencePackage}>复制历史证据包</Button>
             <Button size="small" theme="light" disabled={validLocations.length === 0} onClick={openAmapTrajectory}>高德线路</Button>
           </Space>
         )}

vehicle-data-platform/apps/web/src/test/App.test.tsx

@@ -4651,7 +4651,25 @@ test('copies trajectory playback summary from history page', async () => {
       return {
         ok: true,
         json: async () => ({
-          data: { items: [], total: 0, limit: 10, offset: 0 },
+          data: {
+            items: [{
+              id: 'raw-history-evidence-001',
+              vin: 'VIN-HISTORY-SUMMARY',
+              plate: '粤A轨迹1',
+              protocol: 'JT808',
+              frameType: '0x0200',
+              rawSizeBytes: 96,
+              deviceTime: '2026-07-03 10:00:00',
+              serverTime: '2026-07-03 10:00:02',
+              parsedFields: {
+                'jt808.location.longitude': 113.201,
+                'jt808.location.total_mileage_km': 1000
+              }
+            }],
+            total: 1,
+            limit: 10,
+            offset: 0
+          },
           traceId: 'trace-test',
           timestamp: 1783094400000
         })
@@ -4681,6 +4699,20 @@ test('copies trajectory playback summary from history page', async () => {
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('最高速度：58.8 km/h'));
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('起点：2026-07-03 10:00:00'));
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('终点：2026-07-03 11:00:00'));
+
+  fireEvent.click(screen.getAllByRole('button', { name: /复制历史证据包/ })[0]);
+
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('【历史证据包】'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('车辆：VIN-HISTORY-SUMMARY'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('位置记录：2，有效定位：2'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('RAW帧：1，解析字段：2'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('异常：断点 1 / 里程回退 0 / 超速 0'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('轨迹回放：http://localhost:3000/#/history?keyword=VIN-HISTORY-SUMMARY&protocol=JT808&dateFrom=2026-07-03&dateTo=2026-07-04'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('历史位置：http://localhost:3000/#/history-query?keyword=VIN-HISTORY-SUMMARY&protocol=JT808&tab=location&dateFrom=2026-07-03&dateTo=2026-07-04'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('RAW证据：http://localhost:3000/#/history-query?keyword=VIN-HISTORY-SUMMARY&protocol=JT808&tab=raw&dateFrom=2026-07-03&dateTo=2026-07-04&includeFields=true'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('解析字段：http://localhost:3000/#/history-query?keyword=VIN-HISTORY-SUMMARY&protocol=JT808&tab=fields&dateFrom=2026-07-03&dateTo=2026-07-04&includeFields=true'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('里程复核：http://localhost:3000/#/mileage?keyword=VIN-HISTORY-SUMMARY&protocol=JT808&dateFrom=2026-07-03&dateTo=2026-07-04'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('车辆服务：http://localhost:3000/#/detail?keyword=VIN-HISTORY-SUMMARY&protocol=JT808'));
 });
 
 test('opens same-day mileage statistics from quality issue row', async () => {