# izangdev/prediccion-abandono-ml architecture

> Architecture diagram of the GitHub repository izangdev/prediccion-abandono-ml, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/izangdev/prediccion-abandono-ml
- Repository: https://github.com/izangdev/prediccion-abandono-ml

## Overview

##### Main Components
- Data Sources: Represent the raw data files (AbandonoEmpleados.csv, abandono.xlsx) that feed into the analysis. These are the foundational inputs.
- Data Analysis & EDA Component: Represented by the Notebook_Abandono.ipynb. This component uses libraries such as pandas, numpy, and matplotlib to clean the data, handle nulls, categorize numeric and categorical features, and extract key insights.
- Machine Learning Model Component: Highlight the ML pipeline that transforms data (using ScikitLearn) and builds a decision tree model, achieving approximately 70% accuracy. Here, individual steps like data transformation and model training (including the integration of the results into the dataset) should be delineated.
- Visualization/Dashboard Component: Show Tableau as an external service used to build the final dashboard. The assets folder (e.g., Dashboard.png) supports this component by providing static assets, and the README includes a link to the live dashboard.

##### Relationships and Data Flow
- From EDA, show the process flow into the Machine Learning Model component where data is transformed (e.g., converting variables to numerical) and the decision tree model is trained.
- After model training, indicate that results are merged back with the original dataset.
- Finally, represent how the processed data and results are utilized by the Tableau dashboard for visualization.

##### Architectural Patterns and Design Principles
- Modularity: Emphasize separable modules (data input, analysis, model training, visualization) to highlight the distinct roles and responsibilities.
- Separation of Concerns: Demonstrate how the computational logic (in the Jupyter Notebook) is separated from the visualization layer (Tableau), making the system easier to manage and adapt.

##### Relevant Technologies, Frameworks, and Libraries
- Data Handling: Python libraries (pandas, numpy, matplotlib) used in the Notebook for initial analysis.
- Machine Learning: ScikitLearn for data transformation and decision tree classification.
- Visualization: Tableau (and associated public dashboard link) for interactive visualization.
- Data Files: CSV and XLSX formats as sources; emphasize that these are ingested and pre-processed.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Data Sources"
        DS1("AbandonoEmpleados.csv"):::file
        DS2("abandono.xlsx"):::file
    end

    subgraph "Data Processing"
        EDA("Notebook_Abandono.ipynb (EDA)[pandas,numpy,matplotlib]"):::process
        ML("Notebook_Abandono.ipynb (ML-DecisionTree)[ScikitLearn]"):::process
        Merged("Merged Data (MLresults+RawData)"):::process
    end

    subgraph "Visualization"
        DT("Dashboard - Tableau"):::viz
        Assets("assets (Dashboard.png)"):::file
        Readme("README.md (LiveDashboard)"):::doc
    end

    DS1 --> EDA
    DS2 --> EDA
    EDA --> ML
    ML --> Merged
    Merged --> DT
    DT --> Assets
    DT --> Readme

    click DS1 "https://github.com/izangdev/prediccion-abandono-ml/blob/main/AbandonoEmpleados.csv"
    click DS2 "https://github.com/izangdev/prediccion-abandono-ml/blob/main/abandono.xlsx"
    click EDA "https://github.com/izangdev/prediccion-abandono-ml/blob/main/Notebook_Abandono.ipynb"
    click ML "https://github.com/izangdev/prediccion-abandono-ml/blob/main/Notebook_Abandono.ipynb"
    click Assets "https://github.com/izangdev/prediccion-abandono-ml/tree/main/assets"
    click Readme "https://github.com/izangdev/prediccion-abandono-ml/blob/main/README.md"

    classDef file fill:#f9f,stroke:#333,stroke-width:2px;
    classDef process fill:#ccf,stroke:#333,stroke-width:2px;
    classDef viz fill:#cfc,stroke:#333,stroke-width:2px;
    classDef doc fill:#ffc,stroke:#333,stroke-width:2px;
```
