# hasnain-111/sih architecture

> Architecture diagram of the GitHub repository hasnain-111/sih, 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/hasnain-111/sih
- Repository: https://github.com/hasnain-111/sih

## Overview

MPLADS is a web application for officials to browse constituency projects and review stored ML-derived risk assessments, with separate admin and official account flows. The principal review path loads a project, retrieves its stored risk result, and presents risk details; zone counts and project lists support discovery. The source excerpts establish Java-side calls and database access, but do not show browser-to-servlet wiring or the Python server’s endpoint implementation, so those links are omitted or marked unverified.

Main entry points: [`src/java/com/mplads/DBConnection.java`](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/DBConnection.java) (DB connection), [`src/java/com/mplads/dao/ZoneDAO.java`](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/dao/ZoneDAO.java) (Zone and risk queries), [`src/java/com/mplads/dao/ProjectDAO.java`](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/dao/ProjectDAO.java) (Project queries), [`src/java/com/mplads/dao/MlResultDAO.java`](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/dao/MlResultDAO.java) (ML result lookup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_pages["Project and risk pages"]
  node_dashboard_ui["Dashboard UI<br/>[dashboard.js]"]
  node_projects_ui["Project browsing UI<br/>[projects.js]"]
  node_details_ui["Project details UI<br/>[project-details.js]"]
  node_risk_ui["Risk analysis UI<br/>[risk-analysis.js]"]
end

subgraph group_access["Accounts"]
  node_login["Login<br/>[LoginServlet.java]"]
  node_registration["Official registration"]
end

subgraph group_projects["Project data"]
  node_project_api["Project endpoints"]
  node_dashboard_api["Dashboard endpoint"]
  node_project_store["Project queries<br/>[ProjectDAO.java]"]
  node_project_model["Project record<br/>[Project.java]"]
end

subgraph group_risk["Risk analysis"]
  node_analyze_api["Stored risk lookup"]
  node_zone_api["Zone project endpoints"]
  node_zone_count_api["Zone counts endpoint"]
  node_risk_projects_api["Risk project endpoint"]
  node_zone_queries["Zone and risk queries<br/>[ZoneDAO.java]"]
  node_risk_queries["Risk queries<br/>[RiskDAO.java]"]
  node_result_api["ML result endpoint"]
  node_result_queries["ML result lookup<br/>[MlResultDAO.java]"]
  node_result_model["ML result record<br/>[MlResult.java]"]
  node_ml_service["ML request client<br/>[MLService.java]"]
  node_ml_server["Python analysis server<br/>[ml_server.py]"]
end

subgraph group_infra["Persistence"]
  node_database[("MySQL database")]
  node_db_connection["DB connection<br/>[DBConnection.java]"]
end

node_official(("Official / admin"))

node_official -.->|"uses"| node_pages
node_official -.->|"submits credentials"| node_login
node_official -.->|"registers"| node_registration
node_project_api -->|"queries"| node_project_store
node_project_api -->|"returns"| node_project_model
node_project_store -->|"opens connection"| node_db_connection
node_project_store -->|"maps rows"| node_project_model
node_dashboard_api -.->|"reads"| node_database
node_login -->|"checks officials"| node_db_connection
node_registration -->|"inserts official"| node_db_connection
node_analyze_api -->|"loads project"| node_project_store
node_analyze_api -->|"fetches risk"| node_zone_queries
node_zone_api -->|"queries zones"| node_zone_queries
node_zone_count_api -->|"counts zones"| node_zone_queries
node_risk_projects_api -.->|"queries risks"| node_risk_queries
node_zone_queries -->|"reads results"| node_db_connection
node_zone_queries -->|"maps projects"| node_project_model
node_result_api -->|"looks up result"| node_result_queries
node_result_queries -->|"maps row"| node_result_model
node_result_queries -->|"reads results"| node_db_connection
node_db_connection -->|"connects"| node_database
node_ml_service -.->|"posts analysis"| node_ml_server

click node_pages "https://github.com/hasnain-111/sih/blob/main/web/project-details.html"
click node_dashboard_ui "https://github.com/hasnain-111/sih/blob/main/web/js/dashboard.js"
click node_projects_ui "https://github.com/hasnain-111/sih/blob/main/web/js/projects.js"
click node_details_ui "https://github.com/hasnain-111/sih/blob/main/web/js/project-details.js"
click node_risk_ui "https://github.com/hasnain-111/sih/blob/main/web/js/risk-analysis.js"
click node_login "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/LoginServlet.java"
click node_registration "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/RegistrationServlet.java"
click node_project_api "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/ProjectServlet.java"
click node_dashboard_api "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/DashboardServlet.java"
click node_project_store "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/dao/ProjectDAO.java"
click node_project_model "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/model/Project.java"
click node_analyze_api "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/AnalyzeServlet.java"
click node_zone_api "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/ZoneProjectServlet.java"
click node_zone_count_api "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/ZoneCountServlet.java"
click node_risk_projects_api "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/RiskProjectsServlet.java"
click node_zone_queries "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/dao/ZoneDAO.java"
click node_risk_queries "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/dao/RiskDAO.java"
click node_result_api "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/MlResultServlet.java"
click node_result_queries "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/dao/MlResultDAO.java"
click node_result_model "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/model/MlResult.java"
click node_ml_service "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/service/MLService.java"
click node_ml_server "https://github.com/hasnain-111/sih/blob/main/ml_engine/ml_server.py"
click node_db_connection "https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/DBConnection.java"

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_pages,node_dashboard_ui,node_projects_ui,node_details_ui,node_risk_ui toneBlue
class node_login,node_registration toneAmber
class node_project_api,node_dashboard_api,node_project_store,node_project_model toneMint
class node_analyze_api,node_zone_api,node_zone_count_api,node_risk_projects_api,node_zone_queries,node_risk_queries,node_result_api,node_result_queries,node_result_model,node_ml_service,node_ml_server toneRose
class node_database,node_db_connection,node_official toneIndigo
```

## Components

### Web experience

- [Project and risk pages](https://github.com/hasnain-111/sih/blob/main/web/project-details.html): `web/project-details.html`
- [Dashboard UI](https://github.com/hasnain-111/sih/blob/main/web/js/dashboard.js): `web/js/dashboard.js`
- [Project browsing UI](https://github.com/hasnain-111/sih/blob/main/web/js/projects.js): `web/js/projects.js`
- [Project details UI](https://github.com/hasnain-111/sih/blob/main/web/js/project-details.js): `web/js/project-details.js`
- [Risk analysis UI](https://github.com/hasnain-111/sih/blob/main/web/js/risk-analysis.js): `web/js/risk-analysis.js`

### Accounts

- [Login](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/LoginServlet.java): `src/java/com/mplads/servlet/LoginServlet.java`
- [Official registration](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/RegistrationServlet.java): `src/java/com/mplads/servlet/RegistrationServlet.java`

### Project data

- [Project endpoints](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/ProjectServlet.java): `src/java/com/mplads/servlet/ProjectServlet.java`
- [Dashboard endpoint](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/DashboardServlet.java): `src/java/com/mplads/servlet/DashboardServlet.java`
- [Project queries](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/dao/ProjectDAO.java): `src/java/com/mplads/dao/ProjectDAO.java`
- [Project record](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/model/Project.java): `src/java/com/mplads/model/Project.java`

### Risk analysis

- [Stored risk lookup](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/AnalyzeServlet.java): `src/java/com/mplads/servlet/AnalyzeServlet.java`
- [Zone project endpoints](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/ZoneProjectServlet.java): `src/java/com/mplads/servlet/ZoneProjectServlet.java`
- [Zone counts endpoint](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/ZoneCountServlet.java): `src/java/com/mplads/servlet/ZoneCountServlet.java`
- [Risk project endpoint](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/RiskProjectsServlet.java): `src/java/com/mplads/servlet/RiskProjectsServlet.java`
- [Zone and risk queries](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/dao/ZoneDAO.java): `src/java/com/mplads/dao/ZoneDAO.java`
- [Risk queries](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/dao/RiskDAO.java): `src/java/com/mplads/dao/RiskDAO.java`
- [ML result endpoint](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/servlet/MlResultServlet.java): `src/java/com/mplads/servlet/MlResultServlet.java`
- [ML result lookup](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/dao/MlResultDAO.java): `src/java/com/mplads/dao/MlResultDAO.java`
- [ML result record](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/model/MlResult.java): `src/java/com/mplads/model/MlResult.java`
- [ML request client](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/service/MLService.java): `src/java/com/mplads/service/MLService.java`
- [Python analysis server](https://github.com/hasnain-111/sih/blob/main/ml_engine/ml_server.py): `ml_engine/ml_server.py`

### Persistence

- **MySQL database**
- [DB connection](https://github.com/hasnain-111/sih/blob/main/src/java/com/mplads/DBConnection.java): `src/java/com/mplads/DBConnection.java`

### Other components

- **Official / admin**

## Connections

- Official / admin → Project and risk pages: uses
- Official / admin → Login: submits credentials
- Official / admin → Official registration: registers
- Project endpoints → Project queries: queries (evidence: `src/java/com/mplads/servlet/ProjectServlet.java`)
- Project endpoints → Project record: returns (evidence: `src/java/com/mplads/servlet/ProjectServlet.java`)
- Project queries → DB connection: opens connection (evidence: `src/java/com/mplads/dao/ProjectDAO.java`)
- Project queries → Project record: maps rows (evidence: `src/java/com/mplads/dao/ProjectDAO.java`)
- Dashboard endpoint → MySQL database: reads
- Login → DB connection: checks officials (evidence: `src/java/com/mplads/servlet/LoginServlet.java`)
- Official registration → DB connection: inserts official (evidence: `src/java/com/mplads/servlet/RegistrationServlet.java`)
- Stored risk lookup → Project queries: loads project (evidence: `src/java/com/mplads/servlet/AnalyzeServlet.java`)
- Stored risk lookup → Zone and risk queries: fetches risk (evidence: `src/java/com/mplads/servlet/AnalyzeServlet.java`)
- Zone project endpoints → Zone and risk queries: queries zones (evidence: `src/java/com/mplads/servlet/ZoneProjectServlet.java`)
- Zone counts endpoint → Zone and risk queries: counts zones (evidence: `src/java/com/mplads/servlet/ZoneCountServlet.java`)
- Risk project endpoint → Risk queries: queries risks
- Zone and risk queries → DB connection: reads results (evidence: `src/java/com/mplads/dao/ZoneDAO.java`)
- Zone and risk queries → Project record: maps projects (evidence: `src/java/com/mplads/dao/ZoneDAO.java`)
- ML result endpoint → ML result lookup: looks up result (evidence: `src/java/com/mplads/servlet/MlResultServlet.java`)
- ML result lookup → ML result record: maps row (evidence: `src/java/com/mplads/dao/MlResultDAO.java`)
- ML result lookup → DB connection: reads results (evidence: `src/java/com/mplads/dao/MlResultDAO.java`)
- DB connection → MySQL database: connects (evidence: `src/java/com/mplads/DBConnection.java`)
- ML request client → Python analysis server: posts analysis
