CLOUD POS & INVENTORY — MULTI-BUSINESS, MULTI-BRANCH WEB APP
=============================================================

WHAT IT IS
You sell this software to shops. Each shop (a "customer" / business):
  1. registers on your website and chooses a plan,
  2. pays with OPay, Moniepoint, or a bank transfer + uploaded receipt,
  3. is activated (automatically for OPay / Moniepoint, or when you approve
     the receipt in Admin -> Payments),
  4. then gets its own Dashboard, Inventory, POS, branches, staff and reports.
When the subscription ends the business is locked to the renewal page (its
data is kept). Renewals add the days on top of the current end date.

THREE AREAS
- Website (index.php): homepage, pricing (from your plans), FAQ, contact form,
  register, sign in. Installable as an app (PWA) on phones and PCs.
- Admin panel (/admin): YOU. Customers, payment approvals, plans, OPay /
  Moniepoint keys, bank accounts, website text, logo & colours, emails.
- Business app (/app): each shop's owner and staff.

BUSINESS APP FEATURES
Dashboard · POS (barcode scan, categories/brands, hold orders, cash / transfer
/ POS-terminal payment, change, 80mm receipt with barcode, calculator, works on
phone and tablet) · Products, categories, brands, units, CSV import/export ·
Print barcode labels (A4 sheets or label roll) · Multi-branch / warehouse stock ·
Purchases & suppliers · Stock adjustments · Branch transfers · Sales, invoices,
part payments and customer credit · Sales returns · Expenses · Customers ·
Reports (sales, profit & loss, stock, stock alerts, best sellers, purchases,
branches, cashiers) · Staff users limited to one branch · Roles & permissions ·
Business settings (logo, receipt text, tax, POS rules) · Subscription & invoices.
Plans decide branches / products / users and which features a business gets.

INSTALL (cPanel)
1. cPanel -> MySQL Databases: create a database and a user, add the user to the
   database with ALL PRIVILEGES.
2. Upload the zip to public_html (or a sub-folder / sub-domain) and extract.
3. Open the website. The installer asks for the database, your platform name and
   your Super Admin login, then builds all tables by itself.
4. Sign in at  yoursite.com/admin  and do the setup checklist on the dashboard:
   - Website & Branding: logo, colour, phone, WhatsApp, address.
   - OPay, Moniepoint & Bank: paste your API keys, switch them on, add your
     bank account(s). Copy the webhook URLs shown there into the OPay and
     Moniepoint dashboards.
   - Plans & Pricing: set prices, limits and features (weekly / monthly /
     quarterly / yearly; optional free-trial days).
   - Email & System: SMTP details so welcome, payment and password emails go out.
Requirements: PHP 8.1+ with PDO MySQL, cURL, GD, mbstring; MySQL 5.7/8 or MariaDB 10.3+.
Use HTTPS (free SSL in cPanel) — needed for payments and to install the app.

UPDATING LATER
Upload the new zip over the old files. config/config.php and uploads/ are not
in the zip, so nothing is lost. The database updates itself the first time a
page is opened (Admin -> Email & System shows the database status).
