# bharath114-dod/campus-orbis-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/bharath114-dod/campus-orbis-frontend
- Repository: https://github.com/bharath114-dod/campus-orbis-frontend

## Overview

Campus Orbis is a role-based campus portal frontend backed by an existing Express API. Users enter through public or authenticated routes; role-specific pages support academic administration and student/faculty workflows, with shared session, notification, and API layers. The README documents attendance, courses, tests, placements, clubs, competitions, messaging, and the public board. The route table and selected components were sampled; other feature links below rely on README documentation, not inspection of their implementations.

Main entry points: [`src/routes/AppRoutes.jsx`](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/routes/AppRoutes.jsx) (Route access), [`src/services`](https://github.com/bharath114-dod/campus-orbis-frontend/tree/main/src/services) (Domain services), [`src/App.jsx`](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/App.jsx) (App providers), [`src/components/attendance/FacultyAttendance.jsx`](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/components/attendance/FacultyAttendance.jsx) (Attendance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry and access"]
  node_app["App providers<br/>[App.jsx]"]
  node_routes["Route access<br/>[AppRoutes.jsx]"]
  node_guard["Role guard<br/>[ProtectedRoute.jsx]"]
  node_dashboard["Dashboard shell"]
end

subgraph group_academics["Academic workflows"]
  node_people["People admin<br/>[HodPeople.jsx]"]
  node_attendance["Attendance"]
  node_face["Face attendance"]
  node_courses["Courses and timetable<br/>[Courses.jsx]"]
  node_tests["Tests and monitoring<br/>[Tests.jsx]"]
end

subgraph group_campus["Campus services"]
  node_placements["Placements<br/>[Placements.jsx]"]
  node_clubs["Clubs<br/>[Clubs.jsx]"]
  node_competition["Competitions<br/>[Competition.jsx]"]
  node_board["Public board<br/>[Board.jsx]"]
  node_messaging["Messaging<br/>[Messages.jsx]"]
end

subgraph group_shared["Shared client state"]
  node_auth["Session auth<br/>[AuthContext.jsx]"]
  node_notify["Notifications"]
  node_push["Push setup"]
end

subgraph group_integration["Backend integration"]
  node_services["Domain services"]
  node_api["HTTP client<br/>[api.js]"]
end

node_user(("Campus user"))
node_backend["Express backend"]

node_user -->|"opens routes"| node_routes
node_routes -->|"guards roles"| node_guard
node_routes -->|"renders shell"| node_dashboard
node_routes -->|"routes to"| node_people
node_routes -->|"routes to"| node_attendance
node_routes -->|"routes to"| node_courses
node_routes -->|"routes to"| node_tests
node_routes -->|"routes to"| node_placements
node_routes -->|"routes to"| node_clubs
node_routes -->|"routes to"| node_competition
node_routes -->|"routes to"| node_board
node_routes -->|"routes to"| node_messaging
node_app -->|"provides session"| node_auth
node_auth -->|"auth requests"| node_services
node_attendance -->|"embeds recognition"| node_face
node_people -->|"manages people"| node_services
node_attendance -->|"loads attendance"| node_services
node_competition -->|"loads quizzes"| node_services
node_tests -->|"test operations"| node_services
node_placements -->|"placement operations"| node_services
node_clubs -->|"club operations"| node_services
node_services -->|"uses client"| node_api
node_api -->|"sends requests"| node_backend
node_app -->|"provides context"| node_notify
node_app -->|"sets up push"| node_push
node_notify -->|"fetches updates"| node_services
node_push -->|"registers subscription"| node_services
node_notify -->|"feeds bell"| node_dashboard

click node_app "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/App.jsx"
click node_routes "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/routes/AppRoutes.jsx"
click node_guard "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/routes/ProtectedRoute.jsx"
click node_auth "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/context/AuthContext.jsx"
click node_dashboard "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/layouts/DashboardLayout.jsx"
click node_people "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/components/people/HodPeople.jsx"
click node_attendance "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/components/attendance/FacultyAttendance.jsx"
click node_face "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/components/attendance/FaceRecognitionAttendance.jsx"
click node_courses "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Courses.jsx"
click node_tests "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Tests.jsx"
click node_placements "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Placements.jsx"
click node_clubs "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Clubs.jsx"
click node_competition "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Competition.jsx"
click node_board "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Board.jsx"
click node_messaging "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Messages.jsx"
click node_notify "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/context/NotificationContext.jsx"
click node_push "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/hooks/usePushNotifications.js"
click node_services "https://github.com/bharath114-dod/campus-orbis-frontend/tree/main/src/services"
click node_api "https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/services/api.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_guard,node_dashboard,node_user toneBlue
class node_people,node_attendance,node_face,node_courses,node_tests toneAmber
class node_placements,node_clubs,node_competition,node_board,node_messaging toneMint
class node_auth,node_notify,node_push toneRose
class node_services,node_api,node_backend toneIndigo
```

## Components

### App entry and access

- [App providers](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/App.jsx): `src/App.jsx`
- [Route access](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/routes/AppRoutes.jsx): `src/routes/AppRoutes.jsx`
- [Role guard](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/routes/ProtectedRoute.jsx): `src/routes/ProtectedRoute.jsx`
- [Dashboard shell](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/layouts/DashboardLayout.jsx): `src/layouts/DashboardLayout.jsx`

### Academic workflows

- [People admin](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/components/people/HodPeople.jsx): `src/components/people/HodPeople.jsx`
- [Attendance](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/components/attendance/FacultyAttendance.jsx): `src/components/attendance/FacultyAttendance.jsx`
- [Face attendance](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/components/attendance/FaceRecognitionAttendance.jsx): `src/components/attendance/FaceRecognitionAttendance.jsx`
- [Courses and timetable](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Courses.jsx): `src/pages/Courses.jsx`
- [Tests and monitoring](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Tests.jsx): `src/pages/Tests.jsx`

### Campus services

- [Placements](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Placements.jsx): `src/pages/Placements.jsx`
- [Clubs](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Clubs.jsx): `src/pages/Clubs.jsx`
- [Competitions](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Competition.jsx): `src/pages/Competition.jsx`
- [Public board](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Board.jsx): `src/pages/Board.jsx`
- [Messaging](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/pages/Messages.jsx): `src/pages/Messages.jsx`

### Shared client state

- [Session auth](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Notifications](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/context/NotificationContext.jsx): `src/context/NotificationContext.jsx`
- [Push setup](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/hooks/usePushNotifications.js): `src/hooks/usePushNotifications.js`

### Backend integration

- [Domain services](https://github.com/bharath114-dod/campus-orbis-frontend/tree/main/src/services): `src/services`
- [HTTP client](https://github.com/bharath114-dod/campus-orbis-frontend/blob/main/src/services/api.js): `src/services/api.js`

### Other components

- **Campus user**
- **Express backend**

## Connections

- Campus user → Route access: opens routes (evidence: `src/routes/AppRoutes.jsx`)
- Route access → Role guard: guards roles (evidence: `src/routes/AppRoutes.jsx`)
- Route access → Dashboard shell: renders shell (evidence: `src/routes/AppRoutes.jsx`)
- Route access → People admin: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route access → Attendance: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route access → Courses and timetable: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route access → Tests and monitoring: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route access → Placements: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route access → Clubs: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route access → Competitions: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route access → Public board: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route access → Messaging: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App providers → Session auth: provides session (evidence: `src/App.jsx`)
- Session auth → Domain services: auth requests (evidence: `src/context/AuthContext.jsx`)
- Attendance → Face attendance: embeds recognition (evidence: `src/components/attendance/FacultyAttendance.jsx`)
- People admin → Domain services: manages people (evidence: `src/components/people/HodPeople.jsx`)
- Attendance → Domain services: loads attendance (evidence: `src/components/attendance/FacultyAttendance.jsx`)
- Competitions → Domain services: loads quizzes (evidence: `src/pages/Competition.jsx`)
- Tests and monitoring → Domain services: test operations
- Placements → Domain services: placement operations
- Clubs → Domain services: club operations (evidence: `src/pages/Clubs.jsx`)
- Domain services → HTTP client: uses client (evidence: `src/services/authService.js`)
- HTTP client → Express backend: sends requests
- App providers → Notifications: provides context (evidence: `src/App.jsx`)
- App providers → Push setup: sets up push (evidence: `src/App.jsx`)
- Notifications → Domain services: fetches updates (evidence: `src/context/NotificationContext.jsx`)
- Push setup → Domain services: registers subscription (evidence: `src/hooks/usePushNotifications.js`)
- Notifications → Dashboard shell: feeds bell (evidence: `src/layouts/DashboardLayout.jsx`)
