# shettybro/vtufest architecture

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

- Interactive diagram: https://gitdiagram.com/shettybro/vtufest
- Repository: https://github.com/shettybro/vtufest

## Overview

VTU Youth Fest 2026 is a role-based React web portal for managing fest registrations and event-day operations. The documented core workflow moves student applications through manager curation, principal approval, administrative review and event assignment, then supports ID cards and volunteer QR scanning. Separate role portals cover payments, accommodation, transport, food, feedback and operational administration. The README documents the end-to-end workflow; sampled source confirms SPA routing, shared layout and UI state, and selected API-backed interactions. Other feature links are documented rather than verified in unsampled implementations.

Main entry points: [`src/routes/AppRoutes.jsx`](https://github.com/shettybro/vtufest/blob/main/src/routes/AppRoutes.jsx) (Role routing), [`src/pages/ManagerDashboard.jsx`](https://github.com/shettybro/vtufest/blob/main/src/pages/ManagerDashboard.jsx) (Manager workspace), [`src/pages/StudentRegister.jsx`](https://github.com/shettybro/vtufest/blob/main/src/pages/StudentRegister.jsx) (Student registration), [`src/pages/Approvals.jsx`](https://github.com/shettybro/vtufest/blob/main/src/pages/Approvals.jsx) (Manager review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_spa["Web application<br/>[App.jsx]"]
  node_routing["Role routing<br/>[AppRoutes.jsx]"]
  node_guards["Route guards<br/>[ProtectedRoute.jsx]"]
end

subgraph group_registration["Registration and approvals"]
  node_registration["Student registration"]
  node_application["Student application"]
  node_manager["Manager review<br/>[Approvals.jsx]"]
  node_principal["Principal approval"]
  node_fees["Fee payment<br/>[FeePayment.jsx]"]
end

subgraph group_operations["Fest operations"]
  node_admin["Fest administration<br/>[AdminDashboard.jsx]"]
  node_scheduling["Event assignment<br/>[AssignEvents.jsx]"]
  node_idcards["ID card portals"]
  node_scanning["Volunteer scanning<br/>[InEventScanner.jsx]"]
  node_transport["Transport logistics"]
  node_food["Food operations<br/>[FoodMeals.jsx]"]
end

subgraph group_portals["Role portals"]
  node_managerportal["Manager workspace"]
  node_eventmanager["Event manager<br/>[EMDashboard.jsx]"]
  node_dataadmin["Data administration<br/>[DAManagers.jsx]"]
  node_volunteers["Volunteer portal"]
  node_companion["Accompanist portal<br/>[CompanionHome.jsx]"]
end

subgraph group_shared["Shared services"]
  node_layout["Responsive layout<br/>[layout.jsx]"]
  node_onboarding["Onboarding tours"]
  node_feedback["Feedback forms<br/>[FeedbackForm.jsx]"]
end

node_participant(("Student / college"))
node_backend["Backend API"]

node_participant -->|"uses"| node_spa
node_spa -->|"renders routes"| node_routing
node_routing -->|"protects routes"| node_guards
node_routing -->|"routes to"| node_registration
node_routing -->|"routes to"| node_manager
node_routing -->|"routes to"| node_principal
node_routing -->|"routes to"| node_admin
node_participant -->|"registers"| node_registration
node_registration -->|"submits for review"| node_manager
node_manager -->|"curates for approval"| node_principal
node_principal -->|"submits for review"| node_admin
node_admin -->|"assigns events"| node_scheduling
node_scheduling -->|"enables generation"| node_idcards
node_idcards -->|"provides QR codes"| node_scanning
node_participant -->|"pays registration fee"| node_fees
node_managerportal -->|"renders within"| node_layout
node_managerportal -->|"renders tours"| node_onboarding
node_managerportal -->|"opens feedback"| node_feedback
node_layout -->|"fetches notifications"| node_backend
node_dataadmin -->|"requests manager data"| node_backend
node_eventmanager -.->|"uses role APIs"| node_backend
node_fees -.->|"uses payment APIs"| node_backend
node_transport -.->|"uses transport APIs"| node_backend
node_food -.->|"uses food APIs"| node_backend
node_volunteers -.->|"scans event QR"| node_scanning

click node_spa "https://github.com/shettybro/vtufest/blob/main/src/App.jsx"
click node_routing "https://github.com/shettybro/vtufest/blob/main/src/routes/AppRoutes.jsx"
click node_guards "https://github.com/shettybro/vtufest/blob/main/src/routes/ProtectedRoute.jsx"
click node_registration "https://github.com/shettybro/vtufest/blob/main/src/pages/StudentRegister.jsx"
click node_application "https://github.com/shettybro/vtufest/blob/main/src/pages/StudentApplication.jsx"
click node_manager "https://github.com/shettybro/vtufest/blob/main/src/pages/Approvals.jsx"
click node_principal "https://github.com/shettybro/vtufest/blob/main/src/pages/PrincipalDashboard.jsx"
click node_fees "https://github.com/shettybro/vtufest/blob/main/src/pages/FeePayment.jsx"
click node_admin "https://github.com/shettybro/vtufest/blob/main/src/pages/admin/AdminDashboard.jsx"
click node_scheduling "https://github.com/shettybro/vtufest/blob/main/src/pages/AssignEvents.jsx"
click node_idcards "https://github.com/shettybro/vtufest/blob/main/src/pages/idcard/IDCardTeamPortal.jsx"
click node_scanning "https://github.com/shettybro/vtufest/blob/main/src/pages/volunteer/InEventScanner.jsx"
click node_transport "https://github.com/shettybro/vtufest/blob/main/src/pages/transport/TransportDashboard.jsx"
click node_food "https://github.com/shettybro/vtufest/blob/main/src/pages/food/FoodMeals.jsx"
click node_managerportal "https://github.com/shettybro/vtufest/blob/main/src/pages/ManagerDashboard.jsx"
click node_eventmanager "https://github.com/shettybro/vtufest/blob/main/src/pages/em/EMDashboard.jsx"
click node_dataadmin "https://github.com/shettybro/vtufest/blob/main/src/pages/da/DAManagers.jsx"
click node_volunteers "https://github.com/shettybro/vtufest/blob/main/src/pages/volunteer/VolunteerPortal.jsx"
click node_companion "https://github.com/shettybro/vtufest/blob/main/src/pages/companion/CompanionHome.jsx"
click node_layout "https://github.com/shettybro/vtufest/blob/main/src/components/layout/layout.jsx"
click node_onboarding "https://github.com/shettybro/vtufest/blob/main/src/context/OnboardingContext.jsx"
click node_feedback "https://github.com/shettybro/vtufest/blob/main/src/components/feedback/FeedbackForm.jsx"

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_spa,node_routing,node_guards toneBlue
class node_registration,node_application,node_manager,node_principal,node_fees toneAmber
class node_admin,node_scheduling,node_idcards,node_scanning,node_transport,node_food,node_backend toneMint
class node_managerportal,node_eventmanager,node_dataadmin,node_volunteers,node_companion toneRose
class node_layout,node_onboarding,node_feedback,node_participant toneIndigo
```

## Components

### Application shell

- [Web application](https://github.com/shettybro/vtufest/blob/main/src/App.jsx): `src/App.jsx`
- [Role routing](https://github.com/shettybro/vtufest/blob/main/src/routes/AppRoutes.jsx): `src/routes/AppRoutes.jsx`
- [Route guards](https://github.com/shettybro/vtufest/blob/main/src/routes/ProtectedRoute.jsx): `src/routes/ProtectedRoute.jsx`

### Registration and approvals

- [Student registration](https://github.com/shettybro/vtufest/blob/main/src/pages/StudentRegister.jsx): `src/pages/StudentRegister.jsx`
- [Student application](https://github.com/shettybro/vtufest/blob/main/src/pages/StudentApplication.jsx): `src/pages/StudentApplication.jsx`
- [Manager review](https://github.com/shettybro/vtufest/blob/main/src/pages/Approvals.jsx): `src/pages/Approvals.jsx`
- [Principal approval](https://github.com/shettybro/vtufest/blob/main/src/pages/PrincipalDashboard.jsx): `src/pages/PrincipalDashboard.jsx`
- [Fee payment](https://github.com/shettybro/vtufest/blob/main/src/pages/FeePayment.jsx): `src/pages/FeePayment.jsx`

### Fest operations

- [Fest administration](https://github.com/shettybro/vtufest/blob/main/src/pages/admin/AdminDashboard.jsx): `src/pages/admin/AdminDashboard.jsx`
- [Event assignment](https://github.com/shettybro/vtufest/blob/main/src/pages/AssignEvents.jsx): `src/pages/AssignEvents.jsx`
- [ID card portals](https://github.com/shettybro/vtufest/blob/main/src/pages/idcard/IDCardTeamPortal.jsx): `src/pages/idcard/IDCardTeamPortal.jsx`
- [Volunteer scanning](https://github.com/shettybro/vtufest/blob/main/src/pages/volunteer/InEventScanner.jsx): `src/pages/volunteer/InEventScanner.jsx`
- [Transport logistics](https://github.com/shettybro/vtufest/blob/main/src/pages/transport/TransportDashboard.jsx): `src/pages/transport/TransportDashboard.jsx`
- [Food operations](https://github.com/shettybro/vtufest/blob/main/src/pages/food/FoodMeals.jsx): `src/pages/food/FoodMeals.jsx`

### Role portals

- [Manager workspace](https://github.com/shettybro/vtufest/blob/main/src/pages/ManagerDashboard.jsx): `src/pages/ManagerDashboard.jsx`
- [Event manager](https://github.com/shettybro/vtufest/blob/main/src/pages/em/EMDashboard.jsx): `src/pages/em/EMDashboard.jsx`
- [Data administration](https://github.com/shettybro/vtufest/blob/main/src/pages/da/DAManagers.jsx): `src/pages/da/DAManagers.jsx`
- [Volunteer portal](https://github.com/shettybro/vtufest/blob/main/src/pages/volunteer/VolunteerPortal.jsx): `src/pages/volunteer/VolunteerPortal.jsx`
- [Accompanist portal](https://github.com/shettybro/vtufest/blob/main/src/pages/companion/CompanionHome.jsx): `src/pages/companion/CompanionHome.jsx`

### Shared services

- [Responsive layout](https://github.com/shettybro/vtufest/blob/main/src/components/layout/layout.jsx): `src/components/layout/layout.jsx`
- [Onboarding tours](https://github.com/shettybro/vtufest/blob/main/src/context/OnboardingContext.jsx): `src/context/OnboardingContext.jsx`
- [Feedback forms](https://github.com/shettybro/vtufest/blob/main/src/components/feedback/FeedbackForm.jsx): `src/components/feedback/FeedbackForm.jsx`

### Other components

- **Student / college**
- **Backend API**

## Connections

- Student / college → Web application: uses
- Web application → Role routing: renders routes (evidence: `src/App.jsx`)
- Role routing → Route guards: protects routes (evidence: `src/routes/AppRoutes.jsx`)
- Role routing → Student registration: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Role routing → Manager review: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Role routing → Principal approval: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Role routing → Fest administration: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Student / college → Student registration: registers
- Student registration → Manager review: submits for review
- Manager review → Principal approval: curates for approval
- Principal approval → Fest administration: submits for review
- Fest administration → Event assignment: assigns events
- Event assignment → ID card portals: enables generation
- ID card portals → Volunteer scanning: provides QR codes
- Student / college → Fee payment: pays registration fee
- Manager workspace → Responsive layout: renders within (evidence: `src/pages/ManagerDashboard.jsx`)
- Manager workspace → Onboarding tours: renders tours (evidence: `src/pages/ManagerDashboard.jsx`)
- Manager workspace → Feedback forms: opens feedback (evidence: `src/pages/ManagerDashboard.jsx`)
- Responsive layout → Backend API: fetches notifications (evidence: `src/components/layout/layout.jsx`)
- Data administration → Backend API: requests manager data (evidence: `src/pages/da/DAManagers.jsx`)
- Event manager → Backend API: uses role APIs
- Fee payment → Backend API: uses payment APIs
- Transport logistics → Backend API: uses transport APIs
- Food operations → Backend API: uses food APIs
- Volunteer portal → Volunteer scanning: scans event QR
