# enescelebii/microservices-with-kubernetes-and-angular architecture

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

- Interactive diagram: https://gitdiagram.com/enescelebii/microservices-with-kubernetes-and-angular
- Repository: https://github.com/enescelebii/microservices-with-kubernetes-and-angular

## Overview

This is an e-commerce application: customers browse and add products, then place orders and receive email notifications. The frontend calls API endpoints through the gateway; product requests are handled by the product service, while order placement checks inventory, persists an order, and publishes an event consumed by the notification service. The graph includes the documented security, discovery, resilience, and observability capabilities, but their runtime wiring is not fully shown in the sampled files, so uncertain connections are omitted or dashed.

Main entry points: [`order-service/src/main/java/com/venx/microservices/order/service/OrderService.java`](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/order-service/src/main/java/com/venx/microservices/order/service/OrderService.java) (Order placement), [`frontend/src/app/pages/home-page/home-page.component.ts`](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/frontend/src/app/pages/home-page/home-page.component.ts) (Browse and order), [`frontend/src/app/services/product/product.service.ts`](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/frontend/src/app/services/product/product.service.ts) (Product HTTP client), [`api-gateway/src/main/java/com/venx/microservices/gateway/routes/Routes.java`](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/api-gateway/src/main/java/com/venx/microservices/gateway/routes/Routes.java) (API gateway routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Customer frontend"]
  node_home["Browse and order"]
  node_addproduct["Add product"]
  node_frontendmodels["Product and order models"]
  node_productapi["Product HTTP client<br/>[product.service.ts]"]
  node_orderapi["Order HTTP client<br/>[order.service.ts]"]
  node_auth["Authentication UI<br/>[auth.config.ts]"]
end

subgraph group_edge["Gateway and security"]
  node_gateway["API gateway routes<br/>[Routes.java]"]
  node_gatewaysecurity["Gateway security"]
end

subgraph group_catalog["Product catalog"]
  node_productcontroller["Product API"]
  node_productservice["Product operations"]
  node_productstore[("Product store")]
  node_productdata["Product DTO and model<br/>[Product.java]"]
end

subgraph group_fulfillment["Order fulfillment"]
  node_ordercontroller["Order API"]
  node_orderservice["Order placement<br/>[OrderService.java]"]
  node_inventoryclient["Inventory client"]
  node_inventoryapi["Inventory API"]
  node_inventoryservice["Stock checks"]
  node_inventorystore[("Inventory store")]
  node_orderstore[("Order store")]
end

subgraph group_platform["Messaging and operations"]
  node_orderevent["Order placed event"]
  node_kafka["Kafka topic"]
  node_notification["Email notification"]
  node_observability["Observability config"]
end

node_customer(("Customer"))
node_mail["Email service"]

node_customer -->|"browses"| node_home
node_customer -->|"adds products"| node_addproduct
node_home -->|"loads products"| node_productapi
node_home -->|"places order"| node_orderapi
node_addproduct -->|"creates product"| node_productapi
node_productapi -->|"uses product"| node_frontendmodels
node_orderapi -->|"uses order"| node_frontendmodels
node_home -->|"uses models"| node_frontendmodels
node_auth -.->|"authenticates"| node_gatewaysecurity
node_productapi -->|"HTTP requests"| node_gateway
node_orderapi -->|"HTTP requests"| node_gateway
node_gateway -.->|"routes requests"| node_productcontroller
node_gateway -.->|"routes requests"| node_ordercontroller
node_productcontroller -->|"delegates to"| node_productservice
node_productservice -->|"reads and writes"| node_productstore
node_productservice -->|"builds responses"| node_productdata
node_ordercontroller -->|"delegates to"| node_orderservice
node_orderservice -->|"checks stock"| node_inventoryclient
node_inventoryclient -.->|"checks stock"| node_inventoryapi
node_inventoryapi -->|"delegates to"| node_inventoryservice
node_inventoryservice -->|"checks availability"| node_inventorystore
node_orderservice -->|"saves order"| node_orderstore
node_orderservice -->|"creates event"| node_orderevent
node_orderservice -->|"publishes event"| node_kafka
node_kafka -->|"delivers event"| node_notification
node_notification -->|"sends email"| node_mail

click node_home "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/frontend/src/app/pages/home-page/home-page.component.ts"
click node_addproduct "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/frontend/src/app/pages/add-product/add-product.component.ts"
click node_frontendmodels "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/tree/main/frontend/src/app/model"
click node_productapi "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/frontend/src/app/services/product/product.service.ts"
click node_orderapi "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/frontend/src/app/services/order/order.service.ts"
click node_auth "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/frontend/src/app/config/auth.config.ts"
click node_gateway "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/api-gateway/src/main/java/com/venx/microservices/gateway/routes/Routes.java"
click node_gatewaysecurity "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/api-gateway/src/main/java/com/venx/microservices/gateway/config/SecurityConfig.java"
click node_productcontroller "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/product-service/src/main/java/com/venx/microservices/product/controller/ProductController.java"
click node_productservice "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/product-service/src/main/java/com/venx/microservices/product/service/ProductService.java"
click node_productstore "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/product-service/src/main/java/com/venx/microservices/product/repository/ProductRepository.java"
click node_productdata "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/product-service/src/main/java/com/venx/microservices/product/model/Product.java"
click node_ordercontroller "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/order-service/src/main/java/com/venx/microservices/order/controller/OrderController.java"
click node_orderservice "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/order-service/src/main/java/com/venx/microservices/order/service/OrderService.java"
click node_inventoryclient "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/order-service/src/main/java/com/venx/microservices/order/client/InventoryClient.java"
click node_inventoryapi "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/inventory-service/src/main/java/com/venx/microservices/inventory/controller/InventoryController.java"
click node_inventoryservice "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/inventory-service/src/main/java/com/venx/microservices/inventory/service/InventoryService.java"
click node_inventorystore "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/inventory-service/src/main/java/com/venx/microservices/inventory/repository/InventoryRepository.java"
click node_orderstore "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/order-service/src/main/java/com/venx/microservices/order/repository/OrderRepository.java"
click node_orderevent "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/order-service/src/main/java/com/venx/microservices/order/event/OrderPlacedEvent.java"
click node_notification "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/notification-service/src/main/java/com/venx/microservices/notification/service/NotificationService.java"
click node_observability "https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/api-gateway/src/main/java/com/venx/microservices/gateway/config/ObservabilityConfig.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_home,node_addproduct,node_frontendmodels,node_productapi,node_orderapi,node_auth toneBlue
class node_gateway,node_gatewaysecurity toneAmber
class node_productcontroller,node_productservice,node_productstore,node_productdata toneMint
class node_ordercontroller,node_orderservice,node_inventoryclient,node_inventoryapi,node_inventoryservice,node_inventorystore,node_orderstore toneRose
class node_orderevent,node_kafka,node_notification,node_observability,node_customer,node_mail toneIndigo
```

## Components

### Customer frontend

- [Browse and order](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/frontend/src/app/pages/home-page/home-page.component.ts): `frontend/src/app/pages/home-page/home-page.component.ts`
- [Add product](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/frontend/src/app/pages/add-product/add-product.component.ts): `frontend/src/app/pages/add-product/add-product.component.ts`
- [Product and order models](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/tree/main/frontend/src/app/model): `frontend/src/app/model`
- [Product HTTP client](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/frontend/src/app/services/product/product.service.ts): `frontend/src/app/services/product/product.service.ts`
- [Order HTTP client](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/frontend/src/app/services/order/order.service.ts): `frontend/src/app/services/order/order.service.ts`
- [Authentication UI](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/frontend/src/app/config/auth.config.ts): `frontend/src/app/config/auth.config.ts`

### Gateway and security

- [API gateway routes](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/api-gateway/src/main/java/com/venx/microservices/gateway/routes/Routes.java): `api-gateway/src/main/java/com/venx/microservices/gateway/routes/Routes.java`
- [Gateway security](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/api-gateway/src/main/java/com/venx/microservices/gateway/config/SecurityConfig.java): `api-gateway/src/main/java/com/venx/microservices/gateway/config/SecurityConfig.java`

### Product catalog

- [Product API](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/product-service/src/main/java/com/venx/microservices/product/controller/ProductController.java): `product-service/src/main/java/com/venx/microservices/product/controller/ProductController.java`
- [Product operations](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/product-service/src/main/java/com/venx/microservices/product/service/ProductService.java): `product-service/src/main/java/com/venx/microservices/product/service/ProductService.java`
- [Product store](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/product-service/src/main/java/com/venx/microservices/product/repository/ProductRepository.java): `product-service/src/main/java/com/venx/microservices/product/repository/ProductRepository.java`
- [Product DTO and model](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/product-service/src/main/java/com/venx/microservices/product/model/Product.java): `product-service/src/main/java/com/venx/microservices/product/model/Product.java`

### Order fulfillment

- [Order API](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/order-service/src/main/java/com/venx/microservices/order/controller/OrderController.java): `order-service/src/main/java/com/venx/microservices/order/controller/OrderController.java`
- [Order placement](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/order-service/src/main/java/com/venx/microservices/order/service/OrderService.java): `order-service/src/main/java/com/venx/microservices/order/service/OrderService.java`
- [Inventory client](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/order-service/src/main/java/com/venx/microservices/order/client/InventoryClient.java): `order-service/src/main/java/com/venx/microservices/order/client/InventoryClient.java`
- [Inventory API](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/inventory-service/src/main/java/com/venx/microservices/inventory/controller/InventoryController.java): `inventory-service/src/main/java/com/venx/microservices/inventory/controller/InventoryController.java`
- [Stock checks](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/inventory-service/src/main/java/com/venx/microservices/inventory/service/InventoryService.java): `inventory-service/src/main/java/com/venx/microservices/inventory/service/InventoryService.java`
- [Inventory store](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/inventory-service/src/main/java/com/venx/microservices/inventory/repository/InventoryRepository.java): `inventory-service/src/main/java/com/venx/microservices/inventory/repository/InventoryRepository.java`
- [Order store](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/order-service/src/main/java/com/venx/microservices/order/repository/OrderRepository.java): `order-service/src/main/java/com/venx/microservices/order/repository/OrderRepository.java`

### Messaging and operations

- [Order placed event](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/order-service/src/main/java/com/venx/microservices/order/event/OrderPlacedEvent.java): `order-service/src/main/java/com/venx/microservices/order/event/OrderPlacedEvent.java`
- **Kafka topic**
- [Email notification](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/notification-service/src/main/java/com/venx/microservices/notification/service/NotificationService.java): `notification-service/src/main/java/com/venx/microservices/notification/service/NotificationService.java`
- [Observability config](https://github.com/enescelebii/microservices-with-kubernetes-and-angular/blob/main/api-gateway/src/main/java/com/venx/microservices/gateway/config/ObservabilityConfig.java): `api-gateway/src/main/java/com/venx/microservices/gateway/config/ObservabilityConfig.java`

### Other components

- **Customer**
- **Email service**

## Connections

- Customer → Browse and order: browses
- Customer → Add product: adds products
- Browse and order → Product HTTP client: loads products (evidence: `frontend/src/app/pages/home-page/home-page.component.ts`)
- Browse and order → Order HTTP client: places order (evidence: `frontend/src/app/pages/home-page/home-page.component.ts`)
- Add product → Product HTTP client: creates product (evidence: `frontend/src/app/pages/add-product/add-product.component.ts`)
- Product HTTP client → Product and order models: uses product (evidence: `frontend/src/app/services/product/product.service.ts`)
- Order HTTP client → Product and order models: uses order (evidence: `frontend/src/app/services/order/order.service.ts`)
- Browse and order → Product and order models: uses models (evidence: `frontend/src/app/pages/home-page/home-page.component.ts`)
- Authentication UI → Gateway security: authenticates
- Product HTTP client → API gateway routes: HTTP requests (evidence: `frontend/src/app/services/product/product.service.ts`)
- Order HTTP client → API gateway routes: HTTP requests (evidence: `frontend/src/app/services/order/order.service.ts`)
- API gateway routes → Product API: routes requests
- API gateway routes → Order API: routes requests
- Product API → Product operations: delegates to (evidence: `product-service/src/main/java/com/venx/microservices/product/controller/ProductController.java`)
- Product operations → Product store: reads and writes (evidence: `product-service/src/main/java/com/venx/microservices/product/service/ProductService.java`)
- Product operations → Product DTO and model: builds responses (evidence: `product-service/src/main/java/com/venx/microservices/product/service/ProductService.java`)
- Order API → Order placement: delegates to (evidence: `order-service/src/main/java/com/venx/microservices/order/controller/OrderController.java`)
- Order placement → Inventory client: checks stock (evidence: `order-service/src/main/java/com/venx/microservices/order/service/OrderService.java`)
- Inventory client → Inventory API: checks stock
- Inventory API → Stock checks: delegates to (evidence: `inventory-service/src/main/java/com/venx/microservices/inventory/controller/InventoryController.java`)
- Stock checks → Inventory store: checks availability (evidence: `inventory-service/src/main/java/com/venx/microservices/inventory/service/InventoryService.java`)
- Order placement → Order store: saves order (evidence: `order-service/src/main/java/com/venx/microservices/order/service/OrderService.java`)
- Order placement → Order placed event: creates event (evidence: `order-service/src/main/java/com/venx/microservices/order/service/OrderService.java`)
- Order placement → Kafka topic: publishes event (evidence: `order-service/src/main/java/com/venx/microservices/order/service/OrderService.java`)
- Kafka topic → Email notification: delivers event (evidence: `notification-service/src/main/java/com/venx/microservices/notification/service/NotificationService.java`)
- Email notification → Email service: sends email (evidence: `notification-service/src/main/java/com/venx/microservices/notification/service/NotificationService.java`)
