README
¶
common-go
Shared Go foundations for Gym microservices.
Status
Published stable line is v0.4.0. develop prepares the v0.5.0 contract line and pins published github.com/pploc/proto-go v1.7.1 without a replace directive.
Packages
auth,errors,grpc/interceptor,grpc/middleware,logging, andobservabilityprovide trusted-claim extraction, safe error mapping, gRPC policies, logging, and W3C propagation.kafkaprovides acknowledged concrete-Protobuf publishing and a privatefranz-goadapter behind project-owned interfaces.
Kafka transport
- Uses Confluent Schema Registry framing with
TopicNameStrategyand runtime lookup-only schema resolution. - Disables consumer auto-commit and processes raw broker records through
FranzConsumer.RunandDelivery.Process. - Retries after 2s, 4s, and 8s. Successful handling or confirmed raw DLQ publishing commits the source record; a failed DLQ write, cancellation, or unfinished delivery leaves it eligible for redelivery.
{topic}.DLQpreserves the original key, framed value, and ordered headers, adding only contract diagnostic headers.
This transport is at-least-once. Services own idempotency and transactional outboxes.
Verification
go install honnef.co/go/tools/cmd/staticcheck@v0.7.0
go install golang.org/x/vuln/cmd/govulncheck@v1.6.0
make verify
For Kafka/Registry validation, use the reusable repository workflow. It provisions Confluent Kafka and Schema Registry 7.7.1, verifies all eleven immutable gym-proto v7.0.2 fixtures, and runs:
KAFKA_BROKERS=localhost:9092 SCHEMA_REGISTRY_URL=http://localhost:8081 make integration
Documentation
¶
Overview ¶
Package common provides shared contracts for the Gym microservices.
Feature packages are introduced incrementally after their cross-language contracts and compatibility fixtures are approved.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package auth extracts gateway-injected request claims.
|
Package auth extracts gateway-injected request claims. |
|
Package errors defines client-safe domain errors and gRPC conversion.
|
Package errors defines client-safe domain errors and gRPC conversion. |
|
grpc
|
|
|
interceptor
Package interceptor provides composable gRPC server interceptors.
|
Package interceptor provides composable gRPC server interceptors. |
|
middleware
Package middleware provides explicit gRPC authorization policies.
|
Package middleware provides explicit gRPC authorization policies. |
|
internal
|
|
|
kafka
Package kafka contains franz-go transport code kept private from consumers of github.com/pploc/common-go/kafka.
|
Package kafka contains franz-go transport code kept private from consumers of github.com/pploc/common-go/kafka. |
|
Package kafka provides the project-owned Kafka foundation API.
|
Package kafka provides the project-owned Kafka foundation API. |
|
Package logging provides safe structured logger context helpers.
|
Package logging provides safe structured logger context helpers. |
|
Package observability provides opt-in OpenTelemetry helpers.
|
Package observability provides opt-in OpenTelemetry helpers. |
Click to show internal directories.
Click to hide internal directories.