Fluxy

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: SQLite com better-sqlite3
• Extras: exportacao CSV e dados mockados no primeiro start

Estrutura

fluxy/
  server/
    index.js          API HTTP e rotas de lancamentos
    storage.js        inicializacao do SQLite e seed mockado
    data/             banco local gerado automaticamente
  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

cd fluxy
npm install
npm run dev

Depois abra:

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

A senha padrao deve ser configurada em base64 no arquivo .env:

APP_PASSWORD_BASE64=<senhabase64>

Para gerar a versao de producao:

npm run build
npm start

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 SQLite e criado em server/data/finance.sqlite com exemplos como:

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

Para resetar os dados, pare o servidor e remova o arquivo server/data/finance.sqlite.