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-dlq-idempotency.md

View on GitHub
# Messaging — Idempotent Consumers

How to prevent duplicate message processing. Companion to `messaging-dlq-setup.md` (dead letter queues).

---

## Gate

Add idempotency when duplicate message delivery would cause real harm (double charge, duplicate record). RabbitMQ guarantees at-least-once delivery on requeue.

**Cost: MEDIUM** — requires Redis or PostgreSQL for dedup state.

---

## Redis-Based Dedup

```go
// internal/worker/idempotency.go
package worker

import (
	"context"
	"fmt"
	"time"

	"github.com/redis/go-redis/v9"
)

const dedupTTL = 24 * time.Hour

type Deduplicator struct {
	rdb *redis.Client
}

// IsDuplicate returns true if messageID was already processed.
// Marks messageID as processed atomically on first call.
func (d *Deduplicator) IsDuplicate(ctx context.Context, messageID string) (bool, error) {
	key := "msg:processed:" + messageID
	// SET NX: only set if not exists. Returns true if set (new), false if existed.
	ok, err := d.rdb.SetNX(ctx, key, "1", dedupTTL).Result()
	if err != nil {
		return false, fmt.Errorf("dedup check %q: %w", messageID, err)
	}
	return !ok, nil // !ok means key already existed → duplicate
}
```

---

## PostgreSQL-Based Dedup

```sql
-- migrations: create processed_messages table
CREATE TABLE processed_messages (
    message_id TEXT PRIMARY KEY,
    processed_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
```

```go
func (d *PgDeduplicator) IsDuplicate(ctx context.Context, db *sql.DB, messageID string) (bool, error) {
	result, err := db.ExecContext(ctx,
		`INSERT INTO processed_messages (message_id) VALUES ($1) ON CONFLICT DO NOTHING`,
		messageID,
	)
	if err != nil {
		return false, fmt.Errorf("pg dedup %q: %w", messageID, err)
	}
	n, _ := result.RowsAffected()
	return n == 0, nil // 0 rows affected = already existed → duplicate
}
```

---

## Usage in Consumer

```go
func (c *EmailConsumer) handle(ctx context.Context, d amqp.Delivery) {
	dup, err := c.dedup.IsDuplicate(ctx, d.MessageId)
	if err != nil {
		c.logger.WarnContext(ctx, "dedup check failed, processing anyway", "error", err)
	}
	if dup {
		c.logger.InfoContext(ctx, "duplicate message skipped", "message_id", d.MessageId)
		_ = d.Ack(false)
		return
	}
	// ... proceed with normal processing
}
```

---

## Quick Reference

| Pattern | Use When | Client Call | Cost |
|---|---|---|---|
| Work queue | Task distribution across N workers | `ch.Consume` + `Qos(1)` | LOW |
| Fanout exchange | One event, many consumers | `ExchangeDeclare("fanout")` | MEDIUM |
| Topic exchange | Selective routing by key pattern | `ExchangeDeclare("topic")` | MEDIUM |
| DLQ | Message failure must not cause data loss | `x-dead-letter-exchange` arg | MEDIUM |
| Idempotent consumer | At-least-once delivery + side effects | Redis `SETNX` or PG `ON CONFLICT` | MEDIUM |
| Transactional outbox | Exactly-once across DB + broker | DB write + poller publishes | HIGH |

## Cross-Skill References

| Topic | Reference |
|---|---|
| Database transactions for outbox pattern | `data-patterns-outbox.md` |
| Redis client setup for dedup | `redis-caching-patterns.md` |
| Dead letter queue setup | `messaging-dlq-setup.md` |
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