Update README.md

Author: AsieduDevelopmentHub

dashboard/README.md

@@ -1,40 +1,240 @@
-# SentraCore Dashboard (Flutter / Windows)
+# SentraCore Dashboard (Flutter Desktop)
 
-The SentraCore dashboard is a Flutter Windows desktop UI that connects to the local Python engine and renders real-time system intelligence:
+The **SentraCore Dashboard** is the desktop visualization and interaction layer of the SentraCore platform.
 
-- Live system state stream (WebSocket)
-- Status/health/process/event queries (REST)
-- Stability Index, stress, predictions, and root cause panels
+Built with **Flutter for Windows**, the dashboard connects to the local intelligence engine to deliver **real-time telemetry visibility**, **system health analytics**, and **explainable operational insights** through an interactive desktop experience.
+
+The dashboard is designed to provide a low-latency interface for observing system behavior while exposing actionable intelligence generated by the backend engine.
+
+---
+
+## Overview
+
+The dashboard communicates with the local SentraCore engine through a combination of:
+
+- **REST APIs** for state retrieval and command operations
+- **WebSocket streams** for real-time updates and event delivery
+
+This architecture separates intelligence processing from presentation while maintaining responsive desktop performance.
+
+---
+
+## Core Capabilities
+
+### Real-Time Monitoring
+- Live system telemetry streaming
+- Dynamic health and status updates
+- Continuous event visualization
+
+### Intelligence Visualization
+- Stability Index monitoring
+- System stress analysis
+- Predictive risk indicators
+- Root cause investigation panels
+
+### Operational Insight
+- Process and event inspection
+- Historical system context
+- Diagnostic views
+- Explainable intelligence outputs
+
+---
 
 ## Connectivity
 
-By default the engine runs on:
+By default, the dashboard connects to a locally running SentraCore engine.
+
+### REST API
+
+```text
+http://127.0.0.1:8740/api/v1/
+```
+
+Used for:
+
+- System status
+- Health queries
+- Process inspection
+- Historical retrieval
+- Control actions
+
+---
+
+### WebSocket
+
+```text
+ws://127.0.0.1:8740/ws/live
+```
 
-- REST: `http://127.0.0.1:8740/api/v1/`
-- WebSocket: `ws://127.0.0.1:8740/ws/live`
+Used for:
 
-If you change the engine port, update `EngineService` in `lib/services/engine_service.dart` (or make it configurable via settings).
+- Live telemetry streaming
+- Event propagation
+- Dashboard updates
+- Realtime intelligence output
 
-## Running locally
+---
 
-From the repository root, start the engine:
+## Configuration
+
+If the engine host or port changes, update the dashboard connection settings.
+
+Current location:
+
+```text
+dashboard/lib/services/engine_service.dart
+```
+
+Recommended future enhancement:
+
+```text
+Settings → Engine Endpoint Configuration
+```
+
+This would allow runtime endpoint configuration without rebuilding the application.
+
+---
+
+## Local Development
+
+### 1. Start SentraCore Engine
+
+From the repository root:
 
 ```powershell
 .venv\Scripts\python -m engine.main
 ```
 
-Then in a second terminal:
+Expected startup:
+
+```text
+Engine available at:
+http://127.0.0.1:8740
+```
+
+---
+
+### 2. Start Dashboard
+
+Open a second terminal.
 
 ```powershell
 cd dashboard
+
 flutter pub get
+
 flutter run -d windows
 ```
 
-## Quality checks
+The dashboard should automatically connect to the local engine.
+
+---
+
+## Build Desktop Application
+
+Generate a Windows desktop build:
+
+```powershell
+cd dashboard
+
+flutter build windows
+```
+
+Build output:
+
+```text
+dashboard/build/windows/x64/runner/Release/
+```
+
+---
+
+## Quality Validation
+
+Run quality checks before committing changes.
+
+### Static Analysis
 
 ```powershell
 cd dashboard
+
 flutter analyze
+```
+
+---
+
+### Automated Tests
+
+```powershell
 flutter test
 ```
+
+---
+
+## Development Workflow
+
+Typical iteration cycle:
+
+```text
+Start Engine
+      ↓
+Launch Dashboard
+      ↓
+Modify UI / Services
+      ↓
+Hot Reload
+      ↓
+Validate
+      ↓
+Commit Changes
+```
+
+---
+
+## Project Structure
+
+```text
+dashboard/
+│
+├── lib/
+│   ├── screens/
+│   ├── widgets/
+│   ├── services/
+│   ├── models/
+│   └── theme/
+│
+├── test/
+├── windows/
+└── pubspec.yaml
+```
+
+---
+
+## Troubleshooting
+
+| Issue | Possible Cause |
+|---|---|
+| Dashboard cannot connect | Engine not running |
+| Empty realtime panels | WebSocket unavailable |
+| REST requests fail | Incorrect engine endpoint |
+| Flutter build fails | Missing Windows desktop support |
+| UI not updating | Hot reload required |
+
+---
+
+## Platform Support
+
+| Platform | Status |
+|---|---|
+| Windows | Fully Supported |
+| Linux | Experimental |
+| macOS | Experimental |
+
+---
+
+<div align="center">
+
+### SentraCore Dashboard
+
+Observe • Understand • Act
+
+</div>