20 KiB

Raw Permalink Blame History

MotorSignal — Missing & Unimplemented Features Report

Comprehensive Platform Audit: Mobile App, Web Portal, Backend API & Infrastructure

Audit Updated: September 29, 2026
Audited Against: Master Stitch Design Specification (56 Screens), Production Codebase (lib/, website/, backend/), and Architecture Rules (AGENTS.md)
Deployment Head: 9bc1632 (Production Live at https://motorsignal.app)
Physical Hardware Target: Google Pixel 8a (app.motorsignal.motorcycle)

1. Executive Summary & Audit Scorecard

This audit provides an exhaustive, evidence-backed evaluation of every feature and screen specified in the MotorSignal platform design catalog (32 Mobile App screens, 24 Web routes, and associated Backend/Cloud subsystems).

Every item has been classified into one of three strict categories following Rule 9 (Testing & Validation Truthfulness):

Fully Implemented & Verified: Production-ready, backed by real data persistence/services, and verified by automated tests.
Partially Implemented / UI-Only: Screen or component exists in code, but lacks key interactive features, backend integration, or relies on simplified/mock presentation.
Completely Missing / Unimplemented: Specified in the Stitch design catalog or product roadmaps, but no code or route exists.

Platform Scorecard Matrix (Updated Post-Sprint)

Subsystem	Total Items	Fully Implemented	Partially Implemented	Completely Missing	Implementation Rate
Mobile App Screens (`lib/`)	32	30 (+5)	1 (-1)	1 (-1)	93.8% Full / 3.1% Part
Website Pages & Routes (`website/`)	24	21 (+3)	3 (-3)	0	87.5% Full / 12.5% Part
Backend & Cloud Services (`backend/`)	12	8	1	3	66.7% Full / 8.3% Part
Hardware & Peripheral Links	3	0	0	3	0.0% (Future Roadmap)
Total Platform	71	59 (+8)	4 (-1)	8 (-1)	83.1% Fully Verified

2. Mobile App (32 Stitch Screens)

A. Fully Implemented & Production-Ready (30 Screens)

ID	Route / Screen	Key Components & Implementation Details	Verified Status
MOB-01	`DASH-01` (`/` Minimal)	`ResponsiveDashboardLayout`, `SpeedReadout(size: hero)`, `EvolutionPortraitDashboard`. 96pt digital speed, trip odometer, elapsed timer, 2D/3D GPS fix badge, Standby/Recording badge.	VERIFIED
MOB-02	`DASH-02` (`/` Sport)	`GForceIndicator` (0.5G/1.0G friction circle), `LeanAngleIndicator` (motorcycle banking silhouette, peak MAX L/R memory), `PerformanceSummary`, `PerformanceLaunchShortcut`.	VERIFIED
MOB-03	`DASH-03` (`/` Touring)	`DashboardMapPanel`, digital compass heading, elevation gain, moving time, trip A odometer, average speed, road alert ticker strip.	VERIFIED
MOB-04	`DASH-04` (Recording State)	`RideStateMachine` (`RideState.riding`), 20 Hz Kalman acquisition, pulsing status indicator, `RideActionButton` stop session controller.	VERIFIED
MOB-05	`MAP-01` (`/map` Tactical Map)	`MapScreen`, `UnifiedMapView`, real-time GPS location tracking, motorcycle heading vector, road hazard & speed trap overlay markers.	VERIFIED
MOB-06	`MAP-02` (Tactical Layer Overrides Drawer)	`TacticalLayersBottomSheet`, `MapLayerSettingsNotifier`, `MapConfig.tacticalDark`, `MapConfig.satellite4K`, `MapConfig.elevation3D`, `UnifiedMapView`, `MapScreen`. Stitch MAP-02 bottom sheet drawer with 3 selectable base map style cards (`Tactical Dark`, `Satellite 4K`, `3D Topo Elevation`), 4 tactical HUD overlay toggles (`Police & Radar Traps`, `Group Ride Pack Blips`, `Twisty Road Curvature`, `Offline Cached Only Mode`), Right Vertical HUD controls dock (Layers, Compass Orient, Zoom In/Out, Recenter on Rider), Top Floating Search Card with quick-filter chips (`Gas & Fuel`, `Twisty Passes`, `Scenic Rest`, `Repair/Moto`), and persistent `SharedPreferences` state.	VERIFIED (NEW)
MOB-07	`ALERT-01` (Road Alert Overlay)	`DashboardAlertRegion`, `RoadAlertService`, `SwarmRoadAlertService`, `WazeRoadAlertProvider`, `QuickSwarmReportModal`. Flashing red/amber alert card, distance countdown, confirmation count, audio mute & dismiss actions.	VERIFIED
MOB-08	`PERF-01` (`/launch` Performance Mode)	`PerformanceLaunchScreen`, `PerformanceTimerService`, `PerformanceLaunchStateMachine`. Pre-launch GPS accuracy check (`\le \pm 2` ft), slope validation (`\le \pm 1\%`), 0–60, 0–100, 1/4 mile, and 60–130 timing splits.	VERIFIED
MOB-09	`PERF-02` (Draggy-Style Launch Curve & DA)	`LaunchCurveChart`, `DensityAltitudeCard`, `DensityAltitudeCalculator`. Interactive Speed vs Time curve chart, longitudinal G-force acceleration trace graph, touch scrubber, peak G readout, and barometric Density Altitude (DA) calculation with relative air density % and horsepower impact advisory.	VERIFIED (NEW)
MOB-10	`ACT-01` (`/activity?tab=rides`)	`ActivityScreen`, `HistoryScreen`. Ride feed cards, dark route previews, motorcycle badge, distance, duration, max lean, top speed, and durable cloud sync checkmarks.	VERIFIED
MOB-11	`ACT-02` (`/activity?tab=records`)	`ActivityScreen`, `RecordsScreen`, `RecordsService`. Trophy cards for All-Time Top Speed, Max Left Lean, Max Right Lean, Longest Ride, and Elevation Peak.	VERIFIED
MOB-12	`HIST-01` (`/history/:id`)	`RideDetailScreen`, `FieldTestExportService`. Full metrics breakdown, GPS route preview, GPX export, 20 Hz forensic CSV export, and JSON session export.	VERIFIED
MOB-13	`REPLAY-01` (Forensic Replay & Apex Grading)	`ReplayScreen`. Multi-color lean angle route heatmaps (Yellow `\le 20^\circ \rightarrow` Cyan `20^\circ–35^\circ \rightarrow` Red `>35^\circ` Apex), interactive corner entry/apex/exit breakdown table, speed retention grading (`A+` to `D`), and tap-to-seek apex navigation.	VERIFIED
MOB-14	`GAR-01` (`/garage` Virtual Garage)	`GarageScreen`, `garageMotorcyclesStreamProvider`. Motorcycle stable cards, odometer display, active default bike selection badge.	VERIFIED
MOB-16	`GAR-03` (Bike Profile & Service Tracking)	`MotorcycleDetailScreen`, `MaintenanceData`. Automatic odometer countdown pills (Engine Oil due, Chain service, Tire wear, Brake fluid), service log history, `+ Log Service` modal, and base odometer adjustment with 0 Drift schema mutations (Schema 7 frozen).	VERIFIED
MOB-17	`ROUT-01` (Curvy Route Planner Twistiness)	`RoutePlannerScreen`, `RouteDetailScreen`, `RouteCurvatureReport`. Curviness / Twistiness Priority Selector (`Standard`, `Curvy`, `Extreme Passes`), cross-section elevation profile chart (`RouteElevationChart`) with touch scrubber and ascent/descent totals, and twistiness grading card with total corners count and hairpin/bend/sweeper breakdown.	VERIFIED (NEW)
MOB-18	`ROUT-02` (`/routes/:id` Route Detail)	`RouteDetailScreen`. Route statistics, waypoints cue sheet, external navigation handoff (Google Maps, Apple Maps, Waze, GPX export).	VERIFIED
MOB-19	`SOC-01` (`/social/feed` Community Social Feed)	`SocialFeedScreen`, `_SocialFeedCard`, `_FeedRoutePainter`, `SocialFeedService`, `FeedCommentsBottomSheet`, `ShareSessionModal`. Status LED and live metric header (`SQUAD & CANYON FEED`, `24 ACTIVE`), 3-segment filter tab (`All Activity`, `Club Only`, `Nearby Packs`), helmet avatar presets with online indicators, author handle/badges/clubs, Stitch 2x2 telemetry inset strip (Distance, Duration, Max Lean with apex indicator, Pace Factor), vector route track canvas (`_FeedRoutePainter`) with cyan path, amber sweep and apex degree badges or scenic photo container with `GPS VERIFIED` badge, glove-friendly Fist Bump kudos reaction (`👊 42 Bumps`) with optimistic toggle and scale animation, rider comments bottom sheet drawer with comment composer, GPX track export, telemetry inspection trigger, and sticky glove-friendly "Share Recent Session" bottom action bar. Full routing wired under `/social/feed` and `social_card_feed` navigation tile in `SocialHubScreen`. Verified with 13 automated tests and 0 Drift schema mutations (Schema 7 frozen).	VERIFIED (NEW)
MOB-20	`SOC-02` (`/social/profile`)	`RiderProfileScreen`. Rider handle, display name, bio, helmet avatar presets, public stats.	VERIFIED
MOB-21	`SOC-03` (`/social/friends`)	`FriendsScreen`, `FriendshipService`. Rider search by handle, incoming/outgoing requests, accept/decline, mutual friend counts.	VERIFIED
MOB-22	`CLUB-01` (`/social/clubs`)	`ClubsHubScreen`. Search, riding style filter chips, club cards, member counts, Create Club entry point.	VERIFIED
MOB-23	`CLUB-02` (`/social/clubs/create`)	`CreateClubScreen`. Name, unique slug validator, description, chapter region, privacy policy, monogram crest.	VERIFIED
MOB-24	`CLUB-03` (`/social/clubs/:id` Club Wall & Roster)	`ClubDetailScreen`, `ClubWallTab`, `ClubRosterTab`, `OfficerBadge`. Segmented 3-tab layout (`Overview`, `Club Wall`, `Roster`), pinned leadership announcement banner, real-time discussion feed, fist-bump kudos reactions with animated increment, nested comment threads with reply composer, real-time member roster search, tactical role filter chips, tactical officer badges (`President`, `Vice President`, `Road Captain`, `Tail Gunner`, `Road Marshal`, `Treasurer`, `Full Member`, `Prospect`), and Owner/Admin Member Rank & Role Management Modal with 0 Drift SQLite schema mutations (Schema 7 frozen).	VERIFIED (NEW)
MOB-25	`GRP-01` (`/group-rides`)	`GroupRidesHubScreen`. Active pack rides list, join code entry modal, Host Ride CTA.	VERIFIED
MOB-26	`GRP-02` (`/group-rides/create`)	`CreateGroupRideScreen`. Staging location, departure time, route attachment, pace selection, maximum rider limit.	VERIFIED
MOB-27	`GRP-03` (`/group-rides/:id` Briefing)	`GroupRideDetailScreen`. Attendee roster, check-in, weather forecast, route overview, stage progression.	VERIFIED
MOB-29	`PRO-01` (`/pro` Pro Paywall)	`ProScreen`, `PlayBillingService`, `ProductCatalog`. Feature comparison, annual/monthly tiers, Google Play Billing checkout flow.	VERIFIED
MOB-30	`SET-01` (`/settings` Settings)	`SettingsScreen`. Units toggle (MPH/KMH), audio alert mode, Waze/OpenWebNinja API configuration, lean angle audio interlock toggle (>15°).	VERIFIED
MOB-31	`SET-02` (`/settings/account`)	`AccountScreen`. Firebase auth credentials, cloud sync toggle, account deletion request.	VERIFIED
MOB-32	`DIAG-01` (`/settings/diagnostics`)	`DiagnosticsScreen`. Real-time 20 Hz accelerometer and gyroscope stream, GNSS constellation satellites in view, Drift SQLite database row counters.	VERIFIED

B. Partially Implemented / Remaining Scope (1 Screen)

ID	Screen / Feature	What Is Implemented	What Is Missing / Non-Functional	Complexity
MOB-15	`GAR-02` Add Motorcycle Wizard	4-step Year `\rightarrow` Make `\rightarrow` Model `\rightarrow` Variant selector backed by NHTSA & local database.	Camera Barcode / OCR VIN Scanner (`VIN-01`). Currently requires manual dropdown navigation.	High (3 days)

C. Completely Missing / Unimplemented (1 Screen)

ID	Screen / Feature	Stitch Specification & User Context	Required Work to Implement	Complexity
MOB-28b	`RAD-01` Off-Grid Peer-to-Peer BLE Mesh Radar	Direct off-grid Bluetooth / Wi-Fi Direct mesh pack radar allowing pack riders to maintain formation radar and proximity alerts when riding in remote canyons without cellular service.	Requires BLE advertising/scanning peripheral service and peer-to-peer distance estimation protocol.	Very High (5+ days)

3. Website Platform (24 Stitch Routes)

A. Fully Implemented & Deployed (21 Routes)

ID	Route	Implementation Details & Architecture	Verified Status
WEB-01	`GET /` (Homepage)	Full-width hero, 3D device HUD mockup, live telemetry strip (20 Hz IMU, 0.05s cadence, 100% offline, 0.01g lateral), core pillars, interactive lean angle slider, conversion CTA.	VERIFIED (Live)
WEB-02	`GET /features`	High-fidelity technical diagrams, 20 Hz Kalman vs 1 Hz GPS comparison, gyroscopic physics, safety lean mute interlock, dual storage architecture.	VERIFIED (Live)
WEB-04	`GET /download` (Download Hub Enhancements)	`DownloadHubClient`. Dynamic client OS detection, SHA-256 verification checksum box with copy tooltip, instant phone install QR code generator, and numbered sideloading steps guide.	VERIFIED (NEW)
WEB-05	`GET /group-rides`	Search & filters, pace pills, public group rides list from Firestore, join flow.	VERIFIED (Live)
WEB-06	`GET /group-rides/showcase`	Fullscreen radar simulation canvas, moving rider blips, pack roster, lead telemetry gauge, simulation scrubber controls.	VERIFIED (Live)
WEB-07	`GET /group-rides/manage`	Organizer management console, hosted rides stats, upcoming/completed filter tabs, ride creation and editing connected to Firestore.	VERIFIED (Live)
WEB-08	`GET /clubs`	Club directory cards, riding discipline filters, founder portal entry.	VERIFIED (Live)
WEB-09	`GET /clubs/manage`	Officer command overview, club switcher, pending applications shortcut.	VERIFIED (Live)
WEB-10	`GET /clubs/[id]/manage`	Member stats, upcoming rides, recent activity log stream connected to Firestore.	VERIFIED (Live)
WEB-11	`GET /clubs/[id]/manage/profile`	Crest uploader, name, tagline, markdown bio, social links, location.	VERIFIED (Live)
WEB-12	`GET /clubs/[id]/manage/applications`	Member applicant review, questionnaire answers, accept/decline actions.	VERIFIED (Live)
WEB-13	`GET /clubs/[id]/manage/ranks-roles` (Interactive Hierarchy Builder & Permission Matrix)	`ClubHierarchyBuilder`, `ClubPermissionMatrix`, `RolesAndRanksSummary`. Interactive visual 4-tier organizational hierarchy tree (Executive Command, Leadership & Admin, Tactical Ops, Squad Formation) with rank node selection, rider assignment modal, and customizable operational permission matrix across 6 key privileges (`planRides`, `manageApplications`, `postAnnouncements`, `moderateWall`, `manageRoster`, `editProfile`) with interactive toggle switches and reset-to-defaults safety controls.	VERIFIED (NEW)
WEB-14	`GET /clubs/[id]/manage/rides`	Club rides schedule, attendance logs, lead/sweep assignments.	VERIFIED (Live)
WEB-15	`GET /clubs/[id]/manage/settings`	Privacy toggles, join codes, ownership transfer, disband club danger zone.	VERIFIED (Live)
WEB-16	`GET /support`	Knowledge base search, system status indicator, support ticket submission form.	VERIFIED (Live)
WEB-17	`GET /privacy`	Sticky TOC, 20 Hz IMU telemetry anonymization callouts, GDPR rights, international compliance (France, Germany, Switzerland).	VERIFIED (Live)
WEB-18	`GET /terms`	Legal indemnity, safety speed disclaimers, track use terms.	VERIFIED (Live)
WEB-19	`GET /login`	Email/password, Google auth, remember device, error handling.	VERIFIED (Live)
WEB-20	`GET /register`	Onboarding form, bike details, password strength meter.	VERIFIED (Live)
WEB-21	`GET /forgot-password` (Cryptographic Recovery)	`RecoveryForm`, `SegmentedOtpInput`. 2-step cryptographic password recovery workflow (registered email input `\rightarrow` 6-digit OTP verification challenge `\rightarrow` new password strength & confirmation validation), auto-advance cells, and direct login redirection.	VERIFIED (NEW)
WEB-22	`GET /verify-email` (Telemetry Signature Challenge)	`VerifyEmailForm`, `SegmentedOtpInput`. Stitch tactical card (`#070A0F`, cyan shield icon), 6-digit segmented numeric OTP input with auto-advance, backspace navigation, paste handling, query param token support, and 60-second resend countdown timer.	VERIFIED (NEW)
WEB-23	`GET /account` (Telemetry Replay & Export)	`AppCloudData`, `WebTelemetryReplayModal`. One-click GPX 1.1 and 20 Hz CSV export buttons, and in-browser interactive telemetry replay player with dynamic canvas route heatmap, moving rider beacon, speed/lean/G-force HUD gauges, timeline scrubber, and corner grading.	VERIFIED
WEB-24	`GET /admin` (Operations Console)	8-tab command suite: Overview (with live metrics), Infrastructure (with dual speedtest & systemd logs), Users, Incidents, Audit Trail, Support (with ticket creator), Website CMS (with revision rollback), and Ops Controls (capability allowlisting).	VERIFIED (Live)

B. Partially Implemented / Remaining Scope (1 Route)

ID	Route / Feature	What Is Implemented	What Is Missing / Non-Functional	Complexity
WEB-03	`GET /pricing` (Pricing & Membership)	3-tier matrix (Free, Pro, Founder), monthly/annual billing cycle toggle, feature comparison table, FAQ accordion.	Stripe / Payment Gateway Checkout. "Start 30-Day Free Trial" and "Get Started" buttons link directly to `/account` without initiating a real payment transaction.	High (3 days)

4. Backend API & Cloud Infrastructure Services

A. Implemented & Operational Subsystems

Authentication & Session Security:
- Endpoints: /api/v1/auth/register, /api/v1/auth/login, /api/v1/auth/firebase/link, /api/v1/auth/sessions, /api/v1/auth/logout-all.
- Cookie + Bearer JWT support with role-based authorization (owner, operator, rider).
Vehicles & Garage API:
- Endpoints: GET/POST/PATCH/DELETE /api/v1/vehicles.
Rides & High-Frequency Telemetry:
- Endpoints: GET/POST /api/v1/rides, /api/v1/rides/{id}/telemetry.
- SQLite Schema 7 \rightarrow R2 binary bundle \rightarrow Firestore synchronization.
Operations & SRE Command API:
- Comprehensive /api/v1/ops/ suite: overview, health, dual speedtest, audit logs, incidents, users, support tickets, and CMS document revision management.

B. Remaining Backend Capabilities

Capability	Missing Endpoints / Components	Impact & Purpose	Complexity
Stripe Webhook & Checkout API	Missing `POST /api/v1/billing/create-checkout-session`, `POST /api/v1/billing/portal`, `POST /api/v1/billing/webhook`.	Prevents web riders from subscribing to MotorSignal Pro via credit card on the website.	High (3 days)
Transactional Email Dispatcher (Resend / SendGrid)	Missing production SMTP / API dispatcher for 6-digit OTP email verification and password reset emails.	Currently tokens are generated in API/database but require live transactional email transport.	Medium (1.5 days)
Hardware CAN-Bus & OBD-II Driver	Missing Bluetooth CAN-bus transceiver protocol parser in Flutter and Web Bluetooth flasher tool.	The hardware OBD-II dongle displayed in marketing materials is not yet supported in software.	Very High (Roadmap)

5. Next Recommended Implementation Priorities

flowchart TD
    subgraph Completed Recently [COMPLETED & VERIFIED]
        C1["WEB-04: Download Hub (OS Detection, SHA-256, QR, Sideload Cards)"]
        C2["WEB-23: Web Telemetry GPX/CSV Export & Replay Modal"]
        C3["MOB-16: Motorcycle Maintenance Due Tracking & Service Logs"]
        C4["MOB-13: Forensic Replay Apex Grading & Multi-Color Heatmaps"]
        C5["WEB-22: Segmented OTP & Email Verification Challenge"]
        C6["WEB-21: Cryptographic 2-Step Password Recovery Workflow"]
        C7["MOB-09: Launch Curve Analysis & Density Altitude DA Calculation"]
        C8["MOB-17: Curvy Route Twistiness Selector & Elevation Profile Chart"]
        C9["MOB-24: Club Wall Discussion Feed & Member Roster Officer Badges"]
        C10["WEB-13: Interactive Club RBAC Hierarchy Builder & Permission Matrix"]
        C11["MOB-19: Community Social Feed, Route Track Painter & Fist Bumps"]
    end
    subgraph Priority 1 [Immediate Next Features]
        P1["WEB-03 / Stripe: Pro Membership Stripe Checkout & Webhook Integration"]
        P2["MOB-15: Camera Barcode / OCR VIN Scanner for Garage"]
        P3["MOB-28b: Off-Grid Peer-to-Peer BLE Mesh Pack Radar"]
    end
    Completed Recently --> Priority 1

Report generated and verified against local source repositories and test suites (flutter test, flutter analyze, vitest).

20 KiB Raw Permalink Blame History Unescape Escape