How timurgondin/service-courier works
Courier Service manages courier records and delivery assignments through HTTP, while background workers poll the external order service and release expired assignments. A separate Kafka worker processes order-status changes. The main service wires handlers, business services, PostgreSQL repositories, and the gRPC gateway; the README documents these layer relationships and the product capabilities. Some subsystem internals were not sampled, so their links are included only where documented.
Main entry points: service/main.go HTTP service · assign.go Delivery operations · courier.go Courier use cases · worker/main.go Kafka worker
Components 23
Service entrypoints
- HTTP service
cmd/service/main.go - Kafka worker
cmd/worker/main.go
HTTP and events
- Courier API
internal/handler/courier/courier.go - Delivery API
internal/handler/delivery/delivery.go - Order event handler
internal/handler/queues/order/changed/handler.go - Health endpoints
internal/handler/common/ping.go
Business domain
- Courier use cases
internal/service/courier/courier.go - Delivery operations
internal/service/delivery/assign.go - Order status use case
internal/service/order/changed/changed.go - Expiry worker
internal/service/delivery/worker.go - Order polling worker
internal/service/delivery/order_worker.go - Courier model
internal/model/courier/courier.go - Delivery model
internal/model/delivery/delivery.go
Persistence and integrations
- Courier repository
internal/repository/courier/courier.go - Delivery repository
internal/repository/delivery/delivery.go - Order gRPC gateway
internal/gateway/order/client.go - HTTP metrics
internal/metrics/metrics.go - Rate limiting
internal/middleware/middleware.go
Other components
- HTTP client
- Kafka
- Order Service
- PostgreSQL
- Prometheus
Connections 31
- HTTP client → HTTP service: sends HTTP
- HTTP service → Courier API: routes requests
cmd/service/main.go - HTTP service → Delivery API: routes requests
cmd/service/main.go - HTTP service → Health endpoints: routes health
cmd/service/main.go - HTTP service → Courier use cases: constructs
cmd/service/main.go - HTTP service → Delivery operations: constructs
cmd/service/main.go - HTTP service → Courier repository: constructs
cmd/service/main.go - HTTP service → Delivery repository: constructs
cmd/service/main.go - HTTP service → Order gRPC gateway: constructs client
cmd/service/main.go - HTTP service → Expiry worker: starts
cmd/service/main.go - HTTP service → Order polling worker: starts
cmd/service/main.go - HTTP service → Rate limiting: installs middleware
cmd/service/main.go - HTTP service → HTTP metrics: installs middleware
cmd/service/main.go - Courier API → Courier use cases: invokes
- Delivery API → Delivery operations: invokes
- Courier use cases → Courier repository: uses repository
- Delivery operations → Delivery repository: uses repository
- Courier repository → PostgreSQL: queries
internal/repository/courier/courier.go - Delivery repository → PostgreSQL: queries
- Courier use cases → Courier model: uses model
- Delivery operations → Delivery model: uses model
- Order polling worker → Order gRPC gateway: polls orders
internal/service/delivery/order_worker.go - Order polling worker → Delivery operations: assigns couriers
internal/service/delivery/order_worker.go - Order gRPC gateway → Order Service: calls gRPC
- Expiry worker → Delivery operations: releases expired
internal/service/delivery/worker.go - Kafka → Kafka worker: delivers events
cmd/worker/main.go - Kafka worker → Order event handler: registers consumer
cmd/worker/main.go - Order event handler → Order status use case: processes status
- Order status use case → Delivery operations: updates delivery
- Kafka worker → Delivery operations: constructs
cmd/worker/main.go - Prometheus → HTTP service: scrapes metrics