Arsaa Food Delivery

Highlights - 4 portals in one system: Customer / Merchant / Rider / Admin back office - Multi-country, multi-service-area and multi-language (Thai / English / Lao) - Real-time updates — new orders appear on the restaurant screen in about 1 second - Works instantly in any web browser, plus native Android apps - Full REST API with documentation for mobile apps and third-party integration 1) Customer (Web + Android app) ------------------------------- - Automatic service-area detection by GPS, or manual selection - Home page with promotional banners, food categories and nearby restaurants (open/closed status and distance) - Browse restaurants and menus without signing up - Menu options and add-ons (spice level, toppings, size) — single or multiple choice - Shopping cart with a price and delivery-fee quote before ordering - Multiple saved addresses with map pin - Discount codes: percentage off / fixed amount off / free delivery - Payment: Cash on Delivery (COD) and PromptPay QR - Live order tracking with status steps and rider location on the map (updates without page refresh) - Photo proof of delivery from the rider - Order cancellation according to the rules - Rate and review the restaurant and rider (1–5 stars) - Favorite restaurants / order history / notification bell - Sign up / log in / forgot password 2) Merchant (Web, tablet-friendly for the shop counter) ------------------------------------------------------- - Self-service restaurant sign-up (pin location, admin approval) - Today's dashboard: sales, order count and orders in progress - Order board by status — new orders pop up instantly with sound alerts - One-click Accept → Start preparing → Ready for pickup → Cancel - Open/close the shop and set daily business hours - Menu management: name, price, photo, category, option groups, and quick "sold out" toggle - Restaurant profile and logo, multi-branch support (switch branches) - Staff management with owner / staff permissions - Daily/monthly sales reports (charts), best-selling items, payout per order - Daily report with CSV export and print - View and reply to customer reviews - Order map with live rider location 3) Rider (Mobile web) --------------------- - Self-service rider sign-up (admin approval) - Toggle Available / Offline - Job offers with countdown timer — accept or decline - "Open jobs near you" — riders can claim jobs themselves (can be switched off) - Notified as soon as the restaurant accepts the order, so riders arrive when the food is ready - Job flow: Picked up → Delivering → Delivered (confirm cash received for COD) - Navigation map to the restaurant and drop-off; GPS location shared automatically with the customer - Photo proof of delivery using the phone camera - Job history, daily/monthly earnings and COD cash to be remitted - Profile and vehicle information 4) Admin back office -------------------- - Overview dashboard with sales, orders and charts - Manage countries / service areas (radius) / delivery fee zones - Manage restaurants, merchant accounts, riders, customers and admin users - Approve restaurant and rider applications (with sign-up notifications) - View and manage all orders with a live tracking map - Payment management - Discount codes with usage limits and expiry dates - Home page banners and categories - Hide/show reviews - Daily report: hourly summary, by payment method, by restaurant, by rider + COD cash each rider must remit (CSV export / print) - System settings from the screen (no code changes needed) - Audit log — see who changed what and when - 6 roles: Super Admin / Area Admin / Merchant Owner / Merchant Staff / Rider / Customer — Area Admins only see data in their own area 5) Pricing, fees and finance ---------------------------- - Distance-based delivery fee with per-zone settings: base fee, price per km, free distance, minimum/maximum fee, free-delivery zones - Two-level restaurant commission: per service area or per restaurant (percentage / fixed amount / none) - Rider share of the delivery fee with a guaranteed minimum per trip (riders still earn on free-delivery orders) - Price snapshot at order time — later price changes never affect past orders - Reports split into platform / restaurant / rider revenue, consistent everywhere 6) Technology & security ------------------------ - Backend: Laravel 12 (PHP 8.3) + PostgreSQL - Real-time: Laravel Reverb (WebSocket) with built-in polling fallback - Maps: Leaflet / OpenStreetMap (no map API fees) - Mobile apps: native Android (Kotlin + Jetpack Compose) - REST API (JWT) with OpenAPI documentation - Old tokens are revoked on password change, rate limiting, strict data isolation between restaurants and service areas - Pluggable payment gateway architecture for adding new payment methods - Automated test suite (feature tests + E2E) and a server deployment guide