# sabirkekw/ecommerce_go architecture

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

- Interactive diagram: https://gitdiagram.com/sabirkekw/ecommerce_go
- Repository: https://github.com/sabirkekw/ecommerce_go

## Overview

This repository implements an e-commerce backend as four Go services: authentication, product catalog, cart, and orders. A typical user flow authenticates through SSO, browses the catalog, adds products to a cart, then checks out; the cart service publishes checkout messages that the order service consumes. The services expose gRPC APIs and HTTP gateways, with PostgreSQL-backed state and Redis-backed cart storage. Edges reflect explicit wiring and calls shown in excerpts or the source index; cross-service runtime details not shown are omitted or marked unverified.

Main entry points: [`cart-service/internal/service/cart/service.go`](https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/service/cart/service.go) (Cart service), [`order-service/internal/services/order/service.go`](https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/services/order/service.go) (Order service), [`order-service/internal/messaging/kafka-consumer.go`](https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/messaging/kafka-consumer.go) (Checkout consumer), [`sso-service/internal/app/http/app.go`](https://github.com/sabirkekw/ecommerce_go/blob/master/sso-service/internal/app/http/app.go) (Auth gateway)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Identity"]
  node_authgateway["Auth gateway<br/>[app.go]"]
  node_authserver["Auth gRPC<br/>[server.go]"]
  node_authlogic["Auth service<br/>[auth.go]"]
  node_authrepo["Auth repository<br/>[auth.go]"]
  node_authdb[("Auth database<br/>[postgres.go]")]
end

subgraph group_catalog["Product catalog"]
  node_productgateway["Catalog gateway<br/>[app.go]"]
  node_productserver["Catalog gRPC<br/>[server.go]"]
  node_productlogic["Catalog service<br/>[service.go]"]
  node_productrepo["Catalog repository<br/>[repository.go]"]
  node_productdb[("Catalog database<br/>[postgres.go]")]
end

subgraph group_cart["Cart and checkout"]
  node_cartgateway["Cart gateway<br/>[app.go]"]
  node_cartserver["Cart gRPC<br/>[server.go]"]
  node_cartlogic["Cart service<br/>[service.go]"]
  node_cartpgrepo["Cart PostgreSQL repo<br/>[repository.go]"]
  node_cartredisrepo["Cart Redis repo<br/>[repository.go]"]
  node_cartpg[("Cart PostgreSQL<br/>[postgres.go]")]
  node_cartredis[("Cart Redis<br/>[redis.go]")]
  node_productclient["Product client<br/>[products.go]"]
  node_checkoutproducer["Checkout publisher<br/>[kafka.go]"]
end

subgraph group_orders["Order processing"]
  node_ordergateway["Order gateway<br/>[app.go]"]
  node_orderserver["Order gRPC<br/>[server.go]"]
  node_orderlogic["Order service<br/>[service.go]"]
  node_orderrepo["Order repository<br/>[order.go]"]
  node_orderdb[("Order database<br/>[postgres.go]")]
  node_orderconsumer["Checkout consumer<br/>[kafka-consumer.go]"]
  node_orderproductclient["Product client<br/>[client.go]"]
end

subgraph group_contracts["API contracts"]
  node_authapi["SSO API<br/>[sso.proto]"]
  node_productapi["Products API<br/>[products.proto]"]
  node_cartapi["Cart API<br/>[cart.proto]"]
  node_orderapi["Order API<br/>[order.proto]"]
end

node_shopper(("Shopper"))
node_kafka["Kafka"]

node_shopper -.->|"authenticates via"| node_authgateway
node_shopper -.->|"browses via"| node_productgateway
node_shopper -.->|"manages cart"| node_cartgateway
node_shopper -.->|"views orders"| node_ordergateway
node_authgateway -->|"serves API"| node_authapi
node_authserver -->|"dispatches"| node_authlogic
node_authlogic -->|"uses"| node_authrepo
node_authrepo -.->|"queries"| node_authdb
node_productgateway -->|"serves API"| node_productapi
node_productserver -->|"dispatches"| node_productlogic
node_productlogic -->|"uses"| node_productrepo
node_productrepo -.->|"queries"| node_productdb
node_cartgateway -->|"serves API"| node_cartapi
node_cartserver -->|"dispatches"| node_cartlogic
node_cartlogic -->|"uses"| node_cartpgrepo
node_cartlogic -->|"uses"| node_cartredisrepo
node_cartpgrepo -.->|"queries"| node_cartpg
node_cartredisrepo -.->|"reads/writes"| node_cartredis
node_cartlogic -.->|"checks products"| node_productclient
node_cartlogic -.->|"publishes checkout"| node_checkoutproducer
node_checkoutproducer -.->|"publishes messages"| node_kafka
node_ordergateway -->|"serves API"| node_orderapi
node_orderserver -->|"dispatches"| node_orderlogic
node_orderlogic -->|"uses"| node_orderrepo
node_orderrepo -.->|"queries"| node_orderdb
node_orderconsumer -.->|"forwards checkout"| node_orderlogic
node_orderconsumer -.->|"consumes messages"| node_kafka
node_orderlogic -.->|"checks products"| node_orderproductclient

click node_authgateway "https://github.com/sabirkekw/ecommerce_go/blob/master/sso-service/internal/app/http/app.go"
click node_authserver "https://github.com/sabirkekw/ecommerce_go/blob/master/sso-service/internal/grpc/auth/server.go"
click node_authlogic "https://github.com/sabirkekw/ecommerce_go/blob/master/sso-service/internal/service/auth/auth.go"
click node_authrepo "https://github.com/sabirkekw/ecommerce_go/blob/master/sso-service/internal/repository/auth.go"
click node_authdb "https://github.com/sabirkekw/ecommerce_go/blob/master/sso-service/internal/repository/postgres.go"
click node_productgateway "https://github.com/sabirkekw/ecommerce_go/blob/master/products-service/internal/app/http/app.go"
click node_productserver "https://github.com/sabirkekw/ecommerce_go/blob/master/products-service/internal/grpc/server/server.go"
click node_productlogic "https://github.com/sabirkekw/ecommerce_go/blob/master/products-service/internal/service/service.go"
click node_productrepo "https://github.com/sabirkekw/ecommerce_go/blob/master/products-service/internal/repository/repository.go"
click node_productdb "https://github.com/sabirkekw/ecommerce_go/blob/master/products-service/internal/database/postgres/postgres.go"
click node_cartgateway "https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/app/http/app.go"
click node_cartserver "https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/grpc/server/server.go"
click node_cartlogic "https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/service/cart/service.go"
click node_cartpgrepo "https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/repository/postgres/repository.go"
click node_cartredisrepo "https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/repository/redis/repository.go"
click node_cartpg "https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/database/postgres/postgres.go"
click node_cartredis "https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/database/redis/redis.go"
click node_productclient "https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/grpc/client/products.go"
click node_checkoutproducer "https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/service/messaging/kafka.go"
click node_ordergateway "https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/app/http/app.go"
click node_orderserver "https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/grpc/server/server.go"
click node_orderlogic "https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/services/order/service.go"
click node_orderrepo "https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/repository/order.go"
click node_orderdb "https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/database/postgres/postgres.go"
click node_orderconsumer "https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/messaging/kafka-consumer.go"
click node_orderproductclient "https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/grpc/products-client/client.go"
click node_authapi "https://github.com/sabirkekw/ecommerce_go/blob/master/pkg/api/sso/sso.proto"
click node_productapi "https://github.com/sabirkekw/ecommerce_go/blob/master/pkg/api/products/products.proto"
click node_cartapi "https://github.com/sabirkekw/ecommerce_go/blob/master/pkg/api/cart/cart.proto"
click node_orderapi "https://github.com/sabirkekw/ecommerce_go/blob/master/pkg/api/order/order.proto"

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_authgateway,node_authserver,node_authlogic,node_authrepo,node_authdb toneBlue
class node_productgateway,node_productserver,node_productlogic,node_productrepo,node_productdb toneAmber
class node_cartgateway,node_cartserver,node_cartlogic,node_cartpgrepo,node_cartredisrepo,node_cartpg,node_cartredis,node_productclient,node_checkoutproducer toneMint
class node_ordergateway,node_orderserver,node_orderlogic,node_orderrepo,node_orderdb,node_orderconsumer,node_orderproductclient toneRose
class node_authapi,node_productapi,node_cartapi,node_orderapi,node_shopper,node_kafka toneIndigo
```

## Components

### Identity

- [Auth gateway](https://github.com/sabirkekw/ecommerce_go/blob/master/sso-service/internal/app/http/app.go): `sso-service/internal/app/http/app.go`
- [Auth gRPC](https://github.com/sabirkekw/ecommerce_go/blob/master/sso-service/internal/grpc/auth/server.go): `sso-service/internal/grpc/auth/server.go`
- [Auth service](https://github.com/sabirkekw/ecommerce_go/blob/master/sso-service/internal/service/auth/auth.go): `sso-service/internal/service/auth/auth.go`
- [Auth repository](https://github.com/sabirkekw/ecommerce_go/blob/master/sso-service/internal/repository/auth.go): `sso-service/internal/repository/auth.go`
- [Auth database](https://github.com/sabirkekw/ecommerce_go/blob/master/sso-service/internal/repository/postgres.go): `sso-service/internal/repository/postgres.go`

### Product catalog

- [Catalog gateway](https://github.com/sabirkekw/ecommerce_go/blob/master/products-service/internal/app/http/app.go): `products-service/internal/app/http/app.go`
- [Catalog gRPC](https://github.com/sabirkekw/ecommerce_go/blob/master/products-service/internal/grpc/server/server.go): `products-service/internal/grpc/server/server.go`
- [Catalog service](https://github.com/sabirkekw/ecommerce_go/blob/master/products-service/internal/service/service.go): `products-service/internal/service/service.go`
- [Catalog repository](https://github.com/sabirkekw/ecommerce_go/blob/master/products-service/internal/repository/repository.go): `products-service/internal/repository/repository.go`
- [Catalog database](https://github.com/sabirkekw/ecommerce_go/blob/master/products-service/internal/database/postgres/postgres.go): `products-service/internal/database/postgres/postgres.go`

### Cart and checkout

- [Cart gateway](https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/app/http/app.go): `cart-service/internal/app/http/app.go`
- [Cart gRPC](https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/grpc/server/server.go): `cart-service/internal/grpc/server/server.go`
- [Cart service](https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/service/cart/service.go): `cart-service/internal/service/cart/service.go`
- [Cart PostgreSQL repo](https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/repository/postgres/repository.go): `cart-service/internal/repository/postgres/repository.go`
- [Cart Redis repo](https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/repository/redis/repository.go): `cart-service/internal/repository/redis/repository.go`
- [Cart PostgreSQL](https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/database/postgres/postgres.go): `cart-service/internal/database/postgres/postgres.go`
- [Cart Redis](https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/database/redis/redis.go): `cart-service/internal/database/redis/redis.go`
- [Product client](https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/grpc/client/products.go): `cart-service/internal/grpc/client/products.go`
- [Checkout publisher](https://github.com/sabirkekw/ecommerce_go/blob/master/cart-service/internal/service/messaging/kafka.go): `cart-service/internal/service/messaging/kafka.go`

### Order processing

- [Order gateway](https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/app/http/app.go): `order-service/internal/app/http/app.go`
- [Order gRPC](https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/grpc/server/server.go): `order-service/internal/grpc/server/server.go`
- [Order service](https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/services/order/service.go): `order-service/internal/services/order/service.go`
- [Order repository](https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/repository/order.go): `order-service/internal/repository/order.go`
- [Order database](https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/database/postgres/postgres.go): `order-service/internal/database/postgres/postgres.go`
- [Checkout consumer](https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/messaging/kafka-consumer.go): `order-service/internal/messaging/kafka-consumer.go`
- [Product client](https://github.com/sabirkekw/ecommerce_go/blob/master/order-service/internal/grpc/products-client/client.go): `order-service/internal/grpc/products-client/client.go`

### API contracts

- [SSO API](https://github.com/sabirkekw/ecommerce_go/blob/master/pkg/api/sso/sso.proto): `pkg/api/sso/sso.proto`
- [Products API](https://github.com/sabirkekw/ecommerce_go/blob/master/pkg/api/products/products.proto): `pkg/api/products/products.proto`
- [Cart API](https://github.com/sabirkekw/ecommerce_go/blob/master/pkg/api/cart/cart.proto): `pkg/api/cart/cart.proto`
- [Order API](https://github.com/sabirkekw/ecommerce_go/blob/master/pkg/api/order/order.proto): `pkg/api/order/order.proto`

### Other components

- **Shopper**
- **Kafka**

## Connections

- Shopper → Auth gateway: authenticates via
- Shopper → Catalog gateway: browses via
- Shopper → Cart gateway: manages cart
- Shopper → Order gateway: views orders
- Auth gateway → SSO API: serves API (evidence: `sso-service/internal/app/http/app.go`)
- Auth gRPC → Auth service: dispatches (evidence: `sso-service/internal/grpc/auth/server.go`)
- Auth service → Auth repository: uses (evidence: `sso-service/internal/service/auth/auth.go`)
- Auth repository → Auth database: queries
- Catalog gateway → Products API: serves API (evidence: `products-service/internal/app/http/app.go`)
- Catalog gRPC → Catalog service: dispatches (evidence: `products-service/internal/grpc/server/server.go`)
- Catalog service → Catalog repository: uses
- Catalog repository → Catalog database: queries
- Cart gateway → Cart API: serves API (evidence: `cart-service/internal/app/http/app.go`)
- Cart gRPC → Cart service: dispatches (evidence: `cart-service/internal/grpc/server/server.go`)
- Cart service → Cart PostgreSQL repo: uses
- Cart service → Cart Redis repo: uses
- Cart PostgreSQL repo → Cart PostgreSQL: queries
- Cart Redis repo → Cart Redis: reads/writes
- Cart service → Product client: checks products
- Cart service → Checkout publisher: publishes checkout
- Checkout publisher → Kafka: publishes messages
- Order gateway → Order API: serves API (evidence: `order-service/internal/app/http/app.go`)
- Order gRPC → Order service: dispatches (evidence: `order-service/internal/grpc/server/server.go`)
- Order service → Order repository: uses
- Order repository → Order database: queries
- Checkout consumer → Order service: forwards checkout
- Checkout consumer → Kafka: consumes messages
- Order service → Product client: checks products
