How namanlko/eks-deployed-ecommerce works
ShopSphere is a React storefront backed by an Express/MongoDB API and documented for deployment on AWS EKS behind an ALB. The main user journey is browsing products, adding them to a locally persisted cart, authenticating, and placing and tracking orders; catalog reviews and JWT authentication are additional capabilities. The graph includes documented deployment components, but unsampled deployment manifests are represented at their existing directory. Relationships are limited to shown imports/calls or README statements.
Main entry points: App.js Page Router · api.js API Client · server.js Express API · CartContext.js Cart State
Components 30
Storefront
- Page Router
frontend/src/App.js - Catalog Views
frontend/src/pages/Products.js - Product Detail
frontend/src/pages/ProductDetail.js - Product Card
frontend/src/components/ProductCard.js - Home View
frontend/src/pages/Home.js - Cart State
frontend/src/context/CartContext.js - Cart View
frontend/src/pages/Cart.js - Checkout
frontend/src/pages/Checkout.js - Auth State
frontend/src/context/AuthContext.js - Login and Register
frontend/src/pages/Login.js - Order Views
frontend/src/pages/Orders.js - API Client
frontend/src/utils/api.js
Commerce API
- Express API
backend/server.js - Product Routes
backend/routes/products.js - Catalog and Reviews
backend/controllers/productController.js - Product Store
backend/models/Product.js - Order Routes
backend/routes/orders.js - Order Management
backend/controllers/orderController.js - Order Store
backend/models/Order.js - Cart Routes
backend/routes/cart.js
Identity
- Auth Routes
backend/routes/auth.js - JWT Auth
backend/controllers/authController.js - Access Control
backend/middleware/auth.js - User Store
backend/models/User.js
EKS Platform
- MongoDB Deployment
deployment/kubernetes - Backend Deployment
deployment/kubernetes - Frontend Deployment
deployment/kubernetes - ALB Ingress
deployment/kubernetes - Pod Autoscaler
deployment/kubernetes
Other components
- Shopper
Connections 42
- Shopper → Page Router: uses
README.md - Page Router → Home View: routes to
frontend/src/App.js - Page Router → Catalog Views: routes to
frontend/src/App.js - Page Router → Product Detail: routes to
frontend/src/App.js - Page Router → Cart View: routes to
frontend/src/App.js - Page Router → Checkout: routes to
frontend/src/App.js - Page Router → Login and Register: routes to
frontend/src/App.js - Page Router → Order Views: routes to
frontend/src/App.js - Home View → API Client: fetches catalog
frontend/src/pages/Home.js - Catalog Views → API Client: fetches catalog
frontend/src/pages/Products.js - Product Detail → API Client: fetches product
frontend/src/pages/ProductDetail.js - Catalog Views → Product Card: renders
frontend/src/pages/Products.js - Home View → Product Card: renders
frontend/src/pages/Home.js - Product Card → Cart State: adds item
frontend/src/components/ProductCard.js - Product Detail → Cart State: adds item
frontend/src/pages/ProductDetail.js - Cart View → Cart State: reads and updates
frontend/src/pages/Cart.js - Cart State → Shopper: persists locally
frontend/src/context/CartContext.js - Checkout → Cart State: reads and clears
frontend/src/pages/Checkout.js - Checkout → API Client: creates order
frontend/src/pages/Checkout.js - Login and Register → Auth State: authenticates
frontend/src/pages/Login.js - Checkout → Auth State: checks user
frontend/src/pages/Checkout.js - Order Views → API Client: loads orders
frontend/src/pages/Orders.js - API Client → Express API: calls API
README.md - Express API → Product Routes: mounts
backend/server.js - Express API → Auth Routes: mounts
backend/server.js - Express API → Order Routes: mounts
backend/server.js - Express API → Cart Routes: mounts
backend/server.js - Product Routes → Catalog and Reviews: dispatches
backend/routes/products.js - Catalog and Reviews → Product Store: reads and writes
backend/controllers/productController.js - Catalog and Reviews → Access Control: uses identity
backend/routes/products.js - Auth Routes → JWT Auth: dispatches
backend/routes/auth.js - Auth Routes → Access Control: protects profile
backend/routes/auth.js - JWT Auth → User Store: reads and creates
backend/controllers/authController.js - Access Control → User Store: loads user
backend/middleware/auth.js - Order Routes → Order Management: dispatches
backend/routes/orders.js - Order Routes → Access Control: protects orders
backend/routes/orders.js - Order Management → Order Store: reads and writes
backend/controllers/orderController.js - Order Management → Product Store: reduces stock
backend/controllers/orderController.js - ALB Ingress → Frontend Deployment: routes storefront
README.md - ALB Ingress → Backend Deployment: routes API
README.md - Backend Deployment → MongoDB Deployment: uses database
- Pod Autoscaler → Backend Deployment: scales pods