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/redis-session-distributed-lock.md

View on GitHub
# Redis — Session Storage and Distributed Locking

Companion to `redis-cache-warming-pubsub.md` (cache warming, pub/sub invalidation).

---

## Session Storage in Redis

Use for server-side sessions: JWT revocation, large session payloads, multi-device logout.

```go
type SessionStore struct {
    redis  *redis.Client
    logger *slog.Logger
}

type UserSession struct {
    UserID    string    `json:"user_id"`
    Email     string    `json:"email"`
    Roles     []string  `json:"roles"`
    CreatedAt time.Time `json:"created_at"`
}

func sessionKey(sessionID string) string {
    return fmt.Sprintf("myapp:session:%s", sessionID)
}

func (s *SessionStore) Save(ctx context.Context, sessionID string, sess *UserSession, ttl time.Duration) error {
    b, err := json.Marshal(sess)
    if err != nil {
        return fmt.Errorf("marshal session: %w", err)
    }
    return s.redis.Set(ctx, sessionKey(sessionID), b, ttl).Err()
}

func (s *SessionStore) Get(ctx context.Context, sessionID string) (*UserSession, error) {
    data, err := s.redis.Get(ctx, sessionKey(sessionID)).Bytes()
    if err == redis.Nil {
        return nil, nil // session not found / expired
    }
    if err != nil {
        return nil, fmt.Errorf("get session: %w", err)
    }
    var sess UserSession
    if err := json.Unmarshal(data, &sess); err != nil {
        return nil, fmt.Errorf("unmarshal session: %w", err)
    }
    return &sess, nil
}

func (s *SessionStore) Delete(ctx context.Context, sessionID string) error {
    return s.redis.Del(ctx, sessionKey(sessionID)).Err()
}
```

---

## Distributed Locking

Use to prevent duplicate processing in multi-instance deployments.

```go
type DistributedLock struct{ redis *redis.Client }

func (l *DistributedLock) TryLock(ctx context.Context, resource string, ttl time.Duration) (acquired bool, unlock func(), err error) {
    lockKey := fmt.Sprintf("myapp:lock:%s", resource)
    lockVal := fmt.Sprintf("%d", time.Now().UnixNano())

    ok, err := l.redis.SetNX(ctx, lockKey, lockVal, ttl).Result()
    if err != nil {
        return false, nil, fmt.Errorf("acquire lock %s: %w", resource, err)
    }
    if !ok {
        return false, nil, nil
    }

    unlock = func() {
        script := redis.NewScript(`
            if redis.call("get", KEYS[1]) == ARGV[1] then
                return redis.call("del", KEYS[1])
            else
                return 0
            end
        `)
        _ = script.Run(ctx, l.redis, []string{lockKey}, lockVal).Err()
    }
    return true, unlock, nil
}

// Usage — prevent duplicate payment processing
func (s *PaymentService) ProcessPayment(ctx context.Context, orderID string) error {
    acquired, unlock, err := s.lock.TryLock(ctx, "payment:"+orderID, 30*time.Second)
    if err != nil {
        return fmt.Errorf("lock check: %w", err)
    }
    if !acquired {
        return fmt.Errorf("payment for order %s already in progress", orderID)
    }
    defer unlock()
    return s.doProcessPayment(ctx, orderID)
}
```

**Notes:** TTL must exceed max expected operation duration. Lua script ensures atomic check-and-delete. For stronger guarantees, use `github.com/go-redsync/redsync`.

---

## Redis Connection Setup

```go
func NewRedisClient(url string, logger *slog.Logger) (*redis.Client, error) {
    opts, err := redis.ParseURL(url)
    if err != nil {
        return nil, fmt.Errorf("parse redis url: %w", err)
    }
    opts.PoolSize = 20
    opts.MinIdleConns = 5
    opts.ConnMaxIdleTime = 5 * time.Minute
    opts.DialTimeout = 3 * time.Second
    opts.ReadTimeout = 2 * time.Second
    opts.WriteTimeout = 2 * time.Second

    client := redis.NewClient(opts)
    ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
    defer cancel()
    if err := client.Ping(ctx).Err(); err != nil {
        return nil, fmt.Errorf("redis ping: %w", err)
    }
    logger.Info("redis connected", "addr", opts.Addr)
    return client, nil
}
```

**Required modules:** `go get github.com/redis/go-redis/v9`
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: 322kUpdated 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