# ysawant772005/ecommerce-order-management-java architecture

> Architecture diagram of the GitHub repository ysawant772005/ecommerce-order-management-java, 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/ysawant772005/ecommerce-order-management-java
- Repository: https://github.com/ysawant772005/ecommerce-order-management-java

## Overview

This is a Java/Spring order-management application with a Vue storefront and admin console. The user workflow runs from browsing a MongoDB-backed catalog through checkout and PostgreSQL order creation; an outbox then drives asynchronous Elasticsearch indexing for admin search and analytics. The graph also preserves catalog administration, login/session state, order management, sync controls, and seed data. Edges rely on the shown source references and README architecture; several frontend API mappings and worker internals were not excerpted, so those links are documented or marked unverified.

Main entry points: [`backend-java/src/main/java/com/ecommerce/ordermanagement/service/SyncService.java`](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/service/SyncService.java) (Projection sync), [`backend-java/src/main/java/com/ecommerce/ordermanagement/repository/OrderRepository.java`](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/repository/OrderRepository.java) (Order repository), [`frontend/src/App.vue`](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/App.vue) (Vue application), [`backend-java/src/main/java/com/ecommerce/ordermanagement/service/OrderService.java`](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/service/OrderService.java) (Order workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Storefront and admin"]
  node_app["Vue application<br/>[App.vue]"]
  node_router["Route access<br/>[router.js]"]
  node_storefront["Storefront<br/>[StorefrontView.vue]"]
  node_checkout["Checkout<br/>[CheckoutView.vue]"]
  node_catalog_admin["Catalog admin"]
  node_order_search_ui["Order search UI"]
  node_order_detail["Order detail"]
  node_session["Session state<br/>[session.js]"]
  node_catalog_store["Catalog state<br/>[catalog.js]"]
  node_cart["Cart state<br/>[cart.js]"]
  node_admin_catalog_store["Admin catalog state<br/>[adminCatalog.js]"]
  node_search_store["Search state<br/>[search.js]"]
  node_product_api["Product API client<br/>[products.js]"]
  node_orders_api["Order API client<br/>[orders.js]"]
  node_search_api["Search API client<br/>[search.js]"]
  node_user_api["User API client<br/>[users.js]"]
end

subgraph group_api["Backend API and domain"]
  node_product_controller["Product endpoints"]
  node_order_controller["Order endpoints"]
  node_search_controller["Search endpoints"]
  node_sync_controller["Sync endpoints"]
  node_user_controller["User endpoints"]
  node_order_service["Order workflow<br/>[OrderService.java]"]
  node_search_service["Search logic<br/>[SearchService.java]"]
  node_seed_service["Seed and verify<br/>[SeedService.java]"]
end

subgraph group_persistence["Persistence and search"]
  node_product_repository["Catalog repository"]
  node_order_repository["Order repository"]
  node_search_repository["Search repository"]
  node_postgres[("PostgreSQL")]
  node_mongodb[("MongoDB catalog")]
  node_elasticsearch[("Elasticsearch index")]
end

subgraph group_sync["Index synchronization"]
  node_sync_service["Projection sync<br/>[SyncService.java]"]
  node_outbox_repository["Outbox repository"]
  node_rabbit["RabbitMQ"]
end

node_shopper(("Shopper / admin"))

node_shopper -->|"uses"| node_app
node_app -->|"renders routes"| node_router
node_router -->|"checks access"| node_session
node_storefront -->|"uses"| node_catalog_store
node_storefront -->|"uses"| node_cart
node_checkout -.->|"reads cart"| node_cart
node_catalog_admin -->|"uses"| node_admin_catalog_store
node_admin_catalog_store -->|"calls"| node_product_api
node_order_search_ui -->|"uses"| node_search_store
node_search_store -->|"calls"| node_search_api
node_app -->|"loads users"| node_user_api
node_app -->|"uses"| node_session
node_product_api -.->|"HTTP requests"| node_product_controller
node_orders_api -.->|"HTTP requests"| node_order_controller
node_search_api -.->|"HTTP requests"| node_search_controller
node_user_api -.->|"HTTP requests"| node_user_controller
node_product_controller -->|"accesses catalog"| node_product_repository
node_order_controller -->|"delegates"| node_order_service
node_order_service -->|"checks products"| node_product_repository
node_order_service -->|"writes order"| node_order_repository
node_order_controller -->|"reads orders"| node_order_repository
node_search_controller -.->|"delegates"| node_search_service
node_search_service -->|"queries index"| node_search_repository
node_sync_controller -->|"delegates"| node_sync_service
node_sync_service -->|"loads order data"| node_order_repository
node_sync_service -->|"claims events"| node_outbox_repository
node_sync_service -->|"indexes projection"| node_search_repository
node_seed_service -->|"seeds catalog"| node_product_repository
node_seed_service -->|"seeds orders"| node_order_repository
node_seed_service -->|"indexes seed data"| node_search_repository
node_product_repository -->|"reads and writes"| node_mongodb
node_order_repository -->|"reads and writes"| node_postgres
node_outbox_repository -->|"stores events"| node_postgres
node_search_repository -->|"queries and indexes"| node_elasticsearch
node_order_service -.->|"dispatches after commit"| node_rabbit
node_rabbit -.->|"delivers events"| node_sync_service
node_sync_service -->|"updates projection"| node_elasticsearch
node_sync_service -->|"settles outbox"| node_postgres

click node_app "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/App.vue"
click node_router "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/router.js"
click node_storefront "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/views/StorefrontView.vue"
click node_checkout "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/views/CheckoutView.vue"
click node_catalog_admin "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/views/CatalogAdminView.vue"
click node_order_search_ui "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/views/AdminSearchView.vue"
click node_order_detail "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/views/OrderDetailView.vue"
click node_session "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/stores/session.js"
click node_catalog_store "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/stores/catalog.js"
click node_cart "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/stores/cart.js"
click node_admin_catalog_store "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/stores/adminCatalog.js"
click node_search_store "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/stores/search.js"
click node_product_api "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/api/products.js"
click node_orders_api "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/api/orders.js"
click node_search_api "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/api/search.js"
click node_user_api "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/api/users.js"
click node_product_controller "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/controller/ProductController.java"
click node_order_controller "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/controller/OrderController.java"
click node_search_controller "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/controller/SearchController.java"
click node_sync_controller "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/controller/SyncController.java"
click node_user_controller "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/controller/UserController.java"
click node_order_service "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/service/OrderService.java"
click node_search_service "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/service/SearchService.java"
click node_sync_service "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/service/SyncService.java"
click node_seed_service "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/seed/SeedService.java"
click node_product_repository "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/repository/ProductRepository.java"
click node_order_repository "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/repository/OrderRepository.java"
click node_outbox_repository "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/repository/OutboxRepository.java"
click node_search_repository "https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/repository/SearchRepository.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_app,node_router,node_storefront,node_checkout,node_catalog_admin,node_order_search_ui,node_order_detail,node_session,node_catalog_store,node_cart,node_admin_catalog_store,node_search_store,node_product_api,node_orders_api,node_search_api,node_user_api toneBlue
class node_product_controller,node_order_controller,node_search_controller,node_sync_controller,node_user_controller,node_order_service,node_search_service,node_seed_service toneAmber
class node_product_repository,node_order_repository,node_search_repository,node_postgres,node_mongodb,node_elasticsearch toneMint
class node_sync_service,node_outbox_repository,node_rabbit toneRose
class node_shopper toneIndigo
```

## Components

### Storefront and admin

- [Vue application](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Route access](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/router.js): `frontend/src/router.js`
- [Storefront](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/views/StorefrontView.vue): `frontend/src/views/StorefrontView.vue`
- [Checkout](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/views/CheckoutView.vue): `frontend/src/views/CheckoutView.vue`
- [Catalog admin](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/views/CatalogAdminView.vue): `frontend/src/views/CatalogAdminView.vue`
- [Order search UI](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/views/AdminSearchView.vue): `frontend/src/views/AdminSearchView.vue`
- [Order detail](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/views/OrderDetailView.vue): `frontend/src/views/OrderDetailView.vue`
- [Session state](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/stores/session.js): `frontend/src/stores/session.js`
- [Catalog state](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/stores/catalog.js): `frontend/src/stores/catalog.js`
- [Cart state](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/stores/cart.js): `frontend/src/stores/cart.js`
- [Admin catalog state](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/stores/adminCatalog.js): `frontend/src/stores/adminCatalog.js`
- [Search state](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/stores/search.js): `frontend/src/stores/search.js`
- [Product API client](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/api/products.js): `frontend/src/api/products.js`
- [Order API client](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/api/orders.js): `frontend/src/api/orders.js`
- [Search API client](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/api/search.js): `frontend/src/api/search.js`
- [User API client](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/frontend/src/api/users.js): `frontend/src/api/users.js`

### Backend API and domain

- [Product endpoints](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/controller/ProductController.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/controller/ProductController.java`
- [Order endpoints](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/controller/OrderController.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/controller/OrderController.java`
- [Search endpoints](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/controller/SearchController.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/controller/SearchController.java`
- [Sync endpoints](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/controller/SyncController.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/controller/SyncController.java`
- [User endpoints](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/controller/UserController.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/controller/UserController.java`
- [Order workflow](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/service/OrderService.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/service/OrderService.java`
- [Search logic](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/service/SearchService.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/service/SearchService.java`
- [Seed and verify](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/seed/SeedService.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/seed/SeedService.java`

### Persistence and search

- [Catalog repository](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/repository/ProductRepository.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/repository/ProductRepository.java`
- [Order repository](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/repository/OrderRepository.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/repository/OrderRepository.java`
- [Search repository](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/repository/SearchRepository.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/repository/SearchRepository.java`
- **PostgreSQL**
- **MongoDB catalog**
- **Elasticsearch index**

### Index synchronization

- [Projection sync](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/service/SyncService.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/service/SyncService.java`
- [Outbox repository](https://github.com/ysawant772005/ecommerce-order-management-java/blob/main/backend-java/src/main/java/com/ecommerce/ordermanagement/repository/OutboxRepository.java): `backend-java/src/main/java/com/ecommerce/ordermanagement/repository/OutboxRepository.java`
- **RabbitMQ**

### Other components

- **Shopper / admin**

## Connections

- Shopper / admin → Vue application: uses
- Vue application → Route access: renders routes (evidence: `frontend/src/main.js`)
- Route access → Session state: checks access (evidence: `frontend/src/router.js`)
- Storefront → Catalog state: uses (evidence: `frontend/src/views/StorefrontView.vue`)
- Storefront → Cart state: uses (evidence: `frontend/src/views/StorefrontView.vue`)
- Checkout → Cart state: reads cart
- Catalog admin → Admin catalog state: uses (evidence: `frontend/src/views/CatalogAdminView.vue`)
- Admin catalog state → Product API client: calls (evidence: `frontend/src/stores/adminCatalog.js`)
- Order search UI → Search state: uses (evidence: `frontend/src/views/AdminSearchView.vue`)
- Search state → Search API client: calls (evidence: `frontend/src/stores/search.js`)
- Vue application → User API client: loads users (evidence: `frontend/src/App.vue`)
- Vue application → Session state: uses (evidence: `frontend/src/App.vue`)
- Product API client → Product endpoints: HTTP requests
- Order API client → Order endpoints: HTTP requests
- Search API client → Search endpoints: HTTP requests
- User API client → User endpoints: HTTP requests
- Product endpoints → Catalog repository: accesses catalog (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/controller/ProductController.java`)
- Order endpoints → Order workflow: delegates (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/controller/OrderController.java`)
- Order workflow → Catalog repository: checks products (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/service/OrderService.java`)
- Order workflow → Order repository: writes order (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/service/OrderService.java`)
- Order endpoints → Order repository: reads orders (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/controller/OrderController.java`)
- Search endpoints → Search logic: delegates
- Search logic → Search repository: queries index (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/service/SearchService.java`)
- Sync endpoints → Projection sync: delegates (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/controller/SyncController.java`)
- Projection sync → Order repository: loads order data (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/service/SyncService.java`)
- Projection sync → Outbox repository: claims events (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/service/SyncService.java`)
- Projection sync → Search repository: indexes projection (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/service/SyncService.java`)
- Seed and verify → Catalog repository: seeds catalog (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/seed/SeedService.java`)
- Seed and verify → Order repository: seeds orders (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/seed/SeedService.java`)
- Seed and verify → Search repository: indexes seed data (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/seed/SeedService.java`)
- Catalog repository → MongoDB catalog: reads and writes
- Order repository → PostgreSQL: reads and writes
- Outbox repository → PostgreSQL: stores events
- Search repository → Elasticsearch index: queries and indexes (evidence: `backend-java/src/main/java/com/ecommerce/ordermanagement/repository/SearchRepository.java`)
- Order workflow → RabbitMQ: dispatches after commit
- RabbitMQ → Projection sync: delivers events
- Projection sync → Elasticsearch index: updates projection
- Projection sync → PostgreSQL: settles outbox
