# devsam1966/e-commerce architecture

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

- Interactive diagram: https://gitdiagram.com/devsam1966/e-commerce
- Repository: https://github.com/devsam1966/e-commerce

## Overview

This is a Java/Spring hexagonal e-commerce backend. Its main workflow exposes category, product, user, and order operations through REST controllers, application services, domain ports, and persistence adapters; product images also use file storage. Orders are assembled from REST requests and support PayPal payment integration. The README describes PostgreSQL and JWT, but the available source excerpts do not establish their runtime wiring, so those links are not asserted. Edges reflect shown calls or documented capabilities; unsampled implementation details are omitted.

Main entry points: [`src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/CategoryCrudRepositoryImpl.java`](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/CategoryCrudRepositoryImpl.java) (Category adapter), [`src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/ProductCrudRepositoryImpl.java`](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/ProductCrudRepositoryImpl.java) (Product adapter), [`src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/UserCrudRepositoryImpl.java`](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/UserCrudRepositoryImpl.java) (User adapter), [`src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/OrderCrudRepositoryImpl.java`](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/OrderCrudRepositoryImpl.java) (Order adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_category_api["Category API"]
  node_product_api["Product API"]
  node_user_api["User API"]
  node_order_api["Order API"]
  node_paypal_api["PayPal API"]
end

subgraph group_application["Application"]
  node_category_service["Category service"]
  node_product_service["Product service"]
  node_user_service["User service<br/>[UserService.java]"]
  node_order_service["Order service<br/>[OrderService.java]"]
  node_order_assembler["Order assembler"]
  node_upload_file["Image file storage<br/>[UploadFile.java]"]
end

subgraph group_domain["Domain"]
  node_category_model["Category model<br/>[Category.java]"]
  node_product_model["Product model<br/>[Product.java]"]
  node_user_model["User model<br/>[User.java]"]
  node_order_model["Order models<br/>[Order.java]"]
  node_category_port["Category port"]
  node_product_port["Product port"]
  node_user_port["User port"]
  node_order_port["Order port"]
end

subgraph group_infrastructure["Persistence and integrations"]
  node_category_adapter["Category adapter"]
  node_product_adapter["Product adapter"]
  node_user_adapter["User adapter"]
  node_order_adapter["Order adapter"]
  node_category_mapper["Category mapper"]
  node_product_mapper["Product mapper<br/>[ProductMapper.java]"]
  node_user_mapper["User mapper<br/>[UserMapper.java]"]
  node_order_mapper["Order mapper<br/>[IOrderMapper.java]"]
  node_paypal_service["PayPal service<br/>[PaypalService.java]"]
end

node_client(("API client"))
node_postgres[("PostgreSQL")]
node_paypal["PayPal"]

node_client -->|"calls"| node_category_api
node_client -->|"calls"| node_product_api
node_client -->|"calls"| node_user_api
node_client -->|"calls"| node_order_api
node_client -->|"calls"| node_paypal_api
node_category_api -->|"delegates to"| node_category_service
node_product_api -->|"delegates to"| node_product_service
node_user_api -->|"delegates to"| node_user_service
node_order_api -->|"assembles with"| node_order_assembler
node_order_api -->|"delegates to"| node_order_service
node_paypal_api -->|"delegates to"| node_paypal_service
node_category_service -->|"uses"| node_category_port
node_product_service -->|"uses"| node_product_port
node_product_service -->|"uploads and deletes"| node_upload_file
node_user_service -->|"uses"| node_user_port
node_order_service -->|"uses"| node_order_port
node_order_assembler -->|"creates"| node_order_model
node_category_adapter -->|"implements"| node_category_port
node_product_adapter -->|"implements"| node_product_port
node_user_adapter -->|"implements"| node_user_port
node_order_adapter -->|"implements"| node_order_port
node_category_adapter -->|"maps through"| node_category_mapper
node_product_adapter -->|"maps through"| node_product_mapper
node_user_adapter -->|"maps through"| node_user_mapper
node_order_adapter -->|"maps through"| node_order_mapper
node_paypal_service -->|"creates and executes payments"| node_paypal
node_category_adapter -.->|"persists via Spring Data"| node_postgres
node_product_adapter -.->|"persists via Spring Data"| node_postgres
node_user_adapter -.->|"persists via Spring Data"| node_postgres
node_order_adapter -.->|"persists via Spring Data"| node_postgres

click node_category_api "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/CategoryController.java"
click node_product_api "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/ProductController.java"
click node_user_api "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/UserController.java"
click node_order_api "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/OrderController.java"
click node_paypal_api "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/PaypalController.java"
click node_category_service "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/application/CategoryService.java"
click node_product_service "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/application/ProductService.java"
click node_user_service "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/application/UserService.java"
click node_order_service "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/application/OrderService.java"
click node_order_assembler "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/application/assembler/OrderAssembler.java"
click node_upload_file "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/application/UploadFile.java"
click node_category_model "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/model/Category.java"
click node_product_model "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/model/Product.java"
click node_user_model "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/model/User.java"
click node_order_model "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/model/Order.java"
click node_category_port "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/port/ICategoryRepository.java"
click node_product_port "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/port/IProductRepository.java"
click node_user_port "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/port/IUserRepository.java"
click node_order_port "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/port/IOrderRepository.java"
click node_category_adapter "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/CategoryCrudRepositoryImpl.java"
click node_product_adapter "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/ProductCrudRepositoryImpl.java"
click node_user_adapter "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/UserCrudRepositoryImpl.java"
click node_order_adapter "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/OrderCrudRepositoryImpl.java"
click node_category_mapper "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/CategoryMapper.java"
click node_product_mapper "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/ProductMapper.java"
click node_user_mapper "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/UserMapper.java"
click node_order_mapper "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/IOrderMapper.java"
click node_paypal_service "https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/service/PaypalService.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_category_api,node_product_api,node_user_api,node_order_api,node_paypal_api,node_client toneBlue
class node_category_service,node_product_service,node_user_service,node_order_service,node_order_assembler,node_upload_file,node_postgres toneAmber
class node_category_model,node_product_model,node_user_model,node_order_model,node_category_port,node_product_port,node_user_port,node_order_port toneMint
class node_category_adapter,node_product_adapter,node_user_adapter,node_order_adapter,node_category_mapper,node_product_mapper,node_user_mapper,node_order_mapper,node_paypal_service toneRose
class node_paypal toneIndigo
```

## Components

### REST API

- [Category API](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/CategoryController.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/CategoryController.java`
- [Product API](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/ProductController.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/ProductController.java`
- [User API](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/UserController.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/UserController.java`
- [Order API](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/OrderController.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/OrderController.java`
- [PayPal API](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/PaypalController.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/PaypalController.java`

### Application

- [Category service](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/application/CategoryService.java): `src/main/java/com/devsam/backend/ecommerce/application/CategoryService.java`
- [Product service](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/application/ProductService.java): `src/main/java/com/devsam/backend/ecommerce/application/ProductService.java`
- [User service](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/application/UserService.java): `src/main/java/com/devsam/backend/ecommerce/application/UserService.java`
- [Order service](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/application/OrderService.java): `src/main/java/com/devsam/backend/ecommerce/application/OrderService.java`
- [Order assembler](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/application/assembler/OrderAssembler.java): `src/main/java/com/devsam/backend/ecommerce/application/assembler/OrderAssembler.java`
- [Image file storage](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/application/UploadFile.java): `src/main/java/com/devsam/backend/ecommerce/application/UploadFile.java`

### Domain

- [Category model](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/model/Category.java): `src/main/java/com/devsam/backend/ecommerce/domain/model/Category.java`
- [Product model](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/model/Product.java): `src/main/java/com/devsam/backend/ecommerce/domain/model/Product.java`
- [User model](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/model/User.java): `src/main/java/com/devsam/backend/ecommerce/domain/model/User.java`
- [Order models](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/model/Order.java): `src/main/java/com/devsam/backend/ecommerce/domain/model/Order.java`
- [Category port](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/port/ICategoryRepository.java): `src/main/java/com/devsam/backend/ecommerce/domain/port/ICategoryRepository.java`
- [Product port](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/port/IProductRepository.java): `src/main/java/com/devsam/backend/ecommerce/domain/port/IProductRepository.java`
- [User port](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/port/IUserRepository.java): `src/main/java/com/devsam/backend/ecommerce/domain/port/IUserRepository.java`
- [Order port](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/domain/port/IOrderRepository.java): `src/main/java/com/devsam/backend/ecommerce/domain/port/IOrderRepository.java`

### Persistence and integrations

- [Category adapter](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/CategoryCrudRepositoryImpl.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/CategoryCrudRepositoryImpl.java`
- [Product adapter](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/ProductCrudRepositoryImpl.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/ProductCrudRepositoryImpl.java`
- [User adapter](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/UserCrudRepositoryImpl.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/UserCrudRepositoryImpl.java`
- [Order adapter](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/OrderCrudRepositoryImpl.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/OrderCrudRepositoryImpl.java`
- [Category mapper](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/CategoryMapper.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/CategoryMapper.java`
- [Product mapper](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/ProductMapper.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/ProductMapper.java`
- [User mapper](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/UserMapper.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/UserMapper.java`
- [Order mapper](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/IOrderMapper.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/mapper/IOrderMapper.java`
- [PayPal service](https://github.com/devsam1966/e-commerce/blob/develop/src/main/java/com/devsam/backend/ecommerce/infrastructure/service/PaypalService.java): `src/main/java/com/devsam/backend/ecommerce/infrastructure/service/PaypalService.java`

### Other components

- **API client**
- **PostgreSQL**
- **PayPal**

## Connections

- API client → Category API: calls (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/CategoryController.java`)
- API client → Product API: calls (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/ProductController.java`)
- API client → User API: calls (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/UserController.java`)
- API client → Order API: calls (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/OrderController.java`)
- API client → PayPal API: calls (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/PaypalController.java`)
- Category API → Category service: delegates to (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/CategoryController.java`)
- Product API → Product service: delegates to (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/ProductController.java`)
- User API → User service: delegates to (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/UserController.java`)
- Order API → Order assembler: assembles with (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/OrderController.java`)
- Order API → Order service: delegates to (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/OrderController.java`)
- PayPal API → PayPal service: delegates to (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/rest/PaypalController.java`)
- Category service → Category port: uses (evidence: `src/main/java/com/devsam/backend/ecommerce/application/CategoryService.java`)
- Product service → Product port: uses (evidence: `src/main/java/com/devsam/backend/ecommerce/application/ProductService.java`)
- Product service → Image file storage: uploads and deletes (evidence: `src/main/java/com/devsam/backend/ecommerce/application/ProductService.java`)
- User service → User port: uses (evidence: `src/main/java/com/devsam/backend/ecommerce/application/UserService.java`)
- Order service → Order port: uses (evidence: `src/main/java/com/devsam/backend/ecommerce/application/OrderService.java`)
- Order assembler → Order models: creates (evidence: `src/main/java/com/devsam/backend/ecommerce/application/assembler/OrderAssembler.java`)
- Category adapter → Category port: implements (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/CategoryCrudRepositoryImpl.java`)
- Product adapter → Product port: implements (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/ProductCrudRepositoryImpl.java`)
- User adapter → User port: implements (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/UserCrudRepositoryImpl.java`)
- Order adapter → Order port: implements (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/OrderCrudRepositoryImpl.java`)
- Category adapter → Category mapper: maps through (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/CategoryCrudRepositoryImpl.java`)
- Product adapter → Product mapper: maps through (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/ProductCrudRepositoryImpl.java`)
- User adapter → User mapper: maps through (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/UserCrudRepositoryImpl.java`)
- Order adapter → Order mapper: maps through (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/adapter/OrderCrudRepositoryImpl.java`)
- PayPal service → PayPal: creates and executes payments (evidence: `src/main/java/com/devsam/backend/ecommerce/infrastructure/service/PaypalService.java`)
- Category adapter → PostgreSQL: persists via Spring Data
- Product adapter → PostgreSQL: persists via Spring Data
- User adapter → PostgreSQL: persists via Spring Data
- Order adapter → PostgreSQL: persists via Spring Data
