# tahaberkamcadev/ecom architecture

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

- Interactive diagram: https://gitdiagram.com/tahaberkamcadev/ecom
- Repository: https://github.com/tahaberkamcadev/ecom

## Overview

This is an event-driven e-commerce backend. A client enters through the JWT-protected gateway; inventory handles strongly consistent checkout and stock reservation. Outbox events reach Kafka through Debezium, where order and payment services choreograph the purchase saga, including cancellation compensation. Projection service maintains CQRS catalog and order read APIs, with Redis caching and Elasticsearch search; user and review services provide account and review capabilities. The runtime links below follow README-documented flows; unsampled implementation details are not asserted.

Main entry points: [`api-gateway/src/main/java/com/tahaberkamcadev/api_gateway/security/JwtAuthenticationFilter.java`](https://github.com/tahaberkamcadev/ecom/blob/master/api-gateway/src/main/java/com/tahaberkamcadev/api_gateway/security/JwtAuthenticationFilter.java) (API gateway), [`projection-service/src/main/java/com/tahaberkamcadev/projection_service/service/ProductQueryService.java`](https://github.com/tahaberkamcadev/ecom/blob/master/projection-service/src/main/java/com/tahaberkamcadev/projection_service/service/ProductQueryService.java) (Projection APIs), [`inventory-service/src/main/java/com/tahaberkamcadev/inventory_service/service/ProductService.java`](https://github.com/tahaberkamcadev/ecom/blob/master/inventory-service/src/main/java/com/tahaberkamcadev/inventory_service/service/ProductService.java) (Inventory and checkout), [`order-service/src/main/java/com/tahaberkamcadev/order_service/entity/Order.java`](https://github.com/tahaberkamcadev/ecom/blob/master/order-service/src/main/java/com/tahaberkamcadev/order_service/entity/Order.java) (Order service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["API edge"]
  node_gateway["API gateway"]
end

subgraph group_commerce["Commerce services"]
  node_users["User service<br/>[AuthService.java]"]
  node_inventory["Inventory and checkout"]
  node_reviews["Review service<br/>[ReviewService.java]"]
end

subgraph group_saga["Purchase saga"]
  node_orders["Order service<br/>[Order.java]"]
  node_payments["Payment service"]
end

subgraph group_read["Read models"]
  node_projection["Projection APIs"]
end

subgraph group_platform["Messaging and stores"]
  node_kafka["Kafka"]
  node_debezium["Debezium CDC"]
  node_postgres[("PostgreSQL")]
  node_redis[("Redis")]
  node_elasticsearch[("Elasticsearch")]
end

node_client(("E-commerce client"))

node_client -->|"sends requests"| node_gateway
node_gateway -->|"routes auth"| node_users
node_gateway -->|"routes commerce"| node_inventory
node_gateway -->|"routes reviews"| node_reviews
node_gateway -->|"routes catalog"| node_projection
node_gateway -->|"limits requests"| node_redis
node_client -->|"requests purchase"| node_gateway
node_gateway -->|"forwards purchase"| node_inventory
node_inventory -->|"reserves stock"| node_postgres
node_inventory -->|"writes outbox"| node_debezium
node_orders -->|"writes orders"| node_postgres
node_orders -->|"writes outbox"| node_debezium
node_payments -->|"writes payments"| node_postgres
node_payments -->|"writes outbox"| node_debezium
node_reviews -->|"stores reviews"| node_postgres
node_reviews -->|"writes outbox"| node_debezium
node_debezium -->|"publishes events"| node_kafka
node_kafka -->|"delivers saga events"| node_orders
node_kafka -->|"delivers saga events"| node_payments
node_kafka -->|"delivers compensation"| node_inventory
node_kafka -->|"delivers projection events"| node_projection
node_projection -->|"stores read models"| node_postgres
node_projection -->|"indexes products"| node_elasticsearch
node_projection -->|"caches details"| node_redis
node_gateway -.->|"no public routes"| node_orders
node_gateway -.->|"no public routes"| node_payments

click node_gateway "https://github.com/tahaberkamcadev/ecom/blob/master/api-gateway/src/main/java/com/tahaberkamcadev/api_gateway/security/JwtAuthenticationFilter.java"
click node_users "https://github.com/tahaberkamcadev/ecom/blob/master/user-service/src/main/java/com/tahaberkamcadev/e_com/user_service/service/AuthService.java"
click node_inventory "https://github.com/tahaberkamcadev/ecom/blob/master/inventory-service/src/main/java/com/tahaberkamcadev/inventory_service/service/ProductService.java"
click node_reviews "https://github.com/tahaberkamcadev/ecom/blob/master/review-service/src/main/java/com/tahaberkamcadev/review_service/service/ReviewService.java"
click node_orders "https://github.com/tahaberkamcadev/ecom/blob/master/order-service/src/main/java/com/tahaberkamcadev/order_service/entity/Order.java"
click node_payments "https://github.com/tahaberkamcadev/ecom/blob/master/payment-service/src/main/java/com/tahaberkamcadev/payment_service/service/PaymentService.java"
click node_projection "https://github.com/tahaberkamcadev/ecom/blob/master/projection-service/src/main/java/com/tahaberkamcadev/projection_service/service/ProductQueryService.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_gateway,node_client toneBlue
class node_users,node_inventory,node_reviews toneAmber
class node_orders,node_payments toneMint
class node_projection toneRose
class node_kafka,node_debezium,node_postgres,node_redis,node_elasticsearch toneIndigo
```

## Components

### API edge

- [API gateway](https://github.com/tahaberkamcadev/ecom/blob/master/api-gateway/src/main/java/com/tahaberkamcadev/api_gateway/security/JwtAuthenticationFilter.java): `api-gateway/src/main/java/com/tahaberkamcadev/api_gateway/security/JwtAuthenticationFilter.java`

### Commerce services

- [User service](https://github.com/tahaberkamcadev/ecom/blob/master/user-service/src/main/java/com/tahaberkamcadev/e_com/user_service/service/AuthService.java): `user-service/src/main/java/com/tahaberkamcadev/e_com/user_service/service/AuthService.java`
- [Inventory and checkout](https://github.com/tahaberkamcadev/ecom/blob/master/inventory-service/src/main/java/com/tahaberkamcadev/inventory_service/service/ProductService.java): `inventory-service/src/main/java/com/tahaberkamcadev/inventory_service/service/ProductService.java`
- [Review service](https://github.com/tahaberkamcadev/ecom/blob/master/review-service/src/main/java/com/tahaberkamcadev/review_service/service/ReviewService.java): `review-service/src/main/java/com/tahaberkamcadev/review_service/service/ReviewService.java`

### Purchase saga

- [Order service](https://github.com/tahaberkamcadev/ecom/blob/master/order-service/src/main/java/com/tahaberkamcadev/order_service/entity/Order.java): `order-service/src/main/java/com/tahaberkamcadev/order_service/entity/Order.java`
- [Payment service](https://github.com/tahaberkamcadev/ecom/blob/master/payment-service/src/main/java/com/tahaberkamcadev/payment_service/service/PaymentService.java): `payment-service/src/main/java/com/tahaberkamcadev/payment_service/service/PaymentService.java`

### Read models

- [Projection APIs](https://github.com/tahaberkamcadev/ecom/blob/master/projection-service/src/main/java/com/tahaberkamcadev/projection_service/service/ProductQueryService.java): `projection-service/src/main/java/com/tahaberkamcadev/projection_service/service/ProductQueryService.java`

### Messaging and stores

- **Kafka**
- **Debezium CDC**
- **PostgreSQL**
- **Redis**
- **Elasticsearch**

### Other components

- **E-commerce client**

## Connections

- E-commerce client → API gateway: sends requests (evidence: `README.md`)
- API gateway → User service: routes auth (evidence: `README.md`)
- API gateway → Inventory and checkout: routes commerce (evidence: `README.md`)
- API gateway → Review service: routes reviews (evidence: `README.md`)
- API gateway → Projection APIs: routes catalog (evidence: `README.md`)
- API gateway → Redis: limits requests (evidence: `README.md`)
- E-commerce client → API gateway: requests purchase (evidence: `README.md`)
- API gateway → Inventory and checkout: forwards purchase (evidence: `README.md`)
- Inventory and checkout → PostgreSQL: reserves stock (evidence: `README.md`)
- Inventory and checkout → Debezium CDC: writes outbox (evidence: `README.md`)
- Order service → PostgreSQL: writes orders (evidence: `README.md`)
- Order service → Debezium CDC: writes outbox (evidence: `README.md`)
- Payment service → PostgreSQL: writes payments (evidence: `README.md`)
- Payment service → Debezium CDC: writes outbox (evidence: `README.md`)
- Review service → PostgreSQL: stores reviews (evidence: `README.md`)
- Review service → Debezium CDC: writes outbox (evidence: `README.md`)
- Debezium CDC → Kafka: publishes events (evidence: `README.md`)
- Kafka → Order service: delivers saga events (evidence: `README.md`)
- Kafka → Payment service: delivers saga events (evidence: `README.md`)
- Kafka → Inventory and checkout: delivers compensation (evidence: `README.md`)
- Kafka → Projection APIs: delivers projection events (evidence: `README.md`)
- Projection APIs → PostgreSQL: stores read models (evidence: `README.md`)
- Projection APIs → Elasticsearch: indexes products (evidence: `README.md`)
- Projection APIs → Redis: caches details (evidence: `README.md`)
- API gateway → Order service: no public routes (evidence: `README.md`)
- API gateway → Payment service: no public routes (evidence: `README.md`)
