Skip to content

carlos-hfc/financial-control

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

184 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Finance App

Projeto monorepo para controle financeiro com duas aplicações principais:

  • api/ — Backend em Node.js + TypeScript (Fastify, Drizzle ORM, Postgres).
  • web/ — Frontend em React + Vite + TypeScript.

Funcionalidades (resumido)

  • Autenticação e gerenciamento de usuários
  • Gestão de contas e saldos
  • Criação/edição de categorias
  • Registro e listagem de transações
  • Relatórios e métricas por período

Requisitos

  • Node.js 22+
  • npm ou outro gerenciador (pnpm/yarn)
  • Docker & Docker Compose (recomendado para Postgres)

Tecnologias

Estrutura do repositório

financial-control/
├── api/      # Backend (Fastify, Drizzle, migrations, seed, testes)
├── web/      # Frontend (React, Vite)

Configuração rápida (desenvolvimento)

Backend (API)

  1. Instale as dependências:
cd api 
npm install
  1. Configure as variáveis ambiente:
DATABASE_URL=
NODE_ENV=
JWT_SECRET=
COOKIE_NAME=
  1. Rode o banco de dados com Docker:
docker-compose up -d
  1. Execute as migrações do Drizzle:
npm run db:migrate
  1. Popule o banco com exemplos (opcional):
npm run db:seed

Frontend (web)

  1. Instale as dependências:
cd web
npm install
  1. Configure as variáveis ambiente:
VITE_API_URL=

Executando o projeto

cd api
npm run dev
cd web
npm run dev

Contribuição

Pull requests são bem-vindas! Siga as boas práticas de commit e mantenha o padrão de código.

Licença

Está sob a licença MIT.