# athithyan24/event architecture

> Architecture diagram of the GitHub repository athithyan24/event, 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/athithyan24/event
- Repository: https://github.com/athithyan24/event

## Overview

Aura is a campus event-planning application for department users and administrators. Users sign in, create event requests, and check venue and equipment availability; administrators review requests and reserve resources, after which teams track events through completion, feedback, certificates, and reports. The React client calls an Express API backed by MongoDB. The graph preserves the README’s dashboard, calendar, resource administration, notifications, announcements, and reporting capabilities. Some page-to-endpoint wiring is unsampled, so those links are omitted or marked unverified.

Main entry points: [`server/controllers/eventController.js`](https://github.com/athithyan24/event/blob/main/server/controllers/eventController.js) (Event lifecycle), [`client/src/App.jsx`](https://github.com/athithyan24/event/blob/main/client/src/App.jsx) (Application routes), [`server/controllers/dashboardController.js`](https://github.com/athithyan24/event/blob/main/server/controllers/dashboardController.js) (Dashboard services), [`client/src/lib/api.js`](https://github.com/athithyan24/event/blob/main/client/src/lib/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_webapp["Application routes<br/>[App.jsx]"]
  node_shell["App shell<br/>[AppShell.jsx]"]
  node_eventui["Event workspace<br/>[EventDetail.jsx]"]
  node_resourceui["Resource pages<br/>[Venues.jsx]"]
  node_dashboardui["Dashboard and insights<br/>[Dashboard.jsx]"]
  node_adminui["Admin pages<br/>[Approvals.jsx]"]
  node_apiclient["API client<br/>[api.js]"]
end

subgraph group_api["API and workflows"]
  node_httpapi["Aura API<br/>[server.js]"]
  node_auth["Authentication<br/>[authController.js]"]
  node_eventroutes["Event routes<br/>[eventRoutes.js]"]
  node_dashboard["Dashboard services"]
  node_resourceflow["Resource management<br/>[venueController.js]"]
end

subgraph group_planning["Event planning"]
  node_eventflow["Event lifecycle<br/>[eventController.js]"]
  node_extras["Event follow-up"]
  node_availability["Availability checks<br/>[availability.js]"]
end

subgraph group_data["Domain data"]
  node_eventdata[("Events<br/>[Event.js]")]
  node_users[("Users<br/>[User.js]")]
  node_resources[("Venue and equipment<br/>[Equipment.js]")]
  node_allocations[("Equipment allocations")]
  node_audit["Audit and notifications<br/>[audit.js]"]
  node_followupdata[("Event follow-up records<br/>[Feedback.js]")]
end

node_people(("Department users and admins"))

node_people -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_shell
node_webapp -->|"routes to"| node_eventui
node_webapp -->|"routes to"| node_resourceui
node_webapp -->|"routes to"| node_dashboardui
node_webapp -->|"routes to"| node_adminui
node_shell -->|"uses"| node_apiclient
node_eventui -->|"uses"| node_apiclient
node_apiclient -.->|"requests API"| node_httpapi
node_httpapi -->|"mounts"| node_eventroutes
node_eventroutes -->|"dispatches"| node_eventflow
node_eventflow -->|"checks availability"| node_availability
node_eventflow -->|"reads and writes"| node_eventdata
node_eventflow -->|"checks resources"| node_resources
node_eventflow -->|"reserves equipment"| node_allocations
node_eventflow -->|"records updates"| node_audit
node_eventflow -->|"notifies admins"| node_users
node_extras -->|"reads events"| node_eventdata
node_extras -->|"stores feedback"| node_followupdata
node_extras -->|"adds timeline"| node_audit
node_dashboardui -.->|"uses"| node_apiclient
node_adminui -.->|"uses"| node_apiclient
node_dashboard -->|"queries metrics"| node_eventdata
node_dashboard -->|"queries usage"| node_resources
node_dashboard -->|"aggregates usage"| node_allocations
node_dashboard -->|"queries users"| node_users
node_dashboard -->|"logs announcements"| node_audit
node_resourceflow -->|"checks availability"| node_availability
node_resourceflow -->|"reads resources"| node_resources
node_httpapi -->|"mounts auth routes"| node_auth
node_auth -->|"authenticates users"| node_users

click node_webapp "https://github.com/athithyan24/event/blob/main/client/src/App.jsx"
click node_shell "https://github.com/athithyan24/event/blob/main/client/src/layouts/AppShell.jsx"
click node_eventui "https://github.com/athithyan24/event/blob/main/client/src/pages/app/EventDetail.jsx"
click node_resourceui "https://github.com/athithyan24/event/blob/main/client/src/pages/app/Venues.jsx"
click node_dashboardui "https://github.com/athithyan24/event/blob/main/client/src/pages/app/Dashboard.jsx"
click node_adminui "https://github.com/athithyan24/event/blob/main/client/src/pages/app/Approvals.jsx"
click node_apiclient "https://github.com/athithyan24/event/blob/main/client/src/lib/api.js"
click node_httpapi "https://github.com/athithyan24/event/blob/main/server/server.js"
click node_auth "https://github.com/athithyan24/event/blob/main/server/controllers/authController.js"
click node_eventroutes "https://github.com/athithyan24/event/blob/main/server/routes/eventRoutes.js"
click node_eventflow "https://github.com/athithyan24/event/blob/main/server/controllers/eventController.js"
click node_extras "https://github.com/athithyan24/event/blob/main/server/controllers/eventExtrasController.js"
click node_availability "https://github.com/athithyan24/event/blob/main/server/utils/availability.js"
click node_dashboard "https://github.com/athithyan24/event/blob/main/server/controllers/dashboardController.js"
click node_resourceflow "https://github.com/athithyan24/event/blob/main/server/controllers/venueController.js"
click node_eventdata "https://github.com/athithyan24/event/blob/main/server/models/Event.js"
click node_users "https://github.com/athithyan24/event/blob/main/server/models/User.js"
click node_resources "https://github.com/athithyan24/event/blob/main/server/models/Equipment.js"
click node_allocations "https://github.com/athithyan24/event/blob/main/server/models/EquipmentAllocation.js"
click node_audit "https://github.com/athithyan24/event/blob/main/server/utils/audit.js"
click node_followupdata "https://github.com/athithyan24/event/blob/main/server/models/Feedback.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_webapp,node_shell,node_eventui,node_resourceui,node_dashboardui,node_adminui,node_apiclient,node_people toneBlue
class node_httpapi,node_auth,node_eventroutes,node_dashboard,node_resourceflow toneAmber
class node_eventflow,node_extras,node_availability toneMint
class node_eventdata,node_users,node_resources,node_allocations,node_audit,node_followupdata toneRose
```

## Components

### React client

- [Application routes](https://github.com/athithyan24/event/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [App shell](https://github.com/athithyan24/event/blob/main/client/src/layouts/AppShell.jsx): `client/src/layouts/AppShell.jsx`
- [Event workspace](https://github.com/athithyan24/event/blob/main/client/src/pages/app/EventDetail.jsx): `client/src/pages/app/EventDetail.jsx`
- [Resource pages](https://github.com/athithyan24/event/blob/main/client/src/pages/app/Venues.jsx): `client/src/pages/app/Venues.jsx`
- [Dashboard and insights](https://github.com/athithyan24/event/blob/main/client/src/pages/app/Dashboard.jsx): `client/src/pages/app/Dashboard.jsx`
- [Admin pages](https://github.com/athithyan24/event/blob/main/client/src/pages/app/Approvals.jsx): `client/src/pages/app/Approvals.jsx`
- [API client](https://github.com/athithyan24/event/blob/main/client/src/lib/api.js): `client/src/lib/api.js`

### API and workflows

- [Aura API](https://github.com/athithyan24/event/blob/main/server/server.js): `server/server.js`
- [Authentication](https://github.com/athithyan24/event/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Event routes](https://github.com/athithyan24/event/blob/main/server/routes/eventRoutes.js): `server/routes/eventRoutes.js`
- [Dashboard services](https://github.com/athithyan24/event/blob/main/server/controllers/dashboardController.js): `server/controllers/dashboardController.js`
- [Resource management](https://github.com/athithyan24/event/blob/main/server/controllers/venueController.js): `server/controllers/venueController.js`

### Event planning

- [Event lifecycle](https://github.com/athithyan24/event/blob/main/server/controllers/eventController.js): `server/controllers/eventController.js`
- [Event follow-up](https://github.com/athithyan24/event/blob/main/server/controllers/eventExtrasController.js): `server/controllers/eventExtrasController.js`
- [Availability checks](https://github.com/athithyan24/event/blob/main/server/utils/availability.js): `server/utils/availability.js`

### Domain data

- [Events](https://github.com/athithyan24/event/blob/main/server/models/Event.js): `server/models/Event.js`
- [Users](https://github.com/athithyan24/event/blob/main/server/models/User.js): `server/models/User.js`
- [Venue and equipment](https://github.com/athithyan24/event/blob/main/server/models/Equipment.js): `server/models/Equipment.js`
- [Equipment allocations](https://github.com/athithyan24/event/blob/main/server/models/EquipmentAllocation.js): `server/models/EquipmentAllocation.js`
- [Audit and notifications](https://github.com/athithyan24/event/blob/main/server/utils/audit.js): `server/utils/audit.js`
- [Event follow-up records](https://github.com/athithyan24/event/blob/main/server/models/Feedback.js): `server/models/Feedback.js`

### Other components

- **Department users and admins**

## Connections

- Department users and admins → Application routes: uses (evidence: `README.md`)
- Application routes → App shell: routes to (evidence: `client/src/App.jsx`)
- Application routes → Event workspace: routes to (evidence: `client/src/App.jsx`)
- Application routes → Resource pages: routes to (evidence: `client/src/App.jsx`)
- Application routes → Dashboard and insights: routes to (evidence: `client/src/App.jsx`)
- Application routes → Admin pages: routes to (evidence: `client/src/App.jsx`)
- App shell → API client: uses (evidence: `client/src/layouts/AppShell.jsx`)
- Event workspace → API client: uses (evidence: `client/src/pages/app/EventDetail.jsx`)
- API client → Aura API: requests API (evidence: `README.md`)
- Aura API → Event routes: mounts (evidence: `server/server.js`)
- Event routes → Event lifecycle: dispatches (evidence: `server/routes/eventRoutes.js`)
- Event lifecycle → Availability checks: checks availability (evidence: `server/controllers/eventController.js`)
- Event lifecycle → Events: reads and writes (evidence: `server/controllers/eventController.js`)
- Event lifecycle → Venue and equipment: checks resources (evidence: `server/controllers/eventController.js`)
- Event lifecycle → Equipment allocations: reserves equipment (evidence: `server/controllers/eventController.js`)
- Event lifecycle → Audit and notifications: records updates (evidence: `server/controllers/eventController.js`)
- Event lifecycle → Users: notifies admins (evidence: `server/controllers/eventController.js`)
- Event follow-up → Events: reads events (evidence: `server/controllers/eventExtrasController.js`)
- Event follow-up → Event follow-up records: stores feedback (evidence: `server/controllers/eventExtrasController.js`)
- Event follow-up → Audit and notifications: adds timeline (evidence: `server/controllers/eventExtrasController.js`)
- Dashboard and insights → API client: uses
- Admin pages → API client: uses
- Dashboard services → Events: queries metrics (evidence: `server/controllers/dashboardController.js`)
- Dashboard services → Venue and equipment: queries usage (evidence: `server/controllers/dashboardController.js`)
- Dashboard services → Equipment allocations: aggregates usage (evidence: `server/controllers/dashboardController.js`)
- Dashboard services → Users: queries users (evidence: `server/controllers/dashboardController.js`)
- Dashboard services → Audit and notifications: logs announcements (evidence: `server/controllers/dashboardController.js`)
- Resource management → Availability checks: checks availability (evidence: `server/controllers/venueController.js`)
- Resource management → Venue and equipment: reads resources (evidence: `server/controllers/venueController.js`)
- Aura API → Authentication: mounts auth routes (evidence: `server/server.js`)
- Authentication → Users: authenticates users
