feat(monitor): preserve investigation context

vehicle-data-platform/apps/web/src/v2/pages/VehiclePage.test.tsx

@@ -4,6 +4,7 @@ import { afterEach, expect, test, vi } from 'vitest';
 import { MemoryRouter, Route, Routes } from 'react-router-dom';
 import { api } from '../../api/client';
 import type { VehicleDetail, VehicleRealtimeRow } from '../../api/types';
+import { buildMonitorPath, withMonitorReturn } from '../routing/monitorContext';
 import { ROUTER_FUTURE } from '../routing/routerConfig';
 import VehiclePage from './VehiclePage';
 
@@ -77,3 +78,23 @@ test('polls lightweight single-vehicle realtime data and passes its report inter
   fireEvent.click(screen.getByTitle('展开全部位置来源'));
   await waitFor(() => expect(sourceEvidence).toHaveBeenCalledTimes(1));
 });
+
+test('keeps the monitor return on the vehicle page and its nested investigation links', async () => {
+  vi.spyOn(api, 'vehicleDetail').mockResolvedValue(detail);
+  vi.spyOn(api, 'vehicleRealtime').mockResolvedValue({ items: [initialRealtime], total: 1, limit: 1, offset: 0 });
+  vi.spyOn(api, 'latestTelemetry').mockResolvedValue({ values: [], categories: [], scannedFrames: 0 } as never);
+  const client = new QueryClient({ defaultOptions: { queries: { retry: false } } });
+  const monitorPath = buildMonitorPath({
+    mode: 'map', keyword: '', protocol: '', status: '', selectedVin: 'LTEST000000000001', detailOpen: true,
+    viewport: { zoom: 13, bounds: '113.1,23.0,113.4,23.3' }, listOffset: 0, listLimit: 50, hasViewport: true
+  });
+  const initialEntry = withMonitorReturn(`/vehicles/${initialRealtime.vin}`, monitorPath);
+
+  render(<QueryClientProvider client={client}><MemoryRouter initialEntries={[initialEntry]} future={ROUTER_FUTURE}><Routes><Route path="/vehicles/:vin" element={<VehiclePage />} /></Routes></MemoryRouter></QueryClientProvider>);
+
+  expect(await screen.findByRole('link', { name: /返回全局监控/ })).toHaveAttribute('href', monitorPath);
+  const trackLink = screen.getByRole('link', { name: /轨迹回放/ });
+  const historyLink = screen.getByRole('link', { name: /历史数据/ });
+  expect(new URL(trackLink.getAttribute('href')!, 'http://localhost').searchParams.get('monitorReturn')).toBe(monitorPath);
+  expect(new URL(historyLink.getAttribute('href')!, 'http://localhost').searchParams.get('monitorReturn')).toBe(monitorPath);
+});