How wanabro227/eventsphere works
EventSphere is a web platform for venue and event management, ticket booking, QR-based entry validation, waitlists, and venue hire. The main attendee flow is authenticated booking through the API, agent-mediated availability handling, payment, and ticket generation; staff validate tickets separately. The graph also includes administration, notifications, and agent monitoring. Some capabilities are documented but their implementation was not sampled, so those links are documentation-based; unsampled internal call paths are not asserted.
Main entry points: main.py FastAPI application · message_bus.py Agent message bus · __init__.py Domain records · bookings.py Booking routes
Components 32
Web client
- EventSphere UI
frontend/js/events.js - API client
frontend/js/api.js - Admin UI
frontend/js/admin.js - Ticket scanner
frontend/js/scanner.js
API and access
- FastAPI application
backend/app/main.py - Authentication routes
backend/app/routers/auth.py - Identity and roles
backend/app/routers/dependencies.py - Authentication service
backend/app/services/auth_service.py - Password and JWT
backend/app/services/security_service.py
Booking and operations
- Booking routes
backend/app/routers/bookings.py - Ticket routes
backend/app/routers/tickets.py - Event routes
backend/app/routers/events.py - Venue routes
backend/app/routers/venues.py - Venue hire routes
backend/app/routers/venue_hire.py - Waitlist routes
backend/app/routers/waitlist.py - Administration
backend/app/routers/admin.py - Notifications
backend/app/routers/notifications.py - Payment simulation
backend/app/services/payment_service.py - QR generation
backend/app/services/qr_service.py
Agent system
- Booking agent
backend/app/agents/booking_agent.py - Ticket agent
backend/app/agents/ticket_agent.py - Waitlist agent
backend/app/agents/waitlist_agent.py - Notification agent
backend/app/agents/notification_agent.py - Agent message bus
backend/app/messaging/message_bus.py - Structured messages
backend/app/messaging/message.py - Agent activity logs
backend/app/routers/agent_logs.py
Persistence
- Database sessions
backend/app/database.py - Booking records
backend/app/models/booking.py - Domain records
backend/app/models/__init__.py
Other components
- Attendee
- Staff member
- Relational database
Connections 45
- Attendee → EventSphere UI: uses
- Staff member → Ticket scanner: validates tickets
- EventSphere UI → API client: requests API
- Admin UI → API client: requests API
- Ticket scanner → API client: requests API
- API client → FastAPI application: sends HTTP
- FastAPI application → Authentication routes: registers
backend/app/main.py - FastAPI application → Booking routes: registers
backend/app/main.py - FastAPI application → Ticket routes: registers
backend/app/main.py - FastAPI application → Event routes: registers
backend/app/main.py - FastAPI application → Venue routes: registers
backend/app/main.py - FastAPI application → Venue hire routes: registers
backend/app/main.py - FastAPI application → Waitlist routes: registers
backend/app/main.py - FastAPI application → Administration: registers
backend/app/main.py - FastAPI application → Notifications: registers
backend/app/main.py - FastAPI application → Agent activity logs: registers
backend/app/main.py - Authentication routes → Authentication service: calls
backend/app/routers/auth.py - Authentication routes → Password and JWT: creates token
backend/app/routers/auth.py - Authentication service → Password and JWT: hashes and checks
backend/app/services/auth_service.py - Booking routes → Identity and roles: requires user
backend/app/routers/bookings.py - Booking routes → Agent message bus: dispatches booking
backend/app/routers/bookings.py - Booking routes → Payment simulation: simulates payment
backend/app/routers/bookings.py - Booking routes → Agent message bus: requests ticket
backend/app/routers/bookings.py - Agent message bus → Booking agent: dispatches message
backend/app/messaging/message_bus.py - Agent message bus → Ticket agent: dispatches message
backend/app/messaging/message_bus.py - Agent message bus → Waitlist agent: dispatches message
backend/app/messaging/message_bus.py - FastAPI application → Agent message bus: registers agents
backend/app/main.py - Agent message bus → Agent activity logs: records exchanges
backend/app/messaging/message_bus.py - Waitlist routes → Agent message bus: dispatches request
backend/app/routers/waitlist.py - FastAPI application → Notification agent: registers agent
- Booking agent → Structured messages: handles messages
backend/app/agents/booking_agent.py - Waitlist agent → Structured messages: handles messages
backend/app/agents/waitlist_agent.py - Booking agent → Domain records: uses records
backend/app/agents/booking_agent.py - Waitlist agent → Domain records: uses records
backend/app/agents/waitlist_agent.py - Booking routes → Booking records: loads booking
backend/app/routers/bookings.py - Database sessions → Relational database: connects to
backend/app/database.py - Booking records → Database sessions: uses ORM base
backend/app/models/booking.py - Event routes → Domain records: queries records
backend/app/routers/events.py - Venue routes → Domain records: queries records
backend/app/routers/venues.py - Venue hire routes → Domain records: queries records
backend/app/routers/venue_hire.py - Ticket routes → Domain records: queries records
backend/app/routers/tickets.py - Administration → Domain records: manages records
backend/app/routers/admin.py - Notifications → Domain records: queries records
backend/app/routers/notifications.py - QR generation → Ticket agent: generates codes
- Notification agent → Notifications: supports notification flow