# sulaimaangit/e_commerce_application architecture

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

- Interactive diagram: https://gitdiagram.com/sulaimaangit/e_commerce_application
- Repository: https://github.com/sulaimaangit/e_commerce_application

## Overview

The tree indicates a three-service Spring application for product, sales, and user/authentication functions. With no README and no application source excerpts, the graph reflects the apparent service boundaries and conventional layer roles; dashed edges mark unverified relationships rather than confirmed calls. Runtime configuration, database wiring, and inter-service communication cannot be established from the available evidence.

Main entry points: [`user-service/src/main/java/com/example/user_service/service/serviceImpl/AuthServiceImpl.java`](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/service/serviceImpl/AuthServiceImpl.java) (Authentication logic), [`sales-service/src/main/java/com/example/sales_service/service/salesserviceimpl/SalesServiceImpl.java`](https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/service/salesserviceimpl/SalesServiceImpl.java) (Sales logic), [`product-service/src/main/java/com/example/product_service/service/serviceImpl/ProductServiceImpl.java`](https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/service/serviceImpl/ProductServiceImpl.java) (Product logic), [`user-service/src/main/java/com/example/user_service/controller/AuthController.java`](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/controller/AuthController.java) (Auth API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_products["Product service"]
  node_product_api["Product API"]
  node_product_logic["Product logic"]
  node_product_contract["Product service contract"]
  node_product_request["Product request"]
  node_product_record["Product record<br/>[Product.java]"]
  node_product_repository["Product repository"]
end

subgraph group_sales["Sales service"]
  node_sales_api["Sales API"]
  node_sales_logic["Sales logic"]
  node_sales_contract["Sales service contract<br/>[SalesService.java]"]
  node_sales_request["Sales request<br/>[SalesRequest.java]"]
  node_sales_record["Sales records<br/>[Sales.java]"]
  node_sales_item["Sales item<br/>[SalesItem.java]"]
  node_sales_repository["Sales repository"]
end

subgraph group_users["User service"]
  node_auth_api["Auth API"]
  node_auth_logic["Authentication logic"]
  node_auth_contract["Auth service contract<br/>[AuthService.java]"]
  node_auth_requests["Auth requests"]
  node_auth_responses["Auth responses<br/>[AuthResponse.java]"]
  node_user_response["User response<br/>[UserResponse.java]"]
  node_user_record["User credentials<br/>[UserAuth.java]"]
  node_auth_repository["Auth repository<br/>[AuthRepo.java]"]
  node_jwt_filter["JWT filter<br/>[JwtFilter.java]"]
  node_jwt_service["JWT service<br/>[JwtService.java]"]
  node_security_config["Security configuration"]
  node_exception_handler["Exception handling"]
end

node_client(("Client"))

node_client -.->|"requests"| node_product_api
node_product_api -.->|"delegates"| node_product_logic
node_product_api -.->|"accepts"| node_product_request
node_product_logic -.->|"implements"| node_product_contract
node_product_logic -.->|"uses"| node_product_repository
node_product_logic -.->|"handles"| node_product_record
node_client -.->|"requests"| node_sales_api
node_sales_api -.->|"delegates"| node_sales_logic
node_sales_api -.->|"accepts"| node_sales_request
node_sales_logic -.->|"implements"| node_sales_contract
node_sales_logic -.->|"uses"| node_sales_repository
node_sales_logic -.->|"handles"| node_sales_record
node_sales_logic -.->|"handles"| node_sales_item
node_client -.->|"authenticates"| node_auth_api
node_auth_api -.->|"delegates"| node_auth_logic
node_auth_api -.->|"accepts"| node_auth_requests
node_auth_logic -.->|"implements"| node_auth_contract
node_auth_logic -.->|"uses"| node_auth_repository
node_auth_logic -.->|"handles"| node_user_record
node_auth_logic -.->|"returns"| node_auth_responses
node_auth_logic -.->|"returns"| node_user_response
node_security_config -.->|"configures"| node_jwt_filter
node_jwt_filter -.->|"uses"| node_jwt_service
node_auth_api -.->|"handles errors"| node_exception_handler

click node_product_api "https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/controller/ProductController.java"
click node_product_logic "https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/service/serviceImpl/ProductServiceImpl.java"
click node_product_contract "https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/service/ProductService.java"
click node_product_request "https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/dto/ProductRequest.java"
click node_product_record "https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/entity/Product.java"
click node_product_repository "https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/repository/ProductRepository.java"
click node_sales_api "https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/controller/SalesController.java"
click node_sales_logic "https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/service/salesserviceimpl/SalesServiceImpl.java"
click node_sales_contract "https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/service/SalesService.java"
click node_sales_request "https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/dto/SalesRequest.java"
click node_sales_record "https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/entity/Sales.java"
click node_sales_item "https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/entity/SalesItem.java"
click node_sales_repository "https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/repository/SalesRepository.java"
click node_auth_api "https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/controller/AuthController.java"
click node_auth_logic "https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/service/serviceImpl/AuthServiceImpl.java"
click node_auth_contract "https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/service/AuthService.java"
click node_auth_requests "https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/dto/RegisterRequest.java"
click node_auth_responses "https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/dto/AuthResponse.java"
click node_user_response "https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/dto/UserResponse.java"
click node_user_record "https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/entity/UserAuth.java"
click node_auth_repository "https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/repository/AuthRepo.java"
click node_jwt_filter "https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/security/JwtFilter.java"
click node_jwt_service "https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/security/JwtService.java"
click node_security_config "https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/security/SecurityConfig.java"
click node_exception_handler "https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/exception/GlobalExceptionHandler.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_product_api,node_product_logic,node_product_contract,node_product_request,node_product_record,node_product_repository,node_client toneBlue
class node_sales_api,node_sales_logic,node_sales_contract,node_sales_request,node_sales_record,node_sales_item,node_sales_repository toneAmber
class node_auth_api,node_auth_logic,node_auth_contract,node_auth_requests,node_auth_responses,node_user_response,node_user_record,node_auth_repository,node_jwt_filter,node_jwt_service,node_security_config,node_exception_handler toneMint
```

## Components

### Product service

- [Product API](https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/controller/ProductController.java): `product-service/src/main/java/com/example/product_service/controller/ProductController.java`
- [Product logic](https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/service/serviceImpl/ProductServiceImpl.java): `product-service/src/main/java/com/example/product_service/service/serviceImpl/ProductServiceImpl.java`
- [Product service contract](https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/service/ProductService.java): `product-service/src/main/java/com/example/product_service/service/ProductService.java`
- [Product request](https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/dto/ProductRequest.java): `product-service/src/main/java/com/example/product_service/dto/ProductRequest.java`
- [Product record](https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/entity/Product.java): `product-service/src/main/java/com/example/product_service/entity/Product.java`
- [Product repository](https://github.com/sulaimaangit/e_commerce_application/blob/main/product-service/src/main/java/com/example/product_service/repository/ProductRepository.java): `product-service/src/main/java/com/example/product_service/repository/ProductRepository.java`

### Sales service

- [Sales API](https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/controller/SalesController.java): `sales-service/src/main/java/com/example/sales_service/controller/SalesController.java`
- [Sales logic](https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/service/salesserviceimpl/SalesServiceImpl.java): `sales-service/src/main/java/com/example/sales_service/service/salesserviceimpl/SalesServiceImpl.java`
- [Sales service contract](https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/service/SalesService.java): `sales-service/src/main/java/com/example/sales_service/service/SalesService.java`
- [Sales request](https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/dto/SalesRequest.java): `sales-service/src/main/java/com/example/sales_service/dto/SalesRequest.java`
- [Sales records](https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/entity/Sales.java): `sales-service/src/main/java/com/example/sales_service/entity/Sales.java`
- [Sales item](https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/entity/SalesItem.java): `sales-service/src/main/java/com/example/sales_service/entity/SalesItem.java`
- [Sales repository](https://github.com/sulaimaangit/e_commerce_application/blob/main/sales-service/src/main/java/com/example/sales_service/repository/SalesRepository.java): `sales-service/src/main/java/com/example/sales_service/repository/SalesRepository.java`

### User service

- [Auth API](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/controller/AuthController.java): `user-service/src/main/java/com/example/user_service/controller/AuthController.java`
- [Authentication logic](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/service/serviceImpl/AuthServiceImpl.java): `user-service/src/main/java/com/example/user_service/service/serviceImpl/AuthServiceImpl.java`
- [Auth service contract](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/service/AuthService.java): `user-service/src/main/java/com/example/user_service/service/AuthService.java`
- [Auth requests](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/dto/RegisterRequest.java): `user-service/src/main/java/com/example/user_service/dto/RegisterRequest.java`
- [Auth responses](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/dto/AuthResponse.java): `user-service/src/main/java/com/example/user_service/dto/AuthResponse.java`
- [User response](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/dto/UserResponse.java): `user-service/src/main/java/com/example/user_service/dto/UserResponse.java`
- [User credentials](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/entity/UserAuth.java): `user-service/src/main/java/com/example/user_service/entity/UserAuth.java`
- [Auth repository](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/repository/AuthRepo.java): `user-service/src/main/java/com/example/user_service/repository/AuthRepo.java`
- [JWT filter](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/security/JwtFilter.java): `user-service/src/main/java/com/example/user_service/security/JwtFilter.java`
- [JWT service](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/security/JwtService.java): `user-service/src/main/java/com/example/user_service/security/JwtService.java`
- [Security configuration](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/security/SecurityConfig.java): `user-service/src/main/java/com/example/user_service/security/SecurityConfig.java`
- [Exception handling](https://github.com/sulaimaangit/e_commerce_application/blob/main/user-service/src/main/java/com/example/user_service/exception/GlobalExceptionHandler.java): `user-service/src/main/java/com/example/user_service/exception/GlobalExceptionHandler.java`

### Other components

- **Client**

## Connections

- Client → Product API: requests
- Product API → Product logic: delegates
- Product API → Product request: accepts
- Product logic → Product service contract: implements
- Product logic → Product repository: uses
- Product logic → Product record: handles
- Client → Sales API: requests
- Sales API → Sales logic: delegates
- Sales API → Sales request: accepts
- Sales logic → Sales service contract: implements
- Sales logic → Sales repository: uses
- Sales logic → Sales records: handles
- Sales logic → Sales item: handles
- Client → Auth API: authenticates
- Auth API → Authentication logic: delegates
- Auth API → Auth requests: accepts
- Authentication logic → Auth service contract: implements
- Authentication logic → Auth repository: uses
- Authentication logic → User credentials: handles
- Authentication logic → Auth responses: returns
- Authentication logic → User response: returns
- Security configuration → JWT filter: configures
- JWT filter → JWT service: uses
- Auth API → Exception handling: handles errors
