Skip to content

henriqueatila/golang-gin-best-practices / skills/golang-gin-architect

golang-gin-architect

Verified

Software architect for Go Gin APIs. Use when making architecture decisions, evaluating complexity, designing systems, choosing patterns, or coordinating across gin skills.

FileKindSize
SKILL.mdskill md10.7 KB
metadata.jsonconfig466 B
references/adr-format-and-templates.mdmarkdown4.1 KB
references/adr-service-extraction-and-example.mdmarkdown4.0 KB
references/api-design-error-contract-docs.mdmarkdown1.8 KB
references/api-design-filtering-bulk-evolution.mdmarkdown3.8 KB
references/api-design-versioning-pagination.mdmarkdown4.3 KB
references/clean-architecture-feature-module.mdmarkdown4.5 KB
references/clean-architecture-layers-di.mdmarkdown5.2 KB
references/complexity-assessment-budget.mdmarkdown5.6 KB
references/complexity-assessment-gates.mdmarkdown4.2 KB
references/complexity-assessment-patterns.mdmarkdown5.0 KB
references/cross-cutting-health-checks.mdmarkdown1.7 KB
references/cross-cutting-observability.mdmarkdown3.9 KB
references/cross-cutting-security-config.mdmarkdown4.4 KB
references/data-ownership-boundaries.mdmarkdown4.5 KB
references/data-ownership-sync-migration.mdmarkdown4.3 KB
references/data-patterns-cqrs.mdmarkdown3.8 KB
references/data-patterns-event-sourcing-aggregate.mdmarkdown2.2 KB
references/data-patterns-event-store.mdmarkdown3.7 KB
references/data-patterns-outbox.mdmarkdown3.7 KB
references/data-patterns-read-replicas.mdmarkdown2.6 KB
references/data-patterns-saga.mdmarkdown3.6 KB
references/error-flow-domain-layers.mdmarkdown5.3 KB
references/error-flow-handler-chain.mdmarkdown4.7 KB
references/golden-main-medium-project.mdmarkdown3.0 KB
references/golden-main-medium-startup.mdmarkdown2.8 KB
references/golden-main-small-project.mdmarkdown4.0 KB
references/grpc-interop-gateway-docker.mdmarkdown2.1 KB
references/grpc-interop-server-client.mdmarkdown2.7 KB
references/grpc-interop-setup.mdmarkdown3.6 KB
references/messaging-consumer-docker.mdmarkdown1.6 KB
references/messaging-consumer-workqueues.mdmarkdown3.6 KB
references/messaging-dlq-idempotency.mdmarkdown3.1 KB
references/messaging-dlq-setup.mdmarkdown2.4 KB
references/messaging-pubsub-exchanges.mdmarkdown3.6 KB
references/messaging-rabbitmq-connection.mdmarkdown3.2 KB
references/messaging-rabbitmq-producer.mdmarkdown2.4 KB
references/object-storage-download-presign.mdmarkdown3.5 KB
references/object-storage-multipart-minio.mdmarkdown2.2 KB
references/object-storage-setup-upload.mdmarkdown4.2 KB
references/redis-cache-warming-pubsub.mdmarkdown3.2 KB
references/redis-caching-patterns.mdmarkdown4.3 KB
references/redis-session-distributed-lock.mdmarkdown3.9 KB
references/resilience-circuit-breaker-bulkhead.mdmarkdown4.3 KB
references/resilience-retry-rate-limiting.mdmarkdown4.0 KB
references/skill-orchestration-overview.mdmarkdown3.2 KB
references/skill-orchestration-workflows.mdmarkdown5.4 KB
references/system-design-bounded-contexts.mdmarkdown4.1 KB
references/system-design-c4-model.mdmarkdown4.6 KB
references/system-design-dependency-graphs.mdmarkdown2.6 KB
references/system-design-domain-modeling.mdmarkdown3.5 KB
references/system-design-project-structure.mdmarkdown4.2 KB
references/tech-debt-identification-prioritization.mdmarkdown5.1 KB
references/tech-debt-refactoring-communication.mdmarkdown4.0 KB

references/messaging-rabbitmq-connection.md

View on GitHub
# Messaging — When to Use RabbitMQ and Connection Factory

When to use async messaging in Go Gin APIs and how to establish the RabbitMQ connection.

**Package:** `github.com/rabbitmq/amqp091-go`

---

## When to Use Messaging

**Gate:** Add async messaging only when synchronous HTTP creates a user-facing bottleneck or reliability risk.

```
START: Does the caller need the result immediately?
  ├── Yes → Synchronous HTTP. Done.
  └── No → Can the work fail and be retried later?
      ├── No → Synchronous with timeout. Done.
      └── Yes → Message queue.
          └── Need exactly-once delivery?
              ├── No → Producer + consumer with manual ack.
              └── Yes → Transactional outbox + idempotent consumer.
```

**Good candidates for async:** Email/SMS, image processing, PDF generation, webhook delivery, audit log writes, cache invalidation, batch data exports.

**Bad candidates (keep sync):** Auth checks, payment confirmation (user waits), read queries, anything requiring immediate response data.

---

## RabbitMQ Connection Factory

One connection per process. One channel per goroutine. Never share channels across goroutines.

```go
// pkg/messaging/connection.go
type Config struct {
    URL            string
    ReconnectDelay time.Duration
    MaxRetries     int
}

type Connection struct {
    cfg    Config
    conn   *amqp.Connection
    logger *slog.Logger
}

func NewConnection(cfg Config, logger *slog.Logger) (*Connection, error) {
    if cfg.ReconnectDelay == 0 {
        cfg.ReconnectDelay = 5 * time.Second
    }
    if cfg.MaxRetries == 0 {
        cfg.MaxRetries = 10
    }
    c := &Connection{cfg: cfg, logger: logger}
    if err := c.dial(); err != nil {
        return nil, fmt.Errorf("messaging.NewConnection: %w", err)
    }
    return c, nil
}

func (c *Connection) dial() error {
    var err error
    for i := range c.cfg.MaxRetries {
        c.conn, err = amqp.Dial(c.cfg.URL)
        if err == nil {
            c.logger.Info("rabbitmq connected", "attempt", i+1)
            return nil
        }
        c.logger.Warn("rabbitmq dial failed, retrying",
            "attempt", i+1, "max", c.cfg.MaxRetries,
            "error", err, "delay", c.cfg.ReconnectDelay,
        )
        time.Sleep(c.cfg.ReconnectDelay)
    }
    return fmt.Errorf("rabbitmq dial: exhausted %d retries: %w", c.cfg.MaxRetries, err)
}

func (c *Connection) Channel() (*amqp.Channel, error) {
    ch, err := c.conn.Channel()
    if err != nil {
        return nil, fmt.Errorf("messaging.Channel: %w", err)
    }
    return ch, nil
}

func (c *Connection) Reconnect(ctx context.Context) error {
    notifyClose := c.conn.NotifyClose(make(chan *amqp.Error, 1))
    select {
    case <-ctx.Done():
        return ctx.Err()
    case err := <-notifyClose:
        c.logger.Warn("rabbitmq connection closed, reconnecting", "error", err)
        return c.dial()
    }
}

func (c *Connection) Close() error { return c.conn.Close() }
```

---

## See Also

- `messaging-rabbitmq-producer.md` — queue declaration helper and producer pattern
- `messaging-consumer-workqueues.md` — consumer with manual ack, work queues, Docker Compose
- `messaging-dlq-idempotency.md` — dead letter queues, deduplication
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 323kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall