95 lines
5.8 KiB
Markdown
95 lines
5.8 KiB
Markdown
# MotorSignal — Complete Development History & Feature Timeline
|
||
|
||
A comprehensive chronological analysis of all architectural milestones, features, optimizations, and commits from the inception of the repository to the latest build.
|
||
|
||
---
|
||
|
||
## 📜 Complete Git Commit Chronology
|
||
|
||
```
|
||
8c721da (2026-08-27) - Pre-Phase-2-Feature-Expansion Backup
|
||
00fe459 (2026-08-27) - Pre-Motorcycle-Garage-Feature
|
||
7e8b909 (2026-08-27) - OpenStreetMap-Pre-Implementation
|
||
ba29dc2 (2026-08-27) - feat: implement unified map service with support for Google Maps and OpenStreetMap
|
||
781da32 (2026-08-27) - Lean-And-LiveMap-Fixes
|
||
930b7a9 (2026-08-27) - Pre-Police-Alert-Feature
|
||
3e9f8eb (2026-08-27) - Pre-Production-Hardening
|
||
c562339 (2026-08-27) - Production-hardening: road alerts, lint cleanup, http dep, OSM null fix
|
||
51d3121 (2026-08-27) - CHECKPOINT: Pre-audit baseline snapshot before field readiness review
|
||
f7fbe71 (2026-08-27) - fix(telemetry): solve sensor fusion false lean, 3D G-force projection, stationary speed hysteresis
|
||
0cc6ed9 (2026-08-27) - docs: add DESIGN.md design system for Stitch
|
||
0d81524 (2026-08-28) - feat: Evolution UI theme, zero-lag 20Hz speedometer, interactive route preview, and Waze alert relay server
|
||
```
|
||
|
||
---
|
||
|
||
## 🏁 Phase 1: Core Foundation & Telemetry Engine
|
||
* **Commit:** `8c721da` — *Pre-Phase-2-Feature-Expansion Backup*
|
||
* **Architecture & Features:**
|
||
* Scaffolded Flutter cross-platform architecture with Riverpod reactive state management.
|
||
* Configured Drift (SQLite) embedded database with strongly typed DAOs and reactive table streams.
|
||
* Built the Core Telemetry Pipeline fusing GNSS geolocation streams with device IMU (3-axis accelerometer and gyroscope).
|
||
* Built the session state machine (`ready`, `riding`, `paused`, `finished`) with automatic trip calculation (distance in miles, top speed, moving time vs. stopped time, average speed).
|
||
|
||
---
|
||
|
||
## 🏍️ Phase 2: Multi-Bike Digital Garage
|
||
* **Commit:** `00fe459` — *Pre-Motorcycle-Garage-Feature*
|
||
* **Architecture & Features:**
|
||
* Added `GarageMotorcycles` database table with full CRUD functionality.
|
||
* Allows motorcyclists to register multiple bikes with specifications: Make, Model, Year, VIN, Custom Specs, Tire Dimensions, and Service Notes.
|
||
* Linked all ride sessions to the active motorcycle profile with default bike selection and quick switching.
|
||
|
||
---
|
||
|
||
## 🗺️ Phase 3: Unified Mapping & OpenStreetMap Integration
|
||
* **Commits:** `7e8b909`, `ba29dc2` — *Unified Map Service (Google Maps & OpenStreetMap)*
|
||
* **Architecture & Features:**
|
||
* Designed provider-agnostic mapping abstraction layer (`MapProviderInterface`, `UnifiedMapView`).
|
||
* Built dual map backends:
|
||
* **OpenStreetMap / Vector Tactical HUD**: High-contrast, offline-capable vector rendering.
|
||
* **Google Maps SDK**: Official vector map engine with native traffic layers and dark mode styling.
|
||
* Implemented Historical Ride Replay screen with interactive seek bar, variable playback speed (1x–8x), and synchronized G-force/lean/speed HUD telemetry overlays.
|
||
|
||
---
|
||
|
||
## 📐 Phase 4: Sensor Fusion & Lean Angle Calibration
|
||
* **Commits:** `781da32`, `f7fbe71` — *Telemetry & Sensor Fusion Overhaul*
|
||
* **Architecture & Features:**
|
||
* Implemented a robust roll/pitch complementary filter fusing gyroscopic angular velocities with accelerometer gravitational vectors to compute motorcycle lean angle.
|
||
* Solved centripetal acceleration distortion: projected 3D G-forces to isolate pure lateral cornering Gs from gravity vectors during deep lean.
|
||
* Calibrated stationary jitter deadband (< 0.6 m/s) to eliminate GPS drift when stopped at traffic lights.
|
||
* Added factory geometry presets (supersport, naked, adventure, cruiser) for phone mounting orientation compensation.
|
||
|
||
---
|
||
|
||
## 🚔 Phase 5: Road Hazards, Police Alerts & Production Hardening
|
||
* **Commits:** `930b7a9`, `3e9f8eb`, `c562339`, `51d3121` — *Road Alerts & Hardening*
|
||
* **Architecture & Features:**
|
||
* Built multi-provider hazard aggregation service (`RoadAlertService`):
|
||
* **TomTom Traffic Provider**: Live traffic incidents, construction, and road hazard markers.
|
||
* **OpenStreetMap / Overpass Engine**: Speed cameras, red-light enforcement cameras, and fixed speed traps.
|
||
* **Community Traffic Provider**: Custom endpoint configuration for decentralized alert feeds.
|
||
* Integrated Text-to-Speech (TTS) voice warning engine with configurable proximity alerts (500m / 1000m ahead).
|
||
* Implemented Black-Box Field Test Logger for diagnostic recording of raw GPS, IMU, and sensor fusion metrics.
|
||
|
||
---
|
||
|
||
## 🎨 Phase 6: Evolution UI & Cyberpunk Tactical Cockpit
|
||
* **Commit:** `0cc6ed9` — *Design System & Evolution Specs*
|
||
* **Architecture & Features:**
|
||
* Created the **Evolution Theme System** (`#00E5FF` electric cyan, `#69F0AE` spring green, `#0D0D0D` deep titanium, JetBrains Mono typography).
|
||
* Designed modular cockpit components: circular G-force matrix target, dual peak lean arcs, and italic speedometer typography.
|
||
|
||
---
|
||
|
||
## ⚡ Phase 7: Zero-Lag Telemetry, Interactive Route Preview, Compact Landscape & Waze Relay
|
||
* **Commit:** `0d81524` — *Latest Production Release*
|
||
* **Architecture & Features:**
|
||
* **20Hz Speedometer Refresh**: Upgraded Android Fused Location Provider to **100ms (10Hz)** and telemetry engine to **20Hz** with dynamic `0.90` alpha fast-tracking.
|
||
* **Interactive Route Preview**: Full route polyline rendering with 🟢 **START** and 🏁 **FINISH** markers, stationary notices, and cornering/braking event chips.
|
||
* **Landscape UI Optimization**: Compacted toolbars and AppBars to **36px** in landscape mode to maximize map and gauge visibility.
|
||
* **TomTom v5 API Upgrade**: Migrated to official TomTom query-parameter v5 endpoints.
|
||
* **Waze Alert Relay Server**: Built and dockerized self-hosted Node.js relay backend in `server/waze_relay/`.
|
||
* **Markdown Documentation**: Generated `FEATURES_CHANGELOG.md` and `DEVELOPMENT_HISTORY.md`.
|