gRPC Playbook (Java)

Scope

In scope

• .proto conventions (packages, naming, versioning, reserved fields).
• API surface: unary vs streaming; pagination patterns; metadata.
• Reliability: deadlines/timeouts, cancellation, retry policy design.
• Error model: mapping domain errors to gRPC status codes + details.
• Streaming guidelines: flow control, message size, backpressure, ordering.
• Client/server skeletons and testing approaches.

Out of scope

• Service mesh specifics and advanced LB policy tuning unless requested.

When to use