Temporal Go SDK

Build durable, fault-tolerant distributed applications using the Temporal Go SDK (go.temporal.io/sdk). Temporal provides workflow orchestration with automatic retries, state persistence, and exactly-once execution semantics.

Core Principles

• Deterministic Workflows: Workflow code must be deterministic. Never use time.Now(), rand, map range, goroutines, or I/O directly in Workflows.
• Activities for Side Effects: All non-deterministic operations (HTTP calls, DB queries, file I/O) go in Activities.
• Struct Parameters: Use single struct parameters and return values for forward compatibility.
• Idempotent Activities: Activities may be retried; design them to be safely re-executable.
• Explicit Error Handling: Use Temporal's typed errors (ApplicationError, TimeoutError, CanceledError) for control flow.

Project Structure