Files
NODEDC_MISSION_CORE/docs/audits/2026-09-11-session-overview.md
T
DCCONSTRUCTIONS e515ab1b8c feat(planning): consolidate recorded-route localization and spatial scene
Preserve the completed teach-and-repeat laboratory stage: reference preparation, cascaded acquisition, local tracking and recovery, recording lifecycle, replay qualification, and persistent Rerun scene controls. Document the open grid-picking regression and Rerun upgrade contract. No autonomous driving or loop-closure optimization is claimed.
2026-09-21 08:47:19 +03:00

4.9 KiB

Saved-session overview

Owner request: 2026-09-11. The Info utility action opens an overview of the selected saved session. This is a view mode in Data → Sessions, not a new navigation root. The owner specified the composition: orbital point cloud and trajectory upper left, facts upper right, receive-interval chart below; both dividers resize.

The operator checks capture size, route, modalities and delivery continuity. The selected catalog identity owns the result. Opening is observation-only and never starts acquisition. Known, missing, preparing and failed data are separate states; missing metrics remain unavailable rather than zero. Return via Info or Escape retains the selected session.

An overview mode was selected over a modal: it provides room for spatial inspection and keeps the saved-session selector available. A narrow side inspector was rejected because it cannot accommodate the requested three resizable views. Composition uses existing ApplicationPanel.utilityActions, IconButton, GlassSurface, SplitPane and LoadingRegion. The owner-requested info icon is admitted in the Design Guideline first.

The service prepares only the requested session, serially and off the HTTP request, retaining a generation-bound result. Catalog listing never decodes all sessions. The native source remains immutable; limited spatial samples are display derivatives. Vendor decoding belongs to the observation plugin; the host owns identity, confinement, queueing and delivery. Unsupported source representations show catalog facts without fabricated geometry. Derived LAB sessions do not silently inherit their parent's unbounded capture.

The owner additionally requested top/3D presets and a vertical upper-height cutoff. The Design Guideline RangeControl gained the explicitly requested vertical orientation before consumption. Camera presets use Rerun EyeControls3D; clipping replaces only the sampled Points3D in the same recording identity. The pinned Rerun 0.36.3 RrdReader reads only our bounded generated RRD, never arbitrary user RRDs or the source archive. One geometry entry is retained in memory; slider requests are debounced and stale responses aborted. A cutoff update does not replace the blueprint, preserving the current orbit. Top view is a downward-looking 3D camera preset, not an orthographic export. Z is the local recording height. Trajectory and recorded metrics remain intact.

References: Rerun Spatial3DView / EyeControls3D, Rerun blueprint/data separation. This is a visual overview and height filter, not a localization accuracy measurement or semantic tree segmentation.

Validation completed: 842 frontend tests, full typecheck and production build; backend source/cache/plugin tests; Design Guideline registry, icon, range and split-pane contracts, package/catalog typecheck/build. Real JA-SADOVAYA-001 matches the separate audit (4,951 cloud frames; 16,475,293 point observations; 487.610554 m trajectory). Second session 35 independently yields 268 cloud frames and 697,917 observations. Original native data hashes remain unchanged. Both dividers worked by pointer and keyboard; normal and expanded sizes were inspected; Escape returned to the same selected session. Browser QA exposed and fixed Rerun relative-URL interpretation and narrow-header overflow. First preparation is proportional to archive size and can take minutes; subsequent opens use the generation-bound cache.

Preset fitting uses the survey's dominant horizontal direction and current viewport aspect ratio. A conservative perspective fit retains a margin around the full overview bounds. Height-only updates retain the operator's orbit. Returning the slider to its upper limit clears the cutoff despite native input floating-point rounding. Compact interval charts reduce tick density to avoid label overlap.

Final spatial acceptance passed in the canonical browser: top/3D switching; pointer and keyboard cutoff; restoration of all 128,732 JA overview points; 58,350 visible points at Z ≤ 2 m; 23,515 near Z ≤ 0.707 m; manual orbit retained on a subsequent cutoff update. Normal and expanded panel layouts remain usable. Six focused backend overview tests passed, including immutable/reversible clipping and projected preset containment for elongated surveys. The final frontend typecheck and production build passed. Service remains available on 127.0.0.1:8000 with no backend on 8765. These counts describe the display sample, not unique survey points or the complete source.

Owner refinement, 2026-09-11: the canonical vertical RangeControl width is halved from 46 px to 23 px (measured in browser DOM). Height and range behavior remain intact. Registry/range contracts, 842 frontend tests, typecheck and production build passed. Short report accepted in MISSIONCOR-80 after explicit owner permission; next planner prototype is scoped in MISSIONCOR-81 and docs/25_MISSION_PLANNER_RECORDED_ZONE_PLAN.md.