# meghnakorim/americanexpress-user-churn-prediction-ann architecture

> Architecture diagram of the GitHub repository meghnakorim/americanexpress-user-churn-prediction-ann, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/meghnakorim/americanexpress-user-churn-prediction-ann
- Repository: https://github.com/meghnakorim/americanexpress-user-churn-prediction-ann

## Overview

##### Project type and purpose
- This is a data-science/ML pipeline project that builds and evaluates an Artificial Neural Network (ANN) for user churn prediction using an American Express customer dataset.
- It covers the full workflow: data ingestion → preprocessing → model training → evaluation → single-user inference → conceptual 3D visualization.

##### File structure
Top-level files:
- AmericanExpress-Data-Analysis-for-User-Exit-Prediction.csv – raw data source
- churn_prediction.py – main Python script (pipeline entry point)
- requirements.txt – dependency list
- README.md – documentation and usage
There are no subdirectories; all logic lives in a single script. The project has a linear pipeline structure rather than a microservice or multi-tiered web app.

##### README for additional insights
- Data preprocessing uses pandas, NumPy, scikit-learn (label encoding, one-hot encoding, StandardScaler).
- Model built with TensorFlow/Keras: input layer, 2 hidden layers (ReLU), output layer (sigmoid).
- Evaluation via accuracy score and confusion matrix (Matplotlib).
- A conceptual 3D pipeline visualization is mentioned (likely Matplotlib/Plotly).

a. Main components:
1) Data Source (CSV file)
2) Data Ingestion & Preprocessing Module
3) Model Training Module
4) Model Artifact (trained weights)
5) Evaluation & Metrics Module
6) Single-User Prediction Component
7) Visualization Component (3D pipeline, confusion matrix plot)
b. Relationships and interactions:
- Data flows from CSV → preprocessing → training.
- Preprocessing outputs training and test sets → training module.
- Training module writes model artifact → evaluation module reads model + test set.
- Evaluation outputs metrics → directed to console and visualization component.
- Prediction component reads model artifact + new user data → outputs churn probability.
c. Architectural patterns and principles:
- Linear data pipeline (sequential stages).
- Modular separation: each stage is a logical block (even if implemented in one script).
- Reproducibility principle: requirements.txt pins dependencies.
d. Key technologies and libraries:
- Data handling: pandas, NumPy
- Preprocessing: scikit-learn (LabelEncoder, OneHotEncoder, StandardScaler)
- Model building: TensorFlow/Keras
- Evaluation/Visualization: Matplotlib (and potentially 3D lib)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Data Source
    DS["Data Source\n(AmericanExpress-Data-Analysis-for-User-Exit-Prediction.csv)"]:::data
    click DS "https://github.com/meghnakorim/americanexpress-user-churn-prediction-ann/blob/main/AmericanExpress-Data-Analysis-for-User-Exit-Prediction.csv"

    %% Preprocessing Module
    Pre["Data Ingestion & Preprocessing\n(pandas, NumPy, scikit-learn)"]:::compute
    click Pre "https://github.com/meghnakorim/americanexpress-user-churn-prediction-ann/blob/main/churn_prediction.py"

    %% Model Training Module
    Training["Model Training\n(TensorFlow/Keras)"]:::compute
    click Training "https://github.com/meghnakorim/americanexpress-user-churn-prediction-ann/blob/main/churn_prediction.py"

    %% Model Artifact
    ModelArtifact["Trained Model Artifact\n(weights)"]:::data

    %% Evaluation & Metrics Module
    Eval["Evaluation & Metrics\n(Matplotlib)"]:::compute
    click Eval "https://github.com/meghnakorim/americanexpress-user-churn-prediction-ann/blob/main/churn_prediction.py"

    %% Visualization Component
    Vis["Visualization Component\n(3D Pipeline & Plots)"]:::output
    click Vis "https://github.com/meghnakorim/americanexpress-user-churn-prediction-ann/blob/main/churn_prediction.py"

    %% Single-User Prediction Component
    Single["Single-User Prediction\n(churn probability)"]:::compute
    click Single "https://github.com/meghnakorim/americanexpress-user-churn-prediction-ann/blob/main/churn_prediction.py"

    %% Documentation and Dependencies
    Req["requirements.txt"]:::docs
    click Req "https://github.com/meghnakorim/americanexpress-user-churn-prediction-ann/blob/main/requirements.txt"
    Docs["README.md"]:::docs
    click Docs "https://github.com/meghnakorim/americanexpress-user-churn-prediction-ann/blob/main/README.md"

    %% Main Pipeline Flow
    DS -->|"Raw CSV"| Pre
    Pre -->|"Processed Features & Labels"| Training
    Training -->|"Trained Model"| ModelArtifact
    ModelArtifact -->|"Model & Test Data"| Eval
    Eval -->|"Metrics & Confusion Matrix"| Vis

    %% Optional Prediction Flow
    ModelArtifact -.->|"Model"| Single
    Single -.->|"Churn Probability"| Vis

    %% Documentation Links
    Docs -.-> Pre
    Req -.-> Pre

    %% Styling
    classDef data fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef compute fill:#90EE90,stroke:#333,stroke-width:1px
    classDef output fill:#FFA500,stroke:#333,stroke-width:1px
    classDef docs fill:#D3D3D3,stroke:#333,stroke-width:1px
```
