# hersheywaffle/ticketbright-soen341_project_f25 architecture

> Architecture diagram of the GitHub repository hersheywaffle/ticketbright-soen341_project_f25, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hersheywaffle/ticketbright-soen341_project_f25
- Repository: https://github.com/hersheywaffle/ticketbright-soen341_project_f25

## Overview

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: [`src/backend/server.js`](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/server.js) (Express application), [`src/backend/routes/eventCreateRoutes.js`](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/eventCreateRoutes.js) (Event routes), [`src/backend/controllers/eventCreateController.js`](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/controllers/eventCreateController.js) (Event operations), [`src/backend/routes/admin.routes.js`](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/admin.routes.js) (Admin routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student["Student Experience"]
  node_event_search["Event discovery<br/>[event-search.js]"]
  node_event_details["Event details<br/>[script.js]"]
  node_ticket_purchase["Ticket claiming<br/>[purchase.js]"]
  node_student_features["Student features"]
end

subgraph group_organizer["Organizer Tools"]
  node_event_creation["Event creation<br/>[event-create.js]"]
  node_event_analytics["Event analytics<br/>[analytics.js]"]
  node_attendee_tools["Attendee export"]
  node_ticket_checkin["QR check-in"]
end

subgraph group_admin["Administration"]
  node_admin_dashboard["Admin analytics<br/>[adminAnalytics.js]"]
  node_organizer_approval["Organizer approval"]
  node_organization_management["Organization management<br/>[orgManagement.js]"]
end

subgraph group_backend["Backend API"]
  node_server["Express application<br/>[server.js]"]
  node_event_routes["Event routes"]
  node_event_controller["Event operations"]
  node_admin_routes["Admin routes<br/>[admin.routes.js]"]
  node_admin_controller["Admin operations"]
  node_org_routes["Organization routes"]
  node_org_controller["Organization operations"]
  node_ticket_routes["Check-in routes"]
  node_user_routes["User routes<br/>[userRoutes.js]"]
  node_chat_routes["Chat routes<br/>[chat.routes.js]"]
end

subgraph group_data["Data and Services"]
  node_admin_service["Admin services<br/>[admin.service.js]"]
  node_org_service["Organization services"]
  node_chat_service["Chat service<br/>[chat.service.js]"]
  node_event_model[("Event records<br/>[Event.js]")]
  node_user_model[("User records<br/>[user.js]")]
  node_database[("SQLite database<br/>[db.js]")]
end

node_students(("Students"))
node_organizers(("Organizers"))
node_administrators(("Administrators"))

node_students -->|"discover"| node_event_search
node_students -->|"claim tickets"| node_ticket_purchase
node_organizers -->|"create events"| node_event_creation
node_organizers -->|"review metrics"| node_event_analytics
node_organizers -->|"export attendees"| node_attendee_tools
node_organizers -->|"validate tickets"| node_ticket_checkin
node_administrators -->|"view statistics"| node_admin_dashboard
node_administrators -->|"review organizers"| node_organizer_approval
node_administrators -->|"manage organizations"| node_organization_management
node_event_search -.->|"search events"| node_event_controller
node_event_details -.->|"request event"| node_event_controller
node_ticket_purchase -->|"uses features"| node_student_features
node_event_creation -.->|"submit event"| node_event_routes
node_event_analytics -.->|"request metrics"| node_event_routes
node_admin_dashboard -.->|"request statistics"| node_admin_routes
node_organizer_approval -.->|"moderate accounts"| node_admin_routes
node_organization_management -.->|"manage organizations"| node_org_routes
node_server -->|"mounts"| node_event_routes
node_server -->|"mounts"| node_admin_routes
node_server -->|"mounts"| node_org_routes
node_server -->|"mounts"| node_ticket_routes
node_server -->|"mounts"| node_user_routes
node_server -->|"mounts"| node_chat_routes
node_event_routes -->|"dispatches"| node_event_controller
node_admin_routes -->|"dispatches"| node_admin_controller
node_org_routes -->|"dispatches"| node_org_controller
node_ticket_routes -->|"dispatches"| node_ticket_checkin
node_admin_controller -->|"calls"| node_admin_service
node_org_controller -->|"calls"| node_org_service
node_chat_routes -.->|"routes through"| node_chat_service
node_event_controller -->|"reads and updates"| node_event_model
node_admin_controller -->|"queries"| node_event_model
node_admin_service -->|"reads and updates"| node_user_model
node_user_model -->|"uses connection"| node_database
node_server -->|"syncs"| node_database

click node_event_search "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/search/event-search.js"
click node_event_details "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/event/script.js"
click node_ticket_purchase "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/purchase/purchase.js"
click node_student_features "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/js/student-features.js"
click node_event_creation "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/create/event-create.js"
click node_event_analytics "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/analytics/analytics.js"
click node_attendee_tools "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/attendeeCSVRoutes.js"
click node_ticket_checkin "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/controllers/ticketValidationController.js"
click node_admin_dashboard "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/admin-analytics/adminAnalytics.js"
click node_organizer_approval "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/js/organizers-approval.js"
click node_organization_management "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/orgranization-management/orgManagement.js"
click node_server "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/server.js"
click node_event_routes "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/eventCreateRoutes.js"
click node_event_controller "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/controllers/eventCreateController.js"
click node_admin_routes "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/admin.routes.js"
click node_admin_controller "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/controllers/admin.controller.js"
click node_org_routes "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/organizations.routes.js"
click node_org_controller "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/controllers/organizations.controller.js"
click node_ticket_routes "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/ticketValidationRoutes.js"
click node_user_routes "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/userRoutes.js"
click node_chat_routes "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/chat.routes.js"
click node_admin_service "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/services/admin.service.js"
click node_org_service "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/services/organizations.service.js"
click node_chat_service "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/services/chat.service.js"
click node_event_model "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/models/Event.js"
click node_user_model "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/models/user.js"
click node_database "https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/config/db.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_event_search,node_event_details,node_ticket_purchase,node_student_features toneBlue
class node_event_creation,node_event_analytics,node_attendee_tools,node_ticket_checkin toneAmber
class node_admin_dashboard,node_organizer_approval,node_organization_management toneMint
class node_server,node_event_routes,node_event_controller,node_admin_routes,node_admin_controller,node_org_routes,node_org_controller,node_ticket_routes,node_user_routes,node_chat_routes toneRose
class node_admin_service,node_org_service,node_chat_service,node_event_model,node_user_model,node_database,node_students,node_organizers,node_administrators toneIndigo
```

## Components

### Student Experience

- [Event discovery](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/search/event-search.js): `src/frontend/search/event-search.js`
- [Event details](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/event/script.js): `src/frontend/event/script.js`
- [Ticket claiming](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/purchase/purchase.js): `src/frontend/purchase/purchase.js`
- [Student features](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/js/student-features.js): `src/frontend/js/student-features.js`

### Organizer Tools

- [Event creation](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/create/event-create.js): `src/frontend/create/event-create.js`
- [Event analytics](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/analytics/analytics.js): `src/frontend/analytics/analytics.js`
- [Attendee export](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/attendeeCSVRoutes.js): `src/backend/routes/attendeeCSVRoutes.js`
- [QR check-in](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/controllers/ticketValidationController.js): `src/backend/controllers/ticketValidationController.js`

### Administration

- [Admin analytics](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/admin-analytics/adminAnalytics.js): `src/frontend/admin-analytics/adminAnalytics.js`
- [Organizer approval](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/js/organizers-approval.js): `src/frontend/js/organizers-approval.js`
- [Organization management](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/frontend/orgranization-management/orgManagement.js): `src/frontend/orgranization-management/orgManagement.js`

### Backend API

- [Express application](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/server.js): `src/backend/server.js`
- [Event routes](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/eventCreateRoutes.js): `src/backend/routes/eventCreateRoutes.js`
- [Event operations](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/controllers/eventCreateController.js): `src/backend/controllers/eventCreateController.js`
- [Admin routes](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/admin.routes.js): `src/backend/routes/admin.routes.js`
- [Admin operations](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/controllers/admin.controller.js): `src/backend/controllers/admin.controller.js`
- [Organization routes](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/organizations.routes.js): `src/backend/routes/organizations.routes.js`
- [Organization operations](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/controllers/organizations.controller.js): `src/backend/controllers/organizations.controller.js`
- [Check-in routes](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/ticketValidationRoutes.js): `src/backend/routes/ticketValidationRoutes.js`
- [User routes](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/userRoutes.js): `src/backend/routes/userRoutes.js`
- [Chat routes](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/routes/chat.routes.js): `src/backend/routes/chat.routes.js`

### Data and Services

- [Admin services](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/services/admin.service.js): `src/backend/services/admin.service.js`
- [Organization services](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/services/organizations.service.js): `src/backend/services/organizations.service.js`
- [Chat service](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/services/chat.service.js): `src/backend/services/chat.service.js`
- [Event records](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/models/Event.js): `src/backend/models/Event.js`
- [User records](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/models/user.js): `src/backend/models/user.js`
- [SQLite database](https://github.com/hersheywaffle/ticketbright-soen341_project_f25/blob/main/src/backend/config/db.js): `src/backend/config/db.js`

### Other components

- **Students**
- **Organizers**
- **Administrators**

## Connections

- Students → Event discovery: discover (evidence: `README.md`)
- Students → Ticket claiming: claim tickets (evidence: `README.md`)
- Organizers → Event creation: create events (evidence: `README.md`)
- Organizers → Event analytics: review metrics (evidence: `README.md`)
- Organizers → Attendee export: export attendees (evidence: `README.md`)
- Organizers → QR check-in: validate tickets (evidence: `README.md`)
- Administrators → Admin analytics: view statistics (evidence: `README.md`)
- Administrators → Organizer approval: review organizers (evidence: `README.md`)
- Administrators → Organization management: manage organizations (evidence: `README.md`)
- Event discovery → Event operations: search events
- Event details → Event operations: request event
- Ticket claiming → Student features: uses features (evidence: `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 (evidence: `src/backend/server.js`)
- Express application → Admin routes: mounts (evidence: `src/backend/server.js`)
- Express application → Organization routes: mounts (evidence: `src/backend/server.js`)
- Express application → Check-in routes: mounts (evidence: `src/backend/server.js`)
- Express application → User routes: mounts (evidence: `src/backend/server.js`)
- Express application → Chat routes: mounts (evidence: `src/backend/server.js`)
- Event routes → Event operations: dispatches (evidence: `src/backend/routes/eventCreateRoutes.js`)
- Admin routes → Admin operations: dispatches (evidence: `src/backend/routes/admin.routes.js`)
- Organization routes → Organization operations: dispatches (evidence: `src/backend/routes/organizations.routes.js`)
- Check-in routes → QR check-in: dispatches (evidence: `src/backend/routes/ticketValidationRoutes.js`)
- Admin operations → Admin services: calls (evidence: `src/backend/controllers/admin.controller.js`)
- Organization operations → Organization services: calls (evidence: `src/backend/controllers/organizations.controller.js`)
- Chat routes → Chat service: routes through
- Event operations → Event records: reads and updates (evidence: `src/backend/controllers/eventCreateController.js`)
- Admin operations → Event records: queries (evidence: `src/backend/controllers/admin.controller.js`)
- Admin services → User records: reads and updates (evidence: `src/backend/services/admin.service.js`)
- User records → SQLite database: uses connection (evidence: `src/backend/models/user.js`)
- Express application → SQLite database: syncs (evidence: `src/backend/server.js`)
