Pular para o conteúdo

Sobre o FinanCerto

O que é o sistema, como ele é construído e a quem se devem os créditos.

Última revisão em .

O FinanCerto é um sistema web para registrar receitas e despesas, organizar por categoria, acompanhar contas, cartões, orçamentos, metas e investimentos, e ver em gráficos para onde o dinheiro está indo.

Versão 2.0.0.

1. Quem opera esta instalação

Esta instalação ainda não declarou um responsável. O FinanCerto é um sistema que cada pessoa hospeda por conta própria, então quem responde pelos dados é quem subiu esta cópia — e essa informação não foi preenchida.

Se você administra este sistema, defina OPERADOR_NOME e OPERADOR_EMAIL no arquivo .env e reinicie o serviço. Enquanto isso não acontecer, não há canal declarado para exercer os direitos descritos abaixo.

2. A ideia por trás

Quase todo aplicativo de finanças pede que você aprenda o vocabulário dele antes de servir para alguma coisa. Este parte do contrário: a primeira tela responde “sobrou ou faltou dinheiro este mês?” em uma frase e um número. O detalhe vem abaixo, para quem quiser.

A mesma escolha aparece no resto: letra que cresce sem quebrar o layout, alto contraste, modo simples, alvos de toque grandes. Um sistema de dinheiro que só funciona para quem tem vista boa e intimidade com telas exclui exatamente quem mais precisa organizar o orçamento.

3. Como é construído

São dois serviços, que podem rodar na mesma máquina ou em máquinas diferentes:

  • A interface — Next.js com React, renderizada no servidor. É ela que fala com o seu navegador.
  • A API — um serviço em Node.js, sem estado de sessão, que é o único a falar com o banco. Toda regra de negócio mora aqui.
  • O banco — PostgreSQL. Valores em centavos inteiros, porque dinheiro em ponto flutuante acumula erro; datas como texto, porque assim ordenam sem fuso horário para atrapalhar.

A separação tem uma consequência que vale dizer: o navegador nunca fala com o banco nem com a API. Quem busca os dados é o servidor da interface, com o token da sua sessão. Nada do seu extrato passa por JavaScript de página.

4. Onde ficam os seus dados

No banco de quem hospeda esta instalação — na mesma máquina da API, na mesma rede privada, ou num serviço de banco de dados contratado à parte por quem administra. O código do sistema em si não faz análise externa nem tem rastreador nenhum; não faz uma única chamada de rede para fora além do banco que a própria instalação configura. O que muda de uma instalação para outra é decisão de quem hospeda, e é isso que a Política de Privacidade desta cópia declara.

5. Créditos

  • Inter, de Rasmus Andersson e do projeto Inter, sob a SIL Open Font License 1.1. É a fonte de todo o sistema, servida pela própria instalação — nenhum arquivo vem de servidor de terceiro. A licença completa acompanha os arquivos da fonte.
  • Next.js e React para a interface; PostgreSQL para o banco; bcrypt para as senhas; jose para assinar as sessões; Zod para validar toda entrada; Serwist para o aplicativo instalável; Tailwind CSS para o estilo.
  • Os ícones da interface são desenhados neste projeto, na mesma grade e com o mesmo traço — não vêm de biblioteca externa.

6. Instalar como aplicativo

O FinanCerto pode ser instalado na tela inicial do celular ou do computador e abrir em janela própria, sem barra de endereço. No Android e no computador, o navegador oferece “instalar” na barra de endereço; no iPhone, o caminho é Compartilhar e depois Adicionar à Tela de Início.

Instalado, ele guarda no aparelho apenas código, fontes e ícones — nunca o conteúdo da sua conta. Sem rede, ele abre e explica que está sem conexão, em vez de mostrar a tela de erro do navegador.

7. Os outros documentos