# jinkalkershiva/econext-ai-integrated-ecommerce-platform architecture

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

- Interactive diagram: https://gitdiagram.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform
- Repository: https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform

## Overview

EcoNext is a sustainable AI-assisted commerce platform with a React storefront, Django product/AI capabilities, and Java microservices for commerce and staff operations. The main customer journey is discovery, cart, payment, and order fulfillment; separate branches provide recommendations, visual and intent search, price forecasting, and conversational assistance. Staff use an operations portal for catalog, inventory, imports, analytics, orders, and governance. The README describes the gateway, Razorpay, Kafka, and STOMP architecture; most implementation paths below are unsampled, so the documented links use README evidence rather than implying inspected call chains.

Main entry points: [`frontend/src/App.js`](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/frontend/src/App.js) (Storefront), [`microservices/api-gateway/src/main/java/com/econext/gateway/ApiGatewayApplication.java`](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/api-gateway/src/main/java/com/econext/gateway/ApiGatewayApplication.java) (API Gateway), [`microservices/order-operations-service/src/main/java/com/econext/order`](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/tree/main/microservices/order-operations-service/src/main/java/com/econext/order) (Order Operations), [`admin-frontend/src/App.jsx`](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/admin-frontend/src/App.jsx) (Admin Portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer Storefront"]
  node_storefront["Storefront<br/>[App.js]"]
end

subgraph group_commerce["Commerce Services"]
  node_catalog["Product Catalog"]
  node_cart["Shopping Cart<br/>[CartService.java]"]
  node_payment["Payment Processing"]
  node_orders["Order Operations"]
  node_fulfillment["Shipment Fulfillment"]
end

subgraph group_discovery["AI Discovery"]
  node_copilot["Shopping Copilot<br/>[services.py]"]
  node_visual["Visual Search<br/>[visual_search.py]"]
  node_intent["Intent Search<br/>[intent_search.py]"]
  node_pricing["Price Forecast<br/>[price_predictor.py]"]
  node_personalization["Recommendations<br/>[recommendations.py]"]
end

subgraph group_operations["Staff Operations"]
  node_adminui["Admin Portal<br/>[App.jsx]"]
  node_staffauth["Staff Governance"]
  node_ops_catalog["Catalog Inventory"]
  node_import_analysis["Import Analytics"]
end

subgraph group_platform["Platform Services"]
  node_identity["Customer Identity<br/>[AuthService.java]"]
  node_realtime["Live Tracking<br/>[stompClient.js]"]
  node_gateway{{"API Gateway"}}
  node_kafka["Event Streaming<br/>[kafka_producer.py]"]
end

node_shopper(("Shopper"))
node_razorpay["Razorpay"]

node_shopper -->|"shops"| node_storefront
node_storefront -.->|"authenticates"| node_identity
node_storefront -.->|"browses"| node_catalog
node_storefront -.->|"manages cart"| node_cart
node_storefront -.->|"checks out"| node_payment
node_payment -->|"verifies payment"| node_razorpay
node_storefront -.->|"views orders"| node_orders
node_orders -->|"coordinates delivery"| node_fulfillment
node_fulfillment -->|"streams tracking"| node_realtime
node_storefront -.->|"asks questions"| node_copilot
node_storefront -->|"searches images"| node_visual
node_storefront -->|"searches by intent"| node_intent
node_storefront -->|"checks forecast"| node_pricing
node_storefront -.->|"gets recommendations"| node_personalization
node_storefront -->|"API ingress"| node_gateway
node_gateway -->|"routes requests"| node_identity
node_gateway -->|"routes requests"| node_cart
node_gateway -->|"routes requests"| node_payment
node_gateway -->|"routes requests"| node_orders
node_adminui -.->|"staff sign-in"| node_staffauth
node_adminui -->|"manages catalog"| node_ops_catalog
node_adminui -->|"imports and analyzes"| node_import_analysis
node_adminui -->|"manages fulfillment"| node_orders
node_orders -->|"publishes events"| node_kafka
node_kafka -->|"broadcasts updates"| node_realtime

click node_storefront "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/frontend/src/App.js"
click node_catalog "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/tree/main/backend/products"
click node_cart "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/cart-service/src/main/java/com/econext/cart/service/CartService.java"
click node_identity "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/auth-service/src/main/java/com/econext/auth/service/AuthService.java"
click node_payment "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/payment-service/src/main/java/com/econext/payment/service/PaymentService.java"
click node_orders "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/tree/main/microservices/order-operations-service/src/main/java/com/econext/order"
click node_fulfillment "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/order-operations-service/src/main/java/com/econext/order/service/ShipmentService.java"
click node_realtime "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/frontend/src/utils/stompClient.js"
click node_copilot "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/backend/copilot/services.py"
click node_visual "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/backend/ml_engine/visual_search.py"
click node_intent "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/backend/ml_engine/intent_search.py"
click node_pricing "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/backend/ml_engine/price_predictor.py"
click node_personalization "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/backend/personalization/recommendations.py"
click node_adminui "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/admin-frontend/src/App.jsx"
click node_staffauth "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/admin-staff-service/src/main/java/com/econext/admin/service/AdminAuthService.java"
click node_ops_catalog "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/catalog-operations-service/src/main/java/com/econext/catalog/service/OperationalCatalogService.java"
click node_import_analysis "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/tree/main/microservices/data-import-analysis-service/src/main/java/com/econext/importanalysis"
click node_gateway "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/api-gateway/src/main/java/com/econext/gateway/ApiGatewayApplication.java"
click node_kafka "https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/backend/site_analytics/kafka_producer.py"

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 toneBlue
class node_catalog,node_cart,node_payment,node_orders,node_fulfillment toneAmber
class node_copilot,node_visual,node_intent,node_pricing,node_personalization toneMint
class node_adminui,node_staffauth,node_ops_catalog,node_import_analysis toneRose
class node_identity,node_realtime,node_gateway,node_kafka,node_shopper,node_razorpay toneIndigo
```

## Components

### Customer Storefront

- [Storefront](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/frontend/src/App.js): `frontend/src/App.js`

### Commerce Services

- [Product Catalog](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/tree/main/backend/products): `backend/products`
- [Shopping Cart](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/cart-service/src/main/java/com/econext/cart/service/CartService.java): `microservices/cart-service/src/main/java/com/econext/cart/service/CartService.java`
- [Payment Processing](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/payment-service/src/main/java/com/econext/payment/service/PaymentService.java): `microservices/payment-service/src/main/java/com/econext/payment/service/PaymentService.java`
- [Order Operations](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/tree/main/microservices/order-operations-service/src/main/java/com/econext/order): `microservices/order-operations-service/src/main/java/com/econext/order`
- [Shipment Fulfillment](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/order-operations-service/src/main/java/com/econext/order/service/ShipmentService.java): `microservices/order-operations-service/src/main/java/com/econext/order/service/ShipmentService.java`

### AI Discovery

- [Shopping Copilot](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/backend/copilot/services.py): `backend/copilot/services.py`
- [Visual Search](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/backend/ml_engine/visual_search.py): `backend/ml_engine/visual_search.py`
- [Intent Search](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/backend/ml_engine/intent_search.py): `backend/ml_engine/intent_search.py`
- [Price Forecast](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/backend/ml_engine/price_predictor.py): `backend/ml_engine/price_predictor.py`
- [Recommendations](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/backend/personalization/recommendations.py): `backend/personalization/recommendations.py`

### Staff Operations

- [Admin Portal](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/admin-frontend/src/App.jsx): `admin-frontend/src/App.jsx`
- [Staff Governance](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/admin-staff-service/src/main/java/com/econext/admin/service/AdminAuthService.java): `microservices/admin-staff-service/src/main/java/com/econext/admin/service/AdminAuthService.java`
- [Catalog Inventory](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/catalog-operations-service/src/main/java/com/econext/catalog/service/OperationalCatalogService.java): `microservices/catalog-operations-service/src/main/java/com/econext/catalog/service/OperationalCatalogService.java`
- [Import Analytics](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/tree/main/microservices/data-import-analysis-service/src/main/java/com/econext/importanalysis): `microservices/data-import-analysis-service/src/main/java/com/econext/importanalysis`

### Platform Services

- [Customer Identity](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/auth-service/src/main/java/com/econext/auth/service/AuthService.java): `microservices/auth-service/src/main/java/com/econext/auth/service/AuthService.java`
- [Live Tracking](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/frontend/src/utils/stompClient.js): `frontend/src/utils/stompClient.js`
- [API Gateway](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/microservices/api-gateway/src/main/java/com/econext/gateway/ApiGatewayApplication.java): `microservices/api-gateway/src/main/java/com/econext/gateway/ApiGatewayApplication.java`
- [Event Streaming](https://github.com/jinkalkershiva/econext-ai-integrated-ecommerce-platform/blob/main/backend/site_analytics/kafka_producer.py): `backend/site_analytics/kafka_producer.py`

### Other components

- **Shopper**
- **Razorpay**

## Connections

- Shopper → Storefront: shops
- Storefront → Customer Identity: authenticates
- Storefront → Product Catalog: browses
- Storefront → Shopping Cart: manages cart
- Storefront → Payment Processing: checks out
- Payment Processing → Razorpay: verifies payment
- Storefront → Order Operations: views orders
- Order Operations → Shipment Fulfillment: coordinates delivery (evidence: `microservices/order-operations-service/src/main/java/com/econext/order/controller/FulfillmentController.java`)
- Shipment Fulfillment → Live Tracking: streams tracking
- Storefront → Shopping Copilot: asks questions
- Storefront → Visual Search: searches images
- Storefront → Intent Search: searches by intent
- Storefront → Price Forecast: checks forecast
- Storefront → Recommendations: gets recommendations
- Storefront → API Gateway: API ingress
- API Gateway → Customer Identity: routes requests
- API Gateway → Shopping Cart: routes requests
- API Gateway → Payment Processing: routes requests
- API Gateway → Order Operations: routes requests
- Admin Portal → Staff Governance: staff sign-in
- Admin Portal → Catalog Inventory: manages catalog
- Admin Portal → Import Analytics: imports and analyzes
- Admin Portal → Order Operations: manages fulfillment
- Order Operations → Event Streaming: publishes events
- Event Streaming → Live Tracking: broadcasts updates
