# sahil-me/productservice architecture

> Architecture diagram of the GitHub repository sahil-me/productservice, 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/sahil-me/productservice
- Repository: https://github.com/sahil-me/productservice

## Overview

This repository implements the product-catalog microservice, not the full e-commerce platform described in the README. Its main workflow is a client request to the product REST controller, delegated through the product-service abstraction to either database persistence or the FakeStore integration. The sampled database service supports product reads and CRUD; the FakeStore adapter implements list, limited-list, and update calls, while several methods are placeholders. Edges reflect shown calls and references; broader platform capabilities such as cart, checkout, and search infrastructure are documented but not implemented in this source tree.

Main entry points: [`src/main/java/com/ecommerce/productservice/services/FakeStoreProductService.java`](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/services/FakeStoreProductService.java) (FakeStore adapter), [`src/main/java/com/ecommerce/productservice/models/Product.java`](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/models/Product.java) (Product entity), [`src/main/java/com/ecommerce/productservice/services/DbProductService.java`](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/services/DbProductService.java) (Database service), [`src/main/java/com/ecommerce/productservice/controllers/ProductController.java`](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/controllers/ProductController.java) (Product controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Product API"]
  node_controller["Product controller"]
  node_error_handler["Exception handler"]
end

subgraph group_catalog["Catalog Services"]
  node_service_contract["Product service contract"]
  node_db_service["Database service"]
  node_fake_service["FakeStore adapter"]
  node_fake_dto["FakeStore product DTO"]
  node_not_found["Product not found"]
end

subgraph group_persistence["Catalog Persistence"]
  node_product["Product entity<br/>[Product.java]"]
  node_category["Category entity<br/>[Category.java]"]
  node_base["Entity base<br/>[Base.java]"]
  node_product_repo["Product repository"]
  node_category_repo["Category repository"]
  node_projection["Product projection"]
end

subgraph group_experiments["Experiments"]
  node_customer["Experiment customer<br/>[Customer.java]"]
  node_order["Experiment order<br/>[Order.java]"]
end

node_client(("API client"))
node_fake_api["FakeStore API"]

node_client -->|"calls REST"| node_controller
node_controller -->|"delegates to"| node_service_contract
node_db_service -->|"implements"| node_service_contract
node_fake_service -->|"implements"| node_service_contract
node_controller -->|"accepts and returns"| node_product
node_controller -->|"declares error"| node_not_found
node_error_handler -->|"handles"| node_not_found
node_db_service -->|"reads and writes"| node_product_repo
node_db_service -->|"injects repository"| node_category_repo
node_db_service -->|"throws"| node_not_found
node_product_repo -->|"persists"| node_product
node_category_repo -->|"persists"| node_category
node_product_repo -->|"returns projection"| node_projection
node_product -->|"extends"| node_base
node_product -->|"references"| node_category
node_category -->|"extends"| node_base
node_fake_service -->|"requests products"| node_fake_api
node_fake_service -->|"converts responses"| node_fake_dto
node_fake_service -->|"builds catalog model"| node_product
node_fake_service -->|"builds category"| node_category
node_customer -->|"maps orders"| node_order

click node_controller "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/controllers/ProductController.java"
click node_error_handler "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/controllerAdvice/GlobalExceptionHandler.java"
click node_service_contract "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/services/ProductService.java"
click node_db_service "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/services/DbProductService.java"
click node_fake_service "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/services/FakeStoreProductService.java"
click node_fake_dto "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/dtos/FakeStoreProductDto.java"
click node_not_found "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/exceptions/ProductNotFoundException.java"
click node_product "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/models/Product.java"
click node_category "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/models/Category.java"
click node_base "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/models/Base.java"
click node_product_repo "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/repositories/ProductRepository.java"
click node_category_repo "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/repositories/CategoryRepository.java"
click node_projection "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/projections/ProductWithIdAndTitle.java"
click node_customer "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/experimentation/models/Customer.java"
click node_order "https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/experimentation/models/Order.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_controller,node_error_handler,node_client toneBlue
class node_service_contract,node_db_service,node_fake_service,node_fake_dto,node_not_found toneAmber
class node_product,node_category,node_base,node_product_repo,node_category_repo,node_projection,node_fake_api toneMint
class node_customer,node_order toneRose
```

## Components

### Product API

- [Product controller](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/controllers/ProductController.java): `src/main/java/com/ecommerce/productservice/controllers/ProductController.java`
- [Exception handler](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/controllerAdvice/GlobalExceptionHandler.java): `src/main/java/com/ecommerce/productservice/controllerAdvice/GlobalExceptionHandler.java`

### Catalog Services

- [Product service contract](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/services/ProductService.java): `src/main/java/com/ecommerce/productservice/services/ProductService.java`
- [Database service](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/services/DbProductService.java): `src/main/java/com/ecommerce/productservice/services/DbProductService.java`
- [FakeStore adapter](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/services/FakeStoreProductService.java): `src/main/java/com/ecommerce/productservice/services/FakeStoreProductService.java`
- [FakeStore product DTO](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/dtos/FakeStoreProductDto.java): `src/main/java/com/ecommerce/productservice/dtos/FakeStoreProductDto.java`
- [Product not found](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/exceptions/ProductNotFoundException.java): `src/main/java/com/ecommerce/productservice/exceptions/ProductNotFoundException.java`

### Catalog Persistence

- [Product entity](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/models/Product.java): `src/main/java/com/ecommerce/productservice/models/Product.java`
- [Category entity](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/models/Category.java): `src/main/java/com/ecommerce/productservice/models/Category.java`
- [Entity base](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/models/Base.java): `src/main/java/com/ecommerce/productservice/models/Base.java`
- [Product repository](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/repositories/ProductRepository.java): `src/main/java/com/ecommerce/productservice/repositories/ProductRepository.java`
- [Category repository](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/repositories/CategoryRepository.java): `src/main/java/com/ecommerce/productservice/repositories/CategoryRepository.java`
- [Product projection](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/projections/ProductWithIdAndTitle.java): `src/main/java/com/ecommerce/productservice/projections/ProductWithIdAndTitle.java`

### Experiments

- [Experiment customer](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/experimentation/models/Customer.java): `src/main/java/com/ecommerce/productservice/experimentation/models/Customer.java`
- [Experiment order](https://github.com/sahil-me/productservice/blob/main/src/main/java/com/ecommerce/productservice/experimentation/models/Order.java): `src/main/java/com/ecommerce/productservice/experimentation/models/Order.java`

### Other components

- **API client**
- **FakeStore API**

## Connections

- API client → Product controller: calls REST (evidence: `src/main/java/com/ecommerce/productservice/controllers/ProductController.java`)
- Product controller → Product service contract: delegates to (evidence: `src/main/java/com/ecommerce/productservice/controllers/ProductController.java`)
- Database service → Product service contract: implements (evidence: `src/main/java/com/ecommerce/productservice/services/DbProductService.java`)
- FakeStore adapter → Product service contract: implements (evidence: `src/main/java/com/ecommerce/productservice/services/FakeStoreProductService.java`)
- Product controller → Product entity: accepts and returns (evidence: `src/main/java/com/ecommerce/productservice/controllers/ProductController.java`)
- Product controller → Product not found: declares error (evidence: `src/main/java/com/ecommerce/productservice/controllers/ProductController.java`)
- Exception handler → Product not found: handles (evidence: `src/main/java/com/ecommerce/productservice/controllerAdvice/GlobalExceptionHandler.java`)
- Database service → Product repository: reads and writes (evidence: `src/main/java/com/ecommerce/productservice/services/DbProductService.java`)
- Database service → Category repository: injects repository (evidence: `src/main/java/com/ecommerce/productservice/services/DbProductService.java`)
- Database service → Product not found: throws (evidence: `src/main/java/com/ecommerce/productservice/services/DbProductService.java`)
- Product repository → Product entity: persists (evidence: `src/main/java/com/ecommerce/productservice/repositories/ProductRepository.java`)
- Category repository → Category entity: persists (evidence: `src/main/java/com/ecommerce/productservice/repositories/CategoryRepository.java`)
- Product repository → Product projection: returns projection (evidence: `src/main/java/com/ecommerce/productservice/repositories/ProductRepository.java`)
- Product entity → Entity base: extends (evidence: `src/main/java/com/ecommerce/productservice/models/Product.java`)
- Product entity → Category entity: references (evidence: `src/main/java/com/ecommerce/productservice/models/Product.java`)
- Category entity → Entity base: extends (evidence: `src/main/java/com/ecommerce/productservice/models/Category.java`)
- FakeStore adapter → FakeStore API: requests products (evidence: `src/main/java/com/ecommerce/productservice/services/FakeStoreProductService.java`)
- FakeStore adapter → FakeStore product DTO: converts responses (evidence: `src/main/java/com/ecommerce/productservice/services/FakeStoreProductService.java`)
- FakeStore adapter → Product entity: builds catalog model (evidence: `src/main/java/com/ecommerce/productservice/services/FakeStoreProductService.java`)
- FakeStore adapter → Category entity: builds category (evidence: `src/main/java/com/ecommerce/productservice/services/FakeStoreProductService.java`)
- Experiment customer → Experiment order: maps orders (evidence: `src/main/java/com/ecommerce/productservice/experimentation/models/Customer.java`)
