From b1c1bfcb0395c6b3b6b0ac1fca8f53e116ea3ce7 Mon Sep 17 00:00:00 2001
From: nick <coachward0742@gmail.com>
Date: Wed, 10 Jun 2026 03:00:50 -0600
Subject: [PATCH] docs: update dashboard MVP status and roadmap

---
 docs/dashboard-esp32s3.md | 31 +++++++++++++++++++++++++++++++
 docs/project-state.md     | 32 ++++++++++++++++++++++++++++++++
 docs/roadmap.md           | 29 +++++++++++++++++++++++++++++
 3 files changed, 92 insertions(+)

diff --git a/docs/dashboard-esp32s3.md b/docs/dashboard-esp32s3.md
index 5a13c83..480624d 100644
--- a/docs/dashboard-esp32s3.md
+++ b/docs/dashboard-esp32s3.md
@@ -217,3 +217,34 @@ First priority is standalone validation:
 - Basic LVGL/demo functionality
 
 Second priority is Cargo ESP API integration over WiFi using `/api/v1`.
+
+## Current Dashboard Status
+
+Status: Functional MVP
+
+Implemented:
+
+- Boot screen while connecting to Cargo ESP AP
+- Dashboard version display on boot screen
+- WiFi client connection to Cargo ESP
+- HTTP API polling via `/api/v1`
+- Field-filtered status polling with `/api/v1/status?fields=battery,temps,relays`
+- Relay control via HTTP POST
+- Dynamic relay button layout designed to scale up to 6 outputs
+- State-colored relay buttons with dimensional styling
+- Battery SOC gauge
+- Charge/discharge current display
+- Runtime estimate while discharging
+- Time-to-full estimate while charging
+- Idle state when current is near zero
+- WiFi signal strength display
+- Cargo ESP connectivity indicator
+
+Planned next work:
+
+- Temperature card redesign
+- Swipe/page navigation
+- Battery detail page
+- Vehicle data page
+- CAN/OBD-II integration
+- BNO085/BNO086 tilt visualization
diff --git a/docs/project-state.md b/docs/project-state.md
index 7da324e..747e0e8 100644
--- a/docs/project-state.md
+++ b/docs/project-state.md
@@ -283,3 +283,35 @@ Current 2-channel testing should continue until the LilyGO board arrives and is
 The Waveshare ESP32-S3 Touch LCD 5B is expected next.
 
 Next dashboard work should follow `docs/waveshare-5b-bringup-checklist.md` and start with standalone display/touch validation before any Cargo ESP or vehicle integration.
+
+## Dashboard MVP Status
+
+Current dashboard hardware:
+
+- Waveshare ESP32-S3 Touch LCD 5B
+- WiFi client to Cargo ESP32 AP
+- HTTP API consumer
+
+Current dashboard communication path:
+
+    Dashboard ESP32-S3
+        -> WiFi
+        -> HTTP
+        -> Cargo ESP32
+        -> /api/v1
+
+Current dashboard features:
+
+- Boot screen
+- Dashboard version display
+- Battery SOC gauge
+- Charge/discharge current display
+- Runtime estimation
+- Time-to-full estimation
+- Idle battery state
+- Relay controls
+- Dynamic relay button sizing
+- State-colored relay buttons
+- WiFi signal indicator
+- Cargo ESP connectivity indicator
+- Fast status polling using field-filtered API requests
diff --git a/docs/roadmap.md b/docs/roadmap.md
index 0203005..4589c0f 100644
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@@ -159,3 +159,32 @@ These are intentionally not committed v1 architecture until explicitly promoted:
 - Smart high-side switching
 - WUPP-style fused distribution module
 - MQTT/Home Assistant/Grafana/InfluxDB integrations
+
+## Dashboard Overview MVP
+
+Status: Complete
+
+Completed:
+
+- Boot screen
+- Dashboard version display
+- Cargo AP connectivity
+- HTTP API polling
+- Field-filtered `/api/v1/status` polling
+- Battery SOC gauge
+- Runtime / time-to-full calculations
+- Idle battery state
+- Relay controls
+- Dynamic relay layout
+- WiFi signal indicator
+- Cargo ESP connectivity indicator
+
+Next Dashboard Milestones:
+
+- Temperature card redesign
+- Swipe navigation
+- Battery detail page
+- Vehicle page
+- OBD-II integration
+- CAN integration
+- BNO085/BNO086 off-road attitude display