# nikithaganesh26-svg/smart-campus architecture

> Architecture diagram of the GitHub repository nikithaganesh26-svg/smart-campus, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nikithaganesh26-svg/smart-campus
- Repository: https://github.com/nikithaganesh26-svg/smart-campus

## Overview

Smart Campus combines a visitor-facing campus site with campus mapping and walking directions, visitor check-in/check-out, and visitor analytics. Users enter through the web app, which selects login or a campus page; map and chatbot navigation requests go through the backend to route calculation. Visitor records are stored and also support analytics. The excerpts establish these runtime links, but do not show how login/check-in is implemented or how map data files are loaded, so those relationships are omitted.

Main entry points: [`Frontend/src/app.jsx`](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/app.jsx) (App and routing), [`backend/routes/navigationRoutes.js`](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/routes/navigationRoutes.js) (Navigation API), [`backend/server.js`](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/server.js) (Express server), [`navigation/navigation.js`](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/navigation/navigation.js) (Route calculation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Campus Web App"]
  node_app["App and routing<br/>[app.jsx]"]
  node_login["Login<br/>[Login.jsx]"]
  node_home["Home<br/>[Home.jsx]"]
  node_about["About<br/>[about.jsx]"]
  node_rating["Rating<br/>[Rating.jsx]"]
  node_navbar["Navigation bar<br/>[Navbar.jsx]"]
  node_chatbot["Campus chatbot<br/>[Chatbot.jsx]"]
end

subgraph group_navigation["Maps and Navigation"]
  node_campusmap["Campus map<br/>[CampusMap.jsx]"]
  node_routing["Route calculation<br/>[navigation.js]"]
  node_search["Location search<br/>[search.js]"]
end

subgraph group_visitors["Visitor Operations"]
  node_visitorapi["Visitor API<br/>[visitorRoutes.js]"]
  node_visitorcontroller["Visitor operations"]
  node_visitordb[("Visitor records<br/>[visitor.js]")]
  node_analyticsapi["Analytics API<br/>[analyticsRoutes.js]"]
  node_analytics["Visitor analytics"]
end

subgraph group_backend["Backend Runtime"]
  node_navroutes["Navigation API"]
  node_server["Express server<br/>[server.js]"]
end

node_visitor(("Campus visitor"))
node_valhalla["Valhalla routing"]

node_visitor -->|"uses"| node_app
node_app -->|"shows"| node_login
node_app -->|"shows"| node_home
node_app -->|"shows"| node_about
node_app -->|"shows"| node_rating
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_chatbot
node_app -->|"shows"| node_campusmap
node_app -->|"checks out via"| node_visitorapi
node_campusmap -->|"requests route"| node_navroutes
node_chatbot -->|"requests route"| node_navroutes
node_server -->|"mounts"| node_navroutes
node_server -->|"mounts"| node_visitorapi
node_server -->|"mounts"| node_analyticsapi
node_navroutes -->|"calls"| node_routing
node_routing -->|"finds locations"| node_search
node_routing -->|"requests routes"| node_valhalla
node_visitorapi -->|"dispatches"| node_visitorcontroller
node_visitorcontroller -->|"reads and writes"| node_visitordb
node_analyticsapi -->|"dispatches"| node_analytics
node_analytics -->|"reads"| node_visitordb

click node_app "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/app.jsx"
click node_login "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/pages/Login.jsx"
click node_home "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/pages/Home.jsx"
click node_about "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/pages/about.jsx"
click node_rating "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/pages/Rating.jsx"
click node_navbar "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/components/Navbar.jsx"
click node_chatbot "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/components/Chatbot.jsx"
click node_campusmap "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/pages/CampusMap.jsx"
click node_navroutes "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/routes/navigationRoutes.js"
click node_routing "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/navigation/navigation.js"
click node_search "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/navigation/search.js"
click node_server "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/server.js"
click node_visitorapi "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/routes/visitorRoutes.js"
click node_visitorcontroller "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/controllers/visitorController.js"
click node_visitordb "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/models/visitor.js"
click node_analyticsapi "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/analytics/analyticsRoutes.js"
click node_analytics "https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/analytics/visitorAnalytics.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_login,node_home,node_about,node_rating,node_navbar,node_chatbot toneBlue
class node_campusmap,node_routing,node_search toneAmber
class node_visitorapi,node_visitorcontroller,node_visitordb,node_analyticsapi,node_analytics toneMint
class node_navroutes,node_server toneRose
class node_visitor,node_valhalla toneIndigo
```

## Components

### Campus Web App

- [App and routing](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/app.jsx): `Frontend/src/app.jsx`
- [Login](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/pages/Login.jsx): `Frontend/src/pages/Login.jsx`
- [Home](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/pages/Home.jsx): `Frontend/src/pages/Home.jsx`
- [About](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/pages/about.jsx): `Frontend/src/pages/about.jsx`
- [Rating](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/pages/Rating.jsx): `Frontend/src/pages/Rating.jsx`
- [Navigation bar](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/components/Navbar.jsx): `Frontend/src/components/Navbar.jsx`
- [Campus chatbot](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/components/Chatbot.jsx): `Frontend/src/components/Chatbot.jsx`

### Maps and Navigation

- [Campus map](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/Frontend/src/pages/CampusMap.jsx): `Frontend/src/pages/CampusMap.jsx`
- [Route calculation](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/navigation/navigation.js): `navigation/navigation.js`
- [Location search](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/navigation/search.js): `navigation/search.js`

### Visitor Operations

- [Visitor API](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/routes/visitorRoutes.js): `backend/routes/visitorRoutes.js`
- [Visitor operations](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/controllers/visitorController.js): `backend/controllers/visitorController.js`
- [Visitor records](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/models/visitor.js): `backend/models/visitor.js`
- [Analytics API](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/analytics/analyticsRoutes.js): `backend/analytics/analyticsRoutes.js`
- [Visitor analytics](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/analytics/visitorAnalytics.js): `backend/analytics/visitorAnalytics.js`

### Backend Runtime

- [Navigation API](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/routes/navigationRoutes.js): `backend/routes/navigationRoutes.js`
- [Express server](https://github.com/nikithaganesh26-svg/smart-campus/blob/main/backend/server.js): `backend/server.js`

### Other components

- **Campus visitor**
- **Valhalla routing**

## Connections

- Campus visitor → App and routing: uses
- App and routing → Login: shows (evidence: `Frontend/src/app.jsx`)
- App and routing → Home: shows (evidence: `Frontend/src/app.jsx`)
- App and routing → About: shows (evidence: `Frontend/src/app.jsx`)
- App and routing → Rating: shows (evidence: `Frontend/src/app.jsx`)
- App and routing → Navigation bar: renders (evidence: `Frontend/src/app.jsx`)
- App and routing → Campus chatbot: renders (evidence: `Frontend/src/app.jsx`)
- App and routing → Campus map: shows (evidence: `Frontend/src/app.jsx`)
- App and routing → Visitor API: checks out via (evidence: `Frontend/src/app.jsx`)
- Campus map → Navigation API: requests route (evidence: `Frontend/src/pages/CampusMap.jsx`)
- Campus chatbot → Navigation API: requests route (evidence: `Frontend/src/components/Chatbot.jsx`)
- Express server → Navigation API: mounts (evidence: `backend/server.js`)
- Express server → Visitor API: mounts (evidence: `backend/server.js`)
- Express server → Analytics API: mounts (evidence: `backend/server.js`)
- Navigation API → Route calculation: calls (evidence: `backend/routes/navigationRoutes.js`)
- Route calculation → Location search: finds locations (evidence: `navigation/navigation.js`)
- Route calculation → Valhalla routing: requests routes (evidence: `navigation/navigation.js`)
- Visitor API → Visitor operations: dispatches (evidence: `backend/routes/visitorRoutes.js`)
- Visitor operations → Visitor records: reads and writes (evidence: `backend/controllers/visitorController.js`)
- Analytics API → Visitor analytics: dispatches (evidence: `backend/analytics/analyticsRoutes.js`)
- Visitor analytics → Visitor records: reads (evidence: `backend/analytics/visitorAnalytics.js`)
