# hemantvs05/startup-peravai architecture

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

## Overview

Peravai is an event-registration and hackathon platform. Attendees browse events, authenticate, and use the frontend’s registration, team, and visitor flows; the React app sends authenticated requests to an Express API, which dispatches domain routes and uses Firebase services. The graph also preserves partner enquiries, Riseher, event-team, and payment areas shown in the source index. Evidence is limited: several major UI and backend modules were not excerpted, so their internal connections are omitted or marked unverified.

Main entry points: [`frontend/src/components/MainLayout.jsx`](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/MainLayout.jsx) (Main layout), [`backend/server.js`](https://github.com/hemantvs05/startup-peravai/blob/main/backend/server.js) (Express API), [`frontend/src/components/EventsPage.jsx`](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/EventsPage.jsx) (Events page), [`backend/src/routes/registrationRoutes.js`](https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/routes/registrationRoutes.js) (Registration routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["App router<br/>[App.jsx]"]
  node_layout["Main layout<br/>[MainLayout.jsx]"]
  node_events["Events page<br/>[EventsPage.jsx]"]
  node_registration_ui["Registration flows"]
  node_hackathon_ui["Hackathon flows<br/>[HackathonModal.jsx]"]
  node_team_ui["Team service"]
  node_dashboard["User dashboard<br/>[UserDashboard.jsx]"]
  node_visitor_ui["Visitor passes"]
  node_partner_ui["Partner enquiries<br/>[PartnerModal.jsx]"]
  node_event_slideshow["Event slideshow<br/>[EventSlideshow.jsx]"]
  node_payment_ui["Checkout button"]
end

subgraph group_api["API and domains"]
  node_api_client["API client<br/>[api.js]"]
  node_server["Express API<br/>[server.js]"]
  node_team_routes["Team routes<br/>[teamRoutes.js]"]
  node_team_controller["Team controller<br/>[teamController.js]"]
  node_team_service["Team service<br/>[teamService.js]"]
  node_registration_routes["Registration routes"]
  node_registration_controller["Registration controller"]
  node_other_routes["Other domain routes"]
  node_partner_controller["Partner controller"]
  node_payment_routes["Payment routes<br/>[paymentRoutes.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth_context["Auth context<br/>[AuthContext.jsx]"]
  node_client_firebase["Firebase client<br/>[firebase.js]"]
  node_backend_auth["Token verifier<br/>[authMiddleware.js]"]
  node_admin_auth["Admin access<br/>[adminMiddleware.js]"]
end

subgraph group_data["Firebase data"]
  node_firestore[("Firestore<br/>[firebase.js]")]
end

node_attendee(("Attendee"))

node_attendee -.->|"opens"| node_app
node_app -->|"routes to"| node_layout
node_app -->|"routes to"| node_events
node_layout -->|"renders"| node_event_slideshow
node_layout -->|"renders"| node_dashboard
node_layout -->|"renders"| node_visitor_ui
node_layout -->|"renders"| node_partner_ui
node_events -->|"renders"| node_registration_ui
node_events -->|"renders"| node_hackathon_ui
node_events -->|"uses"| node_team_ui
node_auth_context -->|"observes auth"| node_client_firebase
node_auth_context -->|"requests registration"| node_api_client
node_api_client -->|"gets token"| node_client_firebase
node_team_ui -->|"calls teams API"| node_api_client
node_server -->|"mounts"| node_team_routes
node_server -->|"mounts"| node_registration_routes
node_server -->|"mounts domains"| node_other_routes
node_server -->|"mounts"| node_payment_routes
node_team_routes -->|"dispatches"| node_team_controller
node_team_controller -->|"calls"| node_team_service
node_registration_routes -->|"dispatches"| node_registration_controller
node_team_routes -->|"checks token"| node_backend_auth
node_registration_routes -->|"checks token"| node_backend_auth
node_registration_routes -->|"checks admin"| node_admin_auth
node_team_service -->|"uses database"| node_firestore
node_backend_auth -->|"verifies token"| node_firestore
node_partner_controller -->|"writes enquiry"| node_firestore
node_partner_ui -.->|"submits enquiry"| node_api_client
node_payment_ui -.->|"initiates checkout"| node_payment_routes

click node_app "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/App.jsx"
click node_layout "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/MainLayout.jsx"
click node_events "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/EventsPage.jsx"
click node_registration_ui "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/EventRegistrationModal.jsx"
click node_hackathon_ui "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/HackathonModal.jsx"
click node_team_ui "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/services/hackathonService.js"
click node_dashboard "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/UserDashboard.jsx"
click node_visitor_ui "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/VisitorPassPaymentModal.jsx"
click node_partner_ui "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/PartnerModal.jsx"
click node_auth_context "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/context/AuthContext.jsx"
click node_client_firebase "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/config/firebase.js"
click node_api_client "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/utils/api.js"
click node_server "https://github.com/hemantvs05/startup-peravai/blob/main/backend/server.js"
click node_team_routes "https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/routes/teamRoutes.js"
click node_team_controller "https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/controllers/teamController.js"
click node_team_service "https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/services/teamService.js"
click node_registration_routes "https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/routes/registrationRoutes.js"
click node_registration_controller "https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/controllers/registrationController.js"
click node_other_routes "https://github.com/hemantvs05/startup-peravai/tree/main/backend/src/routes"
click node_partner_controller "https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/controllers/partnerController.js"
click node_backend_auth "https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/middleware/authMiddleware.js"
click node_admin_auth "https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/middleware/adminMiddleware.js"
click node_firestore "https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/config/firebase.js"
click node_event_slideshow "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/EventSlideshow.jsx"
click node_payment_ui "https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/RazorpayCheckoutButton.jsx"
click node_payment_routes "https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/routes/paymentRoutes.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_layout,node_events,node_registration_ui,node_hackathon_ui,node_team_ui,node_dashboard,node_visitor_ui,node_partner_ui,node_event_slideshow,node_payment_ui toneBlue
class node_api_client,node_server,node_team_routes,node_team_controller,node_team_service,node_registration_routes,node_registration_controller,node_other_routes,node_partner_controller,node_payment_routes toneAmber
class node_auth_context,node_client_firebase,node_backend_auth,node_admin_auth toneMint
class node_firestore toneRose
class node_attendee toneIndigo
```

## Components

### Web experience

- [App router](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Main layout](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/MainLayout.jsx): `frontend/src/components/MainLayout.jsx`
- [Events page](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/EventsPage.jsx): `frontend/src/components/EventsPage.jsx`
- [Registration flows](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/EventRegistrationModal.jsx): `frontend/src/components/EventRegistrationModal.jsx`
- [Hackathon flows](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/HackathonModal.jsx): `frontend/src/components/HackathonModal.jsx`
- [Team service](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/services/hackathonService.js): `frontend/src/services/hackathonService.js`
- [User dashboard](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/UserDashboard.jsx): `frontend/src/components/UserDashboard.jsx`
- [Visitor passes](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/VisitorPassPaymentModal.jsx): `frontend/src/components/VisitorPassPaymentModal.jsx`
- [Partner enquiries](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/PartnerModal.jsx): `frontend/src/components/PartnerModal.jsx`
- [Event slideshow](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/EventSlideshow.jsx): `frontend/src/components/EventSlideshow.jsx`
- [Checkout button](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/components/RazorpayCheckoutButton.jsx): `frontend/src/components/RazorpayCheckoutButton.jsx`

### API and domains

- [API client](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/utils/api.js): `frontend/src/utils/api.js`
- [Express API](https://github.com/hemantvs05/startup-peravai/blob/main/backend/server.js): `backend/server.js`
- [Team routes](https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/routes/teamRoutes.js): `backend/src/routes/teamRoutes.js`
- [Team controller](https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/controllers/teamController.js): `backend/src/controllers/teamController.js`
- [Team service](https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/services/teamService.js): `backend/src/services/teamService.js`
- [Registration routes](https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/routes/registrationRoutes.js): `backend/src/routes/registrationRoutes.js`
- [Registration controller](https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/controllers/registrationController.js): `backend/src/controllers/registrationController.js`
- [Other domain routes](https://github.com/hemantvs05/startup-peravai/tree/main/backend/src/routes): `backend/src/routes`
- [Partner controller](https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/controllers/partnerController.js): `backend/src/controllers/partnerController.js`
- [Payment routes](https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/routes/paymentRoutes.js): `backend/src/routes/paymentRoutes.js`

### Identity and access

- [Auth context](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Firebase client](https://github.com/hemantvs05/startup-peravai/blob/main/frontend/src/config/firebase.js): `frontend/src/config/firebase.js`
- [Token verifier](https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/middleware/authMiddleware.js): `backend/src/middleware/authMiddleware.js`
- [Admin access](https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/middleware/adminMiddleware.js): `backend/src/middleware/adminMiddleware.js`

### Firebase data

- [Firestore](https://github.com/hemantvs05/startup-peravai/blob/main/backend/src/config/firebase.js): `backend/src/config/firebase.js`

### Other components

- **Attendee**

## Connections

- Attendee → App router: opens
- App router → Main layout: routes to (evidence: `frontend/src/App.jsx`)
- App router → Events page: routes to (evidence: `frontend/src/App.jsx`)
- Main layout → Event slideshow: renders (evidence: `frontend/src/components/MainLayout.jsx`)
- Main layout → User dashboard: renders (evidence: `frontend/src/components/MainLayout.jsx`)
- Main layout → Visitor passes: renders (evidence: `frontend/src/components/MainLayout.jsx`)
- Main layout → Partner enquiries: renders (evidence: `frontend/src/components/MainLayout.jsx`)
- Events page → Registration flows: renders (evidence: `frontend/src/components/EventsPage.jsx`)
- Events page → Hackathon flows: renders (evidence: `frontend/src/components/EventsPage.jsx`)
- Events page → Team service: uses (evidence: `frontend/src/components/EventsPage.jsx`)
- Auth context → Firebase client: observes auth (evidence: `frontend/src/context/AuthContext.jsx`)
- Auth context → API client: requests registration (evidence: `frontend/src/context/AuthContext.jsx`)
- API client → Firebase client: gets token (evidence: `frontend/src/utils/api.js`)
- Team service → API client: calls teams API (evidence: `frontend/src/services/hackathonService.js`)
- Express API → Team routes: mounts (evidence: `backend/server.js`)
- Express API → Registration routes: mounts (evidence: `backend/server.js`)
- Express API → Other domain routes: mounts domains (evidence: `backend/server.js`)
- Express API → Payment routes: mounts (evidence: `backend/server.js`)
- Team routes → Team controller: dispatches (evidence: `backend/src/routes/teamRoutes.js`)
- Team controller → Team service: calls (evidence: `backend/src/controllers/teamController.js`)
- Registration routes → Registration controller: dispatches (evidence: `backend/src/routes/registrationRoutes.js`)
- Team routes → Token verifier: checks token (evidence: `backend/src/routes/teamRoutes.js`)
- Registration routes → Token verifier: checks token (evidence: `backend/src/routes/registrationRoutes.js`)
- Registration routes → Admin access: checks admin (evidence: `backend/src/routes/registrationRoutes.js`)
- Team service → Firestore: uses database (evidence: `backend/src/services/teamService.js`)
- Token verifier → Firestore: verifies token (evidence: `backend/src/middleware/authMiddleware.js`)
- Partner controller → Firestore: writes enquiry (evidence: `backend/src/controllers/partnerController.js`)
- Partner enquiries → API client: submits enquiry
- Checkout button → Payment routes: initiates checkout
