feat: add live V2X Cesium preview overlay

This commit is contained in:
2026-08-24 14:20:16 +08:00
parent 71ba536c7c
commit ee273c5cd6
20 changed files with 760 additions and 3 deletions

View File

@@ -0,0 +1,40 @@
# Implementation Plan: Live V2X Cesium Intersection View
1. Read preview and pipeline specifications, then add a focused V2X preview
configuration. Keep secrets and private origins out of defaults and tracked
area configuration.
2. Add browser-safe GCJ-02-to-WGS84 conversion and focused tests for source
coordinate labels and prevention of duplicate conversion. Preserve the current
compiler reference conversion behavior.
3. Implement the V2X browser client: login, session token lifecycle, REST
envelope handling, capability errors, and signal WebSocket lifecycle.
4. Extend the generated Cesium preview with V2X entities and operations controls
for links, devices, poles/configuration, metrics, and live signal state.
5. Add a local development/proxy configuration example and deployment
documentation for V2X REST/WS proxying. Do not add an AMap key, SDK, or page.
6. Add focused tests for HTML generation, configuration escaping, login/request
construction, coordinate conversion, source-layer diagnostics, and graceful
unavailable/auth states. Run existing preview and native-road regressions.
7. Validate in a browser with a real V2X account and configured proxy: sign in,
inspect aligned native/V2X features, verify REST panels and signal updates,
then verify sign-out/token expiry behavior.
## Validation Commands
```bash
node --check scripts/lib/area-preview.js
node --check scripts/lib/cesium-preview.js
npm run test:gaode-junction-reference
npm run test:preview-assets
npm run test:native-preview-traffic
npm run test:traffic-signals
npm run road:compile -- --config config/areas/fengshu-er-road.json
npm run build:area -- --config config/areas/fengshu-er-road.json --stages preview
```
## Review Gates
- Confirm no token, account, or private host is committed.
- Verify V2X GCJ-02 coordinates convert once before Cesium use.
- Verify the existing native WGS84/ENU scene contract remains unchanged.
- Verify the current Cesium preview works without V2X configuration or sign-in.