1. Project Overview Full development of a service & product marketplace mobile application including users, sellers, service providers, admin panel, negotiation system, real-time location, escrow payments, wallet system, refunds, and full deployment to both App Store & Play Store. Sanayie Masr mobile application, including: ● iOS & Android Applications ● Provider/Seller & User flows ● Escrow-based payment system ● Real-time tracking ● Profile switching ● Admin dashboard ● KYC, disputes, analytics, and advanced payment/refund logic 2. Roles in the System The platform will include three user roles, all accessible from a single account via profile switching: 1. User (Customer) 2. Service Provider 3. Seller (Product Provider) 3. Updated Feature Scope (Including New Requirements) 3.1 Common Features (All Roles) ● Secure Registration/Login (Email, Phone, Google) ● OTP Login (Optional) ● Automated KYC verification ● Profile switching (User ↔ Provider ↔ Seller) ● Arabic (Default) + English ● Push Notifications ● Wallet + Escrow System ● Orders/Bookings History ● Ratings & Reviews ● In-app Chat ● Real-time system status updates ● Multi-location support for users ● Photo/video upload for consultations ● Location auto-detection 3.2 Updated Payment, Escrow & Refund System 1. Escrow Release Logic ● User must confirm before payment is released ● Automatic release after 24–48 hours if the user does not respond 2. Completion Proof Requirement Provider/Seller must upload: ● Photo ● Short video ● Or text note before marking the order as Completed. 3. Safety Delay Before Payout ● Funds move from escrow to provider/seller wallet after a 1-hour security delay 4. Wallet System (3-Wallet Architecture) 1. User Wallet 2. Provider/Seller Wallet (released funds) 3. Withdrawal Wallet (withdrawable balance) 5. Withdrawal Security ● OTP verification before withdrawal ● Minimum withdrawal rule ● No admin approval required (fully automated) 6. Partial Refund Logic ● Provider receives notification and response window ● If provider does not respond → auto-refund rules apply 7. Dispute Evidence Upload ● Both client and provider/seller can upload photos/videos/notes 8. Status Timestamps Each stage is time-logged: ● Accepted ● On the Way ● Arrived ● Completed 9. Provider/Seller Payout Report A simple dashboard showing: ● Total earnings ● Pending earnings ● Released earnings ● Withdrawals ● Commission deducted 10. Cancellation & No-Show Rules ● Provider cancels → instant refund ● User cancels late → partial refund ● Provider no-show → refund to user Optional ● Admin control for commission percentages 3.3 User Flow (Customer) 1. Onboarding → Select language 2. Search services/products 3. Map-based results (nearby providers) 4. Filtering by rating, distance, top-performer badges 5. Booking service or purchasing product 6. Payment via Escrow 7. Real-time order tracking (Preparing → On the Way → Delivered) 8. Upload photo for consultation (optional) 9. Rate and review after completion 10. Switch to Seller/Provider if needed 3.4 Service Provider Flow 1. Complete KYC 2. Add services, pricing, availability 3. Receive bookings → Accept/Reject 4. Upload completion proof 5. Track order statuses 6. Earnings → Wallet → Withdrawal 7. Manage disputes 8. Access payout report 3.5 Seller (Product Provider) Flow 1. Setup store profile 2. Add/edit products 3. Receive orders 4. Update statuses (Preparing → On the Way → Delivered) 5. Upload proof of delivery 6. Manage inventory 7. Earnings report + withdrawal 3.6 Admin Panel (Web-Based) ● User, provider & seller management ● KYC verification ● Dispute center ● Category, banners, home page CMS ● Payment & escrow monitoring ● Refund/cancellation logic ● Analytics for sellers/providers ● Admin commission control ● Multi-location management 4.1 Negotiation System (NEW) ● Providers can propose prices. ● Clients can counter-offer. ● Chat-based negotiation until both agree. ● Final accepted price stored in order details. 4.2 Escrow Release Logic (NEW) ● Payment held in escrow. ● User confirmation before releasing payment. ● Auto-release after 24–48 hours if user does not respond. 4.3 Completion Proof (NEW) ● Provider must upload: - Photo OR -Short video OR -Text note Before order can be marked Completed. 4.4 Safety Delay Before Payout ● 1-hour auto-delay after completion before funds move to provider wallet. 4.5 Multi-Wallet Structure ● User Wallet ● Provider/Seller Wallet (Released Funds) ● Withdrawal Wallet 4.6 Withdrawal Security ● OTP verification before withdrawal. ● Minimum withdrawal amount. ● Instant withdrawal to bank/wallet after OTP verification. ● No admin approval required. 4.7 Partial Refund & Dispute System ● Provider notified. ● If no reply → automatic refund rules apply. ● Both sides can upload images/videos/notes. ● Admin can finalize disputes. 4.8 Real-Time Status Timestamps ● Accepted ● On the Way ● Arrived ● Completed 4.9 Payout Report (Provider Dashboard) Shows: ● Total earnings ● Pending earnings ● Released earnings ● Withdrawals ● Commission deductions 4.10 Cancellations & No-Show Rules ● Provider cancels → auto refund ● User cancels late → partial refund ● Provider no-show → full refund to user 4.11 Optional Features Included ● OTP login ● Admin can change commission % 5. Timeline & Milestones (As Discussed) 6. TECHNICAL STACK Mobile App ● Flutter (iOS + Android) Backend ● Laravel ● REST APIs Database ● MySQL Hosting ● VPS or Cloud Hosting (Client-provided) ● Admin panel + API deployment included 7. Maintenance Type Duration Cost Includes Standard Maintenance 3 months Free Bug fixes, server support, stability updates 8. MULTI-BRANCH & MULTI-LOCATION SUPPORT ● Sellers & Providers can add multiple branches. ● Clients can add multiple residential locations. ● Real-time GPS detection for nearest branch. Search results automatically sort by nearest provider. 9. APP STORE SUBMISSION (DEVELOPER RESPONSIBLE) will handle: ● Play Store submission ● App Store submission ● Fixing any rejections ● Resubmitting until both apps are fully approved 10. SYSTEM SCALABILITY & PERFORMANCE CLAUSE The developer shall design and implement the system architecture, backend, database, and server configuration in a scalable manner capable of supporting future growth in users, service providers, products, orders, media uploads, and overall system traffic without performance degradation. The developer shall ensure database optimization, caching, efficient API structure, and compatibility with vertical and horizontal scaling on cloud hosting. The system must be able to expand in capacity without requiring redevelopment of core components. 2. ADVERTISING BANNERS & DYNAMIC SLIDESHOW CLAUSE The home page of the mobile applications and admin-controlled CMS shall include a dynamic slideshow (carousel) system for displaying multiple banners, promotional offers, services, and advertisements. The admin shall have full control from the dashboard to: 1. Upload and edit banners (images/videos) 2. Add unlimited slides 3. Reorder slides 4. Activate or deactivate slides 5. Schedule banners with start and end dates 6. Optionally assign banners to specific categories or products The system shall support paid advertisements and promotional placements for future monetization. 3. FUTURE ADVERTISING EXPANSION CLAUSE (Optional) The platform shall be built to support future advertising modules, including sponsored products, promoted service providers, and paid homepage placements, without requiring major restructuring.