# msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system architecture

> Architecture diagram of the GitHub repository msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system
- Repository: https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system

## Overview

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: [`frontend/src/services/api.ts`](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/services/api.ts) (HTTP API client), [`frontend/src/App.tsx`](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/App.tsx) (App routes), [`backend/src/main/java/com/uiu/campus/service/CrowdService.java`](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/CrowdService.java) (Zone crowd state), [`backend/src/main/java/com/uiu/campus/service/AuthService.java`](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Student app"]
  node_routes["App routes<br/>[App.tsx]"]
  node_auth_ui["Auth state<br/>[AuthContext.tsx]"]
  node_auth_pages["Login and signup"]
  node_navigation["Navigation UI<br/>[Navbar.tsx]"]
  node_dashboard["Dashboard<br/>[DashboardPage.tsx]"]
  node_live_map["Live map<br/>[LiveMapPage.tsx]"]
  node_qr_checkin["QR check-in<br/>[QRScannerPage.tsx]"]
  node_qr_codes["Zone QR codes<br/>[QRCodesPage.tsx]"]
  node_profile["Profile<br/>[ProfilePage.tsx]"]
  node_api_client["HTTP API client<br/>[api.ts]"]
end

subgraph group_identity["Identity and security"]
  node_auth_api["Auth endpoints"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_jwt["JWT tokens"]
  node_user_store[("User records")]
  node_login_attempts["Login controls"]
  node_attempt_store[("Login attempts")]
end

subgraph group_crowd["Crowd operations"]
  node_location_api["Location endpoints"]
  node_crowd_service["Zone crowd state<br/>[CrowdService.java]"]
  node_zone_model["Zone occupancy<br/>[Zone.java]"]
  node_tlv["Timed auto-exit"]
end

subgraph group_insights["Recommendations and analytics"]
  node_recommend_api["Recommendation endpoints"]
  node_recommend_ui["Recommendations"]
  node_statistics["Crowd statistics<br/>[StatisticsPage.tsx]"]
end

subgraph group_platform["Persistence and realtime"]
  node_audit["Audit logging"]
  node_audit_store[("Audit records")]
  node_websocket["Live broadcasts"]
  node_backup["Crowd backup"]
end

node_student(("Student"))

node_student -->|"uses app"| node_routes
node_routes -->|"provides state"| node_auth_ui
node_routes -->|"routes to"| node_auth_pages
node_routes -->|"routes to"| node_dashboard
node_routes -->|"routes to"| node_live_map
node_routes -->|"routes to"| node_qr_checkin
node_routes -->|"routes to"| node_qr_codes
node_routes -->|"routes to"| node_profile
node_navigation -->|"reads state"| node_auth_ui
node_auth_pages -->|"calls auth"| node_api_client
node_live_map -->|"requests status"| node_api_client
node_qr_checkin -->|"sends check-in"| node_api_client
node_statistics -->|"requests data"| node_api_client
node_api_client -->|"HTTP auth"| node_auth_api
node_api_client -->|"HTTP location"| node_location_api
node_api_client -->|"HTTP recommendations"| node_recommend_api
node_auth_api -->|"delegates to"| node_auth_service
node_auth_service -->|"reads and writes"| node_user_store
node_auth_service -->|"issues tokens"| node_jwt
node_auth_service -->|"records events"| node_audit
node_auth_service -->|"tracks attempts"| node_login_attempts
node_login_attempts -->|"persists attempts"| node_attempt_store
node_audit -->|"persists logs"| node_audit_store
node_location_api -->|"updates and reads"| node_crowd_service
node_crowd_service -->|"manages occupancy"| node_zone_model
node_crowd_service -->|"schedules exits"| node_tlv
node_tlv -->|"removes expired users"| node_crowd_service
node_tlv -->|"broadcasts exit"| node_websocket
node_crowd_service -.->|"broadcasts changes"| node_websocket
node_crowd_service -->|"saves and restores"| node_backup
node_recommend_api -->|"ranks zones"| node_crowd_service
node_recommend_ui -->|"requests suggestions"| node_api_client
node_dashboard -.->|"shows campus data"| node_api_client
node_profile -.->|"manages profile"| node_api_client

click node_routes "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/App.tsx"
click node_auth_ui "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/context/AuthContext.tsx"
click node_auth_pages "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/tree/main/frontend/src/pages"
click node_navigation "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/components/Navbar.tsx"
click node_dashboard "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/DashboardPage.tsx"
click node_live_map "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/LiveMapPage.tsx"
click node_qr_checkin "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/QRScannerPage.tsx"
click node_qr_codes "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/QRCodesPage.tsx"
click node_profile "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/ProfilePage.tsx"
click node_api_client "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/services/api.ts"
click node_auth_api "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/controller/AuthController.java"
click node_auth_service "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/AuthService.java"
click node_jwt "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/security/JwtTokenProvider.java"
click node_user_store "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/repository/UserRepository.java"
click node_location_api "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/controller/LocationController.java"
click node_crowd_service "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/CrowdService.java"
click node_zone_model "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/model/Zone.java"
click node_tlv "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/TLVSchedulerService.java"
click node_recommend_api "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/controller/RecommendationController.java"
click node_recommend_ui "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/RecommendationPage.tsx"
click node_statistics "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/StatisticsPage.tsx"
click node_audit "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/AuditLogService.java"
click node_audit_store "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/repository/AuditLogRepository.java"
click node_login_attempts "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/LoginAttemptService.java"
click node_attempt_store "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/repository/LoginAttemptRepository.java"
click node_websocket "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/WebSocketService.java"
click node_backup "https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/util/CrowdBackupUtil.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_routes,node_auth_ui,node_auth_pages,node_navigation,node_dashboard,node_live_map,node_qr_checkin,node_qr_codes,node_profile,node_api_client toneBlue
class node_auth_api,node_auth_service,node_jwt,node_user_store,node_login_attempts,node_attempt_store toneAmber
class node_location_api,node_crowd_service,node_zone_model,node_tlv toneMint
class node_recommend_api,node_recommend_ui,node_statistics toneRose
class node_audit,node_audit_store,node_websocket,node_backup,node_student toneIndigo
```

## Components

### Student app

- [App routes](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth state](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Login and signup](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/tree/main/frontend/src/pages): `frontend/src/pages`
- [Navigation UI](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/components/Navbar.tsx): `frontend/src/components/Navbar.tsx`
- [Dashboard](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/DashboardPage.tsx): `frontend/src/pages/DashboardPage.tsx`
- [Live map](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/LiveMapPage.tsx): `frontend/src/pages/LiveMapPage.tsx`
- [QR check-in](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/QRScannerPage.tsx): `frontend/src/pages/QRScannerPage.tsx`
- [Zone QR codes](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/QRCodesPage.tsx): `frontend/src/pages/QRCodesPage.tsx`
- [Profile](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/ProfilePage.tsx): `frontend/src/pages/ProfilePage.tsx`
- [HTTP API client](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Identity and security

- [Auth endpoints](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/controller/AuthController.java): `backend/src/main/java/com/uiu/campus/controller/AuthController.java`
- [Authentication](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/AuthService.java): `backend/src/main/java/com/uiu/campus/service/AuthService.java`
- [JWT tokens](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/security/JwtTokenProvider.java): `backend/src/main/java/com/uiu/campus/security/JwtTokenProvider.java`
- [User records](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/repository/UserRepository.java): `backend/src/main/java/com/uiu/campus/repository/UserRepository.java`
- [Login controls](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/LoginAttemptService.java): `backend/src/main/java/com/uiu/campus/service/LoginAttemptService.java`
- [Login attempts](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/repository/LoginAttemptRepository.java): `backend/src/main/java/com/uiu/campus/repository/LoginAttemptRepository.java`

### Crowd operations

- [Location endpoints](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/controller/LocationController.java): `backend/src/main/java/com/uiu/campus/controller/LocationController.java`
- [Zone crowd state](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/CrowdService.java): `backend/src/main/java/com/uiu/campus/service/CrowdService.java`
- [Zone occupancy](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/model/Zone.java): `backend/src/main/java/com/uiu/campus/model/Zone.java`
- [Timed auto-exit](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/TLVSchedulerService.java): `backend/src/main/java/com/uiu/campus/service/TLVSchedulerService.java`

### Recommendations and analytics

- [Recommendation endpoints](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/controller/RecommendationController.java): `backend/src/main/java/com/uiu/campus/controller/RecommendationController.java`
- [Recommendations](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/RecommendationPage.tsx): `frontend/src/pages/RecommendationPage.tsx`
- [Crowd statistics](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/frontend/src/pages/StatisticsPage.tsx): `frontend/src/pages/StatisticsPage.tsx`

### Persistence and realtime

- [Audit logging](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/AuditLogService.java): `backend/src/main/java/com/uiu/campus/service/AuditLogService.java`
- [Audit records](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/repository/AuditLogRepository.java): `backend/src/main/java/com/uiu/campus/repository/AuditLogRepository.java`
- [Live broadcasts](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/service/WebSocketService.java): `backend/src/main/java/com/uiu/campus/service/WebSocketService.java`
- [Crowd backup](https://github.com/msakib2310478-cmd/smart-campus-navigation-crowd-density-monitoring-system/blob/main/backend/src/main/java/com/uiu/campus/util/CrowdBackupUtil.java): `backend/src/main/java/com/uiu/campus/util/CrowdBackupUtil.java`

### Other components

- **Student**

## Connections

- Student → App routes: uses app
- App routes → Auth state: provides state (evidence: `frontend/src/App.tsx`)
- App routes → Login and signup: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Dashboard: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Live map: routes to (evidence: `frontend/src/App.tsx`)
- App routes → QR check-in: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Zone QR codes: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Profile: routes to (evidence: `frontend/src/App.tsx`)
- Navigation UI → Auth state: reads state (evidence: `frontend/src/components/Navbar.tsx`)
- Login and signup → HTTP API client: calls auth (evidence: `frontend/src/pages/SignupPage.tsx`)
- Live map → HTTP API client: requests status (evidence: `frontend/src/pages/LiveMapPage.tsx`)
- QR check-in → HTTP API client: sends check-in (evidence: `frontend/src/pages/QRScannerPage.tsx`)
- Crowd statistics → HTTP API client: requests data (evidence: `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 (evidence: `backend/src/main/java/com/uiu/campus/controller/AuthController.java`)
- Authentication → User records: reads and writes (evidence: `backend/src/main/java/com/uiu/campus/service/AuthService.java`)
- Authentication → JWT tokens: issues tokens (evidence: `backend/src/main/java/com/uiu/campus/service/AuthService.java`)
- Authentication → Audit logging: records events (evidence: `backend/src/main/java/com/uiu/campus/service/AuthService.java`)
- Authentication → Login controls: tracks attempts (evidence: `backend/src/main/java/com/uiu/campus/service/AuthService.java`)
- Login controls → Login attempts: persists attempts (evidence: `backend/src/main/java/com/uiu/campus/service/LoginAttemptService.java`)
- Audit logging → Audit records: persists logs (evidence: `backend/src/main/java/com/uiu/campus/service/AuditLogService.java`)
- Location endpoints → Zone crowd state: updates and reads (evidence: `backend/src/main/java/com/uiu/campus/controller/LocationController.java`)
- Zone crowd state → Zone occupancy: manages occupancy (evidence: `backend/src/main/java/com/uiu/campus/service/CrowdService.java`)
- Zone crowd state → Timed auto-exit: schedules exits (evidence: `backend/src/main/java/com/uiu/campus/service/CrowdService.java`)
- Timed auto-exit → Zone crowd state: removes expired users (evidence: `backend/src/main/java/com/uiu/campus/service/TLVSchedulerService.java`)
- Timed auto-exit → Live broadcasts: broadcasts exit (evidence: `backend/src/main/java/com/uiu/campus/service/TLVSchedulerService.java`)
- Zone crowd state → Live broadcasts: broadcasts changes (evidence: `backend/src/main/java/com/uiu/campus/service/CrowdService.java`)
- Zone crowd state → Crowd backup: saves and restores (evidence: `backend/src/main/java/com/uiu/campus/service/CrowdService.java`)
- Recommendation endpoints → Zone crowd state: ranks zones (evidence: `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
