# Zavvion Events Project Brief

Zavvion Events is a premium, mobile-first event ticketing marketplace for customers, organisers, staff, and platform admins.

## Core Outcomes

- Customers discover events, select seats or ticket types, pay, receive QR tickets, and attend.
- Organisers apply, onboard, connect Stripe, publish events, manage venues, seats, tickets, products, donations, promos, staff, orders, scanners, and reports.
- Platform admins approve organisers, configure roles, fees, taxes, settings, content, payments, compliance, and audit activity.

## Primary Architecture

Use PHP 8.2+, Yii 3 packages, MySQL/XAMPP, Apache, MVC, REST APIs, Bootstrap 5, Composer, services, repositories, dependency injection, and vanilla JavaScript/SVG/Canvas for seat maps.

## Highest-Risk Domains

- RBAC with organiser and event scope
- Seat holds and double-booking prevention
- Stripe Connect payment confirmation and webhooks
- Fee/tax calculation and ledger accuracy
- QR ticket validation and offline scanner sync
- Privacy, audit logs, upload safety, and secret management

## Milestones

1. Foundation: Yii 3 setup, config, routing, auth, RBAC, seed admin.
2. Marketplace: organiser applications, events, venues, seat maps, ticket types.
3. Ticket purchase: event browsing, seat selection, checkout, orders, tickets, QR.
4. Payments: gateway abstraction, Stripe Connect, fee/tax, webhooks, ledger.
5. Operations: scanner, offline sync, box office, attendee imports, promos, merchandise, donations.
6. Admin/compliance: dashboards, reports, privacy tools, audit logs, settings, docs, tests.