# lpdecastro/ecommerce-manager architecture

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

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

## Overview

E-Commerce Manager is a Spring Boot REST API for authenticated customer and seller accounts, product catalogs, carts, and orders. The principal workflow is a client registering or logging in, then using authenticated APIs to manage a profile, browse products, maintain a cart, and manage orders. The source shows the authentication controller delegating to its service and security components loading users and validating tokens; other domain controllers and implementations are listed but not excerpted. Their documented capabilities are included, with unverified links marked dashed.

Main entry points: [`src/main/java/com/lpdecastro/ecommerce/repository`](https://github.com/lpdecastro/ecommerce-manager/tree/main/src/main/java/com/lpdecastro/ecommerce/repository) (JPA repositories), [`src/main/java/com/lpdecastro/ecommerce/service/AuthenticationServiceImpl.java`](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/AuthenticationServiceImpl.java) (Authentication service), [`src/main/java/com/lpdecastro/ecommerce/security/JwtAuthenticationFilter.java`](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/security/JwtAuthenticationFilter.java) (JWT filter), [`src/main/java/com/lpdecastro/ecommerce/api/AuthenticationApi.java`](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/AuthenticationApi.java) (Authentication API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and security"]
  node_auth_api["Authentication API"]
  node_auth_service["Authentication service"]
  node_jwt_provider["JWT provider"]
  node_jwt_filter["JWT filter"]
  node_user_details["User lookup"]
  node_blacklist["Token blacklist"]
  node_auth_dto["Auth contracts"]
end

subgraph group_accounts["Account management"]
  node_customer_api["Customer API<br/>[CustomerApi.java]"]
  node_customer_service["Customer service"]
  node_seller_api["Seller API<br/>[SellerApi.java]"]
  node_seller_service["Seller service"]
  node_account_models["Account models<br/>[Customer.java]"]
end

subgraph group_commerce["Commerce operations"]
  node_product_api["Product API<br/>[ProductApi.java]"]
  node_product_service["Product service"]
  node_cart_api["Cart API<br/>[CartItemApi.java]"]
  node_cart_service["Cart service"]
  node_order_api["Order API<br/>[OrderApi.java]"]
  node_order_service["Order service"]
  node_commerce_models["Commerce models"]
end

subgraph group_persistence["Persistence"]
  node_repositories[("JPA repositories")]
end

node_client(("API client"))

node_client -->|"sends requests"| node_auth_api
node_auth_api -->|"delegates auth"| node_auth_service
node_auth_service -->|"uses tokens"| node_jwt_provider
node_auth_service -->|"uses blacklist"| node_blacklist
node_jwt_filter -->|"validates tokens"| node_jwt_provider
node_jwt_filter -->|"loads user"| node_user_details
node_jwt_filter -->|"checks tokens"| node_blacklist
node_user_details -->|"looks up accounts"| node_repositories
node_auth_service -->|"persists accounts"| node_repositories
node_auth_api -->|"accepts and returns"| node_auth_dto
node_client -->|"manages profile"| node_customer_api
node_customer_api -.->|"routes operations"| node_customer_service
node_customer_service -.->|"reads and writes"| node_repositories
node_customer_service -.->|"uses account data"| node_account_models
node_client -->|"manages seller"| node_seller_api
node_seller_api -.->|"routes operations"| node_seller_service
node_seller_service -.->|"reads and writes"| node_repositories
node_seller_service -.->|"uses account data"| node_account_models
node_client -->|"manages catalog"| node_product_api
node_product_api -.->|"routes operations"| node_product_service
node_product_service -.->|"reads and writes"| node_repositories
node_product_service -.->|"uses product data"| node_commerce_models
node_client -->|"manages cart"| node_cart_api
node_cart_api -.->|"routes operations"| node_cart_service
node_cart_service -.->|"reads and writes"| node_repositories
node_cart_service -.->|"uses cart data"| node_commerce_models
node_client -->|"manages orders"| node_order_api
node_order_api -.->|"routes operations"| node_order_service
node_order_service -.->|"reads and writes"| node_repositories
node_order_service -.->|"uses order data"| node_commerce_models

click node_auth_api "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/AuthenticationApi.java"
click node_auth_service "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/AuthenticationServiceImpl.java"
click node_jwt_provider "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/security/JwtTokenProvider.java"
click node_jwt_filter "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/security/JwtAuthenticationFilter.java"
click node_user_details "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/security/UserDetailsServiceImpl.java"
click node_blacklist "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/security/JwtTokenBlacklist.java"
click node_auth_dto "https://github.com/lpdecastro/ecommerce-manager/tree/main/src/main/java/com/lpdecastro/ecommerce/dto"
click node_customer_api "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/CustomerApi.java"
click node_customer_service "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/CustomerServiceImpl.java"
click node_seller_api "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/SellerApi.java"
click node_seller_service "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/SellerServiceImpl.java"
click node_account_models "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/entity/Customer.java"
click node_product_api "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/ProductApi.java"
click node_product_service "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/ProductServiceImpl.java"
click node_cart_api "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/CartItemApi.java"
click node_cart_service "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/CartItemServiceImpl.java"
click node_order_api "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/OrderApi.java"
click node_order_service "https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/OrderServiceImpl.java"
click node_commerce_models "https://github.com/lpdecastro/ecommerce-manager/tree/main/src/main/java/com/lpdecastro/ecommerce/entity"
click node_repositories "https://github.com/lpdecastro/ecommerce-manager/tree/main/src/main/java/com/lpdecastro/ecommerce/repository"

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_service,node_jwt_provider,node_jwt_filter,node_user_details,node_blacklist,node_auth_dto,node_client toneBlue
class node_customer_api,node_customer_service,node_seller_api,node_seller_service,node_account_models toneAmber
class node_product_api,node_product_service,node_cart_api,node_cart_service,node_order_api,node_order_service,node_commerce_models toneMint
class node_repositories toneRose
```

## Components

### Access and security

- [Authentication API](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/AuthenticationApi.java): `src/main/java/com/lpdecastro/ecommerce/api/AuthenticationApi.java`
- [Authentication service](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/AuthenticationServiceImpl.java): `src/main/java/com/lpdecastro/ecommerce/service/AuthenticationServiceImpl.java`
- [JWT provider](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/security/JwtTokenProvider.java): `src/main/java/com/lpdecastro/ecommerce/security/JwtTokenProvider.java`
- [JWT filter](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/security/JwtAuthenticationFilter.java): `src/main/java/com/lpdecastro/ecommerce/security/JwtAuthenticationFilter.java`
- [User lookup](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/security/UserDetailsServiceImpl.java): `src/main/java/com/lpdecastro/ecommerce/security/UserDetailsServiceImpl.java`
- [Token blacklist](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/security/JwtTokenBlacklist.java): `src/main/java/com/lpdecastro/ecommerce/security/JwtTokenBlacklist.java`
- [Auth contracts](https://github.com/lpdecastro/ecommerce-manager/tree/main/src/main/java/com/lpdecastro/ecommerce/dto): `src/main/java/com/lpdecastro/ecommerce/dto`

### Account management

- [Customer API](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/CustomerApi.java): `src/main/java/com/lpdecastro/ecommerce/api/CustomerApi.java`
- [Customer service](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/CustomerServiceImpl.java): `src/main/java/com/lpdecastro/ecommerce/service/CustomerServiceImpl.java`
- [Seller API](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/SellerApi.java): `src/main/java/com/lpdecastro/ecommerce/api/SellerApi.java`
- [Seller service](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/SellerServiceImpl.java): `src/main/java/com/lpdecastro/ecommerce/service/SellerServiceImpl.java`
- [Account models](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/entity/Customer.java): `src/main/java/com/lpdecastro/ecommerce/entity/Customer.java`

### Commerce operations

- [Product API](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/ProductApi.java): `src/main/java/com/lpdecastro/ecommerce/api/ProductApi.java`
- [Product service](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/ProductServiceImpl.java): `src/main/java/com/lpdecastro/ecommerce/service/ProductServiceImpl.java`
- [Cart API](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/CartItemApi.java): `src/main/java/com/lpdecastro/ecommerce/api/CartItemApi.java`
- [Cart service](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/CartItemServiceImpl.java): `src/main/java/com/lpdecastro/ecommerce/service/CartItemServiceImpl.java`
- [Order API](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/api/OrderApi.java): `src/main/java/com/lpdecastro/ecommerce/api/OrderApi.java`
- [Order service](https://github.com/lpdecastro/ecommerce-manager/blob/main/src/main/java/com/lpdecastro/ecommerce/service/OrderServiceImpl.java): `src/main/java/com/lpdecastro/ecommerce/service/OrderServiceImpl.java`
- [Commerce models](https://github.com/lpdecastro/ecommerce-manager/tree/main/src/main/java/com/lpdecastro/ecommerce/entity): `src/main/java/com/lpdecastro/ecommerce/entity`

### Persistence

- [JPA repositories](https://github.com/lpdecastro/ecommerce-manager/tree/main/src/main/java/com/lpdecastro/ecommerce/repository): `src/main/java/com/lpdecastro/ecommerce/repository`

### Other components

- **API client**

## Connections

- API client → Authentication API: sends requests (evidence: `README.md`)
- Authentication API → Authentication service: delegates auth (evidence: `src/main/java/com/lpdecastro/ecommerce/api/AuthenticationApi.java`)
- Authentication service → JWT provider: uses tokens (evidence: `src/main/java/com/lpdecastro/ecommerce/service/AuthenticationServiceImpl.java`)
- Authentication service → Token blacklist: uses blacklist (evidence: `src/main/java/com/lpdecastro/ecommerce/service/AuthenticationServiceImpl.java`)
- JWT filter → JWT provider: validates tokens (evidence: `src/main/java/com/lpdecastro/ecommerce/security/JwtAuthenticationFilter.java`)
- JWT filter → User lookup: loads user (evidence: `src/main/java/com/lpdecastro/ecommerce/security/JwtAuthenticationFilter.java`)
- JWT filter → Token blacklist: checks tokens (evidence: `src/main/java/com/lpdecastro/ecommerce/security/JwtAuthenticationFilter.java`)
- User lookup → JPA repositories: looks up accounts (evidence: `src/main/java/com/lpdecastro/ecommerce/security/UserDetailsServiceImpl.java`)
- Authentication service → JPA repositories: persists accounts (evidence: `src/main/java/com/lpdecastro/ecommerce/service/AuthenticationServiceImpl.java`)
- Authentication API → Auth contracts: accepts and returns (evidence: `src/main/java/com/lpdecastro/ecommerce/api/AuthenticationApi.java`)
- API client → Customer API: manages profile (evidence: `README.md`)
- Customer API → Customer service: routes operations
- Customer service → JPA repositories: reads and writes
- Customer service → Account models: uses account data
- API client → Seller API: manages seller (evidence: `README.md`)
- Seller API → Seller service: routes operations
- Seller service → JPA repositories: reads and writes
- Seller service → Account models: uses account data
- API client → Product API: manages catalog (evidence: `README.md`)
- Product API → Product service: routes operations
- Product service → JPA repositories: reads and writes
- Product service → Commerce models: uses product data
- API client → Cart API: manages cart (evidence: `README.md`)
- Cart API → Cart service: routes operations
- Cart service → JPA repositories: reads and writes
- Cart service → Commerce models: uses cart data
- API client → Order API: manages orders (evidence: `README.md`)
- Order API → Order service: routes operations
- Order service → JPA repositories: reads and writes
- Order service → Commerce models: uses order data
