🚀 Overview

UClap is a production-ready on-demand service marketplace for Android with a powerful interactive admin panel.
Customers can book services (cleaning, salon, AC repair, plumbing, electrician, pest control, etc.), while providers manage
jobs, schedules, and earnings. The admin controls categories, pricing, commissions, promos, and dispute workflows.

Experience (E): Built from real booking flows—search → instant/slot booking → upfront pricing → live status → cashless payout—minimizing cart abandonment and boosting repeat bookings with subscriptions and smart re-engagement.

✨ Key Features

• 🧭 Geo-Discovery & Service Catalog: Location-aware categories, trending services, add-ons, bundles, and dynamic pricing.
• 📅 Slot/Instant Booking: Real-time provider availability, reschedule, cancellation windows, and surge/peak pricing rules.
• 👤 Two-Sided Marketplace: Separate roles for customers and service professionals with KYC/verification.
• 💬 In-App Chat & Calls: Pre-job messaging with photo sharing and masked numbers.
• 📍 Live Tracking: Provider arrival ETA, map navigation, and job status milestones.
• 💳 Payments & Wallet: Stripe/PayPal/Razorpay, cash on delivery, tips, coupons, referral credits, and partial pre-auth.
• 🧾 Invoices & Taxes: Auto GST/VAT calculation, promo proration, downloadable PDF invoices.
• ⭐ Ratings & Reviews: Post-job feedback, issue types, photo evidence, and dispute intake.
• 👥 Provider Tools: Earnings dashboard, payout requests, shift calendar, pause/online toggle.
• 🔔 Push & CRM: FCM notifications, abandoned-booking nudges, win-back campaigns, and deep links.
• 🌍 i18n & RTL: Multi-language, currency & unit localization, right-to-left UI support.
• 🛡️ Trust & Safety: KYC, document uploads, service area fencing, and admin moderation hooks.

⚙️ Technical Stack (Expertise)

• Android App: Kotlin, Material 3, Jetpack (ViewModel, LiveData/Flow, Navigation), Retrofit/OkHttp, Coroutines.
• Maps & Location: Google Maps SDK, Places/Geocoding APIs.
• Backend/Admin: Laravel 10 (PHP 8.1+) REST API, Blade/Tailwind admin, Policies/Gates, Queues (Redis/database).
• Database: MySQL 8 / MariaDB 10.6+, Eloquent ORM; Redis cache/queues (optional).
• Auth: JWT (mobile), Laravel Sanctum for admin; OTP/email verification.
• Notifications: Firebase Cloud Messaging (topics & device tokens).
• Payments: Stripe • Razorpay • PayPal (server-side intents).
• Server Requirements: Nginx/Apache, HTTPS/TLS 1.2+, PHP extensions: pdo_mysql, mbstring, curl, openssl, json, fileinfo.
• Build Tools: Android Studio (Iguana+), Gradle 8+, Composer 2.x; optional Docker for backend.

🧩 Installation Guide

1. Backend: Upload Laravel files → composer install → copy .env.example to .env → set DB, APP_URL, mail, payment keys.
2. Run php artisan key:generate → php artisan migrate --seed → php artisan storage:link.
3. Admin: Login, create service categories, add-ons, zones, taxes, and provider commission rules.
4. Android: Open project → set BASE_API_URL, Maps key, FCM keys, and payment publishable keys.
5. Branding: app name, packageId, icons, colors; configure deep links & notification channels.
6. Test bookings end-to-end on staging (customer ↔ provider ↔ admin). Build release AAB for Play Console.

📦 Deliverables

• ✅ Android customer app source (Kotlin) with booking, chat, tracking, payments.
• ✅ Laravel admin panel + REST API with roles (Admin, Manager, Provider).
• ✅ SQL schema, seed data, and Postman collection.
• ✅ Payment, coupons, wallet, and payout modules.
• ✅ Email/SMS templates, PDF invoice generator.
• ✅ Documentation & GPL v3 license file.

📱 Supported Platforms

• Android: 8.0 (API 26)+ phones & tablets.
• Admin: Web dashboard (Chrome, Edge, Safari, Firefox).
• Server: Ubuntu 22.04+ / cPanel / Docker-ready VPS with HTTPS.

👨‍💻 Original Developer Credit (Authoritativeness)

This redistribution credits the original commercial author on the marketplace. Support them via:
CodeCanyon – Original Author.

🔒 Disclaimer (Trustworthiness)

This software is redistributed under the GPL v3 for educational and lawful commercial reuse.
We are not affiliated with UrbanClap/Urban Company or any referenced brand. Ensure you have required business licenses,
provider contracts/insurance, and clear refund/cancellation policies. Remove demo data/keys and validate payments, taxes, and payouts before production launch.