# 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):
1. **Fully Implemented & Verified**: Production-ready, backed by real data persistence/services, and verified by automated tests.
2. **Partially Implemented / UI-Only**: Screen or component exists in code, but lacks key interactive features, backend integration, or relies on simplified/mock presentation.
3. **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

1. **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`).
2. **Vehicles & Garage API**:
   - Endpoints: `GET/POST/PATCH/DELETE /api/v1/vehicles`.
3. **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.
4. **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

```mermaid
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`).*