# harsh280705/e-commerce-management-java-backend architecture

> Architecture diagram of the GitHub repository harsh280705/e-commerce-management-java-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harsh280705/e-commerce-management-java-backend
- Repository: https://github.com/harsh280705/e-commerce-management-java-backend

## Overview

Level 3 is an e-commerce marketplace: shoppers browse products, check out, and view orders; administrators manage the catalog and search orders. The Vue SPA calls a Spring Boot API. MongoDB owns catalog data, PostgreSQL is authoritative for users and orders, and Elasticsearch serves the admin-search projection. Order synchronization uses RabbitMQ with scheduled polling as a safety net. The graph includes documented product expansion and reindexing capabilities; some backend and checkout relationships are based on README documentation because those sources were not excerpted.

Main entry points: [`frontend/src/api/client.js`](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/api/client.js) (API client), [`backend/src/main/java/com/ecom/level3/service/OrderService.java`](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/OrderService.java) (Order service), [`backend/src/main/java/com/ecom/level3/service/SyncService.java`](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/SyncService.java) (Sync service), [`backend/src/main/java/com/ecom/level3/search/ElasticOrderIndex.java`](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/search/ElasticOrderIndex.java) (Order index)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_spa["Vue application<br/>[App.vue]"]
  node_storefront_view["Storefront<br/>[Storefront.vue]"]
  node_checkout["Checkout<br/>[Checkout.vue]"]
  node_my_orders["My orders<br/>[MyOrders.vue]"]
  node_catalog_admin["Catalog admin<br/>[CatalogAdmin.vue]"]
  node_admin_search["Admin search UI<br/>[AdminSearch.vue]"]
  node_api_client["API client<br/>[client.js]"]
end

subgraph group_api["API and catalog"]
  node_product_api["Product API"]
  node_product_service["Product service"]
  node_catalog_expansion["Catalog expansion"]
  node_mongo_catalog[("MongoDB catalog<br/>[Product.java]")]
end

subgraph group_orders["Orders and sync"]
  node_order_api["Order API"]
  node_order_service["Order service<br/>[OrderService.java]"]
  node_pg_orders[("PostgreSQL orders<br/>[Level3Order.java]")]
  node_pg_users[("PostgreSQL users<br/>[Level3User.java]")]
  node_publisher["Sync publisher"]
  node_rabbit["RabbitMQ"]
  node_listener["Sync listener"]
  node_scheduler["Polling sync"]
  node_sync_service["Sync service<br/>[SyncService.java]"]
end

subgraph group_search["Admin search"]
  node_elastic_index["Order index"]
  node_elasticsearch[("Elasticsearch")]
  node_search_api["Search API"]
  node_search_service["Search service<br/>[SearchService.java]"]
  node_admin_api["Admin API"]
  node_reindex["Reindex service"]
end

node_shopper(("Shopper"))
node_admin(("Administrator"))

node_shopper -->|"uses"| node_spa
node_admin -->|"uses"| node_spa
node_spa -->|"renders"| node_storefront_view
node_shopper -->|"checks out"| node_checkout
node_shopper -->|"views orders"| node_my_orders
node_admin -->|"manages catalog"| node_catalog_admin
node_admin -->|"searches orders"| node_admin_search
node_storefront_view -->|"requests products"| node_api_client
node_catalog_admin -->|"manages products"| node_api_client
node_admin_search -->|"searches orders"| node_api_client
node_checkout -->|"submits orders"| node_api_client
node_my_orders -.->|"requests orders"| node_api_client
node_api_client -->|"calls"| node_product_api
node_api_client -->|"calls"| node_order_api
node_api_client -->|"calls"| node_search_api
node_product_api -->|"delegates"| node_product_service
node_product_service -->|"reads and writes"| node_mongo_catalog
node_catalog_expansion -->|"expands catalog"| node_mongo_catalog
node_order_api -->|"delegates"| node_order_service
node_order_service -->|"validates products"| node_mongo_catalog
node_order_service -->|"validates user"| node_pg_users
node_order_service -->|"persists orders"| node_pg_orders
node_order_api -->|"publishes sync"| node_publisher
node_publisher -->|"sends event"| node_rabbit
node_rabbit -->|"delivers event"| node_listener
node_listener -.->|"requests sync"| node_sync_service
node_scheduler -->|"polls for updates"| node_sync_service
node_sync_service -->|"reads canonical data"| node_pg_orders
node_sync_service -->|"updates projection"| node_elastic_index
node_elastic_index -->|"reads and writes"| node_elasticsearch
node_search_api -->|"delegates"| node_search_service
node_search_service -->|"searches index"| node_elastic_index
node_admin_api -->|"requests rebuild"| node_reindex
node_reindex -->|"reads source orders"| node_pg_orders
node_reindex -->|"rebuilds projection"| node_elastic_index

click node_spa "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/App.vue"
click node_storefront_view "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/views/Storefront.vue"
click node_checkout "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/views/Checkout.vue"
click node_my_orders "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/views/MyOrders.vue"
click node_catalog_admin "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/views/CatalogAdmin.vue"
click node_admin_search "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/views/AdminSearch.vue"
click node_api_client "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/api/client.js"
click node_product_api "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/controller/ProductController.java"
click node_product_service "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/ProductService.java"
click node_catalog_expansion "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/CatalogExpansionService.java"
click node_mongo_catalog "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/model/Product.java"
click node_order_api "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/controller/OrderController.java"
click node_order_service "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/OrderService.java"
click node_pg_orders "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/model/Level3Order.java"
click node_pg_users "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/model/Level3User.java"
click node_publisher "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/messaging/OrderSyncPublisher.java"
click node_rabbit "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/config/RabbitMqConfig.java"
click node_listener "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/messaging/OrderSyncListener.java"
click node_scheduler "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/scheduler/PollingSyncScheduler.java"
click node_sync_service "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/SyncService.java"
click node_elastic_index "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/search/ElasticOrderIndex.java"
click node_search_api "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/controller/SearchController.java"
click node_search_service "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/SearchService.java"
click node_admin_api "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/controller/AdminController.java"
click node_reindex "https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/ReindexService.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_spa,node_storefront_view,node_checkout,node_my_orders,node_catalog_admin,node_admin_search,node_api_client toneBlue
class node_product_api,node_product_service,node_catalog_expansion,node_mongo_catalog toneAmber
class node_order_api,node_order_service,node_pg_orders,node_pg_users,node_publisher,node_rabbit,node_listener,node_scheduler,node_sync_service toneMint
class node_elastic_index,node_elasticsearch,node_search_api,node_search_service,node_admin_api,node_reindex toneRose
class node_shopper,node_admin toneIndigo
```

## Components

### Storefront

- [Vue application](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Storefront](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/views/Storefront.vue): `frontend/src/views/Storefront.vue`
- [Checkout](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/views/Checkout.vue): `frontend/src/views/Checkout.vue`
- [My orders](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/views/MyOrders.vue): `frontend/src/views/MyOrders.vue`
- [Catalog admin](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/views/CatalogAdmin.vue): `frontend/src/views/CatalogAdmin.vue`
- [Admin search UI](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/views/AdminSearch.vue): `frontend/src/views/AdminSearch.vue`
- [API client](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### API and catalog

- [Product API](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/controller/ProductController.java): `backend/src/main/java/com/ecom/level3/controller/ProductController.java`
- [Product service](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/ProductService.java): `backend/src/main/java/com/ecom/level3/service/ProductService.java`
- [Catalog expansion](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/CatalogExpansionService.java): `backend/src/main/java/com/ecom/level3/service/CatalogExpansionService.java`
- [MongoDB catalog](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/model/Product.java): `backend/src/main/java/com/ecom/level3/model/Product.java`

### Orders and sync

- [Order API](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/controller/OrderController.java): `backend/src/main/java/com/ecom/level3/controller/OrderController.java`
- [Order service](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/OrderService.java): `backend/src/main/java/com/ecom/level3/service/OrderService.java`
- [PostgreSQL orders](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/model/Level3Order.java): `backend/src/main/java/com/ecom/level3/model/Level3Order.java`
- [PostgreSQL users](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/model/Level3User.java): `backend/src/main/java/com/ecom/level3/model/Level3User.java`
- [Sync publisher](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/messaging/OrderSyncPublisher.java): `backend/src/main/java/com/ecom/level3/messaging/OrderSyncPublisher.java`
- [RabbitMQ](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/config/RabbitMqConfig.java): `backend/src/main/java/com/ecom/level3/config/RabbitMqConfig.java`
- [Sync listener](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/messaging/OrderSyncListener.java): `backend/src/main/java/com/ecom/level3/messaging/OrderSyncListener.java`
- [Polling sync](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/scheduler/PollingSyncScheduler.java): `backend/src/main/java/com/ecom/level3/scheduler/PollingSyncScheduler.java`
- [Sync service](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/SyncService.java): `backend/src/main/java/com/ecom/level3/service/SyncService.java`

### Admin search

- [Order index](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/search/ElasticOrderIndex.java): `backend/src/main/java/com/ecom/level3/search/ElasticOrderIndex.java`
- **Elasticsearch**
- [Search API](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/controller/SearchController.java): `backend/src/main/java/com/ecom/level3/controller/SearchController.java`
- [Search service](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/SearchService.java): `backend/src/main/java/com/ecom/level3/service/SearchService.java`
- [Admin API](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/controller/AdminController.java): `backend/src/main/java/com/ecom/level3/controller/AdminController.java`
- [Reindex service](https://github.com/harsh280705/e-commerce-management-java-backend/blob/main/backend/src/main/java/com/ecom/level3/service/ReindexService.java): `backend/src/main/java/com/ecom/level3/service/ReindexService.java`

### Other components

- **Shopper**
- **Administrator**

## Connections

- Shopper → Vue application: uses
- Administrator → Vue application: uses
- Vue application → Storefront: renders (evidence: `frontend/src/App.vue`)
- Shopper → Checkout: checks out
- Shopper → My orders: views orders
- Administrator → Catalog admin: manages catalog
- Administrator → Admin search UI: searches orders
- Storefront → API client: requests products (evidence: `frontend/src/views/Storefront.vue`)
- Catalog admin → API client: manages products (evidence: `frontend/src/views/CatalogAdmin.vue`)
- Admin search UI → API client: searches orders (evidence: `frontend/src/views/AdminSearch.vue`)
- Checkout → API client: submits orders
- My orders → API client: requests orders
- API client → Product API: calls (evidence: `frontend/src/api/client.js`)
- API client → Order API: calls (evidence: `frontend/src/api/client.js`)
- API client → Search API: calls (evidence: `frontend/src/api/client.js`)
- Product API → Product service: delegates (evidence: `backend/src/main/java/com/ecom/level3/controller/ProductController.java`)
- Product service → MongoDB catalog: reads and writes (evidence: `backend/src/main/java/com/ecom/level3/service/ProductService.java`)
- Catalog expansion → MongoDB catalog: expands catalog (evidence: `backend/src/main/java/com/ecom/level3/service/CatalogExpansionService.java`)
- Order API → Order service: delegates (evidence: `backend/src/main/java/com/ecom/level3/controller/OrderController.java`)
- Order service → MongoDB catalog: validates products (evidence: `backend/src/main/java/com/ecom/level3/service/OrderService.java`)
- Order service → PostgreSQL users: validates user (evidence: `backend/src/main/java/com/ecom/level3/service/OrderService.java`)
- Order service → PostgreSQL orders: persists orders (evidence: `backend/src/main/java/com/ecom/level3/service/OrderService.java`)
- Order API → Sync publisher: publishes sync (evidence: `backend/src/main/java/com/ecom/level3/controller/OrderController.java`)
- Sync publisher → RabbitMQ: sends event
- RabbitMQ → Sync listener: delivers event
- Sync listener → Sync service: requests sync
- Polling sync → Sync service: polls for updates
- Sync service → PostgreSQL orders: reads canonical data (evidence: `backend/src/main/java/com/ecom/level3/service/SyncService.java`)
- Sync service → Order index: updates projection (evidence: `backend/src/main/java/com/ecom/level3/service/SyncService.java`)
- Order index → Elasticsearch: reads and writes
- Search API → Search service: delegates (evidence: `backend/src/main/java/com/ecom/level3/controller/SearchController.java`)
- Search service → Order index: searches index (evidence: `backend/src/main/java/com/ecom/level3/service/SearchService.java`)
- Admin API → Reindex service: requests rebuild (evidence: `backend/src/main/java/com/ecom/level3/controller/AdminController.java`)
- Reindex service → PostgreSQL orders: reads source orders (evidence: `backend/src/main/java/com/ecom/level3/service/ReindexService.java`)
- Reindex service → Order index: rebuilds projection (evidence: `backend/src/main/java/com/ecom/level3/service/ReindexService.java`)
