# pranay-44/jansuvidha- architecture

> Architecture diagram of the GitHub repository pranay-44/jansuvidha-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pranay-44/jansuvidha-
- Repository: https://github.com/pranay-44/jansuvidha-

## Overview

JanSuvidha is a citizen-services web and Android application for finding local amenities, viewing mapped facility details, and using account and complaint features. The user-facing path is documented from the app to facility records and the map; accounts and complaints require the Node/MySQL server, while amenity browsing and local reviews work offline. The graph also preserves the documented dataset-import and bus-stop capabilities. Frontend modules and some API routes were not excerpted, so uncertain connections are omitted or marked unverified.

Main entry points: [`dist/app.js`](https://github.com/pranay-44/jansuvidha-/blob/main/dist/app.js) (Web interface), [`scripts/api.mjs`](https://github.com/pranay-44/jansuvidha-/blob/main/scripts/api.mjs) (HTTP API), [`scripts/accounts.mjs`](https://github.com/pranay-44/jansuvidha-/blob/main/scripts/accounts.mjs) (Account services), [`scripts/social-auth.mjs`](https://github.com/pranay-44/jansuvidha-/blob/main/scripts/social-auth.mjs) (Social sign-in)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Citizen app"]
  node_web["Web interface<br/>[app.js]"]
  node_map["Street map<br/>[facility-map.js]"]
  node_accountui["Account UI<br/>[account.js]"]
  node_busui["Bus stop UI<br/>[bus-stops.js]"]
end

subgraph group_data["Facility and transit data"]
  node_facilitydata["Facility records<br/>[data.js]"]
  node_busdata["Bus stop records<br/>[stops.js]"]
  node_thaneimport["Facility importer<br/>[import-thane.mjs]"]
  node_busimport["Bus importer<br/>[import-bus.mjs]"]
  node_buspipeline["Bus data pipeline<br/>[pipeline.py]"]
end

subgraph group_identity["Accounts and identity"]
  node_accounts["Account services<br/>[accounts.mjs]"]
  node_authsecurity["Auth security<br/>[auth-security.mjs]"]
  node_socialauth["Social sign-in<br/>[social-auth.mjs]"]
end

subgraph group_server["Service backend"]
  node_serverentry["Server startup<br/>[server.mjs]"]
  node_api["HTTP API<br/>[api.mjs]"]
  node_mysql[("MySQL database<br/>[db.mjs]")]
end

node_citizen(("Citizen"))
node_oauth(("Google / Facebook"))
node_mail(("Email provider"))
node_tiles(("OpenStreetMap tiles"))

node_citizen -->|"uses"| node_web
node_web -.->|"shows listings"| node_facilitydata
node_web -->|"shows locations"| node_map
node_map -->|"loads tiles"| node_tiles
node_web -.->|"offers accounts"| node_accountui
node_web -.->|"shows bus stops"| node_busui
node_thaneimport -->|"generates records"| node_facilitydata
node_buspipeline -.->|"supplies data"| node_busimport
node_busimport -->|"imports stops"| node_busdata
node_serverentry -->|"connects"| node_mysql
node_serverentry -->|"starts app"| node_api
node_api -->|"queries"| node_mysql
node_api -->|"uses services"| node_accounts
node_accounts -->|"reads and writes"| node_mysql
node_accounts -->|"uses security"| node_authsecurity
node_api -->|"validates requests"| node_authsecurity
node_api -->|"installs sign-in"| node_socialauth
node_socialauth -->|"exchanges identity"| node_oauth
node_socialauth -->|"stores identities"| node_mysql
node_socialauth -->|"writes audit"| node_accounts
node_accounts -->|"sends account links"| node_mail
node_web -->|"uses server features"| node_serverentry

click node_web "https://github.com/pranay-44/jansuvidha-/blob/main/dist/app.js"
click node_map "https://github.com/pranay-44/jansuvidha-/blob/main/dist/facility-map.js"
click node_accountui "https://github.com/pranay-44/jansuvidha-/blob/main/dist/account.js"
click node_busui "https://github.com/pranay-44/jansuvidha-/blob/main/dist/bus-stops.js"
click node_facilitydata "https://github.com/pranay-44/jansuvidha-/blob/main/dist/data.js"
click node_busdata "https://github.com/pranay-44/jansuvidha-/blob/main/dist/data/bus/stops.js"
click node_thaneimport "https://github.com/pranay-44/jansuvidha-/blob/main/scripts/import-thane.mjs"
click node_busimport "https://github.com/pranay-44/jansuvidha-/blob/main/scripts/import-bus.mjs"
click node_buspipeline "https://github.com/pranay-44/jansuvidha-/blob/main/bus-pipeline/pipeline.py"
click node_serverentry "https://github.com/pranay-44/jansuvidha-/blob/main/scripts/server.mjs"
click node_api "https://github.com/pranay-44/jansuvidha-/blob/main/scripts/api.mjs"
click node_mysql "https://github.com/pranay-44/jansuvidha-/blob/main/scripts/db.mjs"
click node_accounts "https://github.com/pranay-44/jansuvidha-/blob/main/scripts/accounts.mjs"
click node_authsecurity "https://github.com/pranay-44/jansuvidha-/blob/main/scripts/auth-security.mjs"
click node_socialauth "https://github.com/pranay-44/jansuvidha-/blob/main/scripts/social-auth.mjs"

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_web,node_map,node_accountui,node_busui toneBlue
class node_facilitydata,node_busdata,node_thaneimport,node_busimport,node_buspipeline toneAmber
class node_accounts,node_authsecurity,node_socialauth toneMint
class node_serverentry,node_api,node_mysql toneRose
class node_citizen,node_oauth,node_mail,node_tiles toneIndigo
```

## Components

### Citizen app

- [Web interface](https://github.com/pranay-44/jansuvidha-/blob/main/dist/app.js): `dist/app.js`
- [Street map](https://github.com/pranay-44/jansuvidha-/blob/main/dist/facility-map.js): `dist/facility-map.js`
- [Account UI](https://github.com/pranay-44/jansuvidha-/blob/main/dist/account.js): `dist/account.js`
- [Bus stop UI](https://github.com/pranay-44/jansuvidha-/blob/main/dist/bus-stops.js): `dist/bus-stops.js`

### Facility and transit data

- [Facility records](https://github.com/pranay-44/jansuvidha-/blob/main/dist/data.js): `dist/data.js`
- [Bus stop records](https://github.com/pranay-44/jansuvidha-/blob/main/dist/data/bus/stops.js): `dist/data/bus/stops.js`
- [Facility importer](https://github.com/pranay-44/jansuvidha-/blob/main/scripts/import-thane.mjs): `scripts/import-thane.mjs`
- [Bus importer](https://github.com/pranay-44/jansuvidha-/blob/main/scripts/import-bus.mjs): `scripts/import-bus.mjs`
- [Bus data pipeline](https://github.com/pranay-44/jansuvidha-/blob/main/bus-pipeline/pipeline.py): `bus-pipeline/pipeline.py`

### Accounts and identity

- [Account services](https://github.com/pranay-44/jansuvidha-/blob/main/scripts/accounts.mjs): `scripts/accounts.mjs`
- [Auth security](https://github.com/pranay-44/jansuvidha-/blob/main/scripts/auth-security.mjs): `scripts/auth-security.mjs`
- [Social sign-in](https://github.com/pranay-44/jansuvidha-/blob/main/scripts/social-auth.mjs): `scripts/social-auth.mjs`

### Service backend

- [Server startup](https://github.com/pranay-44/jansuvidha-/blob/main/scripts/server.mjs): `scripts/server.mjs`
- [HTTP API](https://github.com/pranay-44/jansuvidha-/blob/main/scripts/api.mjs): `scripts/api.mjs`
- [MySQL database](https://github.com/pranay-44/jansuvidha-/blob/main/scripts/db.mjs): `scripts/db.mjs`

### Other components

- **Citizen**
- **Google / Facebook**
- **Email provider**
- **OpenStreetMap tiles**

## Connections

- Citizen → Web interface: uses (evidence: `README.md`)
- Web interface → Facility records: shows listings
- Web interface → Street map: shows locations (evidence: `README.md`)
- Street map → OpenStreetMap tiles: loads tiles (evidence: `README.md`)
- Web interface → Account UI: offers accounts
- Web interface → Bus stop UI: shows bus stops
- Facility importer → Facility records: generates records (evidence: `README.md`)
- Bus data pipeline → Bus importer: supplies data
- Bus importer → Bus stop records: imports stops (evidence: `README.md`)
- Server startup → MySQL database: connects (evidence: `scripts/server.mjs`)
- Server startup → HTTP API: starts app (evidence: `scripts/server.mjs`)
- HTTP API → MySQL database: queries (evidence: `scripts/api.mjs`)
- HTTP API → Account services: uses services (evidence: `scripts/api.mjs`)
- Account services → MySQL database: reads and writes (evidence: `scripts/accounts.mjs`)
- Account services → Auth security: uses security (evidence: `scripts/accounts.mjs`)
- HTTP API → Auth security: validates requests (evidence: `scripts/api.mjs`)
- HTTP API → Social sign-in: installs sign-in (evidence: `scripts/api.mjs`)
- Social sign-in → Google / Facebook: exchanges identity (evidence: `scripts/social-auth.mjs`)
- Social sign-in → MySQL database: stores identities (evidence: `scripts/social-auth.mjs`)
- Social sign-in → Account services: writes audit (evidence: `scripts/social-auth.mjs`)
- Account services → Email provider: sends account links (evidence: `scripts/accounts.mjs`)
- Web interface → Server startup: uses server features (evidence: `README.md`)
