# deepakbhandari-kozmo/divyadrishti architecture

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

- Interactive diagram: https://gitdiagram.com/deepakbhandari-kozmo/divyadrishti
- Repository: https://github.com/deepakbhandari-kozmo/divyadrishti

## Overview

Divyadrishti is a Flask-backed GIS mapping and research portal. Users open the map, browse GeoServer workspaces and layers, and inspect geographic features; account registration, login, and profiles support controlled access. Administrators manage users and review analytics and system health, with notifications for notable events. The README also documents bilingual UI and PDF map export. The graph combines documented capabilities with the sampled code and SOURCE INDEX; unsampled routes and frontend wiring are not inferred beyond those explicit references.

Main entry points: [`app.py`](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/app.py) (Flask application), [`api/analytics_data.py`](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/api/analytics_data.py) (Analytics API), [`firebase_config.py`](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/firebase_config.py) (Firebase service), [`static/js/notifications.js`](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/notifications.js) (Notifications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_flask["Flask application<br/>[app.py]"]
  node_pages["Web pages"]
end

subgraph group_identity["Identity and storage"]
  node_authui["Login and registration<br/>[login.js]"]
  node_register["Registration UI<br/>[register.js]"]
  node_profile["Profile management<br/>[profile.js]"]
  node_backendfirebase["Firebase service<br/>[firebase_config.py]"]
  node_firestore[("Firestore data")]
  node_firebaseui["Firebase client config<br/>[firebase-config.js]"]
end

subgraph group_mapping["GIS mapping"]
  node_map["Interactive map<br/>[map.js]"]
  node_geoserver["GeoServer"]
  node_basemaps["Map tile services"]
end

subgraph group_operations["Admin and analytics"]
  node_schema["Analytics data model<br/>[database_schema.py]"]
  node_tracker["Session tracking<br/>[session_tracker.py]"]
  node_analyticsapi["Analytics API<br/>[analytics_data.py]"]
  node_analyticsdata[("Analytics storage<br/>[analytics_data.py]")]
  node_dashboard["Admin dashboard<br/>[dashboard.js]"]
  node_analytics["Analytics interface<br/>[analytics.js]"]
  node_processor["Analytics processor"]
  node_realtime["Realtime dashboard"]
  node_health["System health<br/>[system-health.js]"]
  node_monitor["System monitor<br/>[system-monitor.js]"]
  node_status["Status monitor"]
end

subgraph group_experience["Interface features"]
  node_language["English and Hindi"]
  node_notifications["Notifications<br/>[notifications.js]"]
  node_triggers["Notification triggers"]
  node_toast["Toast messages"]
  node_init["UI initialization<br/>[init-manager.js]"]
end

node_visitor(("Map user"))
node_admin(("Administrator"))

node_visitor -->|"opens application"| node_flask
node_admin -->|"uses admin tools"| node_flask
node_flask -->|"renders pages"| node_pages
node_flask -->|"uses"| node_backendfirebase
node_flask -->|"loads"| node_analyticsapi
node_flask -->|"loads"| node_tracker
node_flask -->|"serves GIS requests"| node_geoserver
node_flask -->|"provides map interface"| node_map
node_flask -->|"provides analytics endpoints"| node_analyticsapi
node_flask -->|"exports map PDF"| node_pages
node_authui -->|"submits login"| node_flask
node_register -->|"submits registration"| node_flask
node_profile -->|"manages profile"| node_backendfirebase
node_backendfirebase -->|"accesses"| node_firestore
node_backendfirebase -->|"provides database access"| node_schema
node_schema -->|"stores analytics records"| node_firestore
node_tracker -->|"records activity"| node_schema
node_analyticsapi -->|"queries metrics"| node_schema
node_analyticsapi -->|"updates fallback data"| node_analyticsdata
node_dashboard -->|"presents analytics"| node_analytics
node_analytics -->|"requests metrics"| node_analyticsapi
node_processor -->|"processes analytics data"| node_analyticsapi
node_realtime -->|"enhances dashboard"| node_dashboard
node_monitor -->|"monitors performance"| node_health
node_status -->|"reports system status"| node_health
node_map -->|"loads layers and features"| node_geoserver
node_map -->|"loads base layers"| node_basemaps
node_language -->|"translates interface"| node_pages
node_notifications -->|"reads and writes alerts"| node_firestore
node_triggers -->|"creates alerts"| node_notifications
node_dashboard -->|"shows notifications"| node_notifications
node_notifications -->|"shows feedback"| node_toast
node_init -->|"initializes"| node_analytics
node_init -->|"initializes"| node_processor
node_init -->|"initializes"| node_realtime
node_firebaseui -.->|"configures client access"| node_firestore

click node_flask "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/app.py"
click node_pages "https://github.com/deepakbhandari-kozmo/divyadrishti/tree/main/templates"
click node_authui "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/login.js"
click node_register "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/register.js"
click node_profile "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/profile.js"
click node_backendfirebase "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/firebase_config.py"
click node_schema "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/database_schema.py"
click node_tracker "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/session_tracker.py"
click node_analyticsapi "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/api/analytics_data.py"
click node_analyticsdata "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/api/analytics_data.py"
click node_dashboard "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/dashboard.js"
click node_analytics "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/analytics.js"
click node_processor "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/real-analytics-processor.js"
click node_realtime "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/realtime-dashboard.js"
click node_health "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/system-health.js"
click node_monitor "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/system-monitor.js"
click node_status "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/system-status-monitor.js"
click node_map "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/map.js"
click node_language "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/aggressive-translator.js"
click node_notifications "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/notifications.js"
click node_triggers "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/notification-triggers.js"
click node_toast "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/toast-notifications.js"
click node_init "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/init-manager.js"
click node_firebaseui "https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/firebase-config.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_flask,node_pages,node_visitor toneBlue
class node_authui,node_register,node_profile,node_backendfirebase,node_firestore,node_firebaseui toneAmber
class node_map,node_geoserver,node_basemaps toneMint
class node_schema,node_tracker,node_analyticsapi,node_analyticsdata,node_dashboard,node_analytics,node_processor,node_realtime,node_health,node_monitor,node_status toneRose
class node_language,node_notifications,node_triggers,node_toast,node_init,node_admin toneIndigo
```

## Components

### Web application

- [Flask application](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/app.py): `app.py`
- [Web pages](https://github.com/deepakbhandari-kozmo/divyadrishti/tree/main/templates): `templates`

### Identity and storage

- [Login and registration](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/login.js): `static/js/login.js`
- [Registration UI](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/register.js): `static/js/register.js`
- [Profile management](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/profile.js): `static/js/profile.js`
- [Firebase service](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/firebase_config.py): `firebase_config.py`
- **Firestore data**
- [Firebase client config](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/firebase-config.js): `static/js/firebase-config.js`

### GIS mapping

- [Interactive map](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/map.js): `static/js/map.js`
- **GeoServer**
- **Map tile services**

### Admin and analytics

- [Analytics data model](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/database_schema.py): `database_schema.py`
- [Session tracking](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/session_tracker.py): `session_tracker.py`
- [Analytics API](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/api/analytics_data.py): `api/analytics_data.py`
- [Analytics storage](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/api/analytics_data.py): `api/analytics_data.py`
- [Admin dashboard](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/dashboard.js): `static/js/dashboard.js`
- [Analytics interface](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/analytics.js): `static/js/analytics.js`
- [Analytics processor](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/real-analytics-processor.js): `static/js/real-analytics-processor.js`
- [Realtime dashboard](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/realtime-dashboard.js): `static/js/realtime-dashboard.js`
- [System health](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/system-health.js): `static/js/system-health.js`
- [System monitor](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/system-monitor.js): `static/js/system-monitor.js`
- [Status monitor](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/system-status-monitor.js): `static/js/system-status-monitor.js`

### Interface features

- [English and Hindi](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/aggressive-translator.js): `static/js/aggressive-translator.js`
- [Notifications](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/notifications.js): `static/js/notifications.js`
- [Notification triggers](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/notification-triggers.js): `static/js/notification-triggers.js`
- [Toast messages](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/toast-notifications.js): `static/js/toast-notifications.js`
- [UI initialization](https://github.com/deepakbhandari-kozmo/divyadrishti/blob/main/static/js/init-manager.js): `static/js/init-manager.js`

### Other components

- **Map user**
- **Administrator**

## Connections

- Map user → Flask application: opens application (evidence: `README.md`)
- Administrator → Flask application: uses admin tools (evidence: `README.md`)
- Flask application → Web pages: renders pages (evidence: `README.md`)
- Flask application → Firebase service: uses (evidence: `app.py`)
- Flask application → Analytics API: loads (evidence: `app.py`)
- Flask application → Session tracking: loads (evidence: `app.py`)
- Flask application → GeoServer: serves GIS requests (evidence: `README.md`)
- Flask application → Interactive map: provides map interface (evidence: `README.md`)
- Flask application → Analytics API: provides analytics endpoints (evidence: `README.md`)
- Flask application → Web pages: exports map PDF (evidence: `README.md`)
- Login and registration → Flask application: submits login (evidence: `README.md`)
- Registration UI → Flask application: submits registration (evidence: `README.md`)
- Profile management → Firebase service: manages profile (evidence: `README.md`)
- Firebase service → Firestore data: accesses (evidence: `firebase_config.py`)
- Firebase service → Analytics data model: provides database access (evidence: `database_schema.py`)
- Analytics data model → Firestore data: stores analytics records (evidence: `database_schema.py`)
- Session tracking → Analytics data model: records activity (evidence: `session_tracker.py`)
- Analytics API → Analytics data model: queries metrics (evidence: `api/analytics_data.py`)
- Analytics API → Analytics storage: updates fallback data (evidence: `api/analytics_data.py`)
- Admin dashboard → Analytics interface: presents analytics (evidence: `README.md`)
- Analytics interface → Analytics API: requests metrics (evidence: `README.md`)
- Analytics processor → Analytics API: processes analytics data (evidence: `README.md`)
- Realtime dashboard → Admin dashboard: enhances dashboard (evidence: `README.md`)
- System monitor → System health: monitors performance (evidence: `README.md`)
- Status monitor → System health: reports system status (evidence: `README.md`)
- Interactive map → GeoServer: loads layers and features (evidence: `static/js/map.js`)
- Interactive map → Map tile services: loads base layers (evidence: `README.md`)
- English and Hindi → Web pages: translates interface (evidence: `README.md`)
- Notifications → Firestore data: reads and writes alerts (evidence: `static/js/notifications.js`)
- Notification triggers → Notifications: creates alerts (evidence: `static/js/notification-triggers.js`)
- Admin dashboard → Notifications: shows notifications (evidence: `README.md`)
- Notifications → Toast messages: shows feedback (evidence: `static/js/notifications.js`)
- UI initialization → Analytics interface: initializes (evidence: `static/js/init-manager.js`)
- UI initialization → Analytics processor: initializes (evidence: `static/js/init-manager.js`)
- UI initialization → Realtime dashboard: initializes (evidence: `static/js/init-manager.js`)
- Firebase client config → Firestore data: configures client access
