# stardeep18/cloudburst-prediction-in-western-ghats architecture

> Architecture diagram of the GitHub repository stardeep18/cloudburst-prediction-in-western-ghats, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-03-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/stardeep18/cloudburst-prediction-in-western-ghats
- Repository: https://github.com/stardeep18/cloudburst-prediction-in-western-ghats

## Overview

##### What this project is (type + purpose)

This is a **3-tier, data-driven predictive dashboard**:

- **Frontend:** React (Vite) dashboard for uploading CSV data, tweaking “what-if” parameters, selecting prediction horizon, and visualizing results.
- **Backend:** Node.js/Express API that accepts prediction requests and **invokes a Haskell program**.
- **Prediction engine:** Haskell script that reads/processes meteorological data and outputs **risk classification + probability**.
- **Data:** CSV datasets (repo includes `dataset/cloudburst_dataset_large.csv` and `public/sample_dataset.csv`).

##### Frontend (root)
- `index.html`, `vite.config.js`, `src/main.jsx`, `src/App.jsx`
- UI components:
`src/components/OverviewPanel.jsx`
`src/components/PredictionPanel.jsx`
`src/components/RiskMap.jsx`
`src/components/Sidebar.jsx`
`src/components/Toast.jsx`
`src/components/UploadPanel.jsx`
`src/components/VisualizationPanel.jsx`
- Prediction client logic: `src/lib/prediction.js`
- Styling: `tailwind.config.js`, `postcss.config.js`, `src/index.css`
- Static sample data served by Vite: `public/sample_dataset.csv`

##### Backend (`backend/`)
- `backend/server.js` (Express server entry)
- `backend/cloudburst.hs` (Haskell engine source co-located with backend)
- `backend/package.json` (backend dependencies)
- `backend/node_modules` (runtime deps)

##### Datasets
- `dataset/cloudburst_dataset_large.csv` (likely used by engine or for testing)
- `public/sample_dataset.csv` (frontend demo data)

##### What the README adds (runtime behavior + interactions)

The README already states the logical pipeline:

`Dataset → React Dashboard → Node API → Haskell Engine → Risk Probability → Dashboard Visualization`

- **Where data is transformed** (CSV parsed client-side vs server-side)
- **How Haskell is invoked** (child process execution from Node)
- **Request/response contracts** (what frontend sends; what backend returns)

Shows Frontend, Backend API, Haskell Engine, Dataset stores as separate containers with protocols.
Split the frontend into key UI/prediction modules and split the backend into API + engine runner + output parser.

This repo is small enough that Level 2 + Level 3 can be on one page, but keep boundaries clear.

##### Frontend container (React + Vite + Tailwind)
Subcomponents (from `src/components` + `src/lib`):
- **UploadPanel**: file selection / load sample dataset
- **PredictionPanel**: horizon selection + sliders (“what-if” params)
- **prediction.js**: builds request payload + calls backend
- **VisualizationPanel / RiskMap / OverviewPanel**: renders probability, classification, indicators
- **Toast**: error/success feedback
- **Sidebar**: navigation / control grouping

##### Backend container (Node.js + Express)
Subcomponents (inferred from `server.js` responsibilities):
- **Prediction API endpoint(s)** (e.g., `POST /predict`)
- **Haskell Runner**: spawn/exec `cloudburst.hs` (or compiled binary)
- **Input adapter**: writes temp CSV / passes args/stdin to Haskell
- **Output parser/mapper**: converts Haskell stdout into JSON response
- **CORS + validation**: typical Express concerns (include if present in `server.js`)

##### Prediction Engine container (Haskell)
- **CSV reader/parser**
- **Feature computations/statistics**
- **Weighted risk scoring model**
- **Classification + probability output formatter**

##### Data sources
- **User CSV upload** (client-side file)
- **Repo CSV dataset** (`dataset/*.csv`)
- **Public sample dataset** (`public/sample_dataset.csv`)

##### User → React UI
- “Upload CSV”, “Set horizon”, “Adjust parameters”
##### React UI → Node API (HTTP/JSON)
- `POST /predict`
- Payload: `{ horizon, parameters, dataset }` or `{ horizon, parameters, datasetRef }`
- If dataset is large, show it as **multipart upload** or “CSV text in body” (choose based on actual implementation once you inspect `src/lib/prediction.js` and `backend/server.js`).
##### Node API → Haskell Engine (OS process invocation)
- Mechanism: `child_process.spawn/exec`
- Inputs: file path / stdin / CLI args
- Output: stdout (risk %, label, maybe factor contributions)
##### Haskell Engine → Node API
- returns computed results (stdout)
##### Node API → React UI (HTTP/JSON response)
- Response: `{ probability, riskLevel, explanation, metrics }`

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =======================
  %% C4 Level 1: Context
  %% =======================
  subgraph "C4 L1 — Context"
    U["User (Browser)"]:::external
    SYS["Cloudburst Prediction System"]:::system
    U -->|"upload_CSV_set_params_view_results"| SYS
  end

  %% =======================
  %% C4 Level 2: Containers
  %% =======================
  subgraph "C4 L2 — Containers (3-tier pipeline)"
    direction TB

    subgraph "Client"
      FE["React Dashboard (Vite)"]:::container
      STYLE["Styling (Tailwind + PostCSS)"]:::support
    end

    subgraph "Server"
      BE["Node.js API (Express)"]:::container
      HE["Haskell Prediction Engine (cloudburst.hs)"]:::container
    end

    subgraph "Data Sources (CSV)"
      direction TB
      CSVU["User Uploaded CSV (local file)"]:::data
      CSVS["Public Sample Dataset (Vite static)"]:::data
      CSVR["Repo Dataset (large CSV)"]:::data
    end

    U -->|"interact"| FE
    FE -->|"fetch_static_CSV"| CSVS
    U -->|"select_file"| CSVU

    FE -->|"HTTP_POST_/predict (JSON_or_multipart: horizon+parameters+dataset)"| BE
    BE -->|"spawn/exec cloudburst.hs (stdin_or_tempfile+args)"| HE
    HE -->|"stdout: riskLevel+probability(+metrics)"| BE
    BE -->|"HTTP_200/4xx/5xx JSON: probability+riskLevel+metrics+explanation"| FE

    CSVR -.->|"optional_server_side_input/test_data"| HE
  end

  %% =======================
  %% C4 Level 3: Components
  %% =======================
  subgraph "C4 L3 — Component View (key modules in this repo)"
    direction TB

    subgraph "Frontend Components (src/)"
      direction TB
      APP["App Shell (main.jsx + App.jsx)"]:::frontend
      SIDEBAR["Sidebar"]:::frontend
      UPLOAD["UploadPanel"]:::frontend
      PREDPANEL["PredictionPanel"]:::frontend
      PREDLIB["Prediction Client (request builder + caller)"]:::api
      VIZ["VisualizationPanel"]:::frontend
      MAP["RiskMap"]:::frontend
      OVERVIEW["OverviewPanel"]:::frontend
      TOAST["Toast"]:::support

      APP -->|"layout/state"| SIDEBAR
      APP -->|"dataset_selection"| UPLOAD
      APP -->|"param_controls"| PREDPANEL
      PREDPANEL -->|"build_payload"| PREDLIB
      UPLOAD -->|"parse_or_attach_CSV"| PREDLIB
      PREDLIB -->|"update_UI_state"| VIZ
      VIZ -->|"render"| MAP
      VIZ -->|"render"| OVERVIEW
      APP -->|"feedback"| TOAST
    end

    subgraph "Backend Components (backend/)"
      direction TB
      ROUTE["Prediction Route Handler (e.g., POST /predict)"]:::backend
      VALID["CORS + Validation"]:::support
      ADAPT["Input Adapter (stdin/tempfile/args)"]:::backend
      RUNNER["Haskell Runner (child_process)"]:::backend
      PARSER["Stdout Parser → JSON Mapper"]:::backend

      BE -->|"routes"| ROUTE
      ROUTE -->|"apply"| VALID
      ROUTE -->|"prepare_input"| ADAPT
      ADAPT -->|"invoke"| RUNNER
      RUNNER -->|"capture_stdout/stderr"| PARSER
      PARSER -->|"respond_JSON"| ROUTE
      ROUTE -->|"errors_4xx/5xx"| TOAST
    end

    subgraph "Engine Components (backend/cloudburst.hs)"
      direction TB
      HCSV["CSV Reader/Parser"]:::engine
      FEAT["Feature Computations/Statistics"]:::engine
      SCORE["Weighted Risk Scoring Model"]:::engine
      FORMAT["Classification + Probability Formatter"]:::engine

      HE -->|"run"| HCSV
      HCSV -->|"records"| FEAT
      FEAT -->|"features"| SCORE
      SCORE -->|"risk"| FORMAT
    end

    %% Cross-boundary component links
    PREDLIB -->|"HTTP_POST_/predict"| ROUTE
    FORMAT -->|"stdout"| PARSER

    %% Dataset component links
    CSVS -->|"loaded_by"| UPLOAD
    CSVU -->|"provided_by_user"| UPLOAD
    CSVR -.->|"optional_input"| HCSV
  end

  %% =======================
  %% Click Events (from mapping)
  %% =======================
  click FE "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/index.html"
  click FE "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/vite.config.js"
  click FE "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/src/main.jsx"
  click FE "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/src/App.jsx"

  click STYLE "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/tailwind.config.js"
  click STYLE "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/postcss.config.js"
  click STYLE "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/src/index.css"

  click UPLOAD "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/src/components/UploadPanel.jsx"
  click PREDPANEL "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/src/components/PredictionPanel.jsx"
  click VIZ "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/src/components/VisualizationPanel.jsx"
  click MAP "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/src/components/RiskMap.jsx"
  click OVERVIEW "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/src/components/OverviewPanel.jsx"
  click SIDEBAR "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/src/components/Sidebar.jsx"
  click TOAST "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/src/components/Toast.jsx"
  click PREDLIB "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/src/lib/prediction.js"

  click BE "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/backend/server.js"
  click ROUTE "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/backend/server.js"
  click VALID "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/backend/server.js"
  click ADAPT "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/backend/server.js"
  click RUNNER "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/backend/server.js"
  click PARSER "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/backend/server.js"

  click HE "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/backend/cloudburst.hs"
  click HCSV "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/backend/cloudburst.hs"
  click FEAT "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/backend/cloudburst.hs"
  click SCORE "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/backend/cloudburst.hs"
  click FORMAT "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/backend/cloudburst.hs"

  click CSVR "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/dataset/cloudburst_dataset_large.csv"
  click CSVS "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/public/sample_dataset.csv"

  %% Backend deps
  click BE "https://github.com/stardeep18/cloudburst-prediction-in-western-ghats/blob/main/backend/package.json"

  %% =======================
  %% Styles
  %% =======================
  classDef external fill:#F3F4F6,stroke:#6B7280,stroke-width:1px,color:#111827;
  classDef system fill:#111827,stroke:#111827,stroke-width:1px,color:#F9FAFB;
  classDef container fill:#DBEAFE,stroke:#2563EB,stroke-width:2px,color:#0B1220;
  classDef frontend fill:#BFDBFE,stroke:#1D4ED8,stroke-width:1.5px,color:#0B1220;
  classDef backend fill:#C7D2FE,stroke:#4338CA,stroke-width:1.5px,color:#0B1220;
  classDef engine fill:#BBF7D0,stroke:#15803D,stroke-width:1.5px,color:#052e16;
  classDef api fill:#93C5FD,stroke:#1E40AF,stroke-width:1.5px,color:#0B1220;
  classDef data fill:#E5E7EB,stroke:#374151,stroke-width:1.5px,color:#111827;
  classDef support fill:#FEE2E2,stroke:#B91C1C,stroke-width:1.5px,color:#111827;

  class U external
  class SYS system
  class FE,BE,HE container
  class APP,SIDEBAR,UPLOAD,PREDPANEL,VIZ,MAP,OVERVIEW frontend
  class ROUTE,ADAPT,RUNNER,PARSER backend
  class HCSV,FEAT,SCORE,FORMAT engine
  class PREDLIB api
  class CSVU,CSVS,CSVR data
  class STYLE,TOAST,VALID support
```
