🚀 Overview

Flutter Handy Service is a complete, production-ready on-demand services & shopping platform that ships with a
customer app, a service-provider app, a responsive website, and a Laravel admin panel.
Customers can discover services/products, schedule bookings, track providers in real time, chat, pay, and rate. Providers manage availability, accept jobs, navigate, and get paid—while the admin handles listings, commissions, promos, and settlements.

Experience (E): Modeled on real-world gig workflows (plumbing, cleaning, AC repair, beauty, appliance install) and local delivery add-ons,
focusing on fast checkout, slot scheduling, cancellations/refunds, and fraud-safe payouts.

✨ Key Features

• 📍 Geo-based Discovery: City/zone catalogs, nearby providers, map view, and service radius rules.
• 🗓️ Smart Booking: Time slots, recurring jobs, dynamic ETA, reschedule/cancel policies.
• 👥 Dual Apps: Customer & Provider apps with role-based flows and KYC.
• 💬 In-App Chat & Calls: Order chat, push alerts, and status updates.
• 🛒 Service + Product Cart: Add-ons, spare parts, and upsells; coupon & wallet support.
• 💳 Payments: Stripe / PayPal / Razorpay / Flutterwave (extensible), COD, and partial payments.
• 📦 Order Lifecycle: Quote → Assign → On the way → Working → Completed → Rated.
• ⭐ Ratings & Reviews: Photo reviews, disputes, refunds, and evidence uploads.
• 📈 Admin Panel: Categories, zones, taxes, fees, commissions, promos, disputes, payout batches.
• 🌐 Website (SEO-ready): Landing, search, category pages, provider profiles, and booking flow.
• 🌍 i18n & RTL: Multi-language, currency, and RTL layouts.
• 🔐 Security: JWT auth, role-based access, rate limits, and audit logs.

⚙️ Technical Stack (Expertise)

• Mobile Apps: Flutter 3.x (Dart 3), Material 3, Bloc/Provider state mgmt, Dio/HTTP.
• Website: Flutter Web or Laravel Blade/Tailwind (depending on build), SEO meta + sitemap.
• Backend: Laravel 10 (PHP 8.1+), REST API, Sanctum/JWT, Spatie Roles/Permissions.
• Database/Cache: MySQL 8 / MariaDB 10.6+, Redis (queue/cache), Horizon (optional).
• Maps/Geo: Google Maps SDK / Mapbox, geocoding + distance matrix.
• Push/Realtime: Firebase Cloud Messaging; Pusher/Soketi for live updates (optional).
• DevOps: Nginx/Apache, PHP-FPM, Supervisor for queues, cron for jobs; Docker-ready.
• Build Tools: Android Studio/Xcode, Gradle 8+, Node 18+ (assets), Composer 2.x.

🧩 Installation Guide

1. Backend: Upload Laravel; run composer install, set .env (DB, mail, cache, keys), then php artisan migrate --seed & php artisan key:generate.
2. Queues & Cron: Start php artisan queue:work (or Supervisor) and add cron for scheduled tasks.
3. Mobile: In lib/config.dart set API_BASE_URL, maps keys, and payment/public keys → flutter pub get → flutter build apk/ios.
4. Website: Configure domain, SEO meta, and env vars; build assets (npm install && npm run build if Blade/Vite).
5. Branding: Replace icons/splash, colors/typography (theme.dart), and upload logos from admin.
6. Go Live: Enable HTTPS, set CORS, configure rate limits, and test payments in sandbox → production.

📦 Deliverables

• ✅ Flutter Customer app & Provider app sources.
• ✅ Laravel backend API + Admin panel.
• ✅ Website/front-end with booking flow.
• ✅ SQL schema, seeders, and sample data.
• ✅ Payment & maps integration templates.
• ✅ Postman/OpenAPI docs, README, CHANGELOG.
• ✅ GPL v3 license file.

📱 Supported Platforms

• Android: 8.0 (API 26)+
• iOS: 13+ (Xcode 15+)
• Web: Chrome, Safari, Edge, Firefox (latest)
• Server: Ubuntu 22.04 LTS or compatible; cPanel/Plesk/Docker supported

👨‍💻 Original Developer Credit (Authoritativeness)

This package credits the original commercial author. Please support them on their marketplace profile:
CodeCanyon – Original Author.

🔒 Disclaimer (Trustworthiness)

Redistributed under GPL v3 for educational and lawful commercial use per GPL terms. We are not affiliated with any trademarked brand.
Production deployments require your own payment credentials, maps keys, SMS gateways, and lawful KYC/AML practices. Always enable HTTPS, rotate secrets,
enforce RBAC, and validate third-party plugin licenses before going live.