GoCore - Microservices E-commerce Platform

A microservices-based e-commerce platform built with Go, gRPC, GraphQL, PostgreSQL, and Elasticsearch.

Architecture

Services

GraphQL Gateway: Single entry point for all API requests
Account Service: Manages user accounts (PostgreSQL)
Product Service: Manages product catalog (Elasticsearch)
Order Service: Manages orders and order history (PostgreSQL)

Prerequisites

Go 1.24+
Docker & Docker Compose
Protocol Buffers compiler (protoc)
Go protobuf plugins

Installation

1. Install Protocol Buffers

# macOS
brew install protobuf

# Ubuntu/Debian
sudo apt-get install protobuf-compiler

# Windows
# Download from https://github.com/protocolbuffers/protobuf/releases

2. Install Go Protobuf Plugins

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

3. Install gqlgen

go install github.com/99designs/gqlgen@latest

Setup

1. Clone the Repository

git clone https://github.com/sdshah09/GoCore.git
cd GoCore

2. Generate Protocol Buffers

# Generate account service protobuf
cd account
protoc --go_out=pb --go_opt=paths=source_relative \
       --go-grpc_out=pb --go-grpc_opt=paths=source_relative \
       account.proto

# Generate product service protobuf
cd ../product
protoc --go_out=pb --go_opt=paths=source_relative \
       --go-grpc_out=pb --go-grpc_opt=paths=source_relative \
       product.proto

# Generate order service protobuf
cd ../order
protoc --go_out=pb --go_opt=paths=source_relative \
       --go-grpc_out=pb --go-grpc_opt=paths=source_relative \
       order.proto

3. Generate GraphQL Code

cd ../graphql
go run github.com/99designs/gqlgen generate

4. Start Services with Docker Compose

cd ..
docker-compose up -d

Running Locally

Start All Services

# Start all services and databases
docker-compose up -d

# Check service status
docker-compose ps

Stop All Services

docker-compose down

View Logs

# View all logs
docker-compose logs

# View specific service logs
docker-compose logs graphql
docker-compose logs account
docker-compose logs product
docker-compose logs order

API Endpoints

GraphQL Playground: http://localhost:8080/playground
GraphQL Endpoint: http://localhost:8080/graphql

GraphQL Queries and Mutations

Mutations

1. Create Account

mutation CreateAccount {
  createAccount(account: {
    name: "John Doe"
  }) {
    id
    name
  }
}

2. Create Product

mutation CreateProduct {
  createProduct(product: {
    name: "iPhone 15 Pro"
    description: "Latest iPhone with advanced camera system"
    price: 999.99
  }) {
    id
    name
    description
    price
  }
}

3. Create Order

mutation CreateOrder {
  createOrder(order: {
    accountId: "account-123"
    products: [
      {
        id: "product-456"
        quantity: 2
      },
      {
        id: "product-789"
        quantity: 1
      }
    ]
  }) {
    id
    createdAt
    totalPrice
    products {
      id
      name
      description
      price
      quantity
    }
  }
}

Queries

1. Get All Accounts

query GetAllAccounts {
  accounts {
    id
    name
    orders {
      id
      createdAt
      totalPrice
    }
  }
}

2. Get Accounts with Pagination

query GetAccountsWithPagination {
  accounts(pagination: {
    skip: 0
    take: 10
  }) {
    id
    name
  }
}

3. Get Account by ID

query GetAccountById {
  accounts(id: "account-123") {
    id
    name
    orders {
      id
      createdAt
      totalPrice
      products {
        id
        name
        price
        quantity
      }
    }
  }
}

4. Get All Products

query GetAllProducts {
  products {
    id
    name
    description
    price
  }
}

5. Search Products

query SearchProducts {
  products(query: "iPhone") {
    id
    name
    description
    price
  }
}

6. Get Products with Pagination

query GetProductsWithPagination {
  products(pagination: {
    skip: 0
    take: 5
  }) {
    id
    name
    description
    price
  }
}

7. Get Product by ID

query GetProductById {
  products(id: "product-456") {
    id
    name
    description
    price
  }
}

8. Get Orders for Account

query GetOrdersForAccount {
  ordersForAccount(accountId: "account-123") {
    id
    createdAt
    totalPrice
    products {
      id
      name
      description
      price
      quantity
    }
  }
}

Database Schema

PostgreSQL (Account & Order Services)

Accounts Table

CREATE TABLE accounts (
    id CHAR(27) PRIMARY KEY,
    name VARCHAR(255) NOT NULL
);

Orders Table

CREATE TABLE orders (
    id CHAR(27) PRIMARY KEY,
    created_at TIMESTAMP WITH TIME ZONE NOT NULL,
    account_id CHAR(27) NOT NULL,
    total_price MONEY NOT NULL
);

Order Products Table

CREATE TABLE order_products (
    order_id CHAR(27) REFERENCES orders (id) ON DELETE CASCADE,
    product_id CHAR(27),
    quantity INT NOT NULL,
    PRIMARY KEY (product_id, order_id)
);

Elasticsearch (Product Service)

Products are stored in Elasticsearch with the following structure:

{
  "id": "product-123",
  "name": "iPhone 15 Pro",
  "description": "Latest iPhone with advanced camera system",
  "price": 999.99
}

Development

Project Structure

GoCore/
├── account/           # Account service
│   ├── cmd/
│   ├── pb/           # Generated protobuf files
│   ├── repository.go
│   ├── service.go
│   ├── server.go
│   └── account.proto
├── product/          # Product service
│   ├── cmd/
│   ├── pb/
│   ├── repository.go
│   ├── service.go
│   ├── server.go
│   └── product.proto
├── order/            # Order service
│   ├── cmd/
│   ├── pb/
│   ├── repository.go
│   ├── service.go
│   ├── server.go
│   └── order.proto
├── graphql/          # GraphQL gateway
│   ├── schema.graphql
│   ├── mutation_resolver.go
│   ├── query_resolver.go
│   └── main.go
├── docker-compose.yml
├── go.mod
└── README.md

Adding New Services

Create service directory with cmd/, pb/, repository.go, service.go, server.go
Define protobuf schema in .proto file
Generate protobuf code
Add service to docker-compose.yml
Update GraphQL schema if needed

Testing

# Test individual services
cd account && go test ./...
cd ../product && go test ./...
cd ../order && go test ./...

# Test GraphQL queries
# Use the GraphQL Playground at http://localhost:8080/playground

Troubleshooting

Common Issues

Port conflicts: Stop local PostgreSQL/Elasticsearch instances
Protobuf generation errors: Ensure protoc and plugins are installed
GraphQL generation errors: Run go mod tidy and ensure gqlgen is installed
Docker build failures: Check Dockerfile paths and dependencies

Debugging

# Check service logs
docker-compose logs [service-name]

# Access service containers
docker-compose exec [service-name] sh

# Check database connections
docker-compose exec account_db psql -U akhil -d akhil
docker-compose exec order_db psql -U akhil -d akhil

# Check Elasticsearch
curl http://localhost:9200/_cluster/health

End-to-End Deployment

GoCore supports multiple deployment paths from local development to production Kubernetes.

Deployment Options Overview

Environment	Tool	Use Case
Local	Docker Compose	Development, quick testing
Kubernetes	Helm	Manual K8s deployment, CI/CD pipelines
Kubernetes	Argo CD + Helm	GitOps, production, self-healing

1. Local Development (Docker Compose)

Fastest way to run the full stack:

docker-compose up -d

This starts:

4 microservices: account, product, order, graphql
3 databases: PostgreSQL (account, order), Elasticsearch (product)
GraphQL Playground: http://localhost:8000/playground

2. Kubernetes Deployment (Helm)

Deploy the entire platform to any Kubernetes cluster with a single Helm command.

Prerequisites

Kubernetes cluster (minikube, kind, EKS, GKE, AKS, etc.)
kubectl configured
Helm 3+

Deploy with Helm

# Create values-secret.yaml (gitignored) for secrets, or use --set
# Example: cp gocore/values-secret.yaml.example gocore/values-secret.yaml

# Install the chart
helm install gocore ./gocore -f gocore/values.yaml -f gocore/values-secret.yaml

# Or upgrade if already installed
helm upgrade --install gocore ./gocore -f gocore/values.yaml -f gocore/values-secret.yaml

What Gets Deployed

Resource	Description
Deployments	account, order, product, graphql + account-db, order-db, product-db
Services	ClusterIP services for all components
PVCs	Persistent volumes for PostgreSQL and Elasticsearch data
Secret	DB credentials (from values-secret.yaml)
Ingress	Optional ingress for external access

Customize Deployment

Edit gocore/values.yaml to change:

Replicas per service
Image tags and repositories
Resources (CPU/memory limits)
Ingress rules and hostnames

# Override values at install time
helm install gocore ./gocore -f gocore/values.yaml \
  --set services.account.replicas=3 \
  --set ingress.enabled=true

3. GitOps Deployment (Argo CD)

Use Argo CD for declarative, Git-driven deployments with automatic sync and self-healing.

Prerequisites

Kubernetes cluster with Argo CD installed
GoCore repo accessible (GitHub, GitLab, etc.)

Create Argo CD Application

Field	Value
Application Name	`gocore` (must be lowercase)
Repository URL	`https://github.com/sdshah09/GoCore`
Path	`gocore`
Revision	`main` (or your branch)
Source Type	Helm
Destination Namespace	`default` (or your namespace)
Sync Policy	Automatic (optional: Self Heal, Prune)

Workflow

Edit gocore/values.yaml or chart templates
Commit and push to the watched branch
Argo CD detects changes and syncs automatically
Cluster state matches Git — manual kubectl changes are reverted if Self Heal is on

Secrets with Argo CD

Do not commit secrets to Git. Use Argo CD Parameters or a values file from a secret store to pass secrets.dbCredentials.stringData.* at sync time.

4. End-to-End Flow Summary

┌─────────────────────────────────────────────────────────────────────────┐
│  Developer                                                                │
│  └── Edit code, values.yaml, Helm templates                              │
│      └── Commit & push to Git                                             │
└─────────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│  Git (Source of Truth)                                                    │
│  └── gocore/ Chart + values.yaml                                          │
└─────────────────────────────────────────────────────────────────────────┘
                                    │
              ┌─────────────────────┼─────────────────────┐
              ▼                     ▼                     ▼
┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐
│ Docker Compose   │  │ Helm             │  │ Argo CD          │
│ (Local dev)      │  │ (Manual K8s)     │  │ (GitOps K8s)     │
│                  │  │                  │  │                  │
│ docker-compose   │  │ helm install     │  │ Watches Git      │
│ up -d            │  │ gocore ./gocore  │  │ helm template    │
│                  │  │                  │  │ + apply          │
└──────────────────┘  └──────────────────┘  └──────────────────┘
              │                     │                     │
              └─────────────────────┼─────────────────────┘
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│  Running GoCore Platform                                                  │
│  • GraphQL Gateway  • Account Service  • Product Service  • Order Service │
│  • PostgreSQL (x2)  • Elasticsearch                                       │
└─────────────────────────────────────────────────────────────────────────┘

5. Deployment Features

Feature	Docker Compose	Helm	Argo CD
One-command deploy	✅	✅	✅ (after initial setup)
Parameterized config	❌	✅ values.yaml	✅ values + Parameters
Secrets management	Env vars	values-secret.yaml	Parameters / external secrets
Rollback	`docker-compose down`	`helm rollback`	Git revert + sync
Self-healing	❌	❌	✅
Multi-environment	❌	✅ (values per env)	✅ (apps per env)
Audit trail	❌	❌	✅ (Git history)

6. Further Reading

Helm in this project: docs/HELM_IN_THIS_PROJECT.md
Argo CD setup: docs/ARGOCD_NOTES.md
Helm chart reference: docs/HELM_CHART_NOTES.md

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request

Name		Name	Last commit message	Last commit date
account		account
docs		docs
gocore		gocore
graphql		graphql
k8s		k8s
order		order
product		product
.gitignore		.gitignore
README.md		README.md
architecture.png		architecture.png
docker-compose.yml		docker-compose.yml
go.mod		go.mod
go.sum		go.sum
kind-config.yaml		kind-config.yaml
tools.go		tools.go

Latest commit

History

Folders and files

Repository files navigation

GoCore - Microservices E-commerce Platform

Architecture

Services

Prerequisites

Installation

1. Install Protocol Buffers

2. Install Go Protobuf Plugins

3. Install gqlgen

Setup

1. Clone the Repository

2. Generate Protocol Buffers

3. Generate GraphQL Code

4. Start Services with Docker Compose

Running Locally

Start All Services

Stop All Services

View Logs

API Endpoints

GraphQL Queries and Mutations

Mutations

1. Create Account

2. Create Product

3. Create Order

Queries

1. Get All Accounts

2. Get Accounts with Pagination

3. Get Account by ID

4. Get All Products

5. Search Products

6. Get Products with Pagination

7. Get Product by ID

8. Get Orders for Account

Database Schema

PostgreSQL (Account & Order Services)

Accounts Table

Orders Table

Order Products Table

Elasticsearch (Product Service)

Development

Project Structure

Adding New Services

Testing

Troubleshooting

Common Issues

Debugging

End-to-End Deployment

Deployment Options Overview

1. Local Development (Docker Compose)

2. Kubernetes Deployment (Helm)

Prerequisites

Deploy with Helm

What Gets Deployed

Customize Deployment

3. GitOps Deployment (Argo CD)

Prerequisites

Create Argo CD Application

Workflow

Secrets with Argo CD

4. End-to-End Flow Summary

5. Deployment Features

6. Further Reading

Contributing

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages