How ismailimamoglu/motocortex works
MotoCortex is an offline-first mobile vehicle diagnostics and ECU-coding product. A driver connects an adapter, identifies a vehicle, scans vehicle systems, reviews diagnostic results, and may perform supported service or coding actions. The map also preserves documented EV, reporting, telemetry, and AI capabilities. The README supports these product branches; sampled source confirms selected engine, safety, storage, and UI behavior, but not every screen-to-service connection.
Main entry points: OBD2ProtocolEngine.ts OBD protocol engine · multiEcuService.ts Multi-ECU diagnostics · App.tsx Mobile app · LiveEngineHero.tsx Live engine
Components 22
Mobile experience
- Mobile app
App.tsx - Connection flow
src/screens/ConnectionFlowScreen.tsx - Live engine
src/components/LiveEngineHero.tsx
Connection and diagnostics
- OBD protocol engine
src/api/OBD2ProtocolEngine.ts - Native OBD transports
modules/motocortex-obd/src/index.ts - Vehicle identity
src/core/identity/VehicleIdentityEngine.ts - ECU discovery
src/core/discovery/EcuDiscoveryEngine.ts - Multi-ECU diagnostics
src/services/multiEcuService.ts - DTC parsing and lookup
src/core/parser/DtcStreamParser.ts
ECU coding and safety
- OEM feature catalog
src/core/features/FeatureCatalog.ts - Feature activation
src/core/features/FeatureActivationEngine.ts - Safety policy
src/core/safety/SafetyGate.ts - Gateway access
src/core/security/SgwBypassEngine.ts
Vehicle insights
- AI Doctor
src/services/aiDoctorService.ts - EV diagnostics
src/core/ev/EvDiagnosticSuite.ts - Inspection reports
src/core/inspection/InspectionReportEngine.ts - Telemetry services
src/services/TelemetrySyncManager.ts
Persistence and services
- Connection state
src/store/useBluetoothStore.ts - Telemetry queue
src/core/database/SQLiteStorage.ts - Supabase services
src/api/supabaseClient.ts
Other components
- Driver
- OBD adapter
Connections 21
- Driver → Mobile app: uses
- Mobile app → Connection flow: presents
- Mobile app → Live engine: presents
- Live engine → Connection state: reads state
- Live engine → OBD adapter: connects through
- OBD adapter → Native OBD transports: sends vehicle data
- OBD protocol engine → Native OBD transports: executes commands
- OBD protocol engine → Connection state: updates state
- OBD protocol engine → DTC parsing and lookup: decodes codes
- OBD protocol engine → Vehicle identity: provides responses
- Vehicle identity → ECU discovery: informs vehicle scan
- ECU discovery → Multi-ECU diagnostics: supports module scan
- Multi-ECU diagnostics → AI Doctor: provides diagnostic context
- DTC parsing and lookup → AI Doctor: provides fault codes
- OEM feature catalog → Feature activation: supplies definitions
- Feature activation → Safety policy: checks safety
- Feature activation → Gateway access: uses gateway access
- Telemetry services → Telemetry queue: queues telemetry
- Telemetry services → Supabase services: syncs data
- Multi-ECU diagnostics → Inspection reports: supplies diagnostics
- Multi-ECU diagnostics → EV diagnostics: supports EV scan