# jose-antonio98/j-commerce architecture

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

- Interactive diagram: https://gitdiagram.com/jose-antonio98/j-commerce
- Repository: https://github.com/jose-antonio98/j-commerce

## Overview

J-Commerce is a Spring-based commerce backend. Its visible user workflow is registration or login through `/auth`, followed by account persistence or JWT issuance; its catalog workflow exposes category operations through public and admin controllers. The tree also contains product entities and repositories, but no product service or controller, so that branch is represented only as a data capability. Relationships are limited to source-index references and shown calls; no README was provided, and unsampled configuration and runtime wiring are not inferred.

Main entry points: [`src/main/java/dev/jose/jcommerce/catalog/mapper/CategoryMapper.java`](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/mapper/CategoryMapper.java) (Category mapper), [`src/main/java/dev/jose/jcommerce/catalog/service/CategoryService.java`](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/service/CategoryService.java) (Category service), [`src/main/java/dev/jose/jcommerce/users/mapper/UserMapper.java`](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/mapper/UserMapper.java) (User mapper), [`src/main/java/dev/jose/jcommerce/util/SlugNormalize.java`](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/util/SlugNormalize.java) (Slug normalization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_user_api["User API"]
  node_user_service["User service<br/>[UserService.java]"]
  node_user_mapper["User mapper<br/>[UserMapper.java]"]
  node_user_request["User request<br/>[UserRequest.java]"]
  node_user_response["User response<br/>[UserResponse.java]"]
  node_auth_service["Auth service<br/>[AuthService.java]"]
  node_login_request["Login request<br/>[LoginRequest.java]"]
  node_jwt_service["JWT token service"]
  node_security_config["Security configuration"]
  node_user_details["User details loader"]
end

subgraph group_catalog["Catalog management"]
  node_category_api["Category APIs"]
  node_admin_category_api["Admin category API"]
  node_category_service["Category service"]
  node_category_mapper["Category mapper"]
  node_category_requests["Category requests"]
  node_category_update["Category updates"]
  node_category_response["Category response"]
  node_product_request["Product request"]
end

subgraph group_persistence["Domain persistence"]
  node_user_repository[("User repository")]
  node_user_entity["User entity<br/>[User.java]"]
  node_category_repository[("Category repository")]
  node_category_entity["Category entity<br/>[Category.java]"]
  node_product_repository[("Product repository")]
  node_product_entity["Product entity<br/>[Product.java]"]
end

subgraph group_shared["Shared support"]
  node_email_normalize["Email normalization"]
  node_slug_normalize["Slug normalization<br/>[SlugNormalize.java]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_user_api
node_user_api -->|"registers or looks up"| node_user_service
node_user_api -->|"logs in"| node_auth_service
node_auth_service -->|"generates token"| node_jwt_service
node_user_service -->|"persists and finds"| node_user_repository
node_user_service -->|"maps users"| node_user_mapper
node_user_mapper -->|"maps entity"| node_user_entity
node_user_mapper -->|"reads request"| node_user_request
node_user_mapper -->|"builds response"| node_user_response
node_user_repository -->|"loads and saves"| node_user_entity
node_user_details -->|"loads account"| node_user_repository
node_security_config -->|"configures lookup"| node_user_details
node_login_request -->|"normalizes email"| node_email_normalize
node_user_request -->|"normalizes email"| node_email_normalize
node_category_api -->|"handles category calls"| node_category_service
node_admin_category_api -->|"handles admin calls"| node_category_service
node_category_service -->|"queries and saves"| node_category_repository
node_category_service -->|"maps categories"| node_category_mapper
node_category_mapper -->|"maps entity"| node_category_entity
node_category_mapper -->|"reads create input"| node_category_requests
node_category_mapper -->|"reads update input"| node_category_update
node_category_mapper -->|"builds response"| node_category_response
node_category_repository -->|"loads and saves"| node_category_entity
node_category_requests -->|"normalizes slug"| node_slug_normalize
node_category_update -->|"normalizes slug"| node_slug_normalize
node_category_service -->|"normalizes lookup"| node_slug_normalize
node_product_repository -->|"loads and saves"| node_product_entity
node_product_entity -->|"references category"| node_category_entity
node_product_request -->|"normalizes slug"| node_slug_normalize

click node_user_api "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/controller/UserController.java"
click node_user_service "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/service/UserService.java"
click node_user_mapper "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/mapper/UserMapper.java"
click node_user_request "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/dto/UserRequest.java"
click node_user_response "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/dto/UserResponse.java"
click node_auth_service "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/auth/service/AuthService.java"
click node_login_request "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/auth/dto/LoginRequest.java"
click node_jwt_service "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/auth/service/JwtTokenService.java"
click node_security_config "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/config/SecurityConfig.java"
click node_user_details "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/auth/service/CustomUserDetailsService.java"
click node_category_api "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/controller/CategoryController.java"
click node_admin_category_api "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/controller/AdminCategoryController.java"
click node_category_service "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/service/CategoryService.java"
click node_category_mapper "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/mapper/CategoryMapper.java"
click node_category_requests "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/dto/CategoryRequest.java"
click node_category_update "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/dto/CategoryRequestUpdate.java"
click node_category_response "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/dto/CategoryResponse.java"
click node_product_request "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/dto/ProductRequest.java"
click node_user_repository "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/repository/UserRepository.java"
click node_user_entity "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/domain/User.java"
click node_category_repository "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/repository/CategoryRepository.java"
click node_category_entity "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/domain/Category.java"
click node_product_repository "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/repository/ProductRepository.java"
click node_product_entity "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/domain/Product.java"
click node_email_normalize "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/util/EmailNormalize.java"
click node_slug_normalize "https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/util/SlugNormalize.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_user_api,node_user_service,node_user_mapper,node_user_request,node_user_response,node_auth_service,node_login_request,node_jwt_service,node_security_config,node_user_details,node_client toneBlue
class node_category_api,node_admin_category_api,node_category_service,node_category_mapper,node_category_requests,node_category_update,node_category_response,node_product_request toneAmber
class node_user_repository,node_user_entity,node_category_repository,node_category_entity,node_product_repository,node_product_entity toneMint
class node_email_normalize,node_slug_normalize toneRose
```

## Components

### Identity and access

- [User API](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/controller/UserController.java): `src/main/java/dev/jose/jcommerce/users/controller/UserController.java`
- [User service](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/service/UserService.java): `src/main/java/dev/jose/jcommerce/users/service/UserService.java`
- [User mapper](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/mapper/UserMapper.java): `src/main/java/dev/jose/jcommerce/users/mapper/UserMapper.java`
- [User request](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/dto/UserRequest.java): `src/main/java/dev/jose/jcommerce/users/dto/UserRequest.java`
- [User response](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/dto/UserResponse.java): `src/main/java/dev/jose/jcommerce/users/dto/UserResponse.java`
- [Auth service](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/auth/service/AuthService.java): `src/main/java/dev/jose/jcommerce/auth/service/AuthService.java`
- [Login request](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/auth/dto/LoginRequest.java): `src/main/java/dev/jose/jcommerce/auth/dto/LoginRequest.java`
- [JWT token service](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/auth/service/JwtTokenService.java): `src/main/java/dev/jose/jcommerce/auth/service/JwtTokenService.java`
- [Security configuration](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/config/SecurityConfig.java): `src/main/java/dev/jose/jcommerce/config/SecurityConfig.java`
- [User details loader](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/auth/service/CustomUserDetailsService.java): `src/main/java/dev/jose/jcommerce/auth/service/CustomUserDetailsService.java`

### Catalog management

- [Category APIs](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/controller/CategoryController.java): `src/main/java/dev/jose/jcommerce/catalog/controller/CategoryController.java`
- [Admin category API](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/controller/AdminCategoryController.java): `src/main/java/dev/jose/jcommerce/catalog/controller/AdminCategoryController.java`
- [Category service](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/service/CategoryService.java): `src/main/java/dev/jose/jcommerce/catalog/service/CategoryService.java`
- [Category mapper](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/mapper/CategoryMapper.java): `src/main/java/dev/jose/jcommerce/catalog/mapper/CategoryMapper.java`
- [Category requests](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/dto/CategoryRequest.java): `src/main/java/dev/jose/jcommerce/catalog/dto/CategoryRequest.java`
- [Category updates](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/dto/CategoryRequestUpdate.java): `src/main/java/dev/jose/jcommerce/catalog/dto/CategoryRequestUpdate.java`
- [Category response](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/dto/CategoryResponse.java): `src/main/java/dev/jose/jcommerce/catalog/dto/CategoryResponse.java`
- [Product request](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/dto/ProductRequest.java): `src/main/java/dev/jose/jcommerce/catalog/dto/ProductRequest.java`

### Domain persistence

- [User repository](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/repository/UserRepository.java): `src/main/java/dev/jose/jcommerce/users/repository/UserRepository.java`
- [User entity](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/users/domain/User.java): `src/main/java/dev/jose/jcommerce/users/domain/User.java`
- [Category repository](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/repository/CategoryRepository.java): `src/main/java/dev/jose/jcommerce/catalog/repository/CategoryRepository.java`
- [Category entity](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/domain/Category.java): `src/main/java/dev/jose/jcommerce/catalog/domain/Category.java`
- [Product repository](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/repository/ProductRepository.java): `src/main/java/dev/jose/jcommerce/catalog/repository/ProductRepository.java`
- [Product entity](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/catalog/domain/Product.java): `src/main/java/dev/jose/jcommerce/catalog/domain/Product.java`

### Shared support

- [Email normalization](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/util/EmailNormalize.java): `src/main/java/dev/jose/jcommerce/util/EmailNormalize.java`
- [Slug normalization](https://github.com/jose-antonio98/j-commerce/blob/master/src/main/java/dev/jose/jcommerce/util/SlugNormalize.java): `src/main/java/dev/jose/jcommerce/util/SlugNormalize.java`

### Other components

- **API client**

## Connections

- API client → User API: sends requests (evidence: `src/main/java/dev/jose/jcommerce/users/controller/UserController.java`)
- User API → User service: registers or looks up (evidence: `src/main/java/dev/jose/jcommerce/users/controller/UserController.java`)
- User API → Auth service: logs in (evidence: `src/main/java/dev/jose/jcommerce/users/controller/UserController.java`)
- Auth service → JWT token service: generates token (evidence: `src/main/java/dev/jose/jcommerce/auth/service/AuthService.java`)
- User service → User repository: persists and finds (evidence: `src/main/java/dev/jose/jcommerce/users/service/UserService.java`)
- User service → User mapper: maps users (evidence: `src/main/java/dev/jose/jcommerce/users/service/UserService.java`)
- User mapper → User entity: maps entity (evidence: `src/main/java/dev/jose/jcommerce/users/mapper/UserMapper.java`)
- User mapper → User request: reads request (evidence: `src/main/java/dev/jose/jcommerce/users/mapper/UserMapper.java`)
- User mapper → User response: builds response (evidence: `src/main/java/dev/jose/jcommerce/users/mapper/UserMapper.java`)
- User repository → User entity: loads and saves (evidence: `src/main/java/dev/jose/jcommerce/users/repository/UserRepository.java`)
- User details loader → User repository: loads account (evidence: `src/main/java/dev/jose/jcommerce/auth/service/CustomUserDetailsService.java`)
- Security configuration → User details loader: configures lookup (evidence: `src/main/java/dev/jose/jcommerce/config/SecurityConfig.java`)
- Login request → Email normalization: normalizes email (evidence: `src/main/java/dev/jose/jcommerce/auth/dto/LoginRequest.java`)
- User request → Email normalization: normalizes email (evidence: `src/main/java/dev/jose/jcommerce/users/dto/UserRequest.java`)
- Category APIs → Category service: handles category calls (evidence: `src/main/java/dev/jose/jcommerce/catalog/controller/CategoryController.java`)
- Admin category API → Category service: handles admin calls (evidence: `src/main/java/dev/jose/jcommerce/catalog/controller/AdminCategoryController.java`)
- Category service → Category repository: queries and saves (evidence: `src/main/java/dev/jose/jcommerce/catalog/service/CategoryService.java`)
- Category service → Category mapper: maps categories (evidence: `src/main/java/dev/jose/jcommerce/catalog/service/CategoryService.java`)
- Category mapper → Category entity: maps entity (evidence: `src/main/java/dev/jose/jcommerce/catalog/mapper/CategoryMapper.java`)
- Category mapper → Category requests: reads create input (evidence: `src/main/java/dev/jose/jcommerce/catalog/mapper/CategoryMapper.java`)
- Category mapper → Category updates: reads update input (evidence: `src/main/java/dev/jose/jcommerce/catalog/mapper/CategoryMapper.java`)
- Category mapper → Category response: builds response (evidence: `src/main/java/dev/jose/jcommerce/catalog/mapper/CategoryMapper.java`)
- Category repository → Category entity: loads and saves (evidence: `src/main/java/dev/jose/jcommerce/catalog/repository/CategoryRepository.java`)
- Category requests → Slug normalization: normalizes slug (evidence: `src/main/java/dev/jose/jcommerce/catalog/dto/CategoryRequest.java`)
- Category updates → Slug normalization: normalizes slug (evidence: `src/main/java/dev/jose/jcommerce/catalog/dto/CategoryRequestUpdate.java`)
- Category service → Slug normalization: normalizes lookup (evidence: `src/main/java/dev/jose/jcommerce/catalog/service/CategoryService.java`)
- Product repository → Product entity: loads and saves (evidence: `src/main/java/dev/jose/jcommerce/catalog/repository/ProductRepository.java`)
- Product entity → Category entity: references category (evidence: `src/main/java/dev/jose/jcommerce/catalog/domain/Product.java`)
- Product request → Slug normalization: normalizes slug (evidence: `src/main/java/dev/jose/jcommerce/catalog/dto/ProductRequest.java`)
