eventhub-domain

name	eventhub-domain
description	EventHub application domain knowledge — business rules, API endpoints, data models, user flows, UI selectors, and error scenarios. Use when writing tests, reviewing code, creating scenarios, or answering questions about how EventHub works.
user-invocable	false

EventHub Domain Knowledge

Overview

EventHub is a full-stack event ticket booking platform. Users browse events, book tickets, and manage bookings. Each user operates in an isolated sandbox with limits on events and bookings.

Tech Stack

• Frontend: Next.js 14 (App Router), React 18, TypeScript, Tailwind CSS, React Query v5
• Backend: Express.js 4.21, Prisma ORM 5.22, MySQL 8+
• Auth: JWT (7-day expiry), bcryptjs password hashing
• Testing: Playwright (E2E), Chromium only
• API Docs: Swagger UI at /api/docs

Data Models

User

Field	Type	Notes
id	Int (PK)	Auto-increment
email	String	Unique
password	String	bcrypt hashed
events	Event[]	User's created events
bookings	Booking[]	User's bookings

Event

Field	Type	Notes
id	Int (PK)	Auto-increment
title	String	Required
description	Text	Optional
category	String	Conference/Concert/Sports/Workshop/Festival
venue	String	Required
city	String	Bangalore/Mumbai/Hyderabad/Delhi/Chennai
eventDate	DateTime	Must be future date
price	Decimal	Per ticket, >= 0
totalSeats	Int	>= 1
availableSeats	Int	Dynamic for user events
isStatic	Boolean	true = seeded event, immutable
userId	Int?	null for static events

Booking

Field	Type	Notes
id	Int (PK)	Auto-increment
eventId	Int (FK)	Cascade delete with Event
userId	Int (FK)	Cascade delete with User
customerName	String	Min 2 chars
customerEmail	String	Valid email format
customerPhone	String	Min 10 digits
quantity	Int	1-10 tickets
totalPrice	Decimal	price x quantity
status	String	Always "confirmed"
bookingRef	String	Unique, format: [FIRST_LETTER]-[6_RANDOM]

Detailed Knowledge (Sub-Files)

Load these based on what the current task needs:

• Business rules & validation logic → read ./business-rules.md
• API endpoints & error codes → read ./api-reference.md
• UI selectors for test automation → read ./ui-selectors.md
• User flows, test scenarios & test data → read ./user-flows.md