# QuickMunch — Restaurant Marketplace & Management Platform (Laravel)

A complete multi-restaurant food ordering, delivery and management platform:
a customer storefront (browse, order, reserve, loyalty), a full vendor
dashboard (menu, POS, kitchen pipeline, tables & QR dine-in, staff, analytics,
billing), a rider app surface, and a super-admin panel that runs the whole
marketplace — subscriptions, payouts, ads, CMS pages, design templates and
more. Built on Laravel with MySQL/MariaDB.

## Requirements

- PHP 8.2+ with `pdo_mysql`, `mbstring`, `openssl`, `gd`, `fileinfo`, `json`
  (`curl`, `zip` and `intl` recommended)
- MySQL 5.7+ / MariaDB 10.4+
- Apache with `mod_rewrite` (or an equivalent Nginx configuration)

## Installation

1. Upload the application and point your domain (or vhost) at the `public/`
   directory. On a shared host you can also upload it to a sub-folder — the
   bundled front-door `.htaccess` redirects visitors into `public/` for you.
2. Create an empty MySQL database.
3. Open your site in a browser — you are taken to the web installer, which
   checks the server, imports the database (with optional demo content),
   creates your admin account and writes the `.env` configuration.
4. Sign in at `/login` and work through **Get started** in the dashboard.

No command-line access is required. `composer install` and `npm` are NOT
needed — all dependencies and assets ship in the package.

## Demo content

Installing the optional demo data seeds restaurants, menus, orders and
one-click demo accounts (password `demo1234`): `vendor@example.com`,
`customer@example.com` and friends. Your own admin account (created by the
installer) always works; demo sign-ins are only shown while `DEMO_MODE` is
enabled.

## Scheduled tasks

Point a cron entry at the scheduler once per five minutes so background
housekeeping (abandoned orders, reports, drip emails) runs:

```
*/5 * * * * php /path/to/your/app/artisan schedule:run >> /dev/null 2>&1
```

Hosts without cron can use the authenticated web endpoint shown on
**Admin → Advanced → Scheduled tasks** instead.

## Documentation

The full buyer documentation ships in the `Documentation/` folder — open
`index.html` locally in any browser; every dashboard screen has its own
chapter.