Ticket Management

Configure ticket types and pricing for your events with flexible options for different attendee categories.

Capabilities

Action	ROLE_CLIENT_ADMIN	ROLE_CLIENT_USER
View ticket types	✅	✅
Create ticket types	✅	❌
Edit pricing	✅	❌
Set capacity	✅	❌
View sales	✅	✅

Features

Ticket Types

Create multiple ticket types per event:

Acceptance Criteria

Frontend

• Ticket type list per event
• Create/edit ticket form
• Price calculator with tax preview
• Availability date pickers
• Capacity allocation interface
• Sales progress visualization
• Promo code management
• Waitlist management
• Sales export

Backend / API

• Backend behavior supports this feature as documented.

Permissions

• Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

Business Rules

• Ticket price cannot be negative
• Cannot delete ticket type with existing sales
• Quantity must be positive integer
• Sales end date cannot be after event start
• Promo codes must be unique per event
• Waitlist entries processed FIFO when capacity opens

Error Handling

• Error states return clear messages and appropriate HTTP status codes.

Ticket Configuration

1. Basic Details
   • Ticket name
   • Description
   • Price (or free)
2. Availability
   • Quantity available
   • Sales start date
   • Sales end date
   • Visibility (public/hidden)
3. Restrictions
   • Member-only purchase
   • Maximum per order
   • Minimum per order
   • Promo code eligibility

Acceptance Criteria

Frontend

• UI supports the workflows described in this feature.

Backend / API

• Backend behavior supports this feature as documented.

Permissions

• Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

Business Rules

• All business rules for this feature are enforced.

Error Handling

• Error states return clear messages and appropriate HTTP status codes.

UI Spec (from supplied spreadsheet)

The following ticket fields are sourced from workspace/sources/entity-registry.csv ("Events" → ticket section).

Field	Input Type	Required	Notes
Ticket Name	Text	Required	model: ticketName
Ticket Description	Text	Required	model: ticketDescription
Ticket Price	Number	Required	model: ticketPrice
Members Only	Checkbox	Required	model: memberOnly
Members Discount	Number	Required	model: memberDiscount
Ticket Qty	Number	Required	model: ticketQuantity
Ticket Purchase Limit	Number	Not Required	model: ticketPurchaseLimit
GL Code	Text	Required	model: glCode
Sales Start Date / Time	Date + Text	Not Required	model: start
Sales End Date / Time	Date + Text	Not Required	model: end
Ticket Notes	Text	Not Required	model: ticketNote

Spreadsheet behavior notes:

• If Free Event is enabled on the event, the ticket section does not appear.

Data Model Cross‑Reference (Entities)

• Event definition: Event
• Purchased tickets / registrations and check-in state: Event Ticket

Pricing Options

Feature	Description
Base Price	Standard ticket price
Member Discount	Automatic discount for members
Early Bird	Time-limited reduced price
Promo Codes	Discount codes for special offers
Group Pricing	Bulk discount for multiple tickets
Tax	Add tax to ticket price

Acceptance Criteria

Frontend

• Pricing Options workflow is implemented in the UI as described.

Backend / API

• Backend behavior supports Pricing Options as documented.

Permissions

• Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

Business Rules

• All business rules for this feature are enforced.

Error Handling

• Error states return clear messages and appropriate HTTP status codes.

Capacity Management

• Set total event capacity
• Allocate capacity per ticket type
• Waitlist when sold out
• Real-time availability updates

Acceptance Criteria

Frontend

• Capacity Management workflow is implemented in the UI as described.

Backend / API

• Backend behavior supports Capacity Management as documented.

Permissions

• Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

Business Rules

• All business rules for this feature are enforced.

Error Handling

• Error states return clear messages and appropriate HTTP status codes.

Implementation Contracts

Backend (API)

GET    /api/events/{id}/tickets              # List ticket types
POST   /api/events/{id}/tickets              # Create ticket type
GET    /api/events/{id}/tickets/{ticketId}   # Get ticket details
PUT    /api/events/{id}/tickets/{ticketId}   # Update ticket
DELETE /api/events/{id}/tickets/{ticketId}   # Delete ticket type

GET    /api/events/{id}/tickets/sales        # Sales summary
GET    /api/events/{id}/tickets/attendees    # List attendees

POST   /api/events/{id}/promo-codes          # Create promo code
GET    /api/events/{id}/promo-codes          # List promo codes
DELETE /api/events/{id}/promo-codes/{code}   # Delete promo code

GET    /api/events/{id}/waitlist             # Waitlist entries
POST   /api/events/{id}/waitlist/notify      # Notify waitlist

Data Model

interface TicketType {
  id: string;
  eventId: string;
  name: string;
  description: string;
  price: number;
  quantity: number;
  quantitySold: number;
  
  // Availability
  salesStartDate: string;
  salesEndDate: string;
  visible: boolean;
  
  // Restrictions
  memberOnly: boolean;
  maxPerOrder: number;
  minPerOrder: number;
  
  createdAt: string;
  updatedAt: string;
}

interface PromoCode {
  id: string;
  eventId: string;
  code: string;
  discountType: 'percentage' | 'fixed';
  discountValue: number;
  maxUses?: number;
  usedCount: number;
  validFrom: string;
  validTo: string;
  ticketTypes?: string[]; // Applicable ticket types
}

interface TicketPurchase {
  id: string;
  ticketId: string;
  eventId: string;
  purchaserId: string;
  purchaserName: string;
  purchaserEmail: string;
  quantity: number;
  unitPrice: number;
  totalPrice: number;
  promoCode?: string;
  discountAmount: number;
  qrCode: string;
  status: 'valid' | 'used' | 'refunded' | 'cancelled';
  purchasedAt: string;
}

Error Handling

Error	HTTP Status	Message
Sold out	400	"Tickets are sold out"
Invalid quantity	400	"Exceeds maximum tickets per order"
Invalid promo	400	"Promo code is invalid or expired"
Sales closed	400	"Ticket sales have ended"
Has sales	400	"Cannot delete ticket type with existing sales"