praxisjbs/Okveggies

E-commerce platform for food and distribution company, Nigeria # OK Veggies Lagos's trusted fresh-provisions partner, online. This repository is the website and back office for OK Veggies: a public storefront for households and businesses, a B2B Pro Portal, and a staff admin panel that runs the whole operation. **Sourced right. Priced right. Delivered right.** > **Start here.** If you are a person or an AI assistant about to build on this project, read this file, then read `CLAUDE.md` (how we work, non-negotiable), then read `docs/PRD.md` (what we are building). Do not write code before you have read the PRD. --- ## What this is OK Veggies sources fresh produce from verified farms in Ogun State and Jos and delivers it on the day the customer picks. The business already supplies restaurants, hotels and supermarkets over WhatsApp; this project opens it to households and turns the manual B2B service into software. See `docs/PRD.md` for the full picture. Three surfaces, one brand: | Surface | Path | For | |---|---|---| | Storefront | `/` | Everyone. Browse, combos, checkout | | Pro Portal | `/pro` | Logged-in B2B buyers. Saved kitchen lists, credit, standing orders | | Admin | `/admin` | Owner and Manager. Runs the business | ## Tech stack - **PHP 8.x** (pin to the host's version, target 8.3), plain and modular. No framework. - **MySQL / MariaDB** on cPanel shared hosting (phpMyAdmin). - **Tailwind CSS**, self-hosted and built (no CDN). Vanilla JavaScript with Fetch. No jQuery. - **Paystack** for payments. Money is stored in subunits (kobo) as integers, formatted by one `Money` helper. - **SMTP email** via PHPMailer. **dompdf** for invoices and receipts. **PhpSpreadsheet** for CSV / Excel import and export. Composer dependencies are committed in `vendor/` because the server has no Composer. - Architecture mirrors the reference project `bureau.lpc.cm`: an `index.php` front, `api/v1` controllers dispatched by action, `includes` for config / classes / functions / components, `modules` for feature pages, numbered SQL `migrati …