Como criar um app de orçamento: categorias, transações, importações e relatórios

Um app de orçamento mostra quanto você planejou gastar em cada categoria, quanto gastou de fato e o que sobrou. Para criar um, você precisa de contas, categorias, um orçamento mensal por categoria, transações e alguns relatórios claros. As duas decisões que moldam tudo são o seu método de orçamento e como as transações entram no app — digitadas, importadas do arquivo CSV do banco ou puxadas por uma conexão bancária. Comece com a importação de CSV; ela entrega a maior parte do valor com uma fração do trabalho e do risco.

Este guia trata do software. Não é uma consultoria financeira.

Escolha primeiro um método de orçamento

O seu método define as telas e os cálculos, então escolha-o antes de escrever o prompt.

Os limites por categoria são os mais fáceis de construir e entender. Orçamento base zero e por envelopes exigem lógica de acúmulo: o que acontece com o dinheiro que sobra em uma categoria no fim do mês, e o que acontece quando uma categoria estoura.

O que um app de orçamento precisa

Páginas

• Este mês — cada categoria com o orçado, o gasto e o restante; renda total e gasto total.
• Transações — uma lista com data, favorecido, valor, categoria e conta; filtros e busca; recategorização rápida.
• Importação — envie um CSV, mapeie as colunas, visualize e confirme.
• Configuração do orçamento — categorias, grupos (Moradia, Alimentação, Transporte) e valores por mês.
• Contas — conta corrente, poupança, cartão de crédito, dinheiro vivo, com saldos.
• Relatórios — gastos por categoria ao longo do tempo, renda versus gastos, comparação mês a mês. Veja como criar um painel para escolher os gráficos.

Dados

• Contas — nome, tipo, moeda, saldo inicial.
• Categorias — nome, grupo, ordem, arquivada.
• Orçamentos — categoria, mês, valor.
• Transações — conta, data, favorecido, valor, categoria, observação, ID de importação, conciliada.
• Regras — "favorecido contém TESCO → Supermercado", aplicadas na importação.
• Transferências — um par de transações vinculadas entre duas contas suas, para que mover dinheiro para a poupança não conte como gasto.

Permissões

Um orçamento pessoal tem um único dono. Um orçamento familiar precisa de uma família compartilhada que seja dona dos dados, com cada parceiro fazendo login separadamente. Em qualquer caso, ninguém fora dessa família pode ver nenhuma linha. Teste entrando com um segundo usuário, sem nenhuma relação com a família.

Fazendo o dinheiro certo

Apps financeiros falham de formas pequenas e constrangedoras. Coloque estas regras no seu prompt:

• Guarde os valores como inteiros da menor unidade (centavos) mais um código de moeda. Números de ponto flutuante produzem totais como 0,30000000000000004.
• Os sinais são consistentes. Gasto é negativo, renda é positiva, ou use um campo separado de direção — mas nunca os dois.
• Transferências não são gastos. Vincule os dois lados de uma transferência e exclua-os dos totais por categoria.
• Reembolsos reduzem o gasto na categoria original, em vez de contar como renda.
• Os meses seguem o fuso horário do usuário, para que uma transação às 23h do dia 31 não caia no mês seguinte.
• Uma moeda por orçamento na primeira versão. Várias moedas exigem taxas de câmbio e uma decisão sobre qual taxa usar.

Como colocar as transações no app

Na importação de CSV, evite duplicatas: guarde um ID de importação ou uma impressão digital da data, do valor e da descrição, e ignore as linhas já vistas. Aplique regras de categorização na importação para que a maioria das linhas já chegue categorizada.

Se você acrescentar uma conexão bancária mais tarde, as chaves de API do provedor devem ficar no servidor, e você nunca deve pedir aos usuários as senhas do banco. Veja como manter suas chaves de API seguras.

Exemplo de primeiro prompt

Crie um app web de orçamento familiar para duas pessoas. Usamos limites por categoria: as categorias são agrupadas (Moradia, Alimentação, Transporte, Lazer, Poupança), cada uma com um valor mensal planejado. A tela inicial mostra este mês: orçado, gasto e restante por categoria com barras de progresso, além da renda total e do gasto total. Temos várias contas (corrente, poupança, cartão de crédito). As transações têm data, favorecido, valor, conta, categoria e observação. Guarde os valores como centavos inteiros com um código de moeda. Transferências entre as nossas contas são pares vinculados e não contam como gasto; reembolsos reduzem o gasto na categoria deles. Adicione importação de CSV: enviar, mapear as colunas uma vez por banco e lembrar o mapeamento, visualizar, ignorar duplicatas e aplicar regras de favorecido como "contém TESCO → Supermercado". Relatórios: gasto por categoria por mês e renda versus gastos dos últimos 12 meses. Cada um de nós entra com e-mail e senha e compartilhamos uma família; ninguém mais pode ver os nossos dados. Com banco de dados, pensado para celular.

Etapas de construção

1. Categorias e a visão do mês com dados de exemplo. Confira os cálculos à mão em um conjunto pequeno.
2. Lista de transações e categorização rápida. Faça com que mudar uma categoria seja um único toque.
3. Importação de CSV. Teste exportações reais do seu banco. Importe o mesmo arquivo duas vezes e confirme que nada duplica.
4. Regras. Adicione os dez favorecidos que cobrem a maior parte dos seus gastos.
5. Transferências e reembolsos. Teste os dois e confira os totais por categoria.
6. Login e família. Veja como adicionar login ao seu app.
7. Relatórios. Quando já houver alguns meses de dados.
8. Revisão de segurança. Passe pela lista de verificação de segurança para apps criados com IA antes de confiar nele com dados reais.

Erros comuns

• Dinheiro em ponto flutuante. Use centavos inteiros.
• Contar transferências como gasto. Seus aportes na poupança vão parecer estouro de orçamento.
• Importações duplicadas. Cada reimportação dobra os seus gastos sem uma checagem de duplicatas.
• Começar pelas conexões bancárias. Muito trabalho e risco antes de saber se o app é útil.
• Guardar senhas bancárias ou números de cartão. Nunca.
• Sem exportação. As pessoas querem os dados em uma planilha; adicione uma exportação em CSV.
• Categorias demais. Vinte já é suficiente; trezentas é uma planilha.

Quando um app de orçamento pronto é melhor

Apps de orçamento consolidados oferecem conexões bancárias seguras com muitas instituições, apps para celular e anos de tratamento de casos extremos. Se a sincronização bancária automática é o que mais importa para você, um deles é a escolha prática.

Crie o seu quando o seu método não couber no modelo deles, quando você não quiser que os seus dados financeiros fiquem com outra empresa, quando algumas importações de CSV por mês forem suficientes, ou quando estiver criando uma ferramenta de orçamento para um grupo específico — o tesoureiro de um clube, uma pequena instituição de caridade, um programa de coaching. Se o seu orçamento hoje vive em uma planilha, como transformar uma planilha em app explica a mudança. Para acompanhar gastos de negócio ou de equipe, em vez de um orçamento familiar, veja como criar um controle de despesas.

Criando com o Mythex

O Mythex pode criar este app de orçamento a partir do prompt acima: você descreve no chat, confere na pré-visualização ao vivo e publica. Ele adiciona um banco de dados Postgres dedicado, a base de dados, quando o app precisa. O login é do tipo traga o seu próprio, e o mesmo vale para qualquer provedor de dados bancários: você guardaria as chaves dele como segredos do projeto e o agente as integra no servidor. O Mythex não tem conexões bancárias integradas. Para um ponto de partida, o modelo de painel de orçamento é construído em torno da importação de CSV e dos relatórios de variação.

Perguntas