Merge PR #1 feat/api-enhancement

Author: alysonsz

.dockerignore

@@ -0,0 +1,27 @@
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+*.test
+
+*.out
+
+go.work
+
+.idea/
+.vscode/
+
+.DS_Store
+Thumbs.db
+
+.git/
+.gitignore
+
+*.db
+*.sqlite
+
+Dockerfile
+docker-compose.yml
+.dockerignore

.gitignore

@@ -0,0 +1,26 @@
+*.exe
+*.dll
+*.so
+*.dylib
+bin/
+
+*.test
+
+*.out
+
+*.db
+*.sqlite
+*.sqlite3
+
+.env
+
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+.DS_Store
+Thumbs.db
+
+go.work

Dockerfile

@@ -0,0 +1,18 @@
+FROM golang:1.25-alpine AS builder
+
+WORKDIR /app
+COPY go.mod go.sum ./
+RUN go mod download
+
+COPY . .
+RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o gobook ./cmd/gobook
+
+FROM alpine:latest
+RUN apk --no-cache add ca-certificates
+WORKDIR /root/
+
+COPY --from=builder /app/gobook .
+
+EXPOSE 8080
+
+CMD ["./gobook"]

Makefile

@@ -0,0 +1,39 @@
+.PHONY: build run test vet clean docker-up docker-down
+
+build:
+	go build -o bin/gobook ./cmd/gobook
+
+run:
+	go run ./cmd/gobook
+
+run-postgres:
+	DB_DRIVER=postgres DB_URL=postgres://library:library@localhost:5432/library?sslmode=disable go run ./cmd/gobook
+
+test:
+	go test ./... -v
+
+vet:
+	go vet ./...
+
+tidy:
+	go mod tidy
+
+swag:
+	swag init -g cmd/gobook/main.go
+
+clean:
+	go clean
+	rm -f bin/gobook
+	rm -f *.db
+
+docker-up:
+	docker-compose up --build -d
+
+docker-down:
+	docker-compose down
+
+cli-search:
+	go run ./cmd/gobook search "$(term)"
+
+cli-simulate:
+	go run ./cmd/gobook simulate $(ids)

README.md

@@ -1,93 +1,142 @@
-
 # LIBRARY-API
 
 ## Descrição
-O **LIBRARY-API** é um sistema backend desenvolvido em Go para gerenciar o catálogo de uma livraria. O sistema permite adicionar, atualizar, listar e remover livros do catálogo, com suporte para diferentes informações, como título, autor e gênero. Ele usa uma base de dados SQLite para armazenar os dados e oferece uma API RESTful para interagir com o sistema.
+O **LIBRARY-API** é um sistema backend desenvolvido em Go para gerenciar o catálogo de uma livraria. O sistema permite adicionar, atualizar, listar e remover livros, autores e empréstimos. Ele suporta **SQLite** e **PostgreSQL**, oferece uma API RESTful completa, CLI para comandos e está containerizado com Docker.
 
 ## Funcionalidades
 
-- **Listar Livros**: Exibe todos os livros registrados no sistema.
-- **Adicionar Livros**: Permite o cadastro de novos livros no catálogo.
-- **Atributos do livro**: título, autor, gênero, quantidade de páginas, ano de publicação.
-- **Atualizar Livro**: Permite a modificação dos detalhes de um livro existente.
-- **Remover Livro**: Permite excluir um livro específico do sistema.
+- **Livros**: CRUD completo, busca paginada com filtros (gênero, autor, ano)
+- **Autores**: CRUD completo, listar livros por autor
+- **Empréstimos**: Registrar (com verificação de disponibilidade), retornar e listar atrasados
+- **CLI**: Comandos `search`, `simulate`, `authors`, `loans`
+- **Logging**: Structured JSON logging com `slog`
+- **Graceful shutdown**: Finalização limpa do servidor HTTP
+- **Health check**: Endpoint `/health` para monitoramento
+- **CORS**: Suporte para requisições cross-origin
+- **Validação**: Validação de entrada para livros, autores e empréstimos
 
 ## Requisitos
 
-- Go 1.22.5 ou superior
-- SQLite3 para o banco de dados
+- Go instalado localmente
+- SQLite3 (padrão) ou Docker com PostgreSQL
 
 ### Dependências
 
-- `github.com/mattn/go-sqlite3 v1.14.23`
+- `github.com/mattn/go-sqlite3`
+- `github.com/jackc/pgx/v5`
 
 ## Como Executar
 
-1. Clone o Repositório:
-    ``` bash
-    git clone https://github.com/alysonsz/library-api.git
-    cd library-api
-    ```
-2. Instale as dependências:
-   ```bash
-   go mod tidy
-   ```
-3. Configurar o Banco de Dados:
-O projeto utiliza o SQLite, então certifique-se de que você tenha o arquivo books.database no diretório correto. Caso ainda não exista, crie-o:
-    ```bash
-    touch books.database
-    ```   
-4. Inicie o servidor:
-   ```bash
-   go run main.go
-   ```
-5. O sistema estará rodando na porta `8080`.
-
-## Endpoints
+### SQLite (padrão)
 
-### Listar Livros
-```http
-GET /books
+```bash
+go mod tidy
+go run ./cmd/gobook
 ```
-Retorna a lista de todos os livros cadastrados.
 
-### Adicionar Livro
-```http
-POST /books
+### PostgreSQL via Docker
+
+```bash
+docker-compose up --build
 ```
-Corpo da requisição:
-```json
-{
-  "title": "Nome do Livro",
-  "author": "Autor do Livro",
-  "genre": "Gênero",
-  "pages": "Número de páginas",
-  "publicationYear": "Ano de publicação"
-}
+
+### Variáveis de Ambiente
+
+| Variável | Padrão | Descrição |
+|----------|--------|-----------|
+| `PORT` | `8080` | Porta do servidor |
+| `DB_DRIVER` | `sqlite3` | `sqlite3` ou `postgres` |
+| `DB_PATH` | `./books.db` | Caminho do SQLite |
+| `DB_URL` | (vazio) | Connection string do PostgreSQL |
+| `LOG_LEVEL` | `info` | `info` ou `debug` |
+
+### Exemplo com PostgreSQL
+
+```bash
+export DB_DRIVER=postgres
+export DB_URL=postgres://user:pass@localhost:5432/library?sslmode=disable
+go run ./cmd/gobook
 ```
 
-### Atualizar Livro
-```http
-PUT /books/{id}
+## CLI
+
+```bash
+go run ./cmd/gobook search "Go"
+go run ./cmd/gobook simulate 1 2 3
+go run ./cmd/gobook authors list
+go run ./cmd/gobook authors create "George Orwell" "Bio" 1903
+go run ./cmd/gobook authors delete 1
+go run ./cmd/gobook loans list
+go run ./cmd/gobook loans overdue
+go run ./cmd/gobook loans return 1
 ```
-Parâmetro: `id` do livro a ser atualizado.  
-Corpo da requisição:
-```json
-{
-  "title": "Novo Nome",
-  "author": "Novo Autor",
-  "genre": "Novo Gênero",
-  "pages": "Novo número de páginas",
-  "publicationYear": "Novo ano de publicação"
-}
+
+## Endpoints
+
+### Livros
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
+| GET | `/books?page=1&pageSize=10&genre=Fiction&authorId=1&publicationYear=2020` | Listar com filtros e paginação |
+| POST | `/books` | Criar livro |
+| GET | `/books/{id}` | Buscar por ID |
+| PUT | `/books/{id}` | Atualizar |
+| DELETE | `/books/{id}` | Remover |
+
+### Autores
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
+| GET | `/authors` | Listar |
+| POST | `/authors` | Criar |
+| GET | `/authors/{id}` | Buscar por ID |
+| PUT | `/authors/{id}` | Atualizar |
+| DELETE | `/authors/{id}` | Remover |
+| GET | `/authors/{id}/books` | Livros do autor |
+
+### Empréstimos
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
+| GET | `/loans` | Listar |
+| POST | `/loans` | Criar empréstimo |
+| GET | `/loans/{id}` | Buscar por ID |
+| POST | `/loans/{id}/return` | Devolver livro |
+| GET | `/loans/overdue` | Empréstimos atrasados |
+
+### Health
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
+| GET | `/health` | Status do sistema e conectividade com banco |
+
+### Swagger
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
+| GET | `/swagger/index.html` | Interface interativa da documentação da API |
+
+## Testes
+
+```bash
+go test ./... -v
 ```
 
-### Remover Livro
-```http
-DELETE /books/{id}
+Use o arquivo `test.http` para testar os endpoints da API.
+
+## Swagger / OpenAPI
+
+Para gerar a documentação Swagger, instale o `swag` CLI e rode:
+
+```bash
+go install github.com/swaggo/swag/cmd/swag@latest
+swag init -g cmd/gobook/main.go
 ```
-Parâmetro: `id` do livro a ser removido.
 
-## Testes
+Após gerar, acesse `http://localhost:8080/swagger/index.html` para explorar a API interativamente.
+
+Você também pode usar o Makefile:
 
-Use o arquivo `test.http` para testar os endpoints da API com exemplos de requisições HTTP.
+```bash
+make swag
+```