diff --git a/DEVELOPMENT_HISTORY.md b/DEVELOPMENT_HISTORY.md new file mode 100644 index 0000000..ac9d4e4 --- /dev/null +++ b/DEVELOPMENT_HISTORY.md @@ -0,0 +1,94 @@ +ο»Ώ# 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`.