# mondrita/credit-card-fraud-detection architecture

> Architecture diagram of the GitHub repository mondrita/credit-card-fraud-detection, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mondrita/credit-card-fraud-detection
- Repository: https://github.com/mondrita/credit-card-fraud-detection

## Overview

##### Project type and purpose
- This is a Machine Learning exploration project (not a multi-tier web app or microservice suite).
- Purpose: build and compare several classification models (KNN, Logistic Regression, SVM, Naive Bayes) to detect credit-card fraud on an imbalanced dataset.

##### File structure
- Top level:
- CREDIT_CARD__FRAUD.ipynb – the single Jupyter notebook containing all steps
- card_transdata.csv – raw transactions dataset
- README.md – project description, objectives, metrics, dependencies
- No separate “src” or “tests” directories, so the code, data loading, preprocessing, modeling, and visualization all live in the one notebook.

##### README for additional insights
- Workflow described implicitly: data exploration → preprocessing (handling imbalance, scaling, etc.) → model training → evaluation (precision, recall, F1) → comparative analysis.
- Dependencies (pandas, numpy, matplotlib/seaborn, scikit-learn) confirm a standard Python data-science stack.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Data Sources
    csv["card_transdata.csv"]:::data
    data_load["Load Data (pandas)"]:::data

    %% Data Preprocessing
    subgraph "Data Preprocessing"
        imbalance["Handle Imbalance (SMOTE/Undersample)"]:::process
        scaling["Feature Scaling (StandardScaler)"]:::process
        split["Train/Test Split"]:::process
    end

    %% Model Training & Selection
    subgraph "Model Training & Selection"
        knn["Train KNN"]:::model
        lr["Train Logistic Regression"]:::model
        svm["Train SVM"]:::model
        nb["Train Naive Bayes"]:::model
    end

    %% Model Evaluation
    subgraph "Model Evaluation"
        metrics["Compute Precision, Recall, F1"]:::eval
        cm["Confusion Matrix"]:::eval
        roc["ROC/AUC Curves"]:::eval
    end

    %% Results & Visualization
    subgraph "Results & Visualization"
        plots["Generate Plots (seaborn/matplotlib)"]:::viz
    end

    %% Documentation
    readme["Project Docs & Dependencies"]:::doc

    %% Connections
    csv --> data_load
    data_load --> imbalance
    imbalance --> scaling
    scaling --> split
    split --> knn
    split --> lr
    split --> svm
    split --> nb
    knn --> metrics
    lr --> metrics
    svm --> metrics
    nb --> metrics
    metrics --> cm
    metrics --> roc
    cm --> plots
    roc --> plots

    %% Feedback Loop
    metrics -.-> imbalance

    %% Legend
    subgraph Legend
        dataL["Data Source"]:::data
        procL["Processing Step"]:::process
        modelL["Model Training"]:::model
        evalL["Evaluation"]:::eval
        vizL["Visualization"]:::viz
        docL["Documentation"]:::doc
    end

    %% Click Events
    click csv "https://github.com/mondrita/credit-card-fraud-detection/blob/main/card_transdata.csv"
    click data_load "https://github.com/mondrita/credit-card-fraud-detection/blob/main/CREDIT_CARD__FRAUD.ipynb"
    click imbalance "https://github.com/mondrita/credit-card-fraud-detection/blob/main/CREDIT_CARD__FRAUD.ipynb"
    click scaling "https://github.com/mondrita/credit-card-fraud-detection/blob/main/CREDIT_CARD__FRAUD.ipynb"
    click split "https://github.com/mondrita/credit-card-fraud-detection/blob/main/CREDIT_CARD__FRAUD.ipynb"
    click knn "https://github.com/mondrita/credit-card-fraud-detection/blob/main/CREDIT_CARD__FRAUD.ipynb"
    click lr "https://github.com/mondrita/credit-card-fraud-detection/blob/main/CREDIT_CARD__FRAUD.ipynb"
    click svm "https://github.com/mondrita/credit-card-fraud-detection/blob/main/CREDIT_CARD__FRAUD.ipynb"
    click nb "https://github.com/mondrita/credit-card-fraud-detection/blob/main/CREDIT_CARD__FRAUD.ipynb"
    click metrics "https://github.com/mondrita/credit-card-fraud-detection/blob/main/CREDIT_CARD__FRAUD.ipynb"
    click cm "https://github.com/mondrita/credit-card-fraud-detection/blob/main/CREDIT_CARD__FRAUD.ipynb"
    click roc "https://github.com/mondrita/credit-card-fraud-detection/blob/main/CREDIT_CARD__FRAUD.ipynb"
    click plots "https://github.com/mondrita/credit-card-fraud-detection/blob/main/CREDIT_CARD__FRAUD.ipynb"
    click readme "https://github.com/mondrita/credit-card-fraud-detection/blob/main/README.md"

    %% Styles
    classDef data fill:#D0E6FF,stroke:#0077C8,color:#000;
    classDef process fill:#DFF5D0,stroke:#3C7A00,color:#000;
    classDef model fill:#FFE5B4,stroke:#FF8C00,color:#000;
    classDef eval fill:#E5D0FF,stroke:#8000FF,color:#000;
    classDef viz fill:#E5D0FF,stroke:#8000FF,color:#000;
    classDef doc fill:#F0F0F0,stroke:#888,color:#000;
```
