How to onboard to orders-service

A Go microservice that accepts orders over gRPC and REST, persists them to Postgres, emits domain events to a message queue, and exposes health and metrics for the platform.

A backend service in a larger platform, where clear boundaries, context propagation, and graceful shutdown matter more than clever code.

First files to read

The fastest way into orders-service: read these 5 files first, in order.

1. 1cmd/server/main.goService entry point: config, wiring, graceful shutdown
2. 2internal/orders/service.goCore order-lifecycle business logic
3. 3internal/transport/grpc.gogRPC handlers that map requests onto the service
4. 4internal/store/postgres.goPersistence layer and queries
5. 5internal/events/publisher.goEmits order events to the queue

Main systems

Key terms

Context propagation

Passing request-scoped deadlines, cancellation, and values through the call chain via context.Context.

Graceful shutdown

Draining in-flight requests before exit so nothing is dropped during a deploy.

Domain event

A record that something meaningful happened, published for other services to react to.

More sample repositories