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-cache-warming-pubsub.md

View on GitHub
# Redis — Cache Warming and Pub/Sub Invalidation

Advanced Redis patterns beyond basic caching for Go Gin APIs.

---

## Cache Warming

**Pattern A — Startup warming** for critical, bounded datasets:

```go
func (s *ProductService) WarmCache(ctx context.Context) error {
    s.logger.Info("warming product cache")
    products, err := s.repo.ListAll(ctx)
    if err != nil {
        return fmt.Errorf("warm cache: %w", err)
    }
    pipe := s.redis.Pipeline()
    for _, p := range products {
        b, _ := json.Marshal(p)
        key := fmt.Sprintf("myapp:v1:product:%s", p.ID)
        pipe.Set(ctx, key, b, withJitter(time.Hour, 300))
    }
    _, err = pipe.Exec(ctx)
    return err
}

// Call in main.go after Redis connection established
if err := productService.WarmCache(context.Background()); err != nil {
    logger.Warn("cache warm failed, degrading gracefully", "err", err)
}
```

**Pattern B — Background refresh** (serve stale, refresh before expiry):

```go
type CachedItem[T any] struct {
    Data      T         `json:"data"`
    ExpiresAt time.Time `json:"expires_at"`
    RefreshAt time.Time `json:"refresh_at"` // 80% of TTL
}

func (s *ProductService) GetWithEarlyRefresh(ctx context.Context, id string) (*Product, error) {
    key := fmt.Sprintf("myapp:v1:product:%s", id)
    data, err := s.redis.Get(ctx, key).Bytes()
    if err == nil {
        var item CachedItem[Product]
        if json.Unmarshal(data, &item) == nil {
            if time.Now().After(item.RefreshAt) {
                go s.refreshAsync(context.Background(), id, key)
            }
            return &item.Data, nil
        }
    }
    return s.fetchAndCache(ctx, id, key)
}
```

---

## Pub/Sub Invalidation (Multi-Instance)

Use when multiple app instances each have local in-memory caches. When instance A updates data, it tells others to invalidate.

```go
const invalidationChannel = "myapp:cache:invalidations"

type InvalidationMessage struct {
    Entity string `json:"entity"`
    ID     string `json:"id"`
}

func (s *ProductService) publishInvalidation(ctx context.Context, id string) {
    msg := InvalidationMessage{Entity: "product", ID: id}
    b, _ := json.Marshal(msg)
    if err := s.redis.Publish(ctx, invalidationChannel, b).Err(); err != nil {
        s.logger.Warn("publish invalidation failed", "err", err)
    }
}

func (s *ProductService) SubscribeInvalidations(ctx context.Context) {
    sub := s.redis.Subscribe(ctx, invalidationChannel)
    defer sub.Close()
    ch := sub.Channel()
    for {
        select {
        case <-ctx.Done():
            return
        case msg, ok := <-ch:
            if !ok {
                return
            }
            var inv InvalidationMessage
            if err := json.Unmarshal([]byte(msg.Payload), &inv); err != nil {
                continue
            }
            if inv.Entity == "product" {
                s.localCache.Delete(inv.ID)
            }
        }
    }
}

// Wire in main.go
go productService.SubscribeInvalidations(ctx)
```

---

## See Also

- `redis-session-distributed-lock.md` — session storage, distributed locking, Redis connection setup
- `redis-caching-patterns.md` — cache-aside, key design, singleflight stampede prevention
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