MotorSignal-App/docs/archive/2026-08/legacy/development-history.md

5.8 KiB
Raw Permalink Blame History

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.