fix(web): preserve route state and cancel stale reads

vehicle-data-platform/docs/deployment.md

@@ -34,6 +34,11 @@ The web application splits every major route into a hashed lazy-loaded asset. An
 CURRENT_WEB=/opt/lingniu-vehicle-platform/current/web
 NEW_WEB=/opt/lingniu-vehicle-platform/releases/$PLATFORM_RELEASE/web
 
+# Archives created on macOS must disable AppleDouble metadata. As a server-side
+# guard, remove any metadata files before recording the release manifest.
+COPYFILE_DISABLE=1 tar -C apps/web/dist -czf "/tmp/$PLATFORM_RELEASE-web.tar.gz" .
+find "$NEW_WEB" -type f -name '._*' -delete
+
 # Record only this release's own build assets before adding compatibility files.
 find "$NEW_WEB/assets" -type f -printf '%P\n' | sort > "$NEW_WEB/.release-assets"
 

vehicle-data-platform/docs/frontend-production-readiness.md

@@ -10,6 +10,8 @@ This document records verified risks, the production controls that address them,
 | --- | --- | --- | --- |
 | A stale lazy route asset disappears during release | Navigation leaves the content area blank | Preserve the previous build's original hashed assets for one generation; isolate every route with a recoverable error boundary and one-shot reload | Request an old route asset after the symlink switch; navigate through every primary route without a blank shell |
 | A pasted batch search temporarily shows the previous fleet | Operators may mistake stale vehicles for batch matches | Hide placeholder rows while `keywords` is changing; report matched and missing plates after the request resolves | Paste newline/comma-separated plates with a duplicate and an unknown plate; verify exact results and missing-count feedback |
+| URL filters remount the whole route | Pagination or tab changes lose local state and may flash a loading screen | Key the route recovery boundary by pathname only; keep the full URL only for chunk-reload diagnostics | Change search parameters inside a stateful route and assert one mount with preserved local state |
+| Route-scoped reads continue after navigation | Obsolete responses consume bandwidth and remain in memory | Consume TanStack Query's `AbortSignal` in every V2 read path; immediately collect high-volume access and alert pages after they become inactive | Start a read, navigate away or change its query key, and assert the fetch receives the query signal |
 | A route is first fetched only after click | Slow transitions and a longer loading flash | Deduplicated route import cache plus pointer, focus and pointer-down preload | Route module unit tests and rendered navigation loop |
 | Rapid map pans retain large query payloads | Heap growth and eventual interaction jank | Consume React Query `AbortSignal` and immediately garbage-collect inactive map viewport queries | Query-cache churn test keeps exactly one map payload after repeated viewport changes |
 | Superseded monitor requests continue in the background | Wasted server traffic and stale responses | Pass request cancellation signals through the API client | API client signal test and browser network/console smoke |