# rkg01/ecommerce architecture

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

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

## Overview

This is a Spring Boot REST backend for a customer storefront and admin dashboard. The principal customer path is authenticate, browse the catalog, manage addresses and cart, check out into an order, then create and verify a Razorpay payment. Payment verification confirms the order, reduces stock, and clears the cart. Admins also manage catalog data and order status. The graph reflects README capabilities and shown source references; some unsampled controller and service internals are represented at their listed paths, with uncertain links omitted.

Main entry points: [`src/main/java/com/ryuk/ecommerce/service/impl/PaymentServiceImpl.java`](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/PaymentServiceImpl.java) (Payment processing), [`src/main/java/com/ryuk/ecommerce/service/impl/AuthServiceImpl.java`](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/AuthServiceImpl.java) (Authentication), [`src/main/java/com/ryuk/ecommerce/service/impl/ProductServiceImpl.java`](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/ProductServiceImpl.java) (Product catalog), [`src/main/java/com/ryuk/ecommerce/service/impl/CartServiceImpl.java`](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/CartServiceImpl.java) (Cart management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth_api["Auth API"]
  node_auth_logic["Authentication"]
  node_jwt["JWT service"]
  node_user_loader["User lookup"]
  node_security["JWT security"]
  node_current_user["Current user"]
end

subgraph group_catalog["Catalog management"]
  node_product_api["Product API"]
  node_product_logic["Product catalog"]
  node_category_api["Category API"]
  node_category_logic["Category catalog"]
end

subgraph group_shopping["Customer shopping"]
  node_address_api["Address API"]
  node_address_logic["Address book"]
  node_cart_api["Cart API"]
  node_cart_logic["Cart management"]
end

subgraph group_orders["Orders and payment"]
  node_order_api["Order API"]
  node_order_logic["Checkout and orders"]
  node_admin_order_api["Admin order API"]
  node_admin_order_logic["Order lifecycle"]
  node_payment_api["Payment API"]
  node_payment_logic["Payment processing"]
end

subgraph group_infrastructure["Persistence and integrations"]
  node_entities["Domain records"]
  node_postgres[("PostgreSQL")]
  node_redis[("Redis cache<br/>[RedisConfig.java]")]
  node_razorpay["Razorpay"]
end

node_customer(("Customer"))
node_admin(("Admin"))

node_customer -->|"registers or logs in"| node_auth_api
node_auth_api -->|"delegates"| node_auth_logic
node_auth_logic -->|"generates token"| node_jwt
node_auth_logic -.->|"authenticates via"| node_user_loader
node_user_loader -.->|"loads user"| node_postgres
node_customer -->|"presents token"| node_security
node_admin -->|"presents token"| node_security
node_customer -->|"browses"| node_product_api
node_admin -->|"manages catalog"| node_product_api
node_product_api -.->|"delegates"| node_product_logic
node_product_logic -.->|"reads and writes"| node_postgres
node_product_logic -.->|"caches catalog"| node_redis
node_customer -->|"browses"| node_category_api
node_admin -->|"manages catalog"| node_category_api
node_category_api -->|"delegates"| node_category_logic
node_category_logic -.->|"caches categories"| node_redis
node_customer -->|"manages addresses"| node_address_api
node_address_api -->|"delegates"| node_address_logic
node_customer -->|"manages cart"| node_cart_api
node_cart_api -.->|"delegates"| node_cart_logic
node_cart_logic -->|"gets current user"| node_current_user
node_cart_logic -->|"reads and writes"| node_postgres
node_cart_logic -.->|"caches cart"| node_redis
node_customer -->|"checks out and views"| node_order_api
node_order_api -.->|"delegates"| node_order_logic
node_admin -->|"manages statuses"| node_admin_order_api
node_admin_order_api -.->|"delegates"| node_admin_order_logic
node_customer -->|"creates and verifies"| node_payment_api
node_payment_api -->|"delegates"| node_payment_logic
node_payment_logic -->|"gets current user"| node_current_user
node_payment_logic -->|"creates order and verifies signature"| node_razorpay
node_payment_logic -->|"stores payment and updates order"| node_postgres
node_payment_logic -->|"evicts cart cache"| node_redis
node_auth_logic -->|"stores and finds users"| node_postgres
node_product_logic -.->|"uses product records"| node_entities
node_payment_logic -->|"updates payment and order"| node_entities

click node_auth_api "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/AuthController.java"
click node_auth_logic "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/AuthServiceImpl.java"
click node_jwt "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/security/jwt/JwtServiceImpl.java"
click node_user_loader "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/security/service/CustomUserDetailsService.java"
click node_security "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/security/config/SecurityConfig.java"
click node_product_api "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/ProductController.java"
click node_product_logic "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/ProductServiceImpl.java"
click node_category_api "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/CategoryController.java"
click node_category_logic "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/CategoryServiceImpl.java"
click node_address_api "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/AddressController.java"
click node_address_logic "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/AddressServiceImpl.java"
click node_cart_api "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/CartController.java"
click node_cart_logic "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/CartServiceImpl.java"
click node_order_api "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/OrderController.java"
click node_order_logic "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/OrderServiceImpl.java"
click node_admin_order_api "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/AdminOrderController.java"
click node_admin_order_logic "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/AdminOrderServiceImpl.java"
click node_payment_api "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/PaymentController.java"
click node_payment_logic "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/PaymentServiceImpl.java"
click node_current_user "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/security/service/CurrentUserServiceImpl.java"
click node_entities "https://github.com/rkg01/ecommerce/tree/main/src/main/java/com/ryuk/ecommerce/entity"
click node_redis "https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/config/RedisConfig.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_auth_api,node_auth_logic,node_jwt,node_user_loader,node_security,node_current_user toneBlue
class node_product_api,node_product_logic,node_category_api,node_category_logic toneAmber
class node_address_api,node_address_logic,node_cart_api,node_cart_logic toneMint
class node_order_api,node_order_logic,node_admin_order_api,node_admin_order_logic,node_payment_api,node_payment_logic toneRose
class node_entities,node_postgres,node_redis,node_razorpay,node_customer,node_admin toneIndigo
```

## Components

### Identity and access

- [Auth API](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/AuthController.java): `src/main/java/com/ryuk/ecommerce/controller/AuthController.java`
- [Authentication](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/AuthServiceImpl.java): `src/main/java/com/ryuk/ecommerce/service/impl/AuthServiceImpl.java`
- [JWT service](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/security/jwt/JwtServiceImpl.java): `src/main/java/com/ryuk/ecommerce/security/jwt/JwtServiceImpl.java`
- [User lookup](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/security/service/CustomUserDetailsService.java): `src/main/java/com/ryuk/ecommerce/security/service/CustomUserDetailsService.java`
- [JWT security](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/security/config/SecurityConfig.java): `src/main/java/com/ryuk/ecommerce/security/config/SecurityConfig.java`
- [Current user](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/security/service/CurrentUserServiceImpl.java): `src/main/java/com/ryuk/ecommerce/security/service/CurrentUserServiceImpl.java`

### Catalog management

- [Product API](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/ProductController.java): `src/main/java/com/ryuk/ecommerce/controller/ProductController.java`
- [Product catalog](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/ProductServiceImpl.java): `src/main/java/com/ryuk/ecommerce/service/impl/ProductServiceImpl.java`
- [Category API](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/CategoryController.java): `src/main/java/com/ryuk/ecommerce/controller/CategoryController.java`
- [Category catalog](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/CategoryServiceImpl.java): `src/main/java/com/ryuk/ecommerce/service/impl/CategoryServiceImpl.java`

### Customer shopping

- [Address API](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/AddressController.java): `src/main/java/com/ryuk/ecommerce/controller/AddressController.java`
- [Address book](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/AddressServiceImpl.java): `src/main/java/com/ryuk/ecommerce/service/impl/AddressServiceImpl.java`
- [Cart API](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/CartController.java): `src/main/java/com/ryuk/ecommerce/controller/CartController.java`
- [Cart management](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/CartServiceImpl.java): `src/main/java/com/ryuk/ecommerce/service/impl/CartServiceImpl.java`

### Orders and payment

- [Order API](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/OrderController.java): `src/main/java/com/ryuk/ecommerce/controller/OrderController.java`
- [Checkout and orders](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/OrderServiceImpl.java): `src/main/java/com/ryuk/ecommerce/service/impl/OrderServiceImpl.java`
- [Admin order API](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/AdminOrderController.java): `src/main/java/com/ryuk/ecommerce/controller/AdminOrderController.java`
- [Order lifecycle](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/AdminOrderServiceImpl.java): `src/main/java/com/ryuk/ecommerce/service/impl/AdminOrderServiceImpl.java`
- [Payment API](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/controller/PaymentController.java): `src/main/java/com/ryuk/ecommerce/controller/PaymentController.java`
- [Payment processing](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/service/impl/PaymentServiceImpl.java): `src/main/java/com/ryuk/ecommerce/service/impl/PaymentServiceImpl.java`

### Persistence and integrations

- [Domain records](https://github.com/rkg01/ecommerce/tree/main/src/main/java/com/ryuk/ecommerce/entity): `src/main/java/com/ryuk/ecommerce/entity`
- **PostgreSQL**
- [Redis cache](https://github.com/rkg01/ecommerce/blob/main/src/main/java/com/ryuk/ecommerce/config/RedisConfig.java): `src/main/java/com/ryuk/ecommerce/config/RedisConfig.java`
- **Razorpay**

### Other components

- **Customer**
- **Admin**

## Connections

- Customer → Auth API: registers or logs in (evidence: `README.md`)
- Auth API → Authentication: delegates (evidence: `src/main/java/com/ryuk/ecommerce/controller/AuthController.java`)
- Authentication → JWT service: generates token (evidence: `src/main/java/com/ryuk/ecommerce/service/impl/AuthServiceImpl.java`)
- Authentication → User lookup: authenticates via
- User lookup → PostgreSQL: loads user
- Customer → JWT security: presents token (evidence: `README.md`)
- Admin → JWT security: presents token (evidence: `README.md`)
- Customer → Product API: browses (evidence: `README.md`)
- Admin → Product API: manages catalog (evidence: `README.md`)
- Product API → Product catalog: delegates
- Product catalog → PostgreSQL: reads and writes
- Product catalog → Redis cache: caches catalog
- Customer → Category API: browses (evidence: `README.md`)
- Admin → Category API: manages catalog (evidence: `README.md`)
- Category API → Category catalog: delegates (evidence: `src/main/java/com/ryuk/ecommerce/controller/CategoryController.java`)
- Category catalog → Redis cache: caches categories
- Customer → Address API: manages addresses (evidence: `README.md`)
- Address API → Address book: delegates (evidence: `src/main/java/com/ryuk/ecommerce/controller/AddressController.java`)
- Customer → Cart API: manages cart (evidence: `README.md`)
- Cart API → Cart management: delegates
- Cart management → Current user: gets current user (evidence: `src/main/java/com/ryuk/ecommerce/service/impl/CartServiceImpl.java`)
- Cart management → PostgreSQL: reads and writes (evidence: `src/main/java/com/ryuk/ecommerce/service/impl/CartServiceImpl.java`)
- Cart management → Redis cache: caches cart
- Customer → Order API: checks out and views (evidence: `README.md`)
- Order API → Checkout and orders: delegates
- Admin → Admin order API: manages statuses (evidence: `README.md`)
- Admin order API → Order lifecycle: delegates
- Customer → Payment API: creates and verifies (evidence: `README.md`)
- Payment API → Payment processing: delegates (evidence: `src/main/java/com/ryuk/ecommerce/controller/PaymentController.java`)
- Payment processing → Current user: gets current user (evidence: `src/main/java/com/ryuk/ecommerce/service/impl/PaymentServiceImpl.java`)
- Payment processing → Razorpay: creates order and verifies signature (evidence: `src/main/java/com/ryuk/ecommerce/service/impl/PaymentServiceImpl.java`)
- Payment processing → PostgreSQL: stores payment and updates order (evidence: `src/main/java/com/ryuk/ecommerce/service/impl/PaymentServiceImpl.java`)
- Payment processing → Redis cache: evicts cart cache (evidence: `src/main/java/com/ryuk/ecommerce/service/impl/PaymentServiceImpl.java`)
- Authentication → PostgreSQL: stores and finds users (evidence: `src/main/java/com/ryuk/ecommerce/service/impl/AuthServiceImpl.java`)
- Product catalog → Domain records: uses product records
- Payment processing → Domain records: updates payment and order (evidence: `src/main/java/com/ryuk/ecommerce/service/impl/PaymentServiceImpl.java`)
