How msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system works
Smart Campus Navigation is a student-facing campus crowd-monitoring and navigation app. Students authenticate, view zone occupancy, and check in or out; the backend updates crowd state, applies time limits, and serves live status and quieter-zone recommendations. The frontend also provides QR check-in, statistics, profile management, and zone QR codes. The README documents these capabilities, while sampled source confirms key crowd, authentication, and API paths; unsampled implementations are represented at their documented subsystem paths.
Main entry points: api.ts HTTP API client · App.tsx App routes · CrowdService.java Zone crowd state · AuthService.java Authentication
Components 28
Student app
- App routes
frontend/src/App.tsx - Auth state
frontend/src/context/AuthContext.tsx - Login and signup
frontend/src/pages - Navigation UI
frontend/src/components/Navbar.tsx - Dashboard
frontend/src/pages/DashboardPage.tsx - Live map
frontend/src/pages/LiveMapPage.tsx - QR check-in
frontend/src/pages/QRScannerPage.tsx - Zone QR codes
frontend/src/pages/QRCodesPage.tsx - Profile
frontend/src/pages/ProfilePage.tsx - HTTP API client
frontend/src/services/api.ts
Identity and security
- Auth endpoints
backend/src/main/java/com/uiu/campus/controller/AuthController.java - Authentication
backend/src/main/java/com/uiu/campus/service/AuthService.java - JWT tokens
backend/src/main/java/com/uiu/campus/security/JwtTokenProvider.java - User records
backend/src/main/java/com/uiu/campus/repository/UserRepository.java - Login controls
backend/src/main/java/com/uiu/campus/service/LoginAttemptService.java - Login attempts
backend/src/main/java/com/uiu/campus/repository/LoginAttemptRepository.java
Crowd operations
- Location endpoints
backend/src/main/java/com/uiu/campus/controller/LocationController.java - Zone crowd state
backend/src/main/java/com/uiu/campus/service/CrowdService.java - Zone occupancy
backend/src/main/java/com/uiu/campus/model/Zone.java - Timed auto-exit
backend/src/main/java/com/uiu/campus/service/TLVSchedulerService.java
Recommendations and analytics
- Recommendation endpoints
backend/src/main/java/com/uiu/campus/controller/RecommendationController.java - Recommendations
frontend/src/pages/RecommendationPage.tsx - Crowd statistics
frontend/src/pages/StatisticsPage.tsx
Persistence and realtime
- Audit logging
backend/src/main/java/com/uiu/campus/service/AuditLogService.java - Audit records
backend/src/main/java/com/uiu/campus/repository/AuditLogRepository.java - Live broadcasts
backend/src/main/java/com/uiu/campus/service/WebSocketService.java - Crowd backup
backend/src/main/java/com/uiu/campus/util/CrowdBackupUtil.java
Other components
- Student
Connections 34
- Student → App routes: uses app
- App routes → Auth state: provides state
frontend/src/App.tsx - App routes → Login and signup: routes to
frontend/src/App.tsx - App routes → Dashboard: routes to
frontend/src/App.tsx - App routes → Live map: routes to
frontend/src/App.tsx - App routes → QR check-in: routes to
frontend/src/App.tsx - App routes → Zone QR codes: routes to
frontend/src/App.tsx - App routes → Profile: routes to
frontend/src/App.tsx - Navigation UI → Auth state: reads state
frontend/src/components/Navbar.tsx - Login and signup → HTTP API client: calls auth
frontend/src/pages/SignupPage.tsx - Live map → HTTP API client: requests status
frontend/src/pages/LiveMapPage.tsx - QR check-in → HTTP API client: sends check-in
frontend/src/pages/QRScannerPage.tsx - Crowd statistics → HTTP API client: requests data
frontend/src/pages/StatisticsPage.tsx - HTTP API client → Auth endpoints: HTTP auth
- HTTP API client → Location endpoints: HTTP location
- HTTP API client → Recommendation endpoints: HTTP recommendations
- Auth endpoints → Authentication: delegates to
backend/src/main/java/com/uiu/campus/controller/AuthController.java - Authentication → User records: reads and writes
backend/src/main/java/com/uiu/campus/service/AuthService.java - Authentication → JWT tokens: issues tokens
backend/src/main/java/com/uiu/campus/service/AuthService.java - Authentication → Audit logging: records events
backend/src/main/java/com/uiu/campus/service/AuthService.java - Authentication → Login controls: tracks attempts
backend/src/main/java/com/uiu/campus/service/AuthService.java - Login controls → Login attempts: persists attempts
backend/src/main/java/com/uiu/campus/service/LoginAttemptService.java - Audit logging → Audit records: persists logs
backend/src/main/java/com/uiu/campus/service/AuditLogService.java - Location endpoints → Zone crowd state: updates and reads
backend/src/main/java/com/uiu/campus/controller/LocationController.java - Zone crowd state → Zone occupancy: manages occupancy
backend/src/main/java/com/uiu/campus/service/CrowdService.java - Zone crowd state → Timed auto-exit: schedules exits
backend/src/main/java/com/uiu/campus/service/CrowdService.java - Timed auto-exit → Zone crowd state: removes expired users
backend/src/main/java/com/uiu/campus/service/TLVSchedulerService.java - Timed auto-exit → Live broadcasts: broadcasts exit
backend/src/main/java/com/uiu/campus/service/TLVSchedulerService.java - Zone crowd state → Live broadcasts: broadcasts changes
backend/src/main/java/com/uiu/campus/service/CrowdService.java - Zone crowd state → Crowd backup: saves and restores
backend/src/main/java/com/uiu/campus/service/CrowdService.java - Recommendation endpoints → Zone crowd state: ranks zones
backend/src/main/java/com/uiu/campus/controller/RecommendationController.java - Recommendations → HTTP API client: requests suggestions
- Dashboard → HTTP API client: shows campus data
- Profile → HTTP API client: manages profile