Fluxo Simples

Mini SaaS web para controle financeiro empresarial, focado em lancar e visualizar receitas e despesas do dia a dia.

Stack

• Frontend: React + Vite
• Backend: Node.js + Express
• Banco: PostgreSQL com pg
• Extras: exportacao CSV e dados mockados no primeiro start

Estrutura

mini-finance-saas/
  server/
    index.js          API HTTP e rotas de lancamentos
    storage.js        inicializacao do PostgreSQL e seed mockado
  src/
    components/       dashboard, formulario, categorias, filtros, lista e grafico
    utils/            formatadores de moeda e data
    api.js            cliente HTTP do frontend
    App.jsx           orquestracao da tela principal
    styles.css        layout mobile-first
  index.html
  vite.config.js
  package.json

Como rodar localmente

A senha padrao e o nome da empresa deve ser configurada em base64 no arquivo .env:

APP_PASSWORD_BASE64=<senhabase64>
APP_COMPANY_NAME=Nome da Empresa
DATABASE_URL=postgres://usuario:senha@localhost:5432/fluxy
# DATABASE_SSL=true

cd fluxy
npm install
docker compose up -d postgres
npm run dev

Depois abra:

• Frontend: http://localhost:5173
• API: http://localhost:3333/api/health

Para parar o banco local:

docker compose down

Para rodar tudo via Docker, incluindo o build e o servidor Node da aplicacao:

docker compose up --build

Depois abra http://localhost:3333.

Para gerar a versao de producao:

npm run build
npm start

Deploy e variaveis de ambiente

Este projeto e full-stack: o frontend em dist/ depende da API Express em server/index.js. Um deploy padrao da Netlify apenas com npm run build e publish em dist publica somente o frontend, entao rotas como /api/login e /api/config nao rodam e as variaveis APP_PASSWORD_BASE64 e APP_COMPANY_NAME nao chegam ao backend.

Para hospedar sem adaptar o codigo, use uma plataforma que rode Node.js persistente, como Render, Railway, Fly.io ou um VPS, e configure no ambiente do servidor:

APP_PASSWORD_BASE64=<senhabase64>
APP_COMPANY_NAME=Nome da Empresa
DATABASE_URL=postgres://usuario:senha@host:5432/database
NODE_ENV=production

Na Netlify, sera necessario converter a API para Netlify Functions ou usar outro runtime Node para a API. Caso contrario, o site ate abre, mas login/configuracao/dados falham porque a API nao existe no deploy estatico.

Funcionalidades

• Cadastro de receitas e despesas com valor, data, descricao e categoria.
• Edicao e exclusao diretamente na lista.
• Filtros por periodo: dia, semana e mes.
• Filtros por tipo: todos, receitas ou despesas.
• Dashboard inicial com total de receitas, total de despesas e saldo.
• Grafico simples de barras com receitas versus despesas por dia.
• Tela de categorias para cadastrar novas categorias de receitas e despesas.
• Tela de login com senha unica, sem usuarios.
• Exportacao CSV dos lancamentos filtrados.

Dados mockados

Na primeira execucao, o schema do PostgreSQL e criado no banco configurado em DATABASE_URL com exemplos como:

• Vendas no balcao
• Compra de insumos
• Contrato mensal
• Campanha local
• Aluguel da loja

Para resetar os dados, limpe as tabelas entries, categories e suppliers no PostgreSQL ou recrie o banco configurado em DATABASE_URL.