# kiranrajdd/market architecture

> Architecture diagram of the GitHub repository kiranrajdd/market, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kiranrajdd/market
- Repository: https://github.com/kiranrajdd/market

## Overview

This is a full-stack market-basket analysis and product-recommendation application. Customers authenticate, browse products, receive cart recommendations, and check out; admins manage datasets and users and inspect dashboards and association rules. Dataset ingestion feeds Apriori analysis, while checkout records transactions and broadcasts live events. The graph combines sampled source with README-documented capabilities; several route and page implementations were not excerpted, so their internal behavior is not expanded.

Main entry points: [`frontend/src/services/api.js`](https://github.com/kiranrajdd/market/blob/main/frontend/src/services/api.js) (API client), [`backend/app/main.py`](https://github.com/kiranrajdd/market/blob/main/backend/app/main.py) (FastAPI application), [`frontend/src/App.jsx`](https://github.com/kiranrajdd/market/blob/main/frontend/src/App.jsx) (App routing), [`backend/app/routes/transactions.py`](https://github.com/kiranrajdd/market/blob/main/backend/app/routes/transactions.py) (Checkout and history)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App routing<br/>[App.jsx]"]
  node_auth_ui["Session context<br/>[AuthContext.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_storefront["Product storefront"]
  node_live_cart["Live cart<br/>[LiveCartPage.jsx]"]
  node_history_recs["History and recommendations"]
  node_dashboard["Dashboard<br/>[DashboardPage.jsx]"]
  node_dataset_ui["Dataset manager<br/>[DatasetPage.jsx]"]
  node_analysis_ui["Rules explorer<br/>[AnalysisPage.jsx]"]
  node_admin_ui["Admin management<br/>[AdminPage.jsx]"]
  node_login_ui["Login page<br/>[LoginPage.jsx]"]
end

subgraph group_api["API and domain"]
  node_auth_routes["Authentication routes<br/>[auth.py]"]
  node_product_routes["Product routes<br/>[products.py]"]
  node_transaction_routes["Checkout and history<br/>[transactions.py]"]
  node_analysis_routes["Analysis routes<br/>[analysis.py]"]
  node_recommend_routes["Recommendation routes<br/>[recommendations.py]"]
  node_dashboard_routes["Dashboard routes<br/>[dashboard.py]"]
  node_admin_routes["User administration<br/>[admin.py]"]
  node_server["FastAPI application<br/>[main.py]"]
end

subgraph group_ml["Analysis engine"]
  node_csv_processing["CSV preprocessing<br/>[preprocessing.py]"]
  node_apriori["Apriori mining<br/>[apriori_model.py]"]
  node_recommender["Rule recommender<br/>[recommender.py]"]
end

subgraph group_state["Persistence and events"]
  node_dataset_service["Dataset loading<br/>[dataset_service.py]"]
  node_db[("Database session<br/>[database.py]")]
  node_models["Domain records<br/>[models.py]"]
  node_ws_manager["WebSocket broadcast"]
end

node_customer(("Customer"))
node_administrator(("Administrator"))

node_customer -->|"uses"| node_app
node_administrator -->|"uses"| node_app
node_app -->|"provides session"| node_auth_ui
node_app -->|"routes to"| node_login_ui
node_app -->|"routes to"| node_storefront
node_app -->|"routes to"| node_live_cart
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_dataset_ui
node_app -->|"routes to"| node_analysis_ui
node_app -->|"routes to"| node_admin_ui
node_auth_ui -->|"calls auth APIs"| node_api_client
node_login_ui -->|"uses session"| node_auth_ui
node_storefront -->|"requests products"| node_api_client
node_live_cart -->|"checks out"| node_api_client
node_history_recs -->|"requests recommendations"| node_api_client
node_dashboard -->|"loads metrics"| node_api_client
node_dataset_ui -->|"manages dataset"| node_api_client
node_analysis_ui -->|"requests rules"| node_api_client
node_admin_ui -->|"manages users"| node_api_client
node_api_client -->|"calls auth endpoints"| node_auth_routes
node_api_client -->|"calls product endpoints"| node_product_routes
node_api_client -->|"calls checkout endpoints"| node_transaction_routes
node_api_client -->|"calls analysis endpoints"| node_analysis_routes
node_api_client -->|"calls recommendation endpoints"| node_recommend_routes
node_api_client -->|"calls dashboard endpoints"| node_dashboard_routes
node_api_client -->|"calls admin endpoints"| node_admin_routes
node_server -->|"registers"| node_auth_routes
node_server -->|"registers"| node_product_routes
node_server -->|"registers"| node_transaction_routes
node_server -->|"registers"| node_analysis_routes
node_server -->|"registers"| node_recommend_routes
node_server -->|"registers"| node_dashboard_routes
node_server -->|"registers"| node_admin_routes
node_server -->|"accepts admin sockets"| node_ws_manager
node_server -->|"loads startup data"| node_dataset_service
node_server -->|"validates startup CSV"| node_csv_processing
node_auth_routes -->|"gets sessions"| node_db
node_auth_routes -->|"queries users"| node_models
node_admin_routes -->|"gets sessions"| node_db
node_admin_routes -->|"manages accounts"| node_models
node_product_routes -->|"gets sessions"| node_db
node_product_routes -->|"queries products"| node_models
node_transaction_routes -->|"validates uploads"| node_csv_processing
node_transaction_routes -->|"loads uploaded data"| node_dataset_service
node_transaction_routes -->|"broadcasts checkout"| node_ws_manager
node_transaction_routes -->|"generates suggestions"| node_recommender
node_analysis_routes -->|"reads transactions"| node_dataset_service
node_analysis_routes -->|"runs mining"| node_apriori

click node_app "https://github.com/kiranrajdd/market/blob/main/frontend/src/App.jsx"
click node_auth_ui "https://github.com/kiranrajdd/market/blob/main/frontend/src/context/AuthContext.jsx"
click node_api_client "https://github.com/kiranrajdd/market/blob/main/frontend/src/services/api.js"
click node_storefront "https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/ProductStorefrontPage.jsx"
click node_live_cart "https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/LiveCartPage.jsx"
click node_history_recs "https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/RecommendationPage.jsx"
click node_dashboard "https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/DashboardPage.jsx"
click node_dataset_ui "https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/DatasetPage.jsx"
click node_analysis_ui "https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/AnalysisPage.jsx"
click node_admin_ui "https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/AdminPage.jsx"
click node_login_ui "https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/LoginPage.jsx"
click node_auth_routes "https://github.com/kiranrajdd/market/blob/main/backend/app/routes/auth.py"
click node_product_routes "https://github.com/kiranrajdd/market/blob/main/backend/app/routes/products.py"
click node_transaction_routes "https://github.com/kiranrajdd/market/blob/main/backend/app/routes/transactions.py"
click node_analysis_routes "https://github.com/kiranrajdd/market/blob/main/backend/app/routes/analysis.py"
click node_recommend_routes "https://github.com/kiranrajdd/market/blob/main/backend/app/routes/recommendations.py"
click node_dashboard_routes "https://github.com/kiranrajdd/market/blob/main/backend/app/routes/dashboard.py"
click node_admin_routes "https://github.com/kiranrajdd/market/blob/main/backend/app/routes/admin.py"
click node_csv_processing "https://github.com/kiranrajdd/market/blob/main/backend/app/ml/preprocessing.py"
click node_apriori "https://github.com/kiranrajdd/market/blob/main/backend/app/ml/apriori_model.py"
click node_recommender "https://github.com/kiranrajdd/market/blob/main/backend/app/ml/recommender.py"
click node_dataset_service "https://github.com/kiranrajdd/market/blob/main/backend/app/services/dataset_service.py"
click node_db "https://github.com/kiranrajdd/market/blob/main/backend/app/database.py"
click node_models "https://github.com/kiranrajdd/market/blob/main/backend/app/models.py"
click node_ws_manager "https://github.com/kiranrajdd/market/blob/main/backend/app/websocket_manager.py"
click node_server "https://github.com/kiranrajdd/market/blob/main/backend/app/main.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth_ui,node_api_client,node_storefront,node_live_cart,node_history_recs,node_dashboard,node_dataset_ui,node_analysis_ui,node_admin_ui,node_login_ui toneBlue
class node_auth_routes,node_product_routes,node_transaction_routes,node_analysis_routes,node_recommend_routes,node_dashboard_routes,node_admin_routes,node_server toneAmber
class node_csv_processing,node_apriori,node_recommender toneMint
class node_dataset_service,node_db,node_models,node_ws_manager toneRose
class node_customer,node_administrator toneIndigo
```

## Components

### Web application

- [App routing](https://github.com/kiranrajdd/market/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session context](https://github.com/kiranrajdd/market/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/kiranrajdd/market/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Product storefront](https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/ProductStorefrontPage.jsx): `frontend/src/pages/ProductStorefrontPage.jsx`
- [Live cart](https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/LiveCartPage.jsx): `frontend/src/pages/LiveCartPage.jsx`
- [History and recommendations](https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/RecommendationPage.jsx): `frontend/src/pages/RecommendationPage.jsx`
- [Dashboard](https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/DashboardPage.jsx): `frontend/src/pages/DashboardPage.jsx`
- [Dataset manager](https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/DatasetPage.jsx): `frontend/src/pages/DatasetPage.jsx`
- [Rules explorer](https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/AnalysisPage.jsx): `frontend/src/pages/AnalysisPage.jsx`
- [Admin management](https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/AdminPage.jsx): `frontend/src/pages/AdminPage.jsx`
- [Login page](https://github.com/kiranrajdd/market/blob/main/frontend/src/pages/LoginPage.jsx): `frontend/src/pages/LoginPage.jsx`

### API and domain

- [Authentication routes](https://github.com/kiranrajdd/market/blob/main/backend/app/routes/auth.py): `backend/app/routes/auth.py`
- [Product routes](https://github.com/kiranrajdd/market/blob/main/backend/app/routes/products.py): `backend/app/routes/products.py`
- [Checkout and history](https://github.com/kiranrajdd/market/blob/main/backend/app/routes/transactions.py): `backend/app/routes/transactions.py`
- [Analysis routes](https://github.com/kiranrajdd/market/blob/main/backend/app/routes/analysis.py): `backend/app/routes/analysis.py`
- [Recommendation routes](https://github.com/kiranrajdd/market/blob/main/backend/app/routes/recommendations.py): `backend/app/routes/recommendations.py`
- [Dashboard routes](https://github.com/kiranrajdd/market/blob/main/backend/app/routes/dashboard.py): `backend/app/routes/dashboard.py`
- [User administration](https://github.com/kiranrajdd/market/blob/main/backend/app/routes/admin.py): `backend/app/routes/admin.py`
- [FastAPI application](https://github.com/kiranrajdd/market/blob/main/backend/app/main.py): `backend/app/main.py`

### Analysis engine

- [CSV preprocessing](https://github.com/kiranrajdd/market/blob/main/backend/app/ml/preprocessing.py): `backend/app/ml/preprocessing.py`
- [Apriori mining](https://github.com/kiranrajdd/market/blob/main/backend/app/ml/apriori_model.py): `backend/app/ml/apriori_model.py`
- [Rule recommender](https://github.com/kiranrajdd/market/blob/main/backend/app/ml/recommender.py): `backend/app/ml/recommender.py`

### Persistence and events

- [Dataset loading](https://github.com/kiranrajdd/market/blob/main/backend/app/services/dataset_service.py): `backend/app/services/dataset_service.py`
- [Database session](https://github.com/kiranrajdd/market/blob/main/backend/app/database.py): `backend/app/database.py`
- [Domain records](https://github.com/kiranrajdd/market/blob/main/backend/app/models.py): `backend/app/models.py`
- [WebSocket broadcast](https://github.com/kiranrajdd/market/blob/main/backend/app/websocket_manager.py): `backend/app/websocket_manager.py`

### Other components

- **Customer**
- **Administrator**

## Connections

- Customer → App routing: uses (evidence: `README.md`)
- Administrator → App routing: uses (evidence: `README.md`)
- App routing → Session context: provides session (evidence: `frontend/src/App.jsx`)
- App routing → Login page: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Product storefront: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Live cart: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Dataset manager: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Rules explorer: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Admin management: routes to (evidence: `frontend/src/App.jsx`)
- Session context → API client: calls auth APIs (evidence: `frontend/src/context/AuthContext.jsx`)
- Login page → Session context: uses session (evidence: `frontend/src/pages/LoginPage.jsx`)
- Product storefront → API client: requests products (evidence: `frontend/src/pages/ProductStorefrontPage.jsx`)
- Live cart → API client: checks out (evidence: `frontend/src/pages/LiveCartPage.jsx`)
- History and recommendations → API client: requests recommendations (evidence: `frontend/src/pages/RecommendationPage.jsx`)
- Dashboard → API client: loads metrics (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Dataset manager → API client: manages dataset (evidence: `frontend/src/pages/DatasetPage.jsx`)
- Rules explorer → API client: requests rules (evidence: `frontend/src/pages/AnalysisPage.jsx`)
- Admin management → API client: manages users (evidence: `frontend/src/pages/AdminPage.jsx`)
- API client → Authentication routes: calls auth endpoints (evidence: `frontend/src/services/api.js`)
- API client → Product routes: calls product endpoints (evidence: `frontend/src/services/api.js`)
- API client → Checkout and history: calls checkout endpoints (evidence: `frontend/src/services/api.js`)
- API client → Analysis routes: calls analysis endpoints (evidence: `frontend/src/services/api.js`)
- API client → Recommendation routes: calls recommendation endpoints (evidence: `frontend/src/services/api.js`)
- API client → Dashboard routes: calls dashboard endpoints (evidence: `frontend/src/services/api.js`)
- API client → User administration: calls admin endpoints (evidence: `frontend/src/services/api.js`)
- FastAPI application → Authentication routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Product routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Checkout and history: registers (evidence: `backend/app/main.py`)
- FastAPI application → Analysis routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Recommendation routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Dashboard routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → User administration: registers (evidence: `backend/app/main.py`)
- FastAPI application → WebSocket broadcast: accepts admin sockets (evidence: `backend/app/main.py`)
- FastAPI application → Dataset loading: loads startup data (evidence: `backend/app/main.py`)
- FastAPI application → CSV preprocessing: validates startup CSV (evidence: `backend/app/main.py`)
- Authentication routes → Database session: gets sessions (evidence: `backend/app/routes/auth.py`)
- Authentication routes → Domain records: queries users (evidence: `backend/app/routes/auth.py`)
- User administration → Database session: gets sessions (evidence: `backend/app/routes/admin.py`)
- User administration → Domain records: manages accounts (evidence: `backend/app/routes/admin.py`)
- Product routes → Database session: gets sessions (evidence: `backend/app/routes/products.py`)
- Product routes → Domain records: queries products (evidence: `backend/app/routes/products.py`)
- Checkout and history → CSV preprocessing: validates uploads (evidence: `backend/app/routes/transactions.py`)
- Checkout and history → Dataset loading: loads uploaded data (evidence: `backend/app/routes/transactions.py`)
- Checkout and history → WebSocket broadcast: broadcasts checkout (evidence: `backend/app/routes/transactions.py`)
- Checkout and history → Rule recommender: generates suggestions (evidence: `backend/app/routes/transactions.py`)
- Analysis routes → Dataset loading: reads transactions (evidence: `backend/app/routes/analysis.py`)
- Analysis routes → Apriori mining: runs mining (evidence: `backend/app/routes/analysis.py`)
