v1.0.0 — Active Development

The Backend for
iMech / iAutomec

AI-powered automotive services marketplace connecting Nigerian car owners with verified mechanics — with OBD-II diagnostics, in-app wallet, real-time GPS tracking, and an AI Mechanic built in.

Open API Docs Learn More
API Server Running
PostgreSQL Connected
Redis Connected
AI Service (pending config)
Payment Gateways (pending keys)
What We're Building
Platform Capabilities
Everything needed to run a full two-sided automotive marketplace in Nigeria.
🔍

OBD-II Diagnostics

Receive OBD scan data and DTC fault codes from the Flutter app via BLE/WiFi adapters. Scans are linked to vehicles and shared with workshops before arrival.

🤖

AI Mechanic

DTC explanation, DIY repair steps, and SSE-streamed chat — powered by GPT-4o via the FastAPI AI service. Voice input via Whisper transcription.

🛒

Marketplace

Workshop discovery by location and service type. Full booking lifecycle: searching → accepted → en route → arrived → in-progress → completed.

🚨

Emergency Services

911 call-out, highway breakdown, jumpstart, EV recharge, and tyre replacement — each with real-time GPS tracking of the assigned workshop.

💳

In-App Wallet

NGN wallet (Paystack) and USD wallet (Stripe). Fund, withdraw to bank, and pay for services — all secured with a 4-digit PIN. Full transaction history.

📦

Subscriptions

Basic (free), Pro, and Enterprise tiers managed via RevenueCat. All prices fetched at runtime from admin — zero hardcoded amounts anywhere.

📡

Real-Time Events

Job status changes and mechanic GPS location broadcast live via Laravel Echo / Pusher channels — powering the Flutter map tracker screen.

🛡️

Admin Dashboard

Separate admin API for the Next.js dashboard: pricing config, user management, analytics, workshop verification, and feature flags.

🌍

Multi-Currency

NGN (Paystack) primary, USD (Stripe) secondary. All amounts stored as integers in smallest denomination. Exchange rates managed by admin.

Technology
Tech Stack
Each service is independently deployable and communicates over internal HTTP.
⚙️
Laravel 11
PHP 8.3 — Main API
🐍
FastAPI
Python 3.11 — AI Service
🗄️
PostgreSQL 16
Primary database
Redis 7
Cache, queue, sessions
📱
Flutter 3.x
iOS + Android client
🖥️
Next.js 14
Admin dashboard
💚
Paystack
NGN payments
🟣
Stripe
USD payments
🔔
Firebase FCM
Push notifications
🔑
Laravel Sanctum
API authentication
📊
Laravel Horizon
Queue monitoring
🐳
Docker
Containerised dev
API Reference
Key Endpoints
Base URL: http://server.imech.pro/api/v1 — All responses are JSON. Auth via Authorization: Bearer {token}.
POST/auth/registerRegister car owner or workshop
POST/auth/loginLogin and get Sanctum token
POST/auth/otp/verifyVerify phone/email OTP
GET/config/pricingFetch all runtime prices (cached)
GET/vehiclesList user's vehicles
POST/obd/sessionsSubmit OBD scan session
POST/ai/explainGet DTC explanation + DIY steps
GET/ai/chatAI Mechanic chat (SSE stream)
GET/marketplace/providersSearch workshops by location
POST/marketplace/requestsCreate service booking
POST/emergency/requestsDispatch emergency service
GET/walletGet wallet balance
POST/wallet/fundFund wallet via Paystack/Stripe
POST/wallet/withdrawWithdraw to bank account
GET/workshop/jobsWorkshop: list incoming jobs
POST/workshop/jobs/{id}/acceptWorkshop: accept a job
View Full API Documentation →