# nishanthcse910/safe-street-navigator architecture

> Architecture diagram of the GitHub repository nishanthcse910/safe-street-navigator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nishanthcse910/safe-street-navigator
- Repository: https://github.com/nishanthcse910/safe-street-navigator

## Overview

SafeStreet is a client-side street-safety navigator. Users enter through the welcome screen, then access route-risk views, maps, safety reports and history, emergency contacts/SOS, and a safety chatbot; an admin dashboard provides case management. The app routes to these page components, and the chatbot page references its service. Source excerpts do not establish the implementations or data flow behind most features, so those connections are not inferred.

Main entry points: [`street-safety-navigator-main/src/App.tsx`](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/App.tsx) (App Router), [`street-safety-navigator-main/src/pages/PathRisk.tsx`](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/PathRisk.tsx) (Route Risk), [`street-safety-navigator-main/src/pages/AdminDashboard.tsx`](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/AdminDashboard.tsx) (Admin Dashboard), [`street-safety-navigator-main/src/pages/Chatbot.tsx`](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Chatbot.tsx) (Safety Chatbot)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_app["App Router<br/>[App.tsx]"]
  node_welcome["Welcome<br/>[Index.tsx]"]
  node_home["Home Dashboard<br/>[Home.tsx]"]
  node_about["About<br/>[About.tsx]"]
  node_notfound["Not Found<br/>[NotFound.tsx]"]
end

subgraph group_navigation["Safety Navigation"]
  node_pathinput["Route Input<br/>[PathInput.tsx]"]
  node_pathrisk["Route Risk<br/>[PathRisk.tsx]"]
  node_mapinput["Map Input<br/>[MapInput.tsx]"]
  node_livemap["Live Map<br/>[LiveMap.tsx]"]
  node_mapviews["Map Components<br/>[GoogleMap.tsx]"]
  node_mockdata["Sample Cases<br/>[mockData.ts]"]
end

subgraph group_reporting["Reports &amp; Admin"]
  node_report["Submit Report<br/>[Report.tsx]"]
  node_history["Report History<br/>[ReportHistory.tsx]"]
  node_reportcard["Report Card<br/>[ReportCard.tsx]"]
  node_reportservice["Report Service<br/>[reportsService.ts]"]
  node_adminlogin["Admin Login<br/>[AdminLogin.tsx]"]
  node_admin["Admin Dashboard<br/>[AdminDashboard.tsx]"]
end

subgraph group_support["Help &amp; Settings"]
  node_chatbot["Safety Chatbot<br/>[Chatbot.tsx]"]
  node_chatservice["Chatbot Service<br/>[chatbotService.ts]"]
  node_emergency["Emergency Contacts<br/>[Emergency.tsx]"]
  node_sos["SOS<br/>[SOS.tsx]"]
  node_settings["Settings<br/>[Settings.tsx]"]
end

node_user(("User"))

node_user -->|"opens"| node_app
node_app -->|"routes /"| node_welcome
node_app -->|"routes /home"| node_home
node_app -->|"routes /about"| node_about
node_app -->|"routes fallback"| node_notfound
node_app -->|"routes /path-input"| node_pathinput
node_app -->|"routes /path-risk"| node_pathrisk
node_app -->|"routes /map-input"| node_mapinput
node_app -->|"routes /live-map"| node_livemap
node_app -->|"routes /report"| node_report
node_app -->|"routes /report-history"| node_history
node_app -->|"routes /admin-login"| node_adminlogin
node_app -->|"routes /admin-dashboard"| node_admin
node_app -->|"routes /chatbot"| node_chatbot
node_app -->|"routes /emergency"| node_emergency
node_app -->|"routes /sos"| node_sos
node_app -->|"routes /settings"| node_settings
node_chatbot -->|"uses service"| node_chatservice
node_pathrisk -->|"imports cases"| node_mockdata
node_admin -->|"imports cases"| node_mockdata

click node_app "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/App.tsx"
click node_welcome "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Index.tsx"
click node_home "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Home.tsx"
click node_about "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/About.tsx"
click node_notfound "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/NotFound.tsx"
click node_pathinput "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/PathInput.tsx"
click node_pathrisk "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/PathRisk.tsx"
click node_mapinput "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/MapInput.tsx"
click node_livemap "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/LiveMap.tsx"
click node_mapviews "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/components/GoogleMap.tsx"
click node_mockdata "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/data/mockData.ts"
click node_report "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Report.tsx"
click node_history "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/ReportHistory.tsx"
click node_reportcard "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/components/ReportCard.tsx"
click node_reportservice "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/services/reportsService.ts"
click node_adminlogin "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/AdminLogin.tsx"
click node_admin "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/AdminDashboard.tsx"
click node_chatbot "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Chatbot.tsx"
click node_chatservice "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/services/chatbotService.ts"
click node_emergency "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Emergency.tsx"
click node_sos "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/SOS.tsx"
click node_settings "https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Settings.tsx"

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_welcome,node_home,node_about,node_notfound,node_user toneBlue
class node_pathinput,node_pathrisk,node_mapinput,node_livemap,node_mapviews,node_mockdata toneAmber
class node_report,node_history,node_reportcard,node_reportservice,node_adminlogin,node_admin toneMint
class node_chatbot,node_chatservice,node_emergency,node_sos,node_settings toneRose
```

## Components

### Application Shell

- [App Router](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/App.tsx): `street-safety-navigator-main/src/App.tsx`
- [Welcome](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Index.tsx): `street-safety-navigator-main/src/pages/Index.tsx`
- [Home Dashboard](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Home.tsx): `street-safety-navigator-main/src/pages/Home.tsx`
- [About](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/About.tsx): `street-safety-navigator-main/src/pages/About.tsx`
- [Not Found](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/NotFound.tsx): `street-safety-navigator-main/src/pages/NotFound.tsx`

### Safety Navigation

- [Route Input](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/PathInput.tsx): `street-safety-navigator-main/src/pages/PathInput.tsx`
- [Route Risk](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/PathRisk.tsx): `street-safety-navigator-main/src/pages/PathRisk.tsx`
- [Map Input](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/MapInput.tsx): `street-safety-navigator-main/src/pages/MapInput.tsx`
- [Live Map](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/LiveMap.tsx): `street-safety-navigator-main/src/pages/LiveMap.tsx`
- [Map Components](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/components/GoogleMap.tsx): `street-safety-navigator-main/src/components/GoogleMap.tsx`
- [Sample Cases](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/data/mockData.ts): `street-safety-navigator-main/src/data/mockData.ts`

### Reports & Admin

- [Submit Report](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Report.tsx): `street-safety-navigator-main/src/pages/Report.tsx`
- [Report History](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/ReportHistory.tsx): `street-safety-navigator-main/src/pages/ReportHistory.tsx`
- [Report Card](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/components/ReportCard.tsx): `street-safety-navigator-main/src/components/ReportCard.tsx`
- [Report Service](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/services/reportsService.ts): `street-safety-navigator-main/src/services/reportsService.ts`
- [Admin Login](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/AdminLogin.tsx): `street-safety-navigator-main/src/pages/AdminLogin.tsx`
- [Admin Dashboard](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/AdminDashboard.tsx): `street-safety-navigator-main/src/pages/AdminDashboard.tsx`

### Help & Settings

- [Safety Chatbot](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Chatbot.tsx): `street-safety-navigator-main/src/pages/Chatbot.tsx`
- [Chatbot Service](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/services/chatbotService.ts): `street-safety-navigator-main/src/services/chatbotService.ts`
- [Emergency Contacts](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Emergency.tsx): `street-safety-navigator-main/src/pages/Emergency.tsx`
- [SOS](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/SOS.tsx): `street-safety-navigator-main/src/pages/SOS.tsx`
- [Settings](https://github.com/nishanthcse910/safe-street-navigator/blob/main/street-safety-navigator-main/src/pages/Settings.tsx): `street-safety-navigator-main/src/pages/Settings.tsx`

### Other components

- **User**

## Connections

- User → App Router: opens
- App Router → Welcome: routes / (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Home Dashboard: routes /home (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → About: routes /about (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Not Found: routes fallback (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Route Input: routes /path-input (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Route Risk: routes /path-risk (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Map Input: routes /map-input (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Live Map: routes /live-map (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Submit Report: routes /report (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Report History: routes /report-history (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Admin Login: routes /admin-login (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Admin Dashboard: routes /admin-dashboard (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Safety Chatbot: routes /chatbot (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Emergency Contacts: routes /emergency (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → SOS: routes /sos (evidence: `street-safety-navigator-main/src/App.tsx`)
- App Router → Settings: routes /settings (evidence: `street-safety-navigator-main/src/App.tsx`)
- Safety Chatbot → Chatbot Service: uses service (evidence: `street-safety-navigator-main/src/pages/Chatbot.tsx`)
- Route Risk → Sample Cases: imports cases (evidence: `street-safety-navigator-main/src/pages/PathRisk.tsx`)
- Admin Dashboard → Sample Cases: imports cases (evidence: `street-safety-navigator-main/src/pages/AdminDashboard.tsx`)
