Go Backend Overview

Production-ready Go microservice built on hexagonal architecture (ports & adapters), powering core domain services with GraphQL and REST APIs.

Overview

The Go backend services handle high-throughput, latency-critical, and event-driven business domains:

Clean Hexagonal Architecture: Strict separation of domain logic, application use cases, and infrastructure adapters.
APIs: GraphQL via gqlgen and high-performance REST endpoints with middleware security.
Event-Driven Messaging: NATS JetStream messaging and Postgres Transactional Outbox pattern.
Persistence: PostgreSQL via GORM with auto-migrations and multi-tenant organization scoping.
Observability: OpenTelemetry distributed tracing and structured JSON logging.

Core Documentation

Explore the primary documentation areas:

Section	Description	Link
Getting Started	Setup local development environment, tools, and configurations	Get Started
Architecture	Hexagonal design, CQRS, event outbox, and decoupling patterns	Architecture Guide
API Reference	GraphQL workflows, schema generation, and pagination standards	API Documentation
Domain Modules	Auth, Organization, Leave, Fieldforce, Digital Worker, and AI	Domain Modules
Infrastructure & CI/CD	Deployment workflow, ArgoCD, Kustomize, and Kubernetes guides	Infrastructure
Development Guides	Coding conventions, validation middleware, and audit logging	Development

Key Guides & Workflows

Deployment Workflow & CI/CD — End-to-end guide detailing the deployment execution workflow, environment promotion, and ArgoCD sync.
Deployment Quick Reference — Essential commands, environment variables, and operational cheatsheets.
Hexagonal Architecture Deep-Dive — Structural rules, port interfaces, and adapter boundary constraints.
GraphQL Workflow — Schema-first GraphQL development and code generation patterns.

Service Layout

backend/go/
├── cmd/
│   └── server/             ← Main entrypoint
├── internal/
│   ├── app/                ← Dependency injection wire & runtime bootstrap
│   ├── modules/            ← Business domains (hexagonal modules)
│   │   ├── auth/
│   │   ├── organization/
│   │   ├── leave/
│   │   ├── fieldforce/
│   │   └── digitalworker/
│   └── shared/             ← Shared ports, config, and cross-cutting adapters
├── k8s/                    ← Kubernetes manifests and Kustomize overlays
└── docs/                   ← Documentation source

​Overview

​Core Documentation

​Key Guides & Workflows

​Service Layout

Overview

Core Documentation

Key Guides & Workflows

Service Layout