# QR Bazar (Q-Bazaar) — G2 Blue Byte
Ethiopian multi-portal bazaar platform — buyers, sellers, organizers, gatekeepers & admins
QR tickets • Chapa payments • Cursor SDK assist • Offline-ready buyer flows
▶ Watch full system demo
•
Reviewer guide
•
Demo logins
---
> **Official G2 submission:** Ethiopian-Cursor-Community/G2-blue-byte — QR Bazar marketplace (G2 Blue Byte). See docs/G2_BLUE_BYTE_QR_BAZAR.md for reviewers.
---
# Q-Bazaar — Setup & Installation Guide
## Requirements
- XAMPP / WAMP / Laragon (PHP 8.0+ with MySQL)
- A modern browser (Chrome recommended for camera access)
## Quick Setup (3 steps)
### Step 1 — Place files
Copy the entire `QR BAZAR` folder into your XAMPP `htdocs` directory:
```
C:\xampp\htdocs\QR BAZAR\
```
### Step 2 — Import database
1. Start **Apache** and **MySQL** from XAMPP Control Panel
2. Open `
localhost`
3. Click **New** → create database named `qr_bazaar`
4. Select `qr_bazaar` → click **Import**
5. Choose `QR BAZAR/sql/schema.sql` → click **Go**
### Step 3 — Open the app
Visit: `
localhost BAZAR/`
---
## Demo Login Credentials
| Seller | Phone | Password |
|---|---|---|
| Abebe Girma (Vegetables) | 0911234567 | password |
| Tigist Bekele (Spices) | 0922345678 | password |
| Dawit Haile (Electronics) | 0933456789 | password |
| Marta Alemu (Clothing) | 0944567890 | password |
---
## Demo Flow (Hackathon Presentation)
1. Open `
localhost BAZAR/` — show the landing page
2. Register a new seller → get redirected to QR page
3. Go to **Products** → add some items
4. Open QR page → download or show QR on screen
5. Open `
localhost BAZAR/buyer/scan.php` in another tab
6. Click **"Demo Scan — Load Abebe's Market"**
7. Add items to cart → proceed with Chapa checkout → Confirm Payment
8. Receipt page appears — rate the seller
9. **Turn on Airplane Mode** (DevTools → Network → Offline)
10. Reload vendor page → it loads from cache! ← **WOW MOMENT** …