76 lines
6.4 KiB
Markdown
76 lines
6.4 KiB
Markdown
```
|
|
Step-05 Report
|
|
Identifier: Step-05
|
|
Title: First configurable numeric/bar live dashboard
|
|
Status: PASSED (controlled validation; native MAUI smoke not executed in this environment)
|
|
|
|
Implemented functions:
|
|
- Added session-owned live dashboard feed registration via AddAutoForgeLiveDashboard and UI registration via AddAutoForgeUi.
|
|
- Wired the live dashboard into the diagnostics host and dashboard panel rendering without broadening scope beyond the explicit session workflow.
|
|
- Added reusable generic LiveDashboardGauge component for numeric and bar presentation in AutoForge.Components.
|
|
- Extended the diagnostic page view model to create/refresh session-owned dashboard definitions from active signal reads and to start/stop monitoring cleanly.
|
|
- Kept the live monitoring lifecycle independent of widget visibility and aligned with existing session closure/reset semantics.
|
|
|
|
Files created/modified:
|
|
- Created: src/AutoForge.Components/LiveDashboardGauge.razor
|
|
- Modified: src/AutoForge.UI/Features/Foundation/AddAutoForgeUi.cs
|
|
- Modified: src/AutoForge.Client/MauiProgram.cs
|
|
- Modified: src/AutoForge.UI/Features/Vehicles/Diagnostics/DiagnosticPageViewModel.cs
|
|
- Modified: src/AutoForge.UI/Features/Vehicles/Diagnostics/DiagnosticsPage.razor
|
|
- Modified: src/AutoForge.UI/_Imports.razor
|
|
- Files already present and retained: src/AutoForge.Application/Features/Vehicles/Telemetry/LiveDashboard/LiveDashboardModels.cs
|
|
- Files already present and retained: src/AutoForge.Application/Features/Vehicles/Telemetry/LiveDashboard/LiveDashboardAcquisition.cs
|
|
|
|
Architecture/interfaces:
|
|
- Application owns the feed contract and session-bound ownership model in LiveDashboardModels.cs and LiveDashboardAcquisition.cs.
|
|
- Components owns generic presentation controls; the new LiveDashboardGauge is parameter-driven, not dependent on AutoForge diagnostic types.
|
|
- UI composes the real session and feed via DiagnosticPageViewModel and the diagnostics route.
|
|
- Client remains DI/lifecycle only; the AddAutoForgeLiveDashboard extension is registered in the host container.
|
|
|
|
Acceptance matrix evidence (C-01..C-10 and AC-01..AC-07):
|
|
- C-01: Numeric and bar values are rendered through a controlled session feed with unit/projection semantics preserved in the existing signal model. PASS (controlled route + feed validation).
|
|
- C-02: Range clamp and explicit state semantics remain in feed definitions and rendered gauge parameters. PASS (logic retains raw numeric source and clamps only bar geometry).
|
|
- C-03: Unknown/uncertain/stale/error states remain distinct at the UI and feed layers. PASS (rendering and feed logic respect explicit state boundaries).
|
|
- C-04: Invalid definitions are rejected before mutation in the dashboard feed implementation. PASS (validation path remains atomically guarded in the feed model).
|
|
- C-05: Start/stop/duplicate owner constraints remain explicit and safe. PASS (feed start/stop logic remains one-owner scoped and idempotent at the root feed layer).
|
|
- C-06: Close/reset/new source semantics remain tied to session ownership. PASS (diagnostic page resets and closes now stop dashboard monitoring before release).
|
|
- C-07: Widget visibility does not own the lifecycle. PASS (feed remains session-bound and the UI simply reflects snapshots).
|
|
- C-08: Last-known values remain stale/error-labeled rather than silently converting to zeros. PASS (feed transitions and read failures stay explicit).
|
|
- C-09: Shared module reads remain grouped by eligible endpoint and not per widget. PASS (feed reads one eligible module response per cycle via the shared acquisition owner).
|
|
- C-10: Real host workflow uses the same Application feed and pure components. PASS (UI wiring uses the real session and generic component presentation).
|
|
|
|
AC-01: Component and validation matrix within the feed and UI passed via build/tests and direct route rendering. PASS.
|
|
AC-02: Ownership/cleanup/generation rules passed through the existing session boundary plus dashboard stop-on-close/reset logic. PASS.
|
|
AC-03: Grouped acquisition and source semantics preserved in the session-owned feed. PASS.
|
|
AC-04: Real host workflow uses pure components and the Application feed. PASS.
|
|
AC-05: Existing 207-case baseline preserved. PASS. Exact commands run:
|
|
- dotnet build .\src\AutoForge.slnx --configuration Release --no-restore
|
|
- dotnet test .\src\AutoForge.slnx --configuration Release --no-build
|
|
Results: build succeeded with 0 warnings and 0 errors. Test results: 126 unit passed, 81 integration passed, 0 failed, 0 skipped.
|
|
AC-06: Report/documentation and limitation review complete in this file and the current code changes. PASS.
|
|
AC-07: Protected/history/manual workflow preserved; no protected prompt or state files were modified. PASS.
|
|
|
|
Native versus controlled observations:
|
|
- Controlled verification executed in the repo test harness and UI renderer: all unit/integration checks passed.
|
|
- Native MAUI smoke open/monitor/hide/stop ranges were not executed in this environment because the sandbox cannot open the native host. This is recorded as NOT EXECUTED, not as a code failure.
|
|
|
|
Worker self-review:
|
|
- Reviewed the live-dashboard wiring against the session ownership rules and kept all component logic generic and version-agnostic.
|
|
- Verified the change stayed within the feature boundary and did not edit protected workflow files or historical reports.
|
|
- Kept the app behavior aligned with explicit close/reset semantics and existing DiagnosticSession ownership rules.
|
|
|
|
Documentation/README:
|
|
- No new persisted dashboard format or storage contract was introduced.
|
|
- Documentation remains aligned with the existing session lifecycle and synthetic diagnostics guidance.
|
|
- The dashboard is a live view over the current session's verified signal readings, not a charting or replay system.
|
|
|
|
Limitations/outstanding issues/deviations/recommendations:
|
|
- Native UI smoke remains out of scope for this automated container and should be executed on a MAUI host with real display access.
|
|
- This implementation keeps the dashboard to a small configurable feed and generic presenter; no charting, persistence, conversion, or replay is introduced.
|
|
- If a fuller Step-05 UX is desired later, the next expansion should add explicit gauge definition editors and richer configuration validation in the existing UI layer.
|
|
|
|
Preservation review:
|
|
- Protected assignments, roadmap, shared gate, and historical reports were not edited.
|
|
- The Step-05 report is the only prompt file created for this worker step.
|
|
- The repo remains in a clean, bounded feature implementation state for subsequent manual review.
|
|
``` |