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/cross-cutting-security-config.md

View on GitHub
# Cross-Cutting Concerns — Security, Config, and Feature Flags

Security architecture, configuration management, feature flags, and graceful degradation for Go Gin APIs.

Companion to `cross-cutting-observability.md` (logging, metrics, tracing, health checks).
Caching decision tree: see `cross-cutting-observability.md` or `redis-caching-patterns.md`.

---

## Security Architecture

### Defense in Depth

```
Internet → Load Balancer (TLS termination, DDoS protection)
         → Gin Middleware (rate limiting, CORS, auth)
           → Handler (input validation, sanitization)
             → Service (business rule enforcement, authorization)
               → Repository (parameterized queries, RLS)
                 → PostgreSQL (encryption at rest, network isolation)
```

### Secret Management

```go
type Config struct {
    DatabaseURL string `env:"DATABASE_URL,required"`
    JWTSecret   string `env:"JWT_SECRET,required"`
    RedisURL    string `env:"REDIS_URL"`
    Port        string `env:"PORT" envDefault:"8080"`
}

func LoadConfig() (*Config, error) {
    cfg := &Config{}
    if err := env.Parse(cfg); err != nil {
        return nil, fmt.Errorf("parse config: %w", err)
    }
    return cfg, nil
}
```

**Rules:** Never hardcode secrets. Never commit `.env` files. Use `.env.example` with placeholders. In production: Docker secrets, Kubernetes secrets, or a vault (HashiCorp, AWS SSM).

### Request Signing (Service-to-Service)

```go
func SignRequest(body []byte, secret string) string {
    mac := hmac.New(sha256.New, []byte(secret))
    mac.Write(body)
    return hex.EncodeToString(mac.Sum(nil))
}

func VerifySignature(secret string) gin.HandlerFunc {
    return func(c *gin.Context) {
        signature := c.GetHeader("X-Signature")
        if signature == "" {
            c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "missing signature"})
            return
        }
        body, err := io.ReadAll(c.Request.Body)
        if err != nil {
            c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "cannot read body"})
            return
        }
        c.Request.Body = io.NopCloser(bytes.NewBuffer(body))
        expected := SignRequest(body, secret)
        if !hmac.Equal([]byte(signature), []byte(expected)) {
            c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "invalid signature"})
            return
        }
        c.Next()
    }
}
```

---

## Configuration Management

Single `Config` struct loaded once in `main.go`, passed via dependency injection.

```go
type Config struct {
    Port         string        `env:"PORT"          envDefault:"8080"`
    Environment  string        `env:"ENVIRONMENT"   envDefault:"development"`
    DatabaseURL  string        `env:"DATABASE_URL,required"`
    MaxOpenConns int           `env:"DB_MAX_OPEN"   envDefault:"25"`
    JWTSecret    string        `env:"JWT_SECRET,required"`
    TokenTTL     time.Duration `env:"TOKEN_TTL"     envDefault:"15m"`
}
```

**Rules:** Never read `os.Getenv` in service/repository code. Use `envDefault` for development defaults. Required fields fail fast at startup (not at first request).

---

## Feature Flags

**Start here — env vars cover 90% of use cases:**

```go
type FeatureFlags struct {
    EnableNewCheckout bool `env:"FF_NEW_CHECKOUT" envDefault:"false"`
    EnableBetaSearch  bool `env:"FF_BETA_SEARCH"  envDefault:"false"`
}
```

**User-targeted flags when you outgrow env vars:**

```sql
CREATE TABLE feature_flags (
    name       TEXT PRIMARY KEY,
    enabled    BOOLEAN NOT NULL DEFAULT false,
    rules      JSONB,
    updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
```

---

## Graceful Degradation

Classify each dependency as **critical** (propagate error) or **non-critical** (degrade + log + return partial result).

```go
func (s *ProductService) GetWithRecommendations(ctx context.Context, id string) (*ProductPage, error) {
    product, err := s.repo.GetByID(ctx, id)
    if err != nil {
        return nil, fmt.Errorf("get product: %w", err) // critical — propagate
    }

    recommendations, err := s.recommender.Get(ctx, id)
    if err != nil {
        s.logger.WarnContext(ctx, "recommendations unavailable, returning empty",
            "product_id", id, "error", err)
        recommendations = []Product{} // non-critical — degrade gracefully
    }

    return &ProductPage{Product: product, Recommendations: recommendations}, nil
}
```
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