# mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system architecture

> Architecture diagram of the GitHub repository mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system
- Repository: https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system

## Overview

This repository is a retail analytics dashboard with a React frontend, a Flask backend, and a separate Express/MongoDB service. Users enter through login and navigate to dashboard, inventory, product, sales, forecast, transaction, report, and settings views. The frontend loads inventory and sales CSV data for analytics; product management calls the Flask API, while inventory changes and transaction history are handled by the Express service. The sampled evidence confirms routing and several data paths, but not all page-to-service connections or the internals of the Flask app.

Main entry points: [`retail-analytics-frontend/src/App.jsx`](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/App.jsx) (Page router), [`server/routes/inventoryRoutes.js`](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/routes/inventoryRoutes.js) (Inventory routes), [`server/server.js`](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/server.js) (Express server), [`retail-analytics-frontend/src/utils/loadInventoryData.js`](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/utils/loadInventoryData.js) (Inventory loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Dashboard frontend"]
  node_app["Page router<br/>[App.jsx]"]
  node_login["Login<br/>[Login.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_inventory["Inventory<br/>[Inventory.jsx]"]
  node_products["Products<br/>[Products.jsx]"]
  node_sales["Sales<br/>[Sales.jsx]"]
  node_forecast["Forecast<br/>[Forecast.jsx]"]
  node_transactions["Transactions<br/>[Transactions.jsx]"]
  node_reports["Reports<br/>[Reports.jsx]"]
  node_settings["Settings<br/>[Settings.jsx]"]
end

subgraph group_analytics["Analytics data"]
  node_inventory_loader["Inventory loader"]
  node_sales_loader["Sales loader<br/>[loadSalesData.js]"]
end

subgraph group_api["API services"]
  node_flask["Flask API<br/>[app.py]"]
  node_express["Express server<br/>[server.js]"]
  node_auth["Authentication routes<br/>[authRoutes.js]"]
  node_report_api["Report routes<br/>[reports.js]"]
end

subgraph group_ledger["Inventory ledger"]
  node_inventory_api["Inventory routes<br/>[inventoryRoutes.js]"]
  node_user_model[("User records<br/>[User.js]")]
  node_transaction_model[("Transaction ledger<br/>[Transaction.js]")]
end

node_user(("Retail user"))
node_mongo[("MongoDB")]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_inventory
node_app -->|"routes to"| node_products
node_app -->|"routes to"| node_sales
node_app -->|"routes to"| node_forecast
node_app -->|"routes to"| node_transactions
node_app -->|"routes to"| node_reports
node_app -->|"routes to"| node_settings
node_products -->|"requests products"| node_flask
node_inventory -->|"loads data"| node_inventory_loader
node_dashboard -.->|"loads data"| node_inventory_loader
node_forecast -->|"loads data"| node_inventory_loader
node_sales -->|"loads data"| node_sales_loader
node_dashboard -.->|"loads data"| node_sales_loader
node_forecast -->|"loads data"| node_sales_loader
node_inventory_loader -->|"fetches CSV"| node_inventory_api
node_sales_loader -->|"fetches CSV"| node_inventory_api
node_reports -->|"fetches reports"| node_report_api
node_express -->|"mounts routes"| node_auth
node_express -->|"mounts routes"| node_report_api
node_express -->|"mounts routes"| node_inventory_api
node_auth -->|"reads and writes"| node_user_model
node_report_api -->|"references model"| node_user_model
node_inventory_api -->|"reads and writes"| node_transaction_model
node_inventory_api -->|"persists ledger"| node_mongo
node_express -->|"connects"| node_mongo

click node_app "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/App.jsx"
click node_login "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Login.jsx"
click node_dashboard "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Dashboard.jsx"
click node_inventory "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Inventory.jsx"
click node_products "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Products.jsx"
click node_sales "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Sales.jsx"
click node_forecast "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Forecast.jsx"
click node_transactions "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Transactions.jsx"
click node_reports "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Reports.jsx"
click node_settings "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Settings.jsx"
click node_inventory_loader "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/utils/loadInventoryData.js"
click node_sales_loader "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/utils/loadSalesData.js"
click node_flask "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-backend/app.py"
click node_express "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/server.js"
click node_auth "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/routes/authRoutes.js"
click node_report_api "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/routes/reports.js"
click node_inventory_api "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/routes/inventoryRoutes.js"
click node_user_model "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/models/User.js"
click node_transaction_model "https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/models/Transaction.js"

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_login,node_dashboard,node_inventory,node_products,node_sales,node_forecast,node_transactions,node_reports,node_settings,node_user toneBlue
class node_inventory_loader,node_sales_loader,node_mongo toneAmber
class node_flask,node_express,node_auth,node_report_api toneMint
class node_inventory_api,node_user_model,node_transaction_model toneRose
```

## Components

### Dashboard frontend

- [Page router](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/App.jsx): `retail-analytics-frontend/src/App.jsx`
- [Login](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Login.jsx): `retail-analytics-frontend/src/pages/Login.jsx`
- [Dashboard](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Dashboard.jsx): `retail-analytics-frontend/src/pages/Dashboard.jsx`
- [Inventory](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Inventory.jsx): `retail-analytics-frontend/src/pages/Inventory.jsx`
- [Products](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Products.jsx): `retail-analytics-frontend/src/pages/Products.jsx`
- [Sales](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Sales.jsx): `retail-analytics-frontend/src/pages/Sales.jsx`
- [Forecast](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Forecast.jsx): `retail-analytics-frontend/src/pages/Forecast.jsx`
- [Transactions](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Transactions.jsx): `retail-analytics-frontend/src/pages/Transactions.jsx`
- [Reports](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Reports.jsx): `retail-analytics-frontend/src/pages/Reports.jsx`
- [Settings](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/pages/Settings.jsx): `retail-analytics-frontend/src/pages/Settings.jsx`

### Analytics data

- [Inventory loader](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/utils/loadInventoryData.js): `retail-analytics-frontend/src/utils/loadInventoryData.js`
- [Sales loader](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-frontend/src/utils/loadSalesData.js): `retail-analytics-frontend/src/utils/loadSalesData.js`

### API services

- [Flask API](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/retail-analytics-backend/app.py): `retail-analytics-backend/app.py`
- [Express server](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/server.js): `server/server.js`
- [Authentication routes](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Report routes](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/routes/reports.js): `server/routes/reports.js`

### Inventory ledger

- [Inventory routes](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/routes/inventoryRoutes.js): `server/routes/inventoryRoutes.js`
- [User records](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/models/User.js): `server/models/User.js`
- [Transaction ledger](https://github.com/mdkubal-17/intelligent-retail-analytics-and-inventory-optimization-system/blob/main/server/models/Transaction.js): `server/models/Transaction.js`

### Other components

- **Retail user**
- **MongoDB**

## Connections

- Retail user → Page router: uses
- Page router → Login: routes to (evidence: `retail-analytics-frontend/src/App.jsx`)
- Page router → Dashboard: routes to (evidence: `retail-analytics-frontend/src/App.jsx`)
- Page router → Inventory: routes to (evidence: `retail-analytics-frontend/src/App.jsx`)
- Page router → Products: routes to (evidence: `retail-analytics-frontend/src/App.jsx`)
- Page router → Sales: routes to (evidence: `retail-analytics-frontend/src/App.jsx`)
- Page router → Forecast: routes to (evidence: `retail-analytics-frontend/src/App.jsx`)
- Page router → Transactions: routes to (evidence: `retail-analytics-frontend/src/App.jsx`)
- Page router → Reports: routes to (evidence: `retail-analytics-frontend/src/App.jsx`)
- Page router → Settings: routes to (evidence: `retail-analytics-frontend/src/App.jsx`)
- Products → Flask API: requests products (evidence: `retail-analytics-frontend/src/pages/Products.jsx`)
- Inventory → Inventory loader: loads data (evidence: `retail-analytics-frontend/src/pages/Inventory.jsx`)
- Dashboard → Inventory loader: loads data
- Forecast → Inventory loader: loads data (evidence: `retail-analytics-frontend/src/pages/Forecast.jsx`)
- Sales → Sales loader: loads data (evidence: `retail-analytics-frontend/src/pages/Sales.jsx`)
- Dashboard → Sales loader: loads data
- Forecast → Sales loader: loads data (evidence: `retail-analytics-frontend/src/pages/Forecast.jsx`)
- Inventory loader → Inventory routes: fetches CSV (evidence: `retail-analytics-frontend/src/utils/loadInventoryData.js`)
- Sales loader → Inventory routes: fetches CSV (evidence: `retail-analytics-frontend/src/utils/loadSalesData.js`)
- Reports → Report routes: fetches reports (evidence: `retail-analytics-frontend/src/pages/Reports.jsx`)
- Express server → Authentication routes: mounts routes (evidence: `server/server.js`)
- Express server → Report routes: mounts routes (evidence: `server/server.js`)
- Express server → Inventory routes: mounts routes (evidence: `server/server.js`)
- Authentication routes → User records: reads and writes (evidence: `server/routes/authRoutes.js`)
- Report routes → User records: references model (evidence: `server/routes/reports.js`)
- Inventory routes → Transaction ledger: reads and writes (evidence: `server/routes/inventoryRoutes.js`)
- Inventory routes → MongoDB: persists ledger (evidence: `server/routes/inventoryRoutes.js`)
- Express server → MongoDB: connects (evidence: `server/server.js`)
