# preet018/bakery-inventory-management-system architecture

> Architecture diagram of the GitHub repository preet018/bakery-inventory-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/preet018/bakery-inventory-management-system
- Repository: https://github.com/preet018/bakery-inventory-management-system

## Overview

This repository implements a bakery storefront and back-office inventory system, with a React frontend and Spring Boot API. The principal workflow is customers browsing products, managing a cart, and checking out; separate back-office workflows manage orders, catalog items, stock, suppliers, and user accounts. The graph shows frontend routing and the sampled service calls, plus backend controller-to-service relationships visible in excerpts. Many domain services and API connections are unsampled, so those links are omitted rather than inferred.

Main entry points: [`bakery-inventory-frontend/src/App.jsx`](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/App.jsx) (Application Router), [`bakery-inventory-frontend/src/services/productService.js`](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/services/productService.js) (Product API Client), [`bakery-inventory-frontend/src/pages/inventory/InventoryManagerDashboard.jsx`](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/inventory/InventoryManagerDashboard.jsx) (Manager Overview), [`bakery-inventory-frontend/src/services/authService.js`](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/services/authService.js) (Auth API Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["Application Router<br/>[App.jsx]"]
  node_catalog["Product Catalog<br/>[ProductsPage.jsx]"]
  node_product_detail["Product Details"]
  node_cart["Cart<br/>[CartPage.jsx]"]
  node_checkout["Checkout<br/>[CheckoutPage.jsx]"]
  node_orders["Order History"]
end

subgraph group_operations["Back Office"]
  node_inventory_dashboard["Inventory Dashboard"]
  node_manager_dashboard["Manager Overview"]
  node_supplier_management["Supplier Management"]
  node_admin_products["Product Management"]
  node_admin_orders["Order Management"]
  node_admin_users["User Management"]
end

subgraph group_backend["Backend API"]
  node_auth_controller["Authentication Endpoints"]
  node_product_controller["Product Endpoints"]
  node_auth_service_backend["Authentication Logic<br/>[AuthService.java]"]
  node_product_service_backend["Product Logic"]
  node_image_storage["Image Storage"]
  node_backend_domains["Other API Domains"]
end

subgraph group_platform["Shared Platform"]
  node_auth_ui["Authentication State<br/>[AuthContext.jsx]"]
  node_api_client["HTTP Client<br/>[axiosInstance.js]"]
  node_product_service["Product API Client<br/>[productService.js]"]
  node_auth_service["Auth API Client<br/>[authService.js]"]
end

node_customer(("Customer"))

node_customer -->|"uses"| node_app
node_app -->|"routes to"| node_catalog
node_app -->|"routes to"| node_product_detail
node_app -->|"routes to"| node_cart
node_app -->|"routes to"| node_checkout
node_app -->|"routes to"| node_orders
node_app -->|"provides"| node_auth_ui
node_catalog -.->|"uses"| node_product_service
node_product_detail -.->|"uses"| node_product_service
node_product_service -->|"sends requests"| node_api_client
node_auth_service -->|"sends requests"| node_api_client
node_app -->|"routes to"| node_inventory_dashboard
node_app -->|"routes to"| node_manager_dashboard
node_app -->|"routes to"| node_supplier_management
node_app -->|"routes to"| node_admin_products
node_app -->|"routes to"| node_admin_orders
node_app -->|"routes to"| node_admin_users
node_manager_dashboard -->|"uses inventory API"| node_inventory_dashboard
node_manager_dashboard -->|"uses order API"| node_admin_orders
node_auth_controller -->|"delegates to"| node_auth_service_backend
node_product_controller -->|"delegates to"| node_product_service_backend
node_product_service_backend -.->|"uses"| node_image_storage
node_admin_products -->|"uses"| node_product_service
node_product_service -.->|"calls API"| node_product_controller
node_auth_service -->|"calls API"| node_auth_controller

click node_app "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/App.jsx"
click node_catalog "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/public/ProductsPage.jsx"
click node_product_detail "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/public/ProductDetailPage.jsx"
click node_cart "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/customer/CartPage.jsx"
click node_checkout "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/customer/CheckoutPage.jsx"
click node_orders "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/customer/OrderHistoryPage.jsx"
click node_auth_ui "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/context/AuthContext.jsx"
click node_api_client "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/api/axiosInstance.js"
click node_product_service "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/services/productService.js"
click node_auth_service "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/services/authService.js"
click node_inventory_dashboard "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/inventory/InventoryDashboard.jsx"
click node_manager_dashboard "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/inventory/InventoryManagerDashboard.jsx"
click node_supplier_management "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/inventory/SupplierManagementPage.jsx"
click node_admin_products "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/admin/ProductManagementPage.jsx"
click node_admin_orders "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/admin/AdminOrderManagementPage.jsx"
click node_admin_users "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/admin/UserManagementPage.jsx"
click node_auth_controller "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-backend/src/main/java/com/bakery/inventory/controller/AuthController.java"
click node_product_controller "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-backend/src/main/java/com/bakery/inventory/controller/ProductController.java"
click node_auth_service_backend "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-backend/src/main/java/com/bakery/inventory/service/AuthService.java"
click node_product_service_backend "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-backend/src/main/java/com/bakery/inventory/service/ProductService.java"
click node_image_storage "https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-backend/src/main/java/com/bakery/inventory/service/ImageStorageService.java"
click node_backend_domains "https://github.com/preet018/bakery-inventory-management-system/tree/main/bakery-inventory-backend/src/main/java/com/bakery/inventory/controller"

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_catalog,node_product_detail,node_cart,node_checkout,node_orders toneBlue
class node_inventory_dashboard,node_manager_dashboard,node_supplier_management,node_admin_products,node_admin_orders,node_admin_users toneAmber
class node_auth_controller,node_product_controller,node_auth_service_backend,node_product_service_backend,node_image_storage,node_backend_domains toneMint
class node_auth_ui,node_api_client,node_product_service,node_auth_service toneRose
class node_customer toneIndigo
```

## Components

### Storefront

- [Application Router](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/App.jsx): `bakery-inventory-frontend/src/App.jsx`
- [Product Catalog](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/public/ProductsPage.jsx): `bakery-inventory-frontend/src/pages/public/ProductsPage.jsx`
- [Product Details](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/public/ProductDetailPage.jsx): `bakery-inventory-frontend/src/pages/public/ProductDetailPage.jsx`
- [Cart](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/customer/CartPage.jsx): `bakery-inventory-frontend/src/pages/customer/CartPage.jsx`
- [Checkout](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/customer/CheckoutPage.jsx): `bakery-inventory-frontend/src/pages/customer/CheckoutPage.jsx`
- [Order History](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/customer/OrderHistoryPage.jsx): `bakery-inventory-frontend/src/pages/customer/OrderHistoryPage.jsx`

### Back Office

- [Inventory Dashboard](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/inventory/InventoryDashboard.jsx): `bakery-inventory-frontend/src/pages/inventory/InventoryDashboard.jsx`
- [Manager Overview](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/inventory/InventoryManagerDashboard.jsx): `bakery-inventory-frontend/src/pages/inventory/InventoryManagerDashboard.jsx`
- [Supplier Management](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/inventory/SupplierManagementPage.jsx): `bakery-inventory-frontend/src/pages/inventory/SupplierManagementPage.jsx`
- [Product Management](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/admin/ProductManagementPage.jsx): `bakery-inventory-frontend/src/pages/admin/ProductManagementPage.jsx`
- [Order Management](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/admin/AdminOrderManagementPage.jsx): `bakery-inventory-frontend/src/pages/admin/AdminOrderManagementPage.jsx`
- [User Management](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/pages/admin/UserManagementPage.jsx): `bakery-inventory-frontend/src/pages/admin/UserManagementPage.jsx`

### Backend API

- [Authentication Endpoints](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-backend/src/main/java/com/bakery/inventory/controller/AuthController.java): `bakery-inventory-backend/src/main/java/com/bakery/inventory/controller/AuthController.java`
- [Product Endpoints](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-backend/src/main/java/com/bakery/inventory/controller/ProductController.java): `bakery-inventory-backend/src/main/java/com/bakery/inventory/controller/ProductController.java`
- [Authentication Logic](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-backend/src/main/java/com/bakery/inventory/service/AuthService.java): `bakery-inventory-backend/src/main/java/com/bakery/inventory/service/AuthService.java`
- [Product Logic](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-backend/src/main/java/com/bakery/inventory/service/ProductService.java): `bakery-inventory-backend/src/main/java/com/bakery/inventory/service/ProductService.java`
- [Image Storage](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-backend/src/main/java/com/bakery/inventory/service/ImageStorageService.java): `bakery-inventory-backend/src/main/java/com/bakery/inventory/service/ImageStorageService.java`
- [Other API Domains](https://github.com/preet018/bakery-inventory-management-system/tree/main/bakery-inventory-backend/src/main/java/com/bakery/inventory/controller): `bakery-inventory-backend/src/main/java/com/bakery/inventory/controller`

### Shared Platform

- [Authentication State](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/context/AuthContext.jsx): `bakery-inventory-frontend/src/context/AuthContext.jsx`
- [HTTP Client](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/api/axiosInstance.js): `bakery-inventory-frontend/src/api/axiosInstance.js`
- [Product API Client](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/services/productService.js): `bakery-inventory-frontend/src/services/productService.js`
- [Auth API Client](https://github.com/preet018/bakery-inventory-management-system/blob/main/bakery-inventory-frontend/src/services/authService.js): `bakery-inventory-frontend/src/services/authService.js`

### Other components

- **Customer**

## Connections

- Customer → Application Router: uses
- Application Router → Product Catalog: routes to (evidence: `bakery-inventory-frontend/src/App.jsx`)
- Application Router → Product Details: routes to (evidence: `bakery-inventory-frontend/src/App.jsx`)
- Application Router → Cart: routes to (evidence: `bakery-inventory-frontend/src/App.jsx`)
- Application Router → Checkout: routes to (evidence: `bakery-inventory-frontend/src/App.jsx`)
- Application Router → Order History: routes to (evidence: `bakery-inventory-frontend/src/App.jsx`)
- Application Router → Authentication State: provides (evidence: `bakery-inventory-frontend/src/App.jsx`)
- Product Catalog → Product API Client: uses
- Product Details → Product API Client: uses
- Product API Client → HTTP Client: sends requests (evidence: `bakery-inventory-frontend/src/services/productService.js`)
- Auth API Client → HTTP Client: sends requests (evidence: `bakery-inventory-frontend/src/services/authService.js`)
- Application Router → Inventory Dashboard: routes to (evidence: `bakery-inventory-frontend/src/App.jsx`)
- Application Router → Manager Overview: routes to (evidence: `bakery-inventory-frontend/src/App.jsx`)
- Application Router → Supplier Management: routes to (evidence: `bakery-inventory-frontend/src/App.jsx`)
- Application Router → Product Management: routes to (evidence: `bakery-inventory-frontend/src/App.jsx`)
- Application Router → Order Management: routes to (evidence: `bakery-inventory-frontend/src/App.jsx`)
- Application Router → User Management: routes to (evidence: `bakery-inventory-frontend/src/App.jsx`)
- Manager Overview → Inventory Dashboard: uses inventory API (evidence: `bakery-inventory-frontend/src/pages/inventory/InventoryManagerDashboard.jsx`)
- Manager Overview → Order Management: uses order API (evidence: `bakery-inventory-frontend/src/pages/inventory/InventoryManagerDashboard.jsx`)
- Authentication Endpoints → Authentication Logic: delegates to (evidence: `bakery-inventory-backend/src/main/java/com/bakery/inventory/controller/AuthController.java`)
- Product Endpoints → Product Logic: delegates to (evidence: `bakery-inventory-backend/src/main/java/com/bakery/inventory/controller/ProductController.java`)
- Product Logic → Image Storage: uses
- Product Management → Product API Client: uses (evidence: `bakery-inventory-frontend/src/services/productService.js`)
- Product API Client → Product Endpoints: calls API
- Auth API Client → Authentication Endpoints: calls API (evidence: `bakery-inventory-frontend/src/services/authService.js`)
