# dulalsaurab/flash-flood-early-warning-systme-ffews architecture

> Architecture diagram of the GitHub repository dulalsaurab/flash-flood-early-warning-systme-ffews, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dulalsaurab/flash-flood-early-warning-systme-ffews
- Repository: https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews

## Overview

##### Project Type and Purpose
- It ingests hydrological and satellite forecast data, stores it in a MySQL database, processes it (inundation modeling, digital terrain analysis via ArcGIS Java Beans), visualizes results (desktop Swing UI + web pages with D3.js/Bootstrap), and issues warnings (SMS).

##### File‐Structure Analysis
- MajorProject/src/majorproject: core Java packages (data ingestion, GIS integration via ArcGIS, charting via JFreeChart, UI forms, SMS notification).
- MajorProject/res/src and MajorProject/WebStuffs: static assets (HTML, CSS, JavaScript, D3.js, Bootstrap, LESS) for web‐based visualization.
- MajorProject/dist: packaged JAR and dependent libraries (mysql-connector, jfreechart, swt, arcobjects.jar).
- build & nbproject: NetBeans build scripts and metadata.
- Docs: thesis, proposal, final presentation – reference materials, not part of runtime.

##### Key Architecture Components
a. Data Sources (External)
- Hydrological sensors, satellite forecast APIs, digital terrain datasets.
b. Data Storage
- MySQL database accessed via DatabaseConnection.java.
c. Application Core
- Ingestion & Scheduling (NewThread.java)
- Business Logic & Modeling (Inundation model code, MapTest.java, BeanFactory.java)
- GIS Engine (ArcGIS.java, UseGlobeBean.java, AddLayerFileToMap.java)
- Charting & Reports (MyChartFactory.java, JFreeChart integration in LineChart.java, GraphsTab.java)
- Notification Service (SendSms.java)
d. Presentation/UI
- Desktop Swing UI (VisualizationFrame.java, VisualFrame.java, ParameterBrowse.java, GoogleMap.java forms)
- Web UI (static HTML + D3.js charts, Bootstrap CSS/LESS under res/src and WebStuffs)
e. External Services
- SMS gateway/provider
- 3rd-party map/tile servers (if any)

##### Relationships & Data Flows
- Data Sources → (pull/receive) → Application Core → (persist) → MySQL
- Application Core → (query/process) → GIS Engine → (map output) → UI layers
- Application Core → (query/process) → Charting module → Desktop UI & Web UI
- Application Core → (trigger) → Notification Service → SMS gateway → End Users
- Web UI assets served from the packaged JAR or a simple HTTP server

##### Architectural Patterns & Design Principles
- Layered Architecture: Data Access layer, Business/Model layer, Presentation layer, Integration/Notification layer.
- Modularization by feature: GIS module, Charting module, Notification module.
- Use of Factory pattern (BeanFactory, MyChartFactory) for pluggable components.

##### Technologies & Frameworks
- Java SE 8+, Swing, SWT (via swtgraphics2d.jar)
- ArcGIS Java Beans (arcobjects.jar)
- JFreeChart & OrsonCharts for charting
- MySQL + JDBC (mysql-connector-java)
- Bootstrap + D3.js for web visualization
- SMS API (via SendSms.java)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Data Layer
    subgraph "Data Layer"
        DSources(("External Data Sources")):::external
        DB[(MySQL Database)]:::db
    end

    %% Core Layer
    subgraph "Core Layer"
        Ingest["Ingestion & Scheduling\nNewThread.java"]:::core
        DataAccess["Database Access\nDatabaseConnection.java"]:::core
        subgraph "Business Logic & Modeling"
            MapTest["MapTest.java"]:::core
            BeanFactory["BeanFactory.java"]:::core
        end
        subgraph "GIS Engine"
            ArcGIS["ArcGIS.java"]:::core
            UseGlobe["UseGlobeBean.java"]:::core
            AddLayer["AddLayerFileToMap.java"]:::core
        end
        subgraph "Charting & Reporting"
            MyChart["MyChartFactory.java"]:::core
            LineChart["LineChart.java"]:::core
            GraphsTab["GraphsTab.java"]:::core
        end
        Notification["Notification Service\nSendSms.java"]:::core
    end

    %% Presentation Layer
    subgraph "Presentation Layer"
        subgraph "Desktop UI"
            VisFrame["VisualizationFrame.java"]:::ui
            VisAlt["VisualFrame.java"]:::ui
            Param["ParameterBrowse.java"]:::ui
            GMap["GoogleMap.java"]:::ui
        end
        subgraph "Web UI"
            WebAssets(("Web Assets\n(res/src/)")):::ui
            WebStuffs(("WebStuffs/")):::ui
        end
    end

    %% External Services
    SmsGateway(("SMS Gateway")):::external

    %% Connections
    DSources -->|"pull/receive"| Ingest
    Ingest -->|"persist via JDBC"| DataAccess
    DataAccess -->|"JDBC query"| DB
    Ingest -->|feeds| MapTest
    MapTest -->|uses| BeanFactory
    BeanFactory -->|process data| ArcGIS
    BeanFactory -->|process data| UseGlobe
    BeanFactory -->|process data| AddLayer
    ArcGIS -->|"map output"| VisFrame
    ArcGIS -->|"map output"| WebAssets
    LineChart -->|"chart output"| VisFrame
    LineChart -->|"chart output"| WebAssets
    BeanFactory -->|generate charts| MyChart
    MyChart -->|create| LineChart
    MyChart -->|provide panels| GraphsTab
    GraphsTab --> VisFrame
    GraphsTab --> WebAssets
    BeanFactory -->|trigger| Notification
    Notification -->|"SMS send"| SmsGateway

    %% Click Events
    click DataAccess "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/DatabaseConnection.java"
    click Ingest "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/NewThread.java"
    click MapTest "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/MapTest.java"
    click BeanFactory "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/BeanFactory.java"
    click ArcGIS "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/ArcGIS.java"
    click UseGlobe "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/UseGlobeBean.java"
    click AddLayer "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/AddLayerFileToMap.java"
    click MyChart "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/MyChartFactory.java"
    click LineChart "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/LineChart.java"
    click GraphsTab "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/GraphsTab.java"
    click Notification "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/SendSms.java"
    click VisFrame "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/VisualizationFrame.java"
    click VisAlt "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/VisualFrame.java"
    click Param "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/ParameterBrowse.java"
    click GMap "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/blob/master/MajorProject/src/majorproject/GoogleMap.java"
    click WebAssets "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/tree/master/MajorProject/res/src"
    click WebStuffs "https://github.com/dulalsaurab/flash-flood-early-warning-systme-ffews/tree/master/MajorProject/WebStuffs"

    %% Styles
    classDef external fill:#D7BDE2,stroke:#7D3C98,color:#1A5276
    classDef db fill:#AED6F1,stroke:#2E86C1,color:#1B4F72
    classDef core fill:#ABEBC6,stroke:#28B463,color:#145A32
    classDef ui fill:#F9E79F,stroke:#D4AC0D,color:#7D6608
```
