skill-go-gin-api

Skill: Go/Gin API DARE

Você é um desenvolvedor sênior Go especialista em APIs REST. Esta skill garante código idiomático Go, com erros tipados, contexto sempre propagado, queries seguras via sqlc, seguindo Layered Design DARE.

Stack canônica

• Go 1.22+ (slog, errors.Is/As, generics)
• Gin (preferido) ou stdlib net/http (Go 1.22+ roteamento OK)
• sqlc para queries seguras (gera código tipado de SQL)
• pgx v5 como driver Postgres
• go-playground/validator (via Gin binding tags)
• golang-jwt/jwt v5
• swaggo/swag para OpenAPI
• testify + httptest
• golangci-lint + govulncheck

---

Estrutura

.
├── cmd/server/main.go
├── internal/
│   ├── handlers/                ← Handler
│   ├── services/                ← Service
│   ├── repositories/            ← Repository
│   ├── domain/                  ← Models + erros sentinela
│   ├── middleware/              ← auth, logging, recovery
│   └── config/
├── db/
│   ├── migrations/              ← golang-migrate
│   └── queries/                 ← arquivos .sql para sqlc
├── sqlc.yaml
└── docs/                        ← gerado pelo swag

---

Handlers

package handlers

import (
    "errors"
    "net/http"
    "github.com/gin-gonic/gin"
    "myapp/internal/domain"
    "myapp/internal/services"
)

type UserHandler struct {
    register *services.RegisterUser
}

func NewUserHandler(r *services.RegisterUser) *UserHandler {
    return &UserHandler{register: r}
}

// @Summary Create user
// @Tags users
// @Accept json
// @Produce json
// @Param user body CreateUserDTO true "user payload"
// @Success 201 {object} UserResponse
// @Failure 409
// @Router /users [post]
func (h *UserHandler) Create(c *gin.Context) {
    var dto CreateUserDTO
    if err := c.ShouldBindJSON(&dto); err != nil {
        c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
        return
    }
    user, err := h.register.Execute(c.Request.Context(), dto.ToService())
    if err != nil {
        if errors.Is(err, domain.ErrUserAlreadyExists) {
            c.JSON(http.StatusConflict, gin.H{"error": "USER_EXISTS"})
            return
        }
        c.JSON(http.StatusInternalServerError, gin.H{"error": "INTERNAL"})
        return
    }
    c.JSON(http.StatusCreated, ToUserResponse(user))
}