How bharath114-dod/campus-orbis-frontend works
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: AppRoutes.jsx Route access · services Domain services · App.jsx App providers · FacultyAttendance.jsx Attendance
Components 21
App entry and access
- App providers
src/App.jsx - Route access
src/routes/AppRoutes.jsx - Role guard
src/routes/ProtectedRoute.jsx - Dashboard shell
src/layouts/DashboardLayout.jsx
Academic workflows
- People admin
src/components/people/HodPeople.jsx - Attendance
src/components/attendance/FacultyAttendance.jsx - Face attendance
src/components/attendance/FaceRecognitionAttendance.jsx - Courses and timetable
src/pages/Courses.jsx - Tests and monitoring
src/pages/Tests.jsx
Campus services
- Placements
src/pages/Placements.jsx - Clubs
src/pages/Clubs.jsx - Competitions
src/pages/Competition.jsx - Public board
src/pages/Board.jsx - Messaging
src/pages/Messages.jsx
Shared client state
- Session auth
src/context/AuthContext.jsx - Notifications
src/context/NotificationContext.jsx - Push setup
src/hooks/usePushNotifications.js
Backend integration
- Domain services
src/services - HTTP client
src/services/api.js
Other components
- Campus user
- Express backend
Connections 28
- Campus user → Route access: opens routes
src/routes/AppRoutes.jsx - Route access → Role guard: guards roles
src/routes/AppRoutes.jsx - Route access → Dashboard shell: renders shell
src/routes/AppRoutes.jsx - Route access → People admin: routes to
src/routes/AppRoutes.jsx - Route access → Attendance: routes to
src/routes/AppRoutes.jsx - Route access → Courses and timetable: routes to
src/routes/AppRoutes.jsx - Route access → Tests and monitoring: routes to
src/routes/AppRoutes.jsx - Route access → Placements: routes to
src/routes/AppRoutes.jsx - Route access → Clubs: routes to
src/routes/AppRoutes.jsx - Route access → Competitions: routes to
src/routes/AppRoutes.jsx - Route access → Public board: routes to
src/routes/AppRoutes.jsx - Route access → Messaging: routes to
src/routes/AppRoutes.jsx - App providers → Session auth: provides session
src/App.jsx - Session auth → Domain services: auth requests
src/context/AuthContext.jsx - Attendance → Face attendance: embeds recognition
src/components/attendance/FacultyAttendance.jsx - People admin → Domain services: manages people
src/components/people/HodPeople.jsx - Attendance → Domain services: loads attendance
src/components/attendance/FacultyAttendance.jsx - Competitions → Domain services: loads quizzes
src/pages/Competition.jsx - Tests and monitoring → Domain services: test operations
- Placements → Domain services: placement operations
- Clubs → Domain services: club operations
src/pages/Clubs.jsx - Domain services → HTTP client: uses client
src/services/authService.js - HTTP client → Express backend: sends requests
- App providers → Notifications: provides context
src/App.jsx - App providers → Push setup: sets up push
src/App.jsx - Notifications → Domain services: fetches updates
src/context/NotificationContext.jsx - Push setup → Domain services: registers subscription
src/hooks/usePushNotifications.js - Notifications → Dashboard shell: feeds bell
src/layouts/DashboardLayout.jsx