CA
carlos-hfc/financial-control
Aplicação de controle financeiro
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)
- Instale as dependências:
cd api
npm install- Configure as variáveis ambiente:
DATABASE_URL=
NODE_ENV=
JWT_SECRET=
COOKIE_NAME=- Rode o banco de dados com Docker:
docker-compose up -d- Execute as migrações do Drizzle:
npm run db:migrate- Popule o banco com exemplos (opcional):
npm run db:seedFrontend (web)
- Instale as dependências:
cd web
npm install- Configure as variáveis ambiente:
VITE_API_URL=Executando o projeto
cd api
npm run devcd web
npm run devContribuiçã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.
On this page
Languages
TypeScript99.8%HTML0.1%JavaScript0.1%CSS0.0%
Contributors
MIT License
Created August 27, 2025
Updated November 21, 2025