TaskFlow API é uma aplicação Node.js desenvolvida para gerenciar tarefas utilizando arquitetura limpa com Controller, Service, Repository, DTO, Middleware e banco de dados MongoDB Atlas.

A API conta com autenticação via JWT, validação com Joi, mensagens publicadas em Redis e um worker para processar eventos.

taskflow-api/
├─ src/
│  ├─ controllers/
│  ├─ db/
│  ├─ services/
│  ├─ repositories/
│  ├─ dtos/
│  ├─ models/
│  ├─ middlewares/
│  ├─ validators/
│  ├─ routes/
│  └─ views/
├─ worker/
├─ .env.example
├─ Dockerfile
├─ docker-compose.yml
├─ package.json
├─ server.js
└─ app.js

• Node.js + Express
• MongoDB Atlas + Mongoose
• Redis (mensageria)
• Joi (validação)
• bcrypt (hash de senhas)
• JWT (autenticação)
• Docker / Docker Compose

• CRUD de usuários e tarefas
• Autenticação JWT
• RBAC (controle de acesso por papel)
• Validação de dados com Joi
• Logging de requisições
• Worker que consome eventos de tarefas via Redis

cp .env.example .env

1. Instalar dependências:

npm install

2. Rodar API:

npm run dev

docker-compose up --build -d

A aplicação vai está rodando em:

http://localhost:3000/

• POST /api/v1/auth/register - registrar usuário
• POST /api/v1/auth/login - login
• POST /api/v1/auth/logout - logout

• GET /api/v1/users/ - listar todos
• GET /api/v1/users/:id - buscar por ID
• PUT /api/v1/users/:id - atualizar
• DELETE /api/v1/users/:id - deletar

• GET /api/v1/tasks/ - listar tasks
• GET /api/v1/tasks/:id - buscar task
• POST /api/v1/tasks/ - criar task
• PATCH /api/v1/tasks/:id - atualizar
• DELETE /api/v1/tasks/:id - deletar

1. Criar usuário:

curl -X POST http://localhost:3000/api/v1/auth/register -H "Content-Type: application/json" -d '{"name":"Carol","email":"carol@example.com","password":"123456","role":"admin"}'

2. Login (copiar token):

curl -X POST http://localhost:3000/api/v1/auth/login -H "Content-Type: application/json" -d '{"email":"carol@example.com","password":"123456"}'

3. Criar tarefa:

curl -X POST http://localhost:3000/api/v1/tasks -H "Content-Type: application/json" -H "Authorization: Bearer <TOKEN>" -d '{"title": "Task 1", "description": "Descrição da task", "dueDate": "2025-12-20"}'

4. Listar tarefas:

curl -X GET http://localhost:3000/api/v1/tasks -H "Authorization: Bearer <TOKEN>"

5. Atualizar tarefa:

curl -X PUT http://localhost:3000/api/v1/tasks/<TASK_ID> -H "Content-Type: application/json" -H "Authorization: Bearer <TOKEN>" -d '{"title": "Task 1 Atualizada", "description": "Nova descrição", "status": "in-progress", "dueDate": "2025-12-22"}'

Execute:

docker exec -it redis redis-cli

Escutar todos os eventos criados:

PSUBSCRIBE *

• Validam e padronizam dados recebidos nos services

• Isolam acesso ao MongoDB

• Contêm regras de negócio

• Recebem requisições e chamam os services

1. Fork o projeto
2. Crie sua feature branch (git checkout -b feature/xyz)
3. Commit (git commit -m "feat: descrição")
4. Push (git push origin feature/xyz)
5. Abra Pull Request

MIT