# aicte-idealab/saline-level-detector- architecture

> Architecture diagram of the GitHub repository aicte-idealab/saline-level-detector-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aicte-idealab/saline-level-detector-
- Repository: https://github.com/aicte-idealab/saline-level-detector-

## Overview

##### Project Type and Purpose
- This is an IoT-enabled full-stack application designed for hospitals to monitor saline levels in real time.
- Hardware components (microcontroller, sensor, Wi-Fi module) feed data into a software stack (firmware → MQTT → backend → database → frontend).
- Purpose: Provide threshold alerts, historical logging, and integrate with hospital management systems via a web interface.

##### (Inferred) File Structure
- Top-level directories:
- firmware/  (Arduino IDE sketches or Python scripts for Raspberry Pi)
- backend/  (Node.js + Express server code, package.json, config files)
- frontend/  (static HTML, CSS, JavaScript files)
- config/ or scripts/  (MQTT broker setup, database migrations)
- Configuration/build files:
- backend/package.json (dependencies, start scripts)
- .env or config.json (DB credentials, MQTT broker URL)
- Dockerfile or docker-compose.yml (optional containerization)

##### Extract Additional Insights from the README
- Technology stack: Arduino/RPi firmware, MQTT, Node.js/Express, MongoDB/MySQL, static web UI.
- Security: MQTT over TLS, DB encryption, network hardening, XSS mitigations.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Edge Layer
    subgraph "Edge Layer"
        MCU["Arduino Uno + Saline Sensor"]:::hardware
    end

    %% Messaging Layer
    subgraph "Messaging Layer"
        Broker["MQTT Broker (TLS)"]:::messaging
    end

    %% Application Layer
    subgraph "Application Layer"
        Backend["Node.js/Express API"]:::server
    end

    %% Data Layer
    subgraph "Data Layer"
        DB["MongoDB / MySQL Database"]:::storage
    end

    %% Presentation Layer
    subgraph "Presentation Layer"
        FE["Web Dashboard (HTML/CSS/JS)"]:::presentation
    end

    %% External Systems
    subgraph "External Systems"
        HIMS["Hospital Management System"]:::external
    end

    %% Data Flows
    MCU -->|"publishes saline readings via MQTT\n(retry & reconnect)"| Broker
    Broker -->|"subscribed by backend"| Backend
    Backend -->|"writes readings"| DB
    FE -->|"fetches data via REST API"| Backend
    Backend -->|"push alerts/webhooks"| HIMS

    %% Styles
    classDef hardware fill:#BDD7EE,stroke:#2F5496,stroke-width:2px
    classDef messaging fill:#C6E0B4,stroke:#548235,stroke-width:2px
    classDef server fill:#F8CBAD,stroke:#B45F06,stroke-width:2px
    classDef storage fill:#D9D2E9,stroke:#7030A0,stroke-width:2px
    classDef presentation fill:#FFE599,stroke:#BF9000,stroke-width:2px
    classDef external fill:#CCCCCC,stroke:#666666,stroke-width:2px
```
