API de CRUD de Notas

API REST simples em Node.js + TypeScript para gerenciar notas, com PostgreSQL, Drizzle ORM, validação Zod e autenticação por token opaco.

Pré-requisitos

• Node.js 20+
• Docker e Docker Compose

Setup

1. Instale as dependências:

npm install

2. Copie o arquivo de ambiente (já existe .env no projeto; use o exemplo se precisar recriar):

cp .env.example .env

3. Suba o PostgreSQL:

docker compose up -d

4. Gere e aplique as migrations:

npm run db:generate
npm run db:migrate

Breaking change: a tabela notes passa a exigir id_user (FK para users). Em desenvolvimento local, se já houver notas sem dono, limpe o banco ou recrie o volume antes de migrar.

5. (Opcional) Popule usuários e notas de exemplo:

npm run db:seed

Usuários de seed:

Email	Senha
demo@example.com	password123
alice@example.com	password123

6. Inicie a API em modo desenvolvimento:

npm run dev

A API fica disponível em http://localhost:3000.

Autenticação

A sessão é um token aleatório opaco gerado no register/login e persistido em users.token (não é JWT).

1. Faça register ou login e guarde o token da resposta.
2. Envie nas rotas de notas: Authorization: Bearer <token>.
3. Cada login gera um novo token e invalida o anterior.

Cada nota pertence a um usuário (notes.id_user). Listagem e acesso individual são restritos ao dono.

Scripts

Script	Descrição
npm run dev	Sobe a API com hot reload (tsx watch)
npm run build	Compila TypeScript para ./dist
npm run db:generate	Gera migrations a partir do schema
npm run db:migrate	Aplica migrations no banco
npm run db:seed	Insere usuários e notas de exemplo

Endpoints

Auth (públicos)

Método	Path	Descrição
POST	/auth/register	Criar usuário e obter token
POST	/auth/login	Autenticar e obter novo token

Notes (protegidos)

Método	Path	Descrição
POST	/notes	Criar nota do usuário autenticado
GET	/notes	Listar notas do usuário autenticado
GET	/notes/:id	Buscar nota própria por id
PUT	/notes/:id	Atualizar nota própria
DELETE	/notes/:id	Excluir nota própria

Exemplos

Registrar

curl -X POST http://localhost:3000/auth/register \
-H "Content-Type: application/json" \
-d '{"email":"user@example.com","password":"secret123"}'

Login

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

Criar nota

curl -X POST http://localhost:3000/notes \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <token>" \
-d '{"title":"Minha nota","content":"Conteúdo da nota"}'

Listar notas

curl http://localhost:3000/notes \
-H "Authorization: Bearer <token>"

Buscar por id

curl http://localhost:3000/notes/<uuid> \
-H "Authorization: Bearer <token>"

Atualizar nota

curl -X PUT http://localhost:3000/notes/<uuid> \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <token>" \
-d '{"title":"Título atualizado","content":"Novo conteúdo"}'

Excluir nota

curl -X DELETE http://localhost:3000/notes/<uuid> \
-H "Authorization: Bearer <token>"

Variáveis de ambiente

Variável	Exemplo
PORT	3000
DATABASE_URL	postgresql://notes:notes@localhost:6000/notes