Exemplo de API em Go organizanda por feature folders, usando Fiber. Dados de seed (80 jogos) são lidos de app/data/games_seed.json.

• Go 1.21+
• Docker & Docker Compose (se for usar containers)
• make (opcional, mas recomendado)

games-api ├── cmd │ └── main.go ├── data │ └── games_seed.json ├── docker-compose.yml ├── Dockerfile ├── go.mod ├── go.sum ├── internal │ ├── games │ │ ├── handler.go │ │ ├── model.go │ │ ├── repository.go │ │ ├── routes.go │ │ └── service.go │ └── health │ └── health.go ├── Makefile ├── openapi.yml ├── pkg │ └── ulidutil │ └── ulid.go └── README.md 

1. Instale dependências e verifique módulos:

make tidy

2. Rodar localmente (usa data/games_seed.json):

make run

3. Build local do binário:

make build # binário gerado em bin/games-api

1. Construir a imagem Docker:

make docker-build

2. Subir containers (monta ./data como /app/data no container):

make up

3. Logs, parar e remover:

make logs make down

Observação: o docker-compose.yml monta a pasta local ./data em /app/data do container (read-only). Garanta que data/games_seed.json esteja presente na raiz do projeto antes de subir o compose.

Lista dos comandos principais (já disponíveis no Makefile):

• make ou make help — mostra os comandos disponíveis.
• make tidy — go mod tidy e go mod verify.
• make build — compila o binário em bin/games-api.
• make run — executa go run main.go (usa o seed JSON em ./data).
• make test — roda go test ./... -v.
• make lint — formata o código (go fmt ./...).

Docker related:

• make docker-build — builda a imagem Dockerfile.
• make docker-run — roda a imagem via Dockerfile.
• make up — docker-compose up --build -d.
• make down — docker-compose down.
• make logs — segue logs do serviço.
• make shell — abre um shell dentro do container (/bin/sh).
• make docker-clean — remove containers/imagens criadas.

Utilitários:

• make health — curl no endpoint GET /health (usa PORT 3000 por padrão).

• O seed com 80 jogos está em data/games_seed.json e é versionado no repositório.
• O serviço carrega esse arquivo ao iniciar; a aplicação espera encontrar data/games_seed.json no diretório de trabalho.

Você pode testar a API localmente (porta padrão 3000) com todos os parâmetros mockados:

curl -X GET "http://localhost:3000/games?name=mario&platform=snes&genre=Platform&subGenre=Adventure" \ -H "Accept: application/json" | jq

Exemplo de resposta:

{ "data": [ { "id": "01H1Z4Q0V1F2G3H4J5K6L7M8N", "name": "Super Mario World", "releaseDate": "1990-11-21", "platform": "snes", "genre": "Platform", "subGenre": "Adventure", "rating": 9.0 } ] }

Parâmetros de exemplo usados:

• name=mario → busca por nome contendo "mario" (case-insensitive)
• platform=snes → filtra apenas jogos de Super Nintendo
• genre=Platform → gênero principal
• subGenre=Adventure → subgênero

Todos os resultados vêm ordenados por rating (desc) por padrão.