Expense Tracker API

API para controle financeiro pessoal ou em grupo, com suporte a despesas categorizadas, métodos de pagamento e metas financeiras mensais por categoria.

Este projeto tem como foco demonstrar boas práticas de modelagem de dados, organização de backend e uso do Prisma ORM com PostgreSQL.

---

🚀 Stack

• Node.js
• Express
• Prisma ORM
• PostgreSQL
• TypeScript

---

📌 Funcionalidades

• Cadastro de usuários
• Organização por grupos
• Categorias de despesas
• Registro de despesas
• Metas financeiras mensais por categoria
• Suporte a múltiplos métodos de pagamento

---

🗂️ Modelagem de Dados

• User: representa o usuário da aplicação (1 usuário → 1 grupo)
• Group: contexto financeiro (ex: pessoal, casal)
• Category: categorias de despesas por grupo
• Expense: despesas financeiras
• Goal: metas financeiras mensais por categoria

Regras importantes:

• Cada categoria pode ter apenas uma meta por mês

---

⚙️ Configuração do Projeto

1. Clonar o repositório

git clone https://github.com/joao3g/expense-tracker-api
cd expense-tracker-api

2. Instalar dependências

npm install

3. Configurar variáveis de ambiente

Crie um arquivo .env com a variável:

DATABASE_URL="postgresql://user:password@localhost:5432/expense_tracker"
SALT_ROUNDS=0
SECRET_KEY="secret_key"

4. Rodar migrations

npx prisma migrate dev

📍 Status do Projeto

🚧 Em aprimoramento

📄 Licença

Este projeto está sob a licença MIT.