Task API

API REST simples de gerenciamento de tarefas (to-do list), construída em Node.js + TypeScript, com persistência em SQLite e testes automatizados.

Projeto pessoal criado para praticar Node.js, TypeScript, SQL e testes de API — com apoio de IA generativa durante o desenvolvimento.

Tecnologias

• Node.js + TypeScript
• Express — framework HTTP
• node:sqlite — módulo nativo de SQLite do Node (sem dependências externas/compilação nativa), usado para praticar SQL puro (CREATE TABLE, INSERT, SELECT, UPDATE, DELETE)
• Vitest + Supertest — testes automatizados de API
• tsx — execução de TypeScript em desenvolvimento

Estrutura do projeto

src/
types.ts # tipos e contratos (Task, inputs)
db.ts # conexão SQLite + migração da tabela
taskRepository.ts # camada de acesso a dados (SQL puro)
validation.ts # validações de entrada
taskController.ts # handlers das rotas (regras HTTP)
routes.ts # definição das rotas
app.ts # instância do Express (usada também nos testes)
server.ts # ponto de entrada (sobe o servidor)
tests/
tasks.test.ts # testes de integração de toda a API
postman/
task-api.postman_collection.json # coleção para testes manuais

Como rodar

npm install
npm run dev # http://localhost:3000

Variáveis de ambiente (opcionais):

Variável	Padrão	Descrição
PORT	3000	Porta do servidor
DB_PATH	./data.db	Caminho do arquivo SQLite (:memory: para banco em memória)

Outros comandos:

npm run build # compila para dist/
npm start # roda a versão compilada
npm test# roda a suíte de testes automatizados
npm run typecheck # checa tipos sem gerar arquivos

Endpoints

Método	Rota	Descrição
GET	/health	Health check
GET	/api/tasks	Lista todas as tarefas (aceita ?status=)
GET	/api/tasks/:id	Busca uma tarefa por id
POST	/api/tasks	Cria uma tarefa
PUT	/api/tasks/:id	Atualiza uma tarefa
DELETE	/api/tasks/:id	Remove uma tarefa

status aceita: pendente, em_andamento, concluida.

Exemplo — criar tarefa

curl -X POST http://localhost:3000/api/tasks \
-H "Content-Type: application/json" \
-d '{"title": "Estudar SQL", "description": "Praticar joins"}'

{
"id": 1,
"title": "Estudar SQL",
"description": "Praticar joins",
"status": "pendente",
"created_at": "2026-07-23 23:00:00",
"updated_at": "2026-07-23 23:00:00"
}

Testes

A suíte em tests/tasks.test.ts cobre, para cada rota, os três tipos de cenário que costumam aparecer em análise de qualidade de software:

• Caso de sucesso (ex.: criar e listar tarefas)
• Caso de erro de validação (ex.: criar tarefa sem title, status inválido → 400)
• Caso de recurso não encontrado / regressão de contrato (ex.: buscar/atualizar/remover id inexistente → 404)

npm test

Testando manualmente (Postman/Insomnia)

Importe postman/task-api.postman_collection.json no Postman ou no Insomnia. A coleção já inclui, além dos casos de sucesso, requisições propositalmente inválidas (sem title, status inválido, id inexistente) para validar o tratamento de erros da API.

Sobre o uso de IA no desenvolvimento

Este projeto foi estruturado com apoio do Claude (Anthropic): definição da arquitetura em camadas (rotas → controller → repositório → banco), revisão de código, e escrita da suíte de testes automatizados. As decisões de escopo, tecnologia e o código final foram revisados e compreendidos por mim.

Possíveis melhorias futuras

• Paginação na listagem de tarefas
• Autenticação (JWT)
• Migração de node:sqlite para PostgreSQL em produção
• Deploy (Render/Railway) e CI com GitHub Actions rodando npm test a cada push