# globalmediaa/apriori-basket-analysis architecture

> Architecture diagram of the GitHub repository globalmediaa/apriori-basket-analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/globalmediaa/apriori-basket-analysis
- Repository: https://github.com/globalmediaa/apriori-basket-analysis

## Overview

##### Project type and purpose
- This is a small monolithic Python “micro-service” that performs market-basket (sepet) analysis and serves results over HTTP.
- It uses Flask for the web layer, Pandas for data manipulation, and mlxtend for association-rule mining on a CSV data source.

##### File structure
- Top level:
- basket.py – main Flask application, ties together HTTP routes, data loading, and the analytics engine
- store_data.csv – static source of transaction data for analysis
- README.md – installation and run instructions
- No separate “frontend” directory—presentation logic is embedded in Flask routes/templates (if any). No external database; the CSV is the only data store.

##### README insights
- Dependencies: pandas, mlxtend, flask
- Run steps: start server on port 5000 and request via URL with a product_id query param
- Implied flow: user calls an endpoint, server reads CSV, computes basket rules, returns result

##### Main components and interactions
a. HTTP Client (browser or API consumer)
b. Flask Web Server (basket.py)
– Request Handler / Router
– Data Loader module (reads store_data.csv via Pandas)
– Analytics Engine (mlxtend rule-mining + Pandas transformation)
– Response Formatter (JSON or HTML)
c. Data Store (store_data.csv)

Relationships:
– Client → Flask Request Handler (HTTP GET /?id=product_id)
– Request Handler → Data Loader (reads CSV)
– Data Loader → Analytics Engine (feeds DataFrame)
– Analytics Engine → Response Formatter (associates rules + filters by product_id)
– Response Formatter → Client (HTTP response)

##### Architectural patterns and design principles
- Monolithic but logically layered: presentation (Flask routes), business logic (analytics), data access (CSV reader)
- Single process, single codebase, no external service dependencies
- Could evolve to a microservices setup by splitting data-access, analytics, and API layers later

##### Putting it all together
1. Request Handler (Flask route)
2. Data Loader (Pandas reading CSV)
3. Analytics Engine (mlxtend rule mining)
4. Response Formatter

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Global entities
    Client["HTTP Client\n(Browser/API)"]:::client
    Client -->|"HTTP GET /?id=product_id"| WebServer["Flask Web Server"]:::web

    %% Flask Application Layers
    subgraph "Flask Application"
        direction TB
        Request["Request Handler\n(Flask Route)"]:::web
        Loader["Data Loader\n(Pandas CSV Reader)"]:::data
        Analytics["Analytics Engine\n(mlxtend + Pandas)"]:::analytics
        Formatter["Response Formatter\n(JSON/HTML)"]:::web
    end

    %% Data Store
    Loader -->|"reads CSV"| DataStore["store_data.csv"]:::datastore

    %% Flow within application
    WebServer --> Request
    Request --> Loader
    Loader --> Analytics
    Analytics --> Formatter
    Formatter -->|"HTTP Response"| Client

    %% Legend
    subgraph "Legend"
        direction TB
        style Legend fill:none,stroke:none
        WebComp["Web/API Components"]:::web
        DataComp["Data Layer"]:::data
        BizComp["Analytics/Business Logic"]:::analytics
        StoreComp["Persistent Data Store"]:::datastore
    end

    %% Click Events
    click WebServer "https://github.com/globalmediaa/apriori-basket-analysis/blob/master/basket.py"
    click Request "https://github.com/globalmediaa/apriori-basket-analysis/blob/master/basket.py"
    click Loader "https://github.com/globalmediaa/apriori-basket-analysis/blob/master/basket.py"
    click Analytics "https://github.com/globalmediaa/apriori-basket-analysis/blob/master/basket.py"
    click Formatter "https://github.com/globalmediaa/apriori-basket-analysis/blob/master/basket.py"
    click DataStore "https://github.com/globalmediaa/apriori-basket-analysis/blob/master/store_data.csv"

    %% Styles
    classDef web fill:#D0E8FF,stroke:#0366d6,color:#0366d6,stroke-width:1px;
    classDef data fill:#E0FFD0,stroke:#28a745,color:#28a745,stroke-width:1px;
    classDef analytics fill:#FFE0B0,stroke:#d18700,color:#d18700,stroke-width:1px;
    classDef datastore fill:#F5F5F5,stroke:#6f42c1,color:#6f42c1,stroke-width:1px,stroke-dasharray: 5 5;
    classDef client fill:#FFFFFF,stroke:#444444,color:#444444,stroke-width:1px;
    class WebServer,Request,Formatter web
    class Loader data
    class Analytics analytics
    class DataStore datastore
    class WebComp web
    class DataComp data
    class BizComp analytics
    class StoreComp datastore
```
