# EventOS & Vendor/Staff Operations — User Manual

> **Platform Module:** EventOS Commercial Infrastructure  
> **Target Roles:** Event Organizers, Gate Staff, Vendors, and Venue Administrators  
> **Workspace URL:** `https://sponzar.africa/event-os`

---

## 1. Overview & Key Roles

**EventOS** is Sponzar's end-to-end event management, ticket issuance, vendor operations, gate entry scanning, and automated revenue settlement engine.

### Operational Roles
1. **Event Organizer**: Creates events, configures ticket tiers, sets sales quotas, manages payouts.
2. **Vendor / Exhibitor**: Operates food, beverage, or merchandise stalls, processes sales, tracks live revenue settlements.
3. **Gate Staff / Scanner Operator**: Uses mobile scanner app or web portal to scan attendee ticket QR codes at gate entrances.

---

## 2. Event Setup & Ticket Tier Management

### 2.1 Creating an Event
1. Log in to **EventOS Workspace** (`/event-os/admin`).
2. Click **Create New Event**.
3. Fill in Event Details:
   - Event Title & Cover Banner
   - Venue Name, Address, and GPS Location
   - Start Date & Time / End Date & Time
   - Event Category (Concert, Festival, Conference, Sports)
4. Click **Save Event**.

### 2.2 Configuring Ticket Tiers
1. Open your created event and go to **Ticket Tiers**.
2. Click **Add Tier**.
3. Configure Tier Specs:
   - Tier Name (e.g., `Early Bird GA`, `VIP Pass`, `Backstage VVIP`).
   - Price per Ticket (e.g., `$25.00`, `$100.00`).
   - Available Quantity / Capacity (e.g., `500`).
   - Max Tickets per User (e.g., `5`).
4. Click **Publish Tier**.

---

## 3. Vendor Portal & Staff Operations

### 3.1 Onboarding Vendors
1. Navigate to **EventOS → Vendors**.
2. Click **Add Vendor**.
3. Assign Vendor Name, Email, Category (Food & Beverage, Merchandise), and Commission Rate.
4. Vendor receives access credentials to access `/event-os/vendor/dashboard`.

### 3.2 Vendor Staff Management
1. Vendor logs into Vendor Dashboard.
2. Navigates to **Staff Management**.
3. Clicks **Add Staff Member** and issues PIN/Login for register operators.

### 3.3 Live Settlements & Payouts
1. Revenue collected from sales is tracked real-time in vendor balance.
2. Click **Request Settlement** under `/event-os/vendor/withdrawals`.
3. Funds transfer to linked bank account upon verification.

---

## 4. Gate Entry Scanning & Ticket Validation

### 4.1 Accessing the Gate Scanner App
Gate staff open the mobile-optimized scanner URL on any smartphone or tablet browser:
`https://sponzar.africa/event-os/scan`

### 4.2 Scanning QR Tickets
1. Staff logs in with Gate Staff credentials.
2. Point camera at attendee's digital or printed ticket QR code.
3. Instant Result Feedback:
   - 🟢 **VALID TICKET**: Displays Attendee Name, Tier (VIP/GA), and plays success chime.
   - 🔴 **ALREADY SCANNED**: Displays warning banner with timestamp of previous entry.
   - ⚠️ **INVALID TICKET**: Displays error warning banner.

---

## 5. Live Event Analytics & Post-Event Reconciliation

1. View **Real-Time Check-In Counter** on Event Dashboard.
2. Export Attendee Roster & Scan History (CSV/Excel).
3. View **Automated Financial Reconciliation**: Verifies total ticket revenue against gate entries and payouts.