# coding-pundit-nitap/addovedi-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/coding-pundit-nitap/addovedi-2026
- Repository: https://github.com/coding-pundit-nitap/addovedi-2026

## Overview

Tech Fest is an immersive event website with public event, timeline, crew, sponsor, and contact experiences, plus participant registration and an admin portal. The principal flow is a visitor entering through the React routes, browsing the site, and submitting participant or event-registration data to the Express API. The backend routes requests through controllers and services to MongoDB-backed models. The graph also preserves admin, upload, and audit capabilities. Several page and server modules were not sampled; their edges are omitted or marked unverified where appropriate.

Main entry points: [`server/routes/index.js`](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/routes/index.js) (API routes), [`client/src/routes/AppRoutes.jsx`](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/routes/AppRoutes.jsx) (Page routes), [`client/src/App.jsx`](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/App.jsx) (Application shell), [`client/src/constants/api.js`](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/constants/api.js) (API settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Application shell<br/>[App.jsx]"]
  node_routes["Page routes<br/>[AppRoutes.jsx]"]
  node_store["UI state<br/>[useStore.js]"]
  node_hero["3D home<br/>[HeroCanvas.jsx]"]
end

subgraph group_domain["Event domains"]
  node_events_ui["Event browser<br/>[EventsPage.jsx]"]
  node_timeline_ui["Timeline<br/>[TimelinePage.jsx]"]
  node_crew_ui["Crew directory<br/>[CrewPage.jsx]"]
  node_alliances_ui["Alliances<br/>[AlliancesPage.jsx]"]
  node_connect_ui["Contact<br/>[ConnectPage.jsx]"]
  node_portal_ui["Participant portal<br/>[PortalPage.jsx]"]
  node_admin_ui["Admin portal<br/>[AdminPage.jsx]"]
end

subgraph group_api["API application"]
  node_api_client["API settings<br/>[api.js]"]
  node_api_routes["API routes<br/>[index.js]"]
  node_event_ctrl["Event handlers<br/>[eventController.js]"]
  node_registration_ctrl["Registration handlers"]
  node_global_user_ctrl["Participant handlers"]
  node_event_service["Event services<br/>[eventService.js]"]
  node_other_domains["Crew, alliance, contact, status, upload, audit"]
  node_server["Express server<br/>[server.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth_ctrl["Admin auth handlers<br/>[authController.js]"]
  node_auth_service["Admin authentication<br/>[authService.js]"]
  node_access["Access controls<br/>[auth.js]"]
  node_participant_service["Participant accounts"]
end

subgraph group_storage["Persistent data"]
  node_registration_model[("Registrations<br/>[Registration.js]")]
  node_global_user_model[("Participant accounts<br/>[GlobalUser.js]")]
  node_event_models[("Event catalog<br/>[SubEvent.js]")]
  node_admin_model[("Admin accounts<br/>[Admin.js]")]
  node_db[("MongoDB connection<br/>[db.js]")]
end

node_visitor(("Visitor"))
node_admin_user(("Admin"))

node_visitor -->|"opens"| node_app
node_admin_user -->|"opens"| node_app
node_app -->|"renders"| node_routes
node_app -->|"reads state"| node_store
node_app -->|"renders"| node_hero
node_routes -->|"routes to"| node_events_ui
node_routes -->|"routes to"| node_timeline_ui
node_routes -->|"routes to"| node_crew_ui
node_routes -->|"routes to"| node_alliances_ui
node_routes -->|"routes to"| node_connect_ui
node_routes -->|"routes to"| node_admin_ui
node_events_ui -->|"uses settings"| node_api_client
node_alliances_ui -->|"uses settings"| node_api_client
node_admin_ui -->|"uses settings"| node_api_client
node_portal_ui -->|"uses settings"| node_api_client
node_api_client -.->|"calls API"| node_api_routes
node_server -->|"mounts"| node_api_routes
node_server -->|"connects"| node_db
node_api_routes -->|"routes to"| node_event_ctrl
node_api_routes -->|"routes to"| node_registration_ctrl
node_api_routes -->|"routes to"| node_global_user_ctrl
node_api_routes -.->|"routes to"| node_auth_ctrl
node_api_routes -->|"protects routes"| node_access
node_api_routes -.->|"routes domain APIs"| node_other_domains
node_event_ctrl -->|"calls"| node_event_service
node_registration_ctrl -->|"reads and writes"| node_registration_model
node_registration_ctrl -->|"checks participant IDs"| node_global_user_model
node_global_user_ctrl -->|"calls"| node_participant_service
node_auth_ctrl -->|"calls"| node_auth_service
node_event_service -->|"reads and writes"| node_event_models
node_participant_service -->|"reads and writes"| node_global_user_model
node_participant_service -.->|"allocates IDs"| node_registration_model
node_auth_service -->|"authenticates"| node_admin_model

click node_app "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/App.jsx"
click node_routes "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/routes/AppRoutes.jsx"
click node_store "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/store/useStore.js"
click node_hero "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/hero/HeroCanvas.jsx"
click node_events_ui "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/events/EventsPage.jsx"
click node_timeline_ui "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/timeline/TimelinePage.jsx"
click node_crew_ui "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/crew/CrewPage.jsx"
click node_alliances_ui "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/alliances/AlliancesPage.jsx"
click node_connect_ui "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/connect/ConnectPage.jsx"
click node_portal_ui "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/portal/PortalPage.jsx"
click node_admin_ui "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/admin/AdminPage.jsx"
click node_api_client "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/constants/api.js"
click node_api_routes "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/routes/index.js"
click node_event_ctrl "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/controllers/eventController.js"
click node_registration_ctrl "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/controllers/registrationController.js"
click node_global_user_ctrl "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/controllers/globalUserController.js"
click node_auth_ctrl "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/controllers/authController.js"
click node_auth_service "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/services/authService.js"
click node_access "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/middleware/auth.js"
click node_event_service "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/services/eventService.js"
click node_participant_service "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/services/globalUserService.js"
click node_registration_model "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/models/Registration.js"
click node_global_user_model "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/models/GlobalUser.js"
click node_event_models "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/models/SubEvent.js"
click node_admin_model "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/models/Admin.js"
click node_db "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/config/db.js"
click node_other_domains "https://github.com/coding-pundit-nitap/addovedi-2026/tree/main/server/controllers"
click node_server "https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/server.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_app,node_routes,node_store,node_hero toneBlue
class node_events_ui,node_timeline_ui,node_crew_ui,node_alliances_ui,node_connect_ui,node_portal_ui,node_admin_ui toneAmber
class node_api_client,node_api_routes,node_event_ctrl,node_registration_ctrl,node_global_user_ctrl,node_event_service,node_other_domains,node_server toneMint
class node_auth_ctrl,node_auth_service,node_access,node_participant_service toneRose
class node_registration_model,node_global_user_model,node_event_models,node_admin_model,node_db,node_visitor,node_admin_user toneIndigo
```

## Components

### Web experience

- [Application shell](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Page routes](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/routes/AppRoutes.jsx): `client/src/routes/AppRoutes.jsx`
- [UI state](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/store/useStore.js): `client/src/store/useStore.js`
- [3D home](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/hero/HeroCanvas.jsx): `client/src/components/hero/HeroCanvas.jsx`

### Event domains

- [Event browser](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/events/EventsPage.jsx): `client/src/components/events/EventsPage.jsx`
- [Timeline](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/timeline/TimelinePage.jsx): `client/src/components/timeline/TimelinePage.jsx`
- [Crew directory](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/crew/CrewPage.jsx): `client/src/components/crew/CrewPage.jsx`
- [Alliances](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/alliances/AlliancesPage.jsx): `client/src/components/alliances/AlliancesPage.jsx`
- [Contact](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/connect/ConnectPage.jsx): `client/src/components/connect/ConnectPage.jsx`
- [Participant portal](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/portal/PortalPage.jsx): `client/src/components/portal/PortalPage.jsx`
- [Admin portal](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/components/admin/AdminPage.jsx): `client/src/components/admin/AdminPage.jsx`

### API application

- [API settings](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/client/src/constants/api.js): `client/src/constants/api.js`
- [API routes](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/routes/index.js): `server/routes/index.js`
- [Event handlers](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/controllers/eventController.js): `server/controllers/eventController.js`
- [Registration handlers](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/controllers/registrationController.js): `server/controllers/registrationController.js`
- [Participant handlers](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/controllers/globalUserController.js): `server/controllers/globalUserController.js`
- [Event services](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/services/eventService.js): `server/services/eventService.js`
- [Crew, alliance, contact, status, upload, audit](https://github.com/coding-pundit-nitap/addovedi-2026/tree/main/server/controllers): `server/controllers`
- [Express server](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/server.js): `server/server.js`

### Identity and access

- [Admin auth handlers](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Admin authentication](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/services/authService.js): `server/services/authService.js`
- [Access controls](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/middleware/auth.js): `server/middleware/auth.js`
- [Participant accounts](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/services/globalUserService.js): `server/services/globalUserService.js`

### Persistent data

- [Registrations](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/models/Registration.js): `server/models/Registration.js`
- [Participant accounts](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/models/GlobalUser.js): `server/models/GlobalUser.js`
- [Event catalog](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/models/SubEvent.js): `server/models/SubEvent.js`
- [Admin accounts](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/models/Admin.js): `server/models/Admin.js`
- [MongoDB connection](https://github.com/coding-pundit-nitap/addovedi-2026/blob/main/server/config/db.js): `server/config/db.js`

### Other components

- **Visitor**
- **Admin**

## Connections

- Visitor → Application shell: opens (evidence: `client/src/App.jsx`)
- Admin → Application shell: opens (evidence: `client/src/App.jsx`)
- Application shell → Page routes: renders (evidence: `client/src/App.jsx`)
- Application shell → UI state: reads state (evidence: `client/src/App.jsx`)
- Application shell → 3D home: renders (evidence: `client/src/App.jsx`)
- Page routes → Event browser: routes to (evidence: `client/src/routes/AppRoutes.jsx`)
- Page routes → Timeline: routes to (evidence: `client/src/routes/AppRoutes.jsx`)
- Page routes → Crew directory: routes to (evidence: `client/src/routes/AppRoutes.jsx`)
- Page routes → Alliances: routes to (evidence: `client/src/routes/AppRoutes.jsx`)
- Page routes → Contact: routes to (evidence: `client/src/routes/AppRoutes.jsx`)
- Page routes → Admin portal: routes to (evidence: `client/src/routes/AppRoutes.jsx`)
- Event browser → API settings: uses settings
- Alliances → API settings: uses settings (evidence: `client/src/components/alliances/AlliancesPage.jsx`)
- Admin portal → API settings: uses settings (evidence: `client/src/components/admin/AdminPage.jsx`)
- Participant portal → API settings: uses settings (evidence: `client/src/components/portal/PortalPage.jsx`)
- API settings → API routes: calls API
- Express server → API routes: mounts (evidence: `server/server.js`)
- Express server → MongoDB connection: connects (evidence: `server/server.js`)
- API routes → Event handlers: routes to
- API routes → Registration handlers: routes to
- API routes → Participant handlers: routes to
- API routes → Admin auth handlers: routes to
- API routes → Access controls: protects routes
- API routes → Crew, alliance, contact, status, upload, audit: routes domain APIs
- Event handlers → Event services: calls (evidence: `server/controllers/eventController.js`)
- Registration handlers → Registrations: reads and writes (evidence: `server/controllers/registrationController.js`)
- Registration handlers → Participant accounts: checks participant IDs (evidence: `server/controllers/registrationController.js`)
- Participant handlers → Participant accounts: calls (evidence: `server/controllers/globalUserController.js`)
- Admin auth handlers → Admin authentication: calls (evidence: `server/controllers/authController.js`)
- Event services → Event catalog: reads and writes (evidence: `server/services/eventService.js`)
- Participant accounts → Participant accounts: reads and writes (evidence: `server/services/globalUserService.js`)
- Participant accounts → Registrations: allocates IDs
- Admin authentication → Admin accounts: authenticates (evidence: `server/services/authService.js`)
