How hersheywaffle/ticketbright-soen341_project_f25 works
TicketBright is a campus events and ticketing application for students, organizers, and administrators. The main user journey is event discovery followed by ticket claiming and venue check-in; organizers also create events and manage attendance, while administrators moderate users and events and oversee organizations and analytics. The backend is organized around Express routing, request controllers, and service/model or file-backed data operations. The README documents the product capabilities; some frontend-to-API wiring and unsampled feature implementations cannot be verified from the excerpts, so those links are omitted or marked unverified.
Main entry points: server.js Express application · eventCreateRoutes.js Event routes · eventCreateController.js Event operations · admin.routes.js Admin routes
Components 30
Student Experience
- Event discovery
src/frontend/search/event-search.js - Event details
src/frontend/event/script.js - Ticket claiming
src/frontend/purchase/purchase.js - Student features
src/frontend/js/student-features.js
Organizer Tools
- Event creation
src/frontend/create/event-create.js - Event analytics
src/frontend/analytics/analytics.js - Attendee export
src/backend/routes/attendeeCSVRoutes.js - QR check-in
src/backend/controllers/ticketValidationController.js
Administration
- Admin analytics
src/frontend/admin-analytics/adminAnalytics.js - Organizer approval
src/frontend/js/organizers-approval.js - Organization management
src/frontend/orgranization-management/orgManagement.js
Backend API
- Express application
src/backend/server.js - Event routes
src/backend/routes/eventCreateRoutes.js - Event operations
src/backend/controllers/eventCreateController.js - Admin routes
src/backend/routes/admin.routes.js - Admin operations
src/backend/controllers/admin.controller.js - Organization routes
src/backend/routes/organizations.routes.js - Organization operations
src/backend/controllers/organizations.controller.js - Check-in routes
src/backend/routes/ticketValidationRoutes.js - User routes
src/backend/routes/userRoutes.js - Chat routes
src/backend/routes/chat.routes.js
Data and Services
- Admin services
src/backend/services/admin.service.js - Organization services
src/backend/services/organizations.service.js - Chat service
src/backend/services/chat.service.js - Event records
src/backend/models/Event.js - User records
src/backend/models/user.js - SQLite database
src/backend/config/db.js
Other components
- Students
- Organizers
- Administrators
Connections 35
- Students → Event discovery: discover
README.md - Students → Ticket claiming: claim tickets
README.md - Organizers → Event creation: create events
README.md - Organizers → Event analytics: review metrics
README.md - Organizers → Attendee export: export attendees
README.md - Organizers → QR check-in: validate tickets
README.md - Administrators → Admin analytics: view statistics
README.md - Administrators → Organizer approval: review organizers
README.md - Administrators → Organization management: manage organizations
README.md - Event discovery → Event operations: search events
- Event details → Event operations: request event
- Ticket claiming → Student features: uses features
src/frontend/purchase/purchase.js - Event creation → Event routes: submit event
- Event analytics → Event routes: request metrics
- Admin analytics → Admin routes: request statistics
- Organizer approval → Admin routes: moderate accounts
- Organization management → Organization routes: manage organizations
- Express application → Event routes: mounts
src/backend/server.js - Express application → Admin routes: mounts
src/backend/server.js - Express application → Organization routes: mounts
src/backend/server.js - Express application → Check-in routes: mounts
src/backend/server.js - Express application → User routes: mounts
src/backend/server.js - Express application → Chat routes: mounts
src/backend/server.js - Event routes → Event operations: dispatches
src/backend/routes/eventCreateRoutes.js - Admin routes → Admin operations: dispatches
src/backend/routes/admin.routes.js - Organization routes → Organization operations: dispatches
src/backend/routes/organizations.routes.js - Check-in routes → QR check-in: dispatches
src/backend/routes/ticketValidationRoutes.js - Admin operations → Admin services: calls
src/backend/controllers/admin.controller.js - Organization operations → Organization services: calls
src/backend/controllers/organizations.controller.js - Chat routes → Chat service: routes through
- Event operations → Event records: reads and updates
src/backend/controllers/eventCreateController.js - Admin operations → Event records: queries
src/backend/controllers/admin.controller.js - Admin services → User records: reads and updates
src/backend/services/admin.service.js - User records → SQLite database: uses connection
src/backend/models/user.js - Express application → SQLite database: syncs
src/backend/server.js