# sakshisingh-bv/infonestfn architecture

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

- Interactive diagram: https://gitdiagram.com/sakshisingh-bv/infonestfn
- Repository: https://github.com/sakshisingh-bv/infonestfn

## Overview

InfoNest is a campus portal for event and club discovery, student registration, staff scheduling, and venue booking. Users enter through the React app, authenticate or browse, then use role-specific screens for these tasks; the frontend API client talks to Spring controllers that apply domain operations and persist records. Schedule lookup and venue booking are distinct workflows. The graph emphasizes relationships visible in excerpts or the source index; several listed controllers and frontend screens were not sampled, so their internal links are omitted where unverified.

Main entry points: [`frontend/src/services/api.js`](https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/services/api.js) (HTTP API client), [`src/main/java/com/infonest/controller/AdminController.java`](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/AdminController.java) (Administration), [`src/main/java/com/infonest/repository/UserRepository.java`](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/UserRepository.java) (User records), [`src/main/java/com/infonest/controller/ClubOfficialController.java`](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/ClubOfficialController.java) (Club official tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Route and role gates<br/>[App.jsx]"]
  node_api["HTTP API client<br/>[api.js]"]
  node_home["Portal home<br/>[Home.jsx]"]
  node_adminui["Admin workspace<br/>[AdminDashboard.jsx]"]
  node_facultyui["Faculty workspace"]
  node_officeui["Office workspace"]
  node_bookingui["Booking calendar"]
end

subgraph group_identity["Identity and access"]
  node_authctx["Session state<br/>[AuthContext.jsx]"]
  node_authservice["Authentication service<br/>[AuthService.java]"]
  node_jwt["JWT utilities<br/>[JwtUtils.java]"]
  node_usercontroller["User endpoints"]
end

subgraph group_campus["Clubs and events"]
  node_adminctrl["Administration"]
  node_officialctrl["Club official tools"]
  node_eventctrl["Event endpoints"]
  node_studentctrl["Student registration"]
end

subgraph group_operations["Scheduling and venues"]
  node_schedulectrl["Schedule endpoints"]
  node_schedulesvc["Schedule operations"]
  node_venuctrl["Venue booking endpoints"]
  node_cleanup["Expired booking cleanup"]
end

subgraph group_persistence["Domain persistence"]
  node_userrepo[("User records")]
  node_usermodel["User account<br/>[User.java]"]
  node_clubrepo[("Club records")]
  node_eventrepo[("Event records")]
  node_eventmodel["Event listing<br/>[Event.java]"]
  node_regrepo[("Registration records")]
  node_schedrepo[("Schedule records")]
  node_bookingrepo[("Venue bookings")]
  node_venuerepo[("Venue records")]
end

node_visitor(("Campus user"))

node_visitor -->|"uses"| node_app
node_app -->|"provides session"| node_authctx
node_app -->|"routes to"| node_home
node_authctx -->|"requests auth"| node_api
node_home -.->|"loads portal data"| node_api
node_adminui -->|"admin requests"| node_api
node_facultyui -.->|"faculty requests"| node_api
node_officeui -.->|"office requests"| node_api
node_bookingui -->|"loads bookings"| node_api
node_api -.->|"HTTP auth calls"| node_authservice
node_api -.->|"HTTP admin calls"| node_adminctrl
node_api -.->|"HTTP faculty calls"| node_officialctrl
node_api -.->|"HTTP venue calls"| node_venuctrl
node_authservice -->|"reads and saves"| node_userrepo
node_authservice -->|"creates token"| node_jwt
node_userrepo -->|"stores"| node_usermodel
node_adminctrl -->|"manages clubs"| node_clubrepo
node_adminctrl -->|"manages events"| node_eventrepo
node_adminctrl -->|"manages users"| node_userrepo
node_officialctrl -->|"manages club events"| node_eventrepo
node_officialctrl -->|"reviews registrations"| node_regrepo
node_officialctrl -->|"updates club"| node_clubrepo
node_eventctrl -->|"queries events"| node_eventrepo
node_eventrepo -->|"persists"| node_eventmodel
node_schedulectrl -->|"delegates schedules"| node_schedulesvc
node_schedulesvc -->|"reads and writes"| node_schedrepo
node_schedulesvc -->|"checks active bookings"| node_bookingrepo
node_schedulesvc -->|"searches teachers"| node_userrepo
node_venuctrl -->|"creates and cancels"| node_bookingrepo
node_venuctrl -->|"validates venues"| node_venuerepo
node_venuctrl -->|"loads booker"| node_userrepo
node_cleanup -.->|"cleans expired"| node_bookingrepo
node_studentctrl -.->|"records registration"| node_regrepo
node_adminctrl -->|"updates event fields"| node_eventmodel

click node_app "https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/App.jsx"
click node_authctx "https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/context/AuthContext.jsx"
click node_api "https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/services/api.js"
click node_home "https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/pages/Home.jsx"
click node_adminui "https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_facultyui "https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/pages/FacultyDashboard.jsx"
click node_officeui "https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/pages/OfficeDashboard.jsx"
click node_bookingui "https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/components/MyBookingsCalendar.jsx"
click node_authservice "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/service/AuthService.java"
click node_jwt "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/config/JwtUtils.java"
click node_usercontroller "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/UserController.java"
click node_userrepo "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/UserRepository.java"
click node_usermodel "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/model/User.java"
click node_adminctrl "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/AdminController.java"
click node_officialctrl "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/ClubOfficialController.java"
click node_eventctrl "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/EventController.java"
click node_clubrepo "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/ClubRepository.java"
click node_eventrepo "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/EventRepository.java"
click node_eventmodel "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/model/Event.java"
click node_regrepo "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/RegistrationRepository.java"
click node_schedulectrl "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/ScheduleController.java"
click node_schedulesvc "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/service/ScheduleService.java"
click node_schedrepo "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/ScheduleRepository.java"
click node_venuctrl "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/VenueController.java"
click node_bookingrepo "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/VenueBookingRepository.java"
click node_venuerepo "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/VenueRepository.java"
click node_cleanup "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/config/BookingCleanupScheduler.java"
click node_studentctrl "https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/StudentController.java"

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_api,node_home,node_adminui,node_facultyui,node_officeui,node_bookingui,node_visitor toneBlue
class node_authctx,node_authservice,node_jwt,node_usercontroller toneAmber
class node_adminctrl,node_officialctrl,node_eventctrl,node_studentctrl toneMint
class node_schedulectrl,node_schedulesvc,node_venuctrl,node_cleanup toneRose
class node_userrepo,node_usermodel,node_clubrepo,node_eventrepo,node_eventmodel,node_regrepo,node_schedrepo,node_bookingrepo,node_venuerepo toneIndigo
```

## Components

### Web application

- [Route and role gates](https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [HTTP API client](https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Portal home](https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Admin workspace](https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`
- [Faculty workspace](https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/pages/FacultyDashboard.jsx): `frontend/src/pages/FacultyDashboard.jsx`
- [Office workspace](https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/pages/OfficeDashboard.jsx): `frontend/src/pages/OfficeDashboard.jsx`
- [Booking calendar](https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/components/MyBookingsCalendar.jsx): `frontend/src/components/MyBookingsCalendar.jsx`

### Identity and access

- [Session state](https://github.com/sakshisingh-bv/infonestfn/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Authentication service](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/service/AuthService.java): `src/main/java/com/infonest/service/AuthService.java`
- [JWT utilities](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/config/JwtUtils.java): `src/main/java/com/infonest/config/JwtUtils.java`
- [User endpoints](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/UserController.java): `src/main/java/com/infonest/controller/UserController.java`

### Clubs and events

- [Administration](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/AdminController.java): `src/main/java/com/infonest/controller/AdminController.java`
- [Club official tools](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/ClubOfficialController.java): `src/main/java/com/infonest/controller/ClubOfficialController.java`
- [Event endpoints](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/EventController.java): `src/main/java/com/infonest/controller/EventController.java`
- [Student registration](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/StudentController.java): `src/main/java/com/infonest/controller/StudentController.java`

### Scheduling and venues

- [Schedule endpoints](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/ScheduleController.java): `src/main/java/com/infonest/controller/ScheduleController.java`
- [Schedule operations](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/service/ScheduleService.java): `src/main/java/com/infonest/service/ScheduleService.java`
- [Venue booking endpoints](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/controller/VenueController.java): `src/main/java/com/infonest/controller/VenueController.java`
- [Expired booking cleanup](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/config/BookingCleanupScheduler.java): `src/main/java/com/infonest/config/BookingCleanupScheduler.java`

### Domain persistence

- [User records](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/UserRepository.java): `src/main/java/com/infonest/repository/UserRepository.java`
- [User account](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/model/User.java): `src/main/java/com/infonest/model/User.java`
- [Club records](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/ClubRepository.java): `src/main/java/com/infonest/repository/ClubRepository.java`
- [Event records](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/EventRepository.java): `src/main/java/com/infonest/repository/EventRepository.java`
- [Event listing](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/model/Event.java): `src/main/java/com/infonest/model/Event.java`
- [Registration records](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/RegistrationRepository.java): `src/main/java/com/infonest/repository/RegistrationRepository.java`
- [Schedule records](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/ScheduleRepository.java): `src/main/java/com/infonest/repository/ScheduleRepository.java`
- [Venue bookings](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/VenueBookingRepository.java): `src/main/java/com/infonest/repository/VenueBookingRepository.java`
- [Venue records](https://github.com/sakshisingh-bv/infonestfn/blob/main/src/main/java/com/infonest/repository/VenueRepository.java): `src/main/java/com/infonest/repository/VenueRepository.java`

### Other components

- **Campus user**

## Connections

- Campus user → Route and role gates: uses (evidence: `frontend/src/App.jsx`)
- Route and role gates → Session state: provides session (evidence: `frontend/src/App.jsx`)
- Route and role gates → Portal home: routes to (evidence: `frontend/src/App.jsx`)
- Session state → HTTP API client: requests auth (evidence: `frontend/src/context/AuthContext.jsx`)
- Portal home → HTTP API client: loads portal data (evidence: `frontend/src/pages/Home.jsx`)
- Admin workspace → HTTP API client: admin requests (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- Faculty workspace → HTTP API client: faculty requests (evidence: `frontend/src/pages/FacultyDashboard.jsx`)
- Office workspace → HTTP API client: office requests (evidence: `frontend/src/pages/OfficeDashboard.jsx`)
- Booking calendar → HTTP API client: loads bookings (evidence: `frontend/src/components/MyBookingsCalendar.jsx`)
- HTTP API client → Authentication service: HTTP auth calls
- HTTP API client → Administration: HTTP admin calls
- HTTP API client → Club official tools: HTTP faculty calls
- HTTP API client → Venue booking endpoints: HTTP venue calls
- Authentication service → User records: reads and saves (evidence: `src/main/java/com/infonest/service/AuthService.java`)
- Authentication service → JWT utilities: creates token (evidence: `src/main/java/com/infonest/service/AuthService.java`)
- User records → User account: stores (evidence: `src/main/java/com/infonest/repository/UserRepository.java`)
- Administration → Club records: manages clubs (evidence: `src/main/java/com/infonest/controller/AdminController.java`)
- Administration → Event records: manages events (evidence: `src/main/java/com/infonest/controller/AdminController.java`)
- Administration → User records: manages users (evidence: `src/main/java/com/infonest/controller/AdminController.java`)
- Club official tools → Event records: manages club events (evidence: `src/main/java/com/infonest/controller/ClubOfficialController.java`)
- Club official tools → Registration records: reviews registrations (evidence: `src/main/java/com/infonest/controller/ClubOfficialController.java`)
- Club official tools → Club records: updates club (evidence: `src/main/java/com/infonest/controller/ClubOfficialController.java`)
- Event endpoints → Event records: queries events (evidence: `src/main/java/com/infonest/controller/EventController.java`)
- Event records → Event listing: persists (evidence: `src/main/java/com/infonest/repository/EventRepository.java`)
- Schedule endpoints → Schedule operations: delegates schedules (evidence: `src/main/java/com/infonest/controller/ScheduleController.java`)
- Schedule operations → Schedule records: reads and writes (evidence: `src/main/java/com/infonest/service/ScheduleService.java`)
- Schedule operations → Venue bookings: checks active bookings (evidence: `src/main/java/com/infonest/service/ScheduleService.java`)
- Schedule operations → User records: searches teachers (evidence: `src/main/java/com/infonest/service/ScheduleService.java`)
- Venue booking endpoints → Venue bookings: creates and cancels (evidence: `src/main/java/com/infonest/controller/VenueController.java`)
- Venue booking endpoints → Venue records: validates venues (evidence: `src/main/java/com/infonest/controller/VenueController.java`)
- Venue booking endpoints → User records: loads booker (evidence: `src/main/java/com/infonest/controller/VenueController.java`)
- Expired booking cleanup → Venue bookings: cleans expired
- Student registration → Registration records: records registration
- Administration → Event listing: updates event fields (evidence: `src/main/java/com/infonest/controller/AdminController.java`)
