# heba23snoubar/ecommerce-platform architecture

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

- Interactive diagram: https://gitdiagram.com/heba23snoubar/ecommerce-platform
- Repository: https://github.com/heba23snoubar/ecommerce-platform

## Overview

This is an e-commerce platform with a React storefront and a modular .NET API, plus a Java gRPC warehouse service and an order worker. The user workflow is to authenticate, browse products, manage a cart, check out, and review orders and notifications; admins can manage catalog products. The sampled code confirms routing, authentication, catalog queries, and warehouse reservation behavior. Order, checkout, and notification internals are represented from the repository tree, so their specific runtime links remain unverified.

Main entry points: [`frontend/src/services/storeApi.js`](https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/services/storeApi.js) (Store API), [`src/AppService/AppService.Host/Program.cs`](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/AppService.Host/Program.cs) (API Host), [`src/AppService/Modules/Orders/Orders.Module/Services/OrdersService.cs`](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Orders/Orders.Module/Services/OrdersService.cs) (Order Service), [`frontend/src/App.jsx`](https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/App.jsx) (Route App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Storefront"]
  node_app["Route App<br/>[App.jsx]"]
  node_authctx["Auth Context<br/>[AuthContext.jsx]"]
  node_storectx["Store Context<br/>[StoreContext.jsx]"]
  node_api["Store API<br/>[storeApi.js]"]
  node_localstorage[("Browser Storage<br/>[storage.js]")]
  node_productpages["Product Pages<br/>[ProductsPage.jsx]"]
  node_checkout["Checkout Page<br/>[CheckoutPage.jsx]"]
  node_orderpages["Order Pages<br/>[OrdersPage.jsx]"]
  node_notificationspage["Notifications Page"]
end

subgraph group_identity["Identity and API"]
  node_host["API Host<br/>[Program.cs]"]
  node_users["Authentication and RBAC<br/>[AuthService.cs]"]
  node_userdb[("User Data<br/>[UsersDbContext.cs]")]
end

subgraph group_commerce["Catalog and Cart"]
  node_products["Product Catalog"]
  node_productquery["Catalog Queries"]
  node_catalogdb[("Catalog Data")]
  node_cart["Cart Service"]
  node_cartcontroller["Cart API<br/>[CartController.cs]"]
  node_cartdb[("Cart Data<br/>[CartDbContext.cs]")]
end

subgraph group_fulfillment["Orders and Notifications"]
  node_orders["Order Service<br/>[OrdersService.cs]"]
  node_orderapi["Orders API"]
  node_orderdb[("Order Data<br/>[OrdersDbContext.cs]")]
  node_worker["Order Worker<br/>[Worker.cs]"]
  node_notifications["Notifications"]
  node_notificationdb[("Notification Data")]
end

subgraph group_warehouse["Warehouse"]
  node_warehouseadapter["Warehouse Adapter"]
  node_warehousegrpc["Warehouse gRPC"]
  node_stockservice["Stock Reservation"]
  node_stockdb[("Stock and Reservations")]
end

node_customer(("Customer / Admin"))

node_customer -->|"uses storefront"| node_app
node_app -->|"routes to"| node_productpages
node_app -->|"routes to"| node_checkout
node_app -->|"routes to"| node_orderpages
node_app -->|"routes to"| node_notificationspage
node_authctx -->|"calls"| node_api
node_authctx -->|"reads and writes"| node_localstorage
node_storectx -.->|"uses"| node_api
node_productpages -.->|"requests catalog"| node_api
node_checkout -.->|"submits checkout"| node_api
node_orderpages -.->|"requests orders"| node_api
node_notificationspage -.->|"requests notices"| node_api
node_api -.->|"calls API"| node_host
node_host -->|"registers module"| node_users
node_host -->|"registers module"| node_products
node_host -->|"registers module"| node_orders
node_host -->|"registers module"| node_notifications
node_host -->|"registers infrastructure"| node_cartcontroller
node_users -->|"queries and saves"| node_userdb
node_products -.->|"queries catalog"| node_productquery
node_productquery -.->|"reads catalog"| node_catalogdb
node_cartcontroller -->|"calls service"| node_cart
node_cart -.->|"reads and saves"| node_cartdb
node_orderapi -.->|"calls service"| node_orders
node_orders -.->|"persists orders"| node_orderdb
node_orders -.->|"queries cart"| node_cart
node_orders -.->|"queries products"| node_products
node_orders -.->|"reserves stock"| node_warehouseadapter
node_worker -.->|"dispatches events"| node_notifications
node_notifications -.->|"persists notices"| node_notificationdb
node_warehouseadapter -.->|"calls gRPC"| node_warehousegrpc
node_warehousegrpc -->|"dispatches"| node_stockservice
node_stockservice -->|"reads and updates"| node_stockdb

click node_app "https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/App.jsx"
click node_authctx "https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/context/AuthContext.jsx"
click node_storectx "https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/context/StoreContext.jsx"
click node_api "https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/services/storeApi.js"
click node_localstorage "https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/utils/storage.js"
click node_productpages "https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/pages/ProductsPage.jsx"
click node_checkout "https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/pages/CheckoutPage.jsx"
click node_orderpages "https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/pages/OrdersPage.jsx"
click node_notificationspage "https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/pages/NotificationsPage.jsx"
click node_host "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/AppService.Host/Program.cs"
click node_users "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Users/Users.Module/Services/AuthService.cs"
click node_userdb "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Users/Users.Module/Data/UsersDbContext.cs"
click node_products "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Products/Products.Module/Endpoints/Contoller/ProductsController.cs"
click node_productquery "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Products/Products.Module/Application/Services/Implementations/ProductQueryService.cs"
click node_catalogdb "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Products/Products.Module/Infrastructure/Persistence/CatalogDbContext.cs"
click node_cart "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Carts/Carts.Module/Application/Services/Implementations/CartQueryService.cs"
click node_cartcontroller "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Carts/Carts.Module/Endpoints/Controller/CartController.cs"
click node_cartdb "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Carts/Carts.Module/Infrastructure/Persistence/CartDbContext.cs"
click node_orders "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Orders/Orders.Module/Services/OrdersService.cs"
click node_orderapi "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Orders/Orders.Module/Controllers/V1/OrdersController.cs"
click node_orderdb "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Orders/Orders.Module/Data/OrdersDbContext.cs"
click node_worker "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/OrderWorker/Worker.cs"
click node_notifications "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Notifications/Notifications.Module/Services/NotificationsService.cs"
click node_notificationdb "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Notifications/Notifications.Module/Data/NotificationsDbContext.cs"
click node_warehouseadapter "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Infrastructure.Warehouse/WarehouseGrpcAdapter.cs"
click node_warehousegrpc "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/grpc/WarehouseGrpcService.java"
click node_stockservice "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/service/WarehouseStockService.java"
click node_stockdb "https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/repository/StockRepository.java"

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_authctx,node_storectx,node_api,node_localstorage,node_productpages,node_checkout,node_orderpages,node_notificationspage toneBlue
class node_host,node_users,node_userdb toneAmber
class node_products,node_productquery,node_catalogdb,node_cart,node_cartcontroller,node_cartdb toneMint
class node_orders,node_orderapi,node_orderdb,node_worker,node_notifications,node_notificationdb toneRose
class node_warehouseadapter,node_warehousegrpc,node_stockservice,node_stockdb,node_customer toneIndigo
```

## Components

### Storefront

- [Route App](https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth Context](https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Store Context](https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/context/StoreContext.jsx): `frontend/src/context/StoreContext.jsx`
- [Store API](https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/services/storeApi.js): `frontend/src/services/storeApi.js`
- [Browser Storage](https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/utils/storage.js): `frontend/src/utils/storage.js`
- [Product Pages](https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/pages/ProductsPage.jsx): `frontend/src/pages/ProductsPage.jsx`
- [Checkout Page](https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/pages/CheckoutPage.jsx): `frontend/src/pages/CheckoutPage.jsx`
- [Order Pages](https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/pages/OrdersPage.jsx): `frontend/src/pages/OrdersPage.jsx`
- [Notifications Page](https://github.com/heba23snoubar/ecommerce-platform/blob/main/frontend/src/pages/NotificationsPage.jsx): `frontend/src/pages/NotificationsPage.jsx`

### Identity and API

- [API Host](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/AppService.Host/Program.cs): `src/AppService/AppService.Host/Program.cs`
- [Authentication and RBAC](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Users/Users.Module/Services/AuthService.cs): `src/AppService/Modules/Users/Users.Module/Services/AuthService.cs`
- [User Data](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Users/Users.Module/Data/UsersDbContext.cs): `src/AppService/Modules/Users/Users.Module/Data/UsersDbContext.cs`

### Catalog and Cart

- [Product Catalog](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Products/Products.Module/Endpoints/Contoller/ProductsController.cs): `src/AppService/Modules/Products/Products.Module/Endpoints/Contoller/ProductsController.cs`
- [Catalog Queries](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Products/Products.Module/Application/Services/Implementations/ProductQueryService.cs): `src/AppService/Modules/Products/Products.Module/Application/Services/Implementations/ProductQueryService.cs`
- [Catalog Data](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Products/Products.Module/Infrastructure/Persistence/CatalogDbContext.cs): `src/AppService/Modules/Products/Products.Module/Infrastructure/Persistence/CatalogDbContext.cs`
- [Cart Service](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Carts/Carts.Module/Application/Services/Implementations/CartQueryService.cs): `src/AppService/Modules/Carts/Carts.Module/Application/Services/Implementations/CartQueryService.cs`
- [Cart API](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Carts/Carts.Module/Endpoints/Controller/CartController.cs): `src/AppService/Modules/Carts/Carts.Module/Endpoints/Controller/CartController.cs`
- [Cart Data](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Carts/Carts.Module/Infrastructure/Persistence/CartDbContext.cs): `src/AppService/Modules/Carts/Carts.Module/Infrastructure/Persistence/CartDbContext.cs`

### Orders and Notifications

- [Order Service](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Orders/Orders.Module/Services/OrdersService.cs): `src/AppService/Modules/Orders/Orders.Module/Services/OrdersService.cs`
- [Orders API](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Orders/Orders.Module/Controllers/V1/OrdersController.cs): `src/AppService/Modules/Orders/Orders.Module/Controllers/V1/OrdersController.cs`
- [Order Data](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Orders/Orders.Module/Data/OrdersDbContext.cs): `src/AppService/Modules/Orders/Orders.Module/Data/OrdersDbContext.cs`
- [Order Worker](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/OrderWorker/Worker.cs): `src/OrderWorker/Worker.cs`
- [Notifications](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Notifications/Notifications.Module/Services/NotificationsService.cs): `src/AppService/Modules/Notifications/Notifications.Module/Services/NotificationsService.cs`
- [Notification Data](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Modules/Notifications/Notifications.Module/Data/NotificationsDbContext.cs): `src/AppService/Modules/Notifications/Notifications.Module/Data/NotificationsDbContext.cs`

### Warehouse

- [Warehouse Adapter](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/AppService/Infrastructure.Warehouse/WarehouseGrpcAdapter.cs): `src/AppService/Infrastructure.Warehouse/WarehouseGrpcAdapter.cs`
- [Warehouse gRPC](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/grpc/WarehouseGrpcService.java): `src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/grpc/WarehouseGrpcService.java`
- [Stock Reservation](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/service/WarehouseStockService.java): `src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/service/WarehouseStockService.java`
- [Stock and Reservations](https://github.com/heba23snoubar/ecommerce-platform/blob/main/src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/repository/StockRepository.java): `src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/repository/StockRepository.java`

### Other components

- **Customer / Admin**

## Connections

- Customer / Admin → Route App: uses storefront (evidence: `frontend/src/App.jsx`)
- Route App → Product Pages: routes to (evidence: `frontend/src/App.jsx`)
- Route App → Checkout Page: routes to (evidence: `frontend/src/App.jsx`)
- Route App → Order Pages: routes to (evidence: `frontend/src/App.jsx`)
- Route App → Notifications Page: routes to (evidence: `frontend/src/App.jsx`)
- Auth Context → Store API: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Auth Context → Browser Storage: reads and writes (evidence: `frontend/src/context/AuthContext.jsx`)
- Store Context → Store API: uses
- Product Pages → Store API: requests catalog
- Checkout Page → Store API: submits checkout
- Order Pages → Store API: requests orders
- Notifications Page → Store API: requests notices
- Store API → API Host: calls API
- API Host → Authentication and RBAC: registers module (evidence: `src/AppService/AppService.Host/Program.cs`)
- API Host → Product Catalog: registers module (evidence: `src/AppService/AppService.Host/Program.cs`)
- API Host → Order Service: registers module (evidence: `src/AppService/AppService.Host/Program.cs`)
- API Host → Notifications: registers module (evidence: `src/AppService/AppService.Host/Program.cs`)
- API Host → Cart API: registers infrastructure (evidence: `src/AppService/AppService.Host/Program.cs`)
- Authentication and RBAC → User Data: queries and saves (evidence: `src/AppService/Modules/Users/Users.Module/Services/AuthService.cs`)
- Product Catalog → Catalog Queries: queries catalog
- Catalog Queries → Catalog Data: reads catalog
- Cart API → Cart Service: calls service (evidence: `src/AppService/Modules/Carts/Carts.Module/Endpoints/Controller/CartController.cs`)
- Cart Service → Cart Data: reads and saves
- Orders API → Order Service: calls service
- Order Service → Order Data: persists orders
- Order Service → Cart Service: queries cart
- Order Service → Product Catalog: queries products
- Order Service → Warehouse Adapter: reserves stock
- Order Worker → Notifications: dispatches events
- Notifications → Notification Data: persists notices
- Warehouse Adapter → Warehouse gRPC: calls gRPC
- Warehouse gRPC → Stock Reservation: dispatches (evidence: `src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/grpc/WarehouseGrpcService.java`)
- Stock Reservation → Stock and Reservations: reads and updates (evidence: `src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/service/WarehouseStockService.java`)
