# jagath-132/ml-project-iot architecture

> Architecture diagram of the GitHub repository jagath-132/ml-project-iot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jagath-132/ml-project-iot
- Repository: https://github.com/jagath-132/ml-project-iot

## Overview

##### Project type and purpose
- This is a machine-learning ETL and training pipeline for IoT sensor data (“ml-project-iot”).
- It ingests raw CSV sensor streams, stores intermediate feature data, trains models, and (via utility code) can send email notifications.

##### File structure
- Top-level scripts:
- main.py (entry point)
- basic_etl.py (simple ETL demo)
- Configuration:
- config/config.yaml (holds file paths, parameters)
- Data folders:
- data/ (source CSV: factory_sensor_simulator_2040.csv)
- artifact/<timestamp>/data_ingestion/… (auto-generated feature store + ingested splits)
- Source code under src/:
- src/components/data_ingestion.py (core ingestion logic)
- src/pipline/traning_pipline.py (training orchestration)
- src/utils/mail_utils.py (notification utilities)
- src/logger for centralized logging
- src/entity for typed artifact and config entities

##### README
- Minimal—project name “ml-project-iot” confirms IoT sensor ML pipeline.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Main Orchestrator
    Main["main.py"]:::processing
    BasicETL["Basic ETL Demo\nbasic_etl.py"]:::processing

    %% Configuration
    ConfigLoader["Config Loader\nconfig.yaml"]:::utility

    %% Data Source and Storage
    DataSource["Data Source\nfactory_sensor_simulator_2040.csv"]:::storage
    ArtifactStore["Artifact Store\nartifact/<timestamp>/data_ingestion/"]:::storage

    %% Processing Components
    DataIngestion["Data Ingestion\nsrc/components/data_ingestion.py"]:::processing
    TrainingPipeline["Training Pipeline\nsrc/pipline/traning_pipline.py"]:::processing

    %% Notification and Logging
    NotificationService["Notification Service\nmail_utils"]:::utility
    Logger["Logger\nsrc/logger/"]:::logging

    %% Entities Subgraph
    subgraph "Entities"
        ArtifactEntity["artifact_entity.py"]:::utility
        ConfigEntity["config_entity.py"]:::utility
    end

    %% Data and Control Flows
    Main -->|"load config"| ConfigLoader
    Main -->|"start ETL"| DataIngestion
    Main -->|"start training"| TrainingPipeline
    Main -->|"demo run"| BasicETL

    ConfigLoader -->|"params"| DataIngestion
    ConfigLoader -->|"params"| TrainingPipeline
    ConfigLoader --> Logger
    ConfigLoader --> ArtifactEntity
    ConfigLoader --> ConfigEntity

    DataSource -->|"raw CSV"| DataIngestion
    DataIngestion -->|"feature_store/raw.csv\ntrain.csv/test.csv"| ArtifactStore
    DataIngestion --> Logger
    DataIngestion --> ArtifactEntity

    ArtifactStore -->|"ingested data"| TrainingPipeline

    TrainingPipeline -->|"model metrics"| NotificationService
    TrainingPipeline --> Logger
    TrainingPipeline --> ArtifactEntity
    TrainingPipeline --> ConfigEntity

    BasicETL --> Logger

    NotificationService --> Logger

    %% Click Events
    click Main "https://github.com/jagath-132/ml-project-iot/blob/main/main.py"
    click BasicETL "https://github.com/jagath-132/ml-project-iot/blob/main/basic_etl.py"
    click ConfigLoader "https://github.com/jagath-132/ml-project-iot/blob/main/config/config.yaml"
    click DataSource "https://github.com/jagath-132/ml-project-iot/blob/main/data/factory_sensor_simulator_2040.csv"
    click DataIngestion "https://github.com/jagath-132/ml-project-iot/blob/main/src/components/data_ingestion.py"
    click ArtifactStore "https://github.com/jagath-132/ml-project-iot/tree/main/artifact/<timestamp>/data_ingestion/"
    click TrainingPipeline "https://github.com/jagath-132/ml-project-iot/blob/main/src/pipline/traning_pipline.py"
    click NotificationService "https://github.com/jagath-132/ml-project-iot/blob/main/src/utils/mail_utils.py"
    click Logger "https://github.com/jagath-132/ml-project-iot/tree/main/src/logger/"
    click ArtifactEntity "https://github.com/jagath-132/ml-project-iot/blob/main/src/entity/artifact_entity.py"
    click ConfigEntity "https://github.com/jagath-132/ml-project-iot/blob/main/src/entity/congif_entity.py"

    %% Styles
    classDef storage fill:#bbdefb,stroke:#0d47a1,color:#0d47a1;
    classDef processing fill:#c8e6c9,stroke:#1b5e20,color:#1b5e20;
    classDef utility fill:#ffe0b2,stroke:#e65100,color:#e65100;
    classDef logging fill:#e0e0e0,stroke:#424242,color:#424242;
```
