How heba23snoubar/ecommerce-platform works
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: storeApi.js Store API · Program.cs API Host · OrdersService.cs Order Service · App.jsx Route App
Components 29
Storefront
- Route App
frontend/src/App.jsx - Auth Context
frontend/src/context/AuthContext.jsx - Store Context
frontend/src/context/StoreContext.jsx - Store API
frontend/src/services/storeApi.js - Browser Storage
frontend/src/utils/storage.js - Product Pages
frontend/src/pages/ProductsPage.jsx - Checkout Page
frontend/src/pages/CheckoutPage.jsx - Order Pages
frontend/src/pages/OrdersPage.jsx - Notifications Page
frontend/src/pages/NotificationsPage.jsx
Identity and API
- API Host
src/AppService/AppService.Host/Program.cs - Authentication and RBAC
src/AppService/Modules/Users/Users.Module/Services/AuthService.cs - User Data
src/AppService/Modules/Users/Users.Module/Data/UsersDbContext.cs
Catalog and Cart
- Product Catalog
src/AppService/Modules/Products/Products.Module/Endpoints/Contoller/ProductsController.cs - Catalog Queries
src/AppService/Modules/Products/Products.Module/Application/Services/Implementations/ProductQueryService.cs - Catalog Data
src/AppService/Modules/Products/Products.Module/Infrastructure/Persistence/CatalogDbContext.cs - Cart Service
src/AppService/Modules/Carts/Carts.Module/Application/Services/Implementations/CartQueryService.cs - Cart API
src/AppService/Modules/Carts/Carts.Module/Endpoints/Controller/CartController.cs - Cart Data
src/AppService/Modules/Carts/Carts.Module/Infrastructure/Persistence/CartDbContext.cs
Orders and Notifications
- Order Service
src/AppService/Modules/Orders/Orders.Module/Services/OrdersService.cs - Orders API
src/AppService/Modules/Orders/Orders.Module/Controllers/V1/OrdersController.cs - Order Data
src/AppService/Modules/Orders/Orders.Module/Data/OrdersDbContext.cs - Order Worker
src/OrderWorker/Worker.cs - Notifications
src/AppService/Modules/Notifications/Notifications.Module/Services/NotificationsService.cs - Notification Data
src/AppService/Modules/Notifications/Notifications.Module/Data/NotificationsDbContext.cs
Warehouse
- Warehouse Adapter
src/AppService/Infrastructure.Warehouse/WarehouseGrpcAdapter.cs - Warehouse gRPC
src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/grpc/WarehouseGrpcService.java - Stock Reservation
src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/service/WarehouseStockService.java - Stock and Reservations
src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/repository/StockRepository.java
Other components
- Customer / Admin
Connections 33
- Customer / Admin → Route App: uses storefront
frontend/src/App.jsx - Route App → Product Pages: routes to
frontend/src/App.jsx - Route App → Checkout Page: routes to
frontend/src/App.jsx - Route App → Order Pages: routes to
frontend/src/App.jsx - Route App → Notifications Page: routes to
frontend/src/App.jsx - Auth Context → Store API: calls
frontend/src/context/AuthContext.jsx - Auth Context → Browser Storage: reads and writes
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
src/AppService/AppService.Host/Program.cs - API Host → Product Catalog: registers module
src/AppService/AppService.Host/Program.cs - API Host → Order Service: registers module
src/AppService/AppService.Host/Program.cs - API Host → Notifications: registers module
src/AppService/AppService.Host/Program.cs - API Host → Cart API: registers infrastructure
src/AppService/AppService.Host/Program.cs - Authentication and RBAC → User Data: queries and saves
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
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
src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/grpc/WarehouseGrpcService.java - Stock Reservation → Stock and Reservations: reads and updates
src/WarehouseServiceJava/src/main/java/com/ecommerce/warehouse/service/WarehouseStockService.java