skill-go-gin-api

/skill-go-gin-api

Padrões DARE para APIs REST em Go + Gin (ou stdlib net/http) + sqlc + PostgreSQL. Handlers, services, repositories, middleware, validador, JWT, rate limit, swag OpenAPI.

Como usar

/skill-go-gin-api                          # audita projeto Go
/skill-go-gin-api scaffold users           # gera handler + service + repo + sqlc query
/skill-go-gin-api migrate-validation       # extrai json.Unmarshal manual para binding tags

Stack canônica

• Go 1.22+ (slog, errors.Is/As, generics)
• Gin (preferido) ou stdlib net/http
• sqlc (queries seguras geradas de SQL)
• pgx v5
• go-playground/validator (via Gin binding tags)
• golang-jwt/jwt v5
• swaggo/swag (OpenAPI)
• testify + httptest
• golangci-lint + govulncheck

Estrutura

cmd/server/main.go
internal/
├── handlers/       ← Handler
├── services/       ← Service
├── repositories/   ← Repository (sqlc)
├── domain/         ← Models + erros sentinela
├── middleware/
└── config/
db/
├── migrations/     ← golang-migrate
└── queries/        ← .sql para sqlc
sqlc.yaml

Handler

// @Summary Create user
// @Router /users [post]
func (h *UserHandler) Create(c *gin.Context) {
    var dto CreateUserDTO
    if err := c.ShouldBindJSON(&dto); err != nil {
        c.JSON(400, 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(409, gin.H{"error": "USER_EXISTS"})
            return
        }
        c.JSON(500, gin.H{"error": "INTERNAL"})
        return
    }
    c.JSON(201, ToUserResponse(user))
}

DTO

type CreateUserDTO struct {
    Email    string `json:"email" binding:"required,email"`
    Name     string `json:"name" binding:"required,min=1,max=255"`
    Password string `json:"password" binding:"required,min=12"`
}

Service

type RegisterUser struct {
    repo *repositories.UserRepository
}

func (s *RegisterUser) Execute(ctx context.Context, in RegisterUserInput) (*domain.User, error) {
    exists, err := s.repo.ExistsByEmail(ctx, in.Email)
    if err != nil { return nil, err }
    if exists { return nil, domain.ErrUserAlreadyExists }
    return s.repo.Create(ctx, repositories.CreateUserParams{
        Email: in.Email,
        Name:  in.Name,
        PasswordHash: hashPassword(in.Password),
    })
}