# trishgupta44/smart-campus-navigation-system architecture

> Architecture diagram of the GitHub repository trishgupta44/smart-campus-navigation-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/trishgupta44/smart-campus-navigation-system
- Repository: https://github.com/trishgupta44/smart-campus-navigation-system

## Overview

SCNS is a Flask-based campus navigation web app for JIIT Sector 128. Visitors can browse a campus map or choose two locations to see a route page with a distance and walking-time estimate; the map also supports walking directions through OSRM. Separate modules present accessibility routes, time-bucketed events with add/delete actions, and an indoor beacon registry. The graph reflects the sampled Flask routes and CSV handling, plus capabilities documented in the README; frontend request wiring was not sampled.

Main entry points: [`app.py`](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/app.py) (Flask routes), [`templates/campus_map.html`](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/campus_map.html) (Campus map), [`data/events.csv`](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/data/events.csv) (Event records), [`templates/home.html`](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/home.html) (Route form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Campus navigation"]
  node_map_page["Campus map<br/>[campus_map.html]"]
  node_location_api["Location API<br/>[app.py]"]
  node_route_form["Route form<br/>[home.html]"]
  node_route_result["Route result<br/>[result.html]"]
  node_route_api["Directions API<br/>[app.py]"]
end

subgraph group_campus_data["Campus data"]
  node_locations_csv[("Location records<br/>[locations.csv]")]
  node_accessibility_data[("Accessibility records<br/>[accessibility.csv]")]
  node_events_data[("Event records<br/>[events.csv]")]
  node_beacon_data[("Beacon records<br/>[indoor_beacons.csv]")]
end

subgraph group_campus_services["Campus services"]
  node_accessibility_page["Accessibility routes<br/>[accessibility.html]"]
  node_events_page["Events feed<br/>[events.html]"]
  node_events_manage["Event management<br/>[app.py]"]
  node_indoor_page["Indoor registry<br/>[indoor.html]"]
end

subgraph group_web_app["Web application"]
  node_flask_app["Flask routes<br/>[app.py]"]
end

node_visitor(("Visitor"))
node_osrm["OSRM router"]
node_osm_tiles["OSM tiles"]

node_visitor -->|"requests pages"| node_flask_app
node_flask_app -->|"renders map"| node_map_page
node_flask_app -->|"renders form"| node_route_form
node_flask_app -->|"renders result"| node_route_result
node_flask_app -->|"loads locations"| node_locations_csv
node_flask_app -->|"serves locations"| node_location_api
node_map_page -.->|"requests locations"| node_location_api
node_map_page -.->|"displays tiles"| node_osm_tiles
node_flask_app -->|"serves directions"| node_route_api
node_route_api -->|"requests route"| node_osrm
node_map_page -.->|"requests directions"| node_route_api
node_flask_app -->|"loads routes"| node_accessibility_data
node_flask_app -->|"renders routes"| node_accessibility_page
node_flask_app -->|"loads events"| node_events_data
node_flask_app -->|"renders feed"| node_events_page
node_events_manage -->|"writes events"| node_events_data
node_flask_app -->|"renders registry"| node_indoor_page
node_flask_app -->|"loads beacons"| node_beacon_data

click node_flask_app "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/app.py"
click node_map_page "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/campus_map.html"
click node_location_api "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/app.py"
click node_locations_csv "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/data/locations.csv"
click node_route_form "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/home.html"
click node_route_result "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/result.html"
click node_route_api "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/app.py"
click node_accessibility_page "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/accessibility.html"
click node_accessibility_data "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/data/accessibility.csv"
click node_events_page "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/events.html"
click node_events_manage "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/app.py"
click node_events_data "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/data/events.csv"
click node_indoor_page "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/indoor.html"
click node_beacon_data "https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/data/indoor_beacons.csv"

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_map_page,node_location_api,node_route_form,node_route_result,node_route_api toneBlue
class node_locations_csv,node_accessibility_data,node_events_data,node_beacon_data toneAmber
class node_accessibility_page,node_events_page,node_events_manage,node_indoor_page,node_osrm toneMint
class node_flask_app toneRose
class node_visitor,node_osm_tiles toneIndigo
```

## Components

### Campus navigation

- [Campus map](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/campus_map.html): `templates/campus_map.html`
- [Location API](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/app.py): `app.py`
- [Route form](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/home.html): `templates/home.html`
- [Route result](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/result.html): `templates/result.html`
- [Directions API](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/app.py): `app.py`

### Campus data

- [Location records](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/data/locations.csv): `data/locations.csv`
- [Accessibility records](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/data/accessibility.csv): `data/accessibility.csv`
- [Event records](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/data/events.csv): `data/events.csv`
- [Beacon records](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/data/indoor_beacons.csv): `data/indoor_beacons.csv`

### Campus services

- [Accessibility routes](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/accessibility.html): `templates/accessibility.html`
- [Events feed](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/events.html): `templates/events.html`
- [Event management](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/app.py): `app.py`
- [Indoor registry](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/templates/indoor.html): `templates/indoor.html`

### Web application

- [Flask routes](https://github.com/trishgupta44/smart-campus-navigation-system/blob/main/app.py): `app.py`

### Other components

- **Visitor**
- **OSRM router**
- **OSM tiles**

## Connections

- Visitor → Flask routes: requests pages (evidence: `README.md`)
- Flask routes → Campus map: renders map (evidence: `app.py`)
- Flask routes → Route form: renders form (evidence: `app.py`)
- Flask routes → Route result: renders result (evidence: `app.py`)
- Flask routes → Location records: loads locations (evidence: `app.py`)
- Flask routes → Location API: serves locations (evidence: `app.py`)
- Campus map → Location API: requests locations (evidence: `README.md`)
- Campus map → OSM tiles: displays tiles (evidence: `README.md`)
- Flask routes → Directions API: serves directions (evidence: `app.py`)
- Directions API → OSRM router: requests route (evidence: `app.py`)
- Campus map → Directions API: requests directions (evidence: `README.md`)
- Flask routes → Accessibility records: loads routes (evidence: `app.py`)
- Flask routes → Accessibility routes: renders routes (evidence: `app.py`)
- Flask routes → Event records: loads events (evidence: `app.py`)
- Flask routes → Events feed: renders feed (evidence: `app.py`)
- Event management → Event records: writes events (evidence: `app.py`)
- Flask routes → Indoor registry: renders registry (evidence: `app.py`)
- Flask routes → Beacon records: loads beacons (evidence: `app.py`)
