# kallappa2005/ecommerce-app architecture

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

- Interactive diagram: https://gitdiagram.com/kallappa2005/ecommerce-app
- Repository: https://github.com/kallappa2005/ecommerce-app

## Overview

This is a multi-store e-commerce platform: shoppers browse products, manage carts, place orders, and pay; administrators manage products and order status. The storefront and admin panel send requests through the gateway to independently deployed services. Order, registration, payment, and status events feed email and app-notification consumers. The README documents service responsibilities and event routing; sampled controllers confirm several service-to-model and payment/storage calls. Some unsampled service wiring is therefore shown only where documented.

Main entry points: [`gateway/server.js`](https://github.com/kallappa2005/ecommerce-app/blob/main/gateway/server.js) (Gateway), [`services/payment-service/controllers/paymentController.js`](https://github.com/kallappa2005/ecommerce-app/blob/main/services/payment-service/controllers/paymentController.js) (Payment Service), [`shared/config/rabbitmq.js`](https://github.com/kallappa2005/ecommerce-app/blob/main/shared/config/rabbitmq.js) (RabbitMQ), [`services/user-service/controllers/userController.js`](https://github.com/kallappa2005/ecommerce-app/blob/main/services/user-service/controllers/userController.js) (User Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User Interfaces"]
  node_storefront["Storefront<br/>[App.jsx]"]
  node_adminui["Admin Panel<br/>[App.jsx]"]
end

subgraph group_edge["API Gateway"]
  node_gateway["Gateway<br/>[server.js]"]
  node_gatewayroutes["Proxy Routes<br/>[index.js]"]
end

subgraph group_commerce["Commerce Services"]
  node_user["User Service<br/>[userController.js]"]
  node_product["Product Service"]
  node_cart["Cart Service<br/>[cartController.js]"]
  node_order["Order Service<br/>[orderController.js]"]
  node_payment["Payment Service"]
  node_userdb[("User Database<br/>[userModel.js]")]
  node_productdb[("Product Database<br/>[productModel.js]")]
  node_cartdb[("Cart User Data<br/>[userModel.js]")]
  node_orderdb[("Order Database<br/>[orderModel.js]")]
  node_paymentdb[("Payment Order Data<br/>[orderModel.js]")]
end

subgraph group_events["Event Consumers"]
  node_email["Email Consumer<br/>[emailConsumer.js]"]
  node_notify["Notification Consumer"]
end

subgraph group_shared["Shared Runtime"]
  node_responses["Response Helpers<br/>[responseHelper.js]"]
  node_errors["Error Handling<br/>[errorHandler.js]"]
  node_mongodb["MongoDB Connector<br/>[mongodb.js]"]
end

node_shopper(("Shopper"))
node_admin(("Administrator"))
node_s3["AWS S3"]
node_payments["Stripe / Razorpay"]
node_rabbit["RabbitMQ<br/>[rabbitmq.js]"]
node_ses["AWS SES<br/>[ses.js]"]

node_shopper -->|"uses"| node_storefront
node_admin -->|"manages"| node_adminui
node_storefront -->|"API requests"| node_gateway
node_adminui -->|"API requests"| node_gateway
node_gateway -->|"routes through"| node_gatewayroutes
node_gateway -->|"proxies requests"| node_user
node_gateway -->|"proxies requests"| node_product
node_gateway -->|"proxies requests"| node_cart
node_gateway -->|"proxies requests"| node_order
node_gateway -->|"proxies requests"| node_payment
node_user -->|"reads / writes"| node_userdb
node_product -->|"reads / writes"| node_productdb
node_product -->|"uploads images"| node_s3
node_cart -->|"reads / writes"| node_cartdb
node_order -->|"reads / writes"| node_orderdb
node_payment -->|"updates orders"| node_paymentdb
node_payment -->|"creates / verifies"| node_payments
node_user -->|"publishes registration"| node_rabbit
node_order -->|"publishes order events"| node_rabbit
node_payment -->|"publishes payment events"| node_rabbit
node_rabbit -->|"delivers events"| node_email
node_rabbit -->|"delivers status events"| node_notify
node_email -->|"sends email"| node_ses
node_user -->|"formats responses"| node_responses
node_order -->|"formats responses"| node_responses
node_payment -->|"wraps handlers"| node_errors
node_gateway -.->|"connects service data"| node_mongodb

click node_storefront "https://github.com/kallappa2005/ecommerce-app/blob/main/frontend/src/App.jsx"
click node_adminui "https://github.com/kallappa2005/ecommerce-app/blob/main/admin/src/App.jsx"
click node_gateway "https://github.com/kallappa2005/ecommerce-app/blob/main/gateway/server.js"
click node_gatewayroutes "https://github.com/kallappa2005/ecommerce-app/blob/main/gateway/src/routes/index.js"
click node_user "https://github.com/kallappa2005/ecommerce-app/blob/main/services/user-service/controllers/userController.js"
click node_product "https://github.com/kallappa2005/ecommerce-app/blob/main/services/product-service/controllers/productController.js"
click node_cart "https://github.com/kallappa2005/ecommerce-app/blob/main/services/cart-service/controllers/cartController.js"
click node_order "https://github.com/kallappa2005/ecommerce-app/blob/main/services/order-service/controllers/orderController.js"
click node_payment "https://github.com/kallappa2005/ecommerce-app/blob/main/services/payment-service/controllers/paymentController.js"
click node_userdb "https://github.com/kallappa2005/ecommerce-app/blob/main/services/user-service/models/userModel.js"
click node_productdb "https://github.com/kallappa2005/ecommerce-app/blob/main/services/product-service/models/productModel.js"
click node_cartdb "https://github.com/kallappa2005/ecommerce-app/blob/main/services/cart-service/models/userModel.js"
click node_orderdb "https://github.com/kallappa2005/ecommerce-app/blob/main/services/order-service/models/orderModel.js"
click node_paymentdb "https://github.com/kallappa2005/ecommerce-app/blob/main/services/payment-service/models/orderModel.js"
click node_rabbit "https://github.com/kallappa2005/ecommerce-app/blob/main/shared/config/rabbitmq.js"
click node_email "https://github.com/kallappa2005/ecommerce-app/blob/main/services/email-service/consumers/emailConsumer.js"
click node_ses "https://github.com/kallappa2005/ecommerce-app/blob/main/services/email-service/config/ses.js"
click node_notify "https://github.com/kallappa2005/ecommerce-app/blob/main/services/notification-service/consumers/notificationConsumer.js"
click node_responses "https://github.com/kallappa2005/ecommerce-app/blob/main/shared/utils/responseHelper.js"
click node_errors "https://github.com/kallappa2005/ecommerce-app/blob/main/shared/utils/errorHandler.js"
click node_mongodb "https://github.com/kallappa2005/ecommerce-app/blob/main/shared/config/mongodb.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_storefront,node_adminui toneBlue
class node_gateway,node_gatewayroutes toneAmber
class node_user,node_product,node_cart,node_order,node_payment,node_userdb,node_productdb,node_cartdb,node_orderdb,node_paymentdb toneMint
class node_email,node_notify toneRose
class node_responses,node_errors,node_mongodb,node_shopper,node_admin,node_s3,node_payments toneIndigo
class node_rabbit,node_ses toneTeal
```

## Components

### User Interfaces

- [Storefront](https://github.com/kallappa2005/ecommerce-app/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Admin Panel](https://github.com/kallappa2005/ecommerce-app/blob/main/admin/src/App.jsx): `admin/src/App.jsx`

### API Gateway

- [Gateway](https://github.com/kallappa2005/ecommerce-app/blob/main/gateway/server.js): `gateway/server.js`
- [Proxy Routes](https://github.com/kallappa2005/ecommerce-app/blob/main/gateway/src/routes/index.js): `gateway/src/routes/index.js`

### Commerce Services

- [User Service](https://github.com/kallappa2005/ecommerce-app/blob/main/services/user-service/controllers/userController.js): `services/user-service/controllers/userController.js`
- [Product Service](https://github.com/kallappa2005/ecommerce-app/blob/main/services/product-service/controllers/productController.js): `services/product-service/controllers/productController.js`
- [Cart Service](https://github.com/kallappa2005/ecommerce-app/blob/main/services/cart-service/controllers/cartController.js): `services/cart-service/controllers/cartController.js`
- [Order Service](https://github.com/kallappa2005/ecommerce-app/blob/main/services/order-service/controllers/orderController.js): `services/order-service/controllers/orderController.js`
- [Payment Service](https://github.com/kallappa2005/ecommerce-app/blob/main/services/payment-service/controllers/paymentController.js): `services/payment-service/controllers/paymentController.js`
- [User Database](https://github.com/kallappa2005/ecommerce-app/blob/main/services/user-service/models/userModel.js): `services/user-service/models/userModel.js`
- [Product Database](https://github.com/kallappa2005/ecommerce-app/blob/main/services/product-service/models/productModel.js): `services/product-service/models/productModel.js`
- [Cart User Data](https://github.com/kallappa2005/ecommerce-app/blob/main/services/cart-service/models/userModel.js): `services/cart-service/models/userModel.js`
- [Order Database](https://github.com/kallappa2005/ecommerce-app/blob/main/services/order-service/models/orderModel.js): `services/order-service/models/orderModel.js`
- [Payment Order Data](https://github.com/kallappa2005/ecommerce-app/blob/main/services/payment-service/models/orderModel.js): `services/payment-service/models/orderModel.js`

### Event Consumers

- [Email Consumer](https://github.com/kallappa2005/ecommerce-app/blob/main/services/email-service/consumers/emailConsumer.js): `services/email-service/consumers/emailConsumer.js`
- [Notification Consumer](https://github.com/kallappa2005/ecommerce-app/blob/main/services/notification-service/consumers/notificationConsumer.js): `services/notification-service/consumers/notificationConsumer.js`

### Shared Runtime

- [Response Helpers](https://github.com/kallappa2005/ecommerce-app/blob/main/shared/utils/responseHelper.js): `shared/utils/responseHelper.js`
- [Error Handling](https://github.com/kallappa2005/ecommerce-app/blob/main/shared/utils/errorHandler.js): `shared/utils/errorHandler.js`
- [MongoDB Connector](https://github.com/kallappa2005/ecommerce-app/blob/main/shared/config/mongodb.js): `shared/config/mongodb.js`

### Other components

- **Shopper**
- **Administrator**
- **AWS S3**
- **Stripe / Razorpay**
- [RabbitMQ](https://github.com/kallappa2005/ecommerce-app/blob/main/shared/config/rabbitmq.js): `shared/config/rabbitmq.js`
- [AWS SES](https://github.com/kallappa2005/ecommerce-app/blob/main/services/email-service/config/ses.js): `services/email-service/config/ses.js`

## Connections

- Shopper → Storefront: uses (evidence: `README.md`)
- Administrator → Admin Panel: manages (evidence: `README.md`)
- Storefront → Gateway: API requests (evidence: `README.md`)
- Admin Panel → Gateway: API requests (evidence: `README.md`)
- Gateway → Proxy Routes: routes through (evidence: `gateway/server.js`)
- Gateway → User Service: proxies requests (evidence: `README.md`)
- Gateway → Product Service: proxies requests (evidence: `README.md`)
- Gateway → Cart Service: proxies requests (evidence: `README.md`)
- Gateway → Order Service: proxies requests (evidence: `README.md`)
- Gateway → Payment Service: proxies requests (evidence: `README.md`)
- User Service → User Database: reads / writes (evidence: `services/user-service/controllers/userController.js`)
- Product Service → Product Database: reads / writes (evidence: `services/product-service/controllers/productController.js`)
- Product Service → AWS S3: uploads images (evidence: `services/product-service/controllers/productController.js`)
- Cart Service → Cart User Data: reads / writes (evidence: `services/cart-service/controllers/cartController.js`)
- Order Service → Order Database: reads / writes (evidence: `services/order-service/controllers/orderController.js`)
- Payment Service → Payment Order Data: updates orders (evidence: `services/payment-service/controllers/paymentController.js`)
- Payment Service → Stripe / Razorpay: creates / verifies (evidence: `services/payment-service/controllers/paymentController.js`)
- User Service → RabbitMQ: publishes registration (evidence: `README.md`)
- Order Service → RabbitMQ: publishes order events (evidence: `README.md`)
- Payment Service → RabbitMQ: publishes payment events (evidence: `README.md`)
- RabbitMQ → Email Consumer: delivers events (evidence: `README.md`)
- RabbitMQ → Notification Consumer: delivers status events (evidence: `README.md`)
- Email Consumer → AWS SES: sends email (evidence: `README.md`)
- User Service → Response Helpers: formats responses (evidence: `services/user-service/controllers/userController.js`)
- Order Service → Response Helpers: formats responses (evidence: `services/order-service/controllers/orderController.js`)
- Payment Service → Error Handling: wraps handlers (evidence: `services/payment-service/controllers/paymentController.js`)
- Gateway → MongoDB Connector: connects service data
