1. Executive Summary & Core Platform Objectives
The objective is to architect, develop, test, and deploy a robust, end-to-end On-Demand Mobile Car Wash Platform tailored for the Algerian market. The platform connects vehicle owners with nearby certified independent detailers (mobile car washers) to perform services at the customer's home or office.
The solution incorporates native mobile experiences built with Flutter, an enterprise-grade PHP Laravel backend API with real-time WebSockets, a Customer-Driven Manual Selection model with background wake-up services, fully dynamic multi-tier service pricing, mandatory before/after camera verification with offline compression, and localized integrations with Icosnet SMS and Chargily Pay.
2. Approved Technical Stack & Infrastructure Ownership
The platform will be engineered strictly using the approved modern technology stack and deployed on client-owned infrastructure:
| Layer / Component | Selected Technology | Implementation & Ownership Details |
|---|---|---|
| Mobile Applications | Flutter (Dart) | Cross-platform apps (Customer & Detailer) on Android & iOS with offline-first local caching and instant_request_handler background wake-up. |
| Backend Framework | PHP / Laravel (v11+) | Secure REST API engine, Laravel Sanctum token auth, Eloquent ORM, RBAC permission roles, and queue workers. |
| Database Engine | MySQL (8.0+) | ACID-compliant relational database for transactional integrity, balances, and audit logs. |
| Real-Time Communication | WebSockets (Laravel Reverb / Soketi) | Bi-directional real-time GPS live tracking, instant job alerts, and state synchronization. |
| Push Notifications | Firebase Cloud Messaging (FCM) | Background and foreground push alerts for critical lifecycle events and order updates. |
| Maps & Geolocation | Google Maps Platform | Places Autocomplete, Reverse Geocoding, Geofencing, and Turn-by-Turn navigation for detailers. |
| SMS Gateway | Icosnet.com API | Local Algerian high-delivery SMS gateway for phone OTP verification and critical notices. |
| Electronic Payments | Chargily.com Gateway | Seamless integration for local Algerian electronic cards (Edahabia & CIB cards). |
| Server Hosting & VPS | Client Cloud VPS (DigitalOcean/AWS/Hetzner) | 100% Client Ownership: Production setup (Nginx, PHP-FPM, MySQL, SSL, Redis) deployed directly on client's dedicated VPS with full root access. |
| App Stores & Publishing | Google Play & Apple Developer Accounts | Build generation, asset prep, and approval handling. (Advisory: Option to launch initially on vendor Play Console & transfer, or directly on client console with client fulfilling 20-testers policy). |
3. Business Logic, Dynamic Multi-Tier Pricing & Debt Control
The platform features 100% Dynamic Service Tiers manageable from the Admin Back-Office (create, edit, reprice, or remove service tiers per vehicle category), coupled with an automated commission debt management engine:
💵 Dynamic Multi-Tier Service Pricing
- Tier 1 - Standard: Exterior wash only (Configurable base price, e.g., 1,000 DZD).
- Tier 2 - Comfort: Full wash (Interior + Exterior) (Configurable base price, e.g., 1,500 DZD).
- Tier 3 - VIP / Detailing: Full wash + protective wax & premium finishes (Configurable base price).
- Dynamic Admin Management: Admin can add new tiers, adjust prices by vehicle category (City car, SUV, 4x4), and set custom add-ons.
- Platform Commission Split: 25% to Platform, 75% retained by Detailer.
🛑 3,000 DZD Debt Cap & Auto-Suspension
- Every cash job accumulates commission debt owed by the detailer to the platform.
- Threshold Cap: 3,000 DZD (Configurable in Admin).
- Auto-Suspension: Once debt reaches or exceeds 3,000 DZD, the detailer is automatically blocked from receiving orders.
- Settlement Channels: BaridiMob transfer, CCP receipt, Cash at office, or instant settlement via Chargily.
- Instant Reactivation: Detailer uploads receipt in-app $\rightarrow$ Admin verifies $\rightarrow$ System credits account and lifts suspension.
4. Customer-Driven Selection Model & Application Scope
📱 1. Customer Mobile Application (Manual Selection Model)
Manual Detailer Selection Workflow
- Customer selects location, vehicle, and desired service tier (Standard / Comfort / VIP).
- Interactive Detailer Map/List: Customer browses nearby available detailers showing photos, 1–5 star ratings, calculated ETA, and base price.
- Customer explicitly picks their preferred detailer.
- Acceptance Window: Selected detailer receives the alert with a recommended 2-minute (120s) acceptance timer (allowing time to notice alerts while working).
- Fallback Routing: If declined or timed out, order auto-routes to Customer's 2nd choice or prompts re-selection.
Live Tracking & Quality Check
- Real-time GPS route tracking of detailer arrival via WebSockets.
- Live status progression: Accepted $\rightarrow$ En Route $\rightarrow$ Arrived $\rightarrow$ Washing $\rightarrow$ Completed.
- Inspection of Before & After wash inspection photos.
- Payment selection: Cash on Delivery or Online via Chargily (Edahabia/CIB).
- Digital invoice breakdown and rating with text feedback.
🧼 2. Detailer Mobile App (Background Wake-Up & Visual Proof)
Powered by the vendor's proprietary instant_request_handler package for background execution, and flutter_image_compress for fast 3G/4G photo uploads.
1 Background Alert & Wakeup
2 Accept (120s Window)
3 Google Maps Navigation
4 "Arrived" Status
5 📸 Mandatory Before Photos
6 "Start Wash" & "Complete"
7 📸 Mandatory After Photos
8 Cash / Digital Settlement
Background Wakeup & Navigation
- App runs in background; upon incoming order request, it automatically wakes/opens the application interface.
- Online / Offline toggle with continuous background location telemetry.
- Google Maps turn-by-turn navigation directly to customer vehicle.
Photo Compression & Debt Wallet
- Native Photo Compression: In-app camera captures 2–4 photos, compresses them client-side via
flutter_image_compressbefore uploading over 3G/4G. - Offline Queue: Local SQLite caching with auto-sync upon reconnection.
- Debt & Settlement: Real-time debt tracker with receipt upload (BaridiMob/CCP).
🖥️ 3. Administrator Back-Office Web Portal (Laravel + Responsive UI)
Executive Dashboard
- Live orders overview & heatmaps.
- Revenue, gross GMV & collected fees.
- Cancellation rate & satisfaction score.
Debt & Receipts Module
- Per-detailer debt balance ledger.
- Review BaridiMob / CCP receipts.
- Approve payment & unlock suspended washers.
Dynamic Pricing & Operations
- Dynamic Tiers: Add/Edit/Delete tiers.
- Detailer KYC verification & zones.
- Order override & dispute resolution.
5. Technical Architecture Assessment & Verification
| Area | Technical Implementation Specification |
|---|---|
| 1. Security & Tokens | User & Detailer sessions are secured via Laravel Sanctum stateful/bearer API tokens transmitted over SSL/TLS (HTTPS) with token expiration, RBAC permissions, and strict API request validation. |
| 2. Offline Image Compression | Before upload, photos taken via the in-app camera are processed locally on the mobile device using flutter_image_compress, reducing file size by up to 80% without visible quality loss to ensure seamless transmission over Algerian 3G/4G networks. |
| 3. Background Tracking & Wakeup | The detailer app utilizes continuous background location telemetry and the proprietary, verified Flutter package instant_request_handler (pub.dev/packages/instant_request_handler) to wake and launch the order acceptance interface automatically even when minimized. |
| 4. Source Code & Git Access | Dedicated private Git repositories (for Flutter mobile apps and Laravel backend) with continuous real-time access granted to the client throughout development and deployment. |
| 5. Verified Client References |
• Algeria Reference (InDrive-like Taxi Platform): Contact Phone: 0659228639• Jordan Reference (On-Demand Delivery Platform like Yassir): Sheikh Hamza: +962788040105
|
6. Infrastructure Costs & App Store Publishing Policy
☁️ Direct Third-Party Operational Costs
- Direct Client Invoicing: External operational expenses (Cloud VPS hosting, Apple/Google Developer account fees, Google Maps API usage, and Icosnet SMS packs) are billed directly to the client.
- Contract Scope: 100% of DevOps configuration, server deployment, database setup, and third-party API wiring are fully covered within the $2,500 contract.
🚀 Google Play Publishing & Tester Advisory
- Recommended Path: For new Play Console accounts, vendor recommends initial publishing under vendor's established console, followed by a direct app transfer to client's console to avoid rejection risks.
- Direct Publishing on Client Console: If client chooses direct publication on a new Play Console, client assumes responsibility for fulfilling Google's policy requiring 20 closed testers for 14 continuous days.
7. Warranty Scope & Maintenance SLA (1-Year Term)
- Warranty Scope: 12 Months of complimentary technical support covering all source code bugs, API breakages, and system crashes delivered under this contract.
- Response Window: Immediate urgent response within 1–2 hours during standard company operating hours (12:00 PM to 12:00 AM Cairo Time / UTC+3).
- Resolution SLA: Critical crashes/dispatch issues targeted for resolution within 24 hours; major UI/upload issues within 48–72 hours.
- Third-Party Disclaimer: Maintenance covers delivered source code. In the event of breaking architectural changes or plugin depreciations enforced by third parties (e.g., major breaking changes in Google Maps or payment gateway APIs), updates will be billed outside standard warranty at fair hourly/task rates.
8. Commercial Investment & Payment Milestones
$2,500 USD
All-inclusive: 2 Mobile Apps (iOS+Android), Admin Web, Backend API, Integrations, Server Deployment, 1-Mo Pilot, and 1-Year Warranty.
Milestone 1 (25%)
$625 USD
Advance Deposit: Due upon contract signing and project initiation.
Milestone 2 (25%)
$625 USD
UI/UX Design Sign-Off: Due upon completion and approval of all Figma prototypes.
Milestone 3 (50%)
$1,250 USD
Final Delivery & Testing: Due upon full delivery, review, testing, and store submission.
💳 Accepted Payment Channels
- Western Union: Direct international cash transfer.
- USDT (Crypto): TRC-20 / ERC-20 secure cryptocurrency transfer.
🛡️ Intellectual Property Transfer
- 100% Full Source Code: Complete Git repositories, database scripts, and technical documentation transferred upon project sign-off.