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

Uma app de orçamento mostra quanto planeou gastar em cada categoria, quanto gastou efetivamente e o que ainda resta. Para a construir 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 método de orçamento e a forma como as transações chegam à app — introduzidas à mão, importadas do ficheiro CSV do banco, ou obtidas através de uma ligação bancária. Comece pela importação de CSV; dá-lhe a maior parte do valor com uma fração do trabalho e do risco.

Este guia trata do software. Não é aconselhamento financeiro.

Escolha primeiro um método de orçamento

O método define os ecrãs e as contas, por isso escolha-o antes de pedir.

Os limites por categoria são os mais fáceis de construir e de perceber. A base zero e o método de envelopes exigem lógica de transição: o que acontece ao dinheiro que sobra numa categoria no fim do mês, e o que acontece quando uma categoria é ultrapassada.

O que uma app de orçamento precisa

Páginas

• Este mês — cada categoria com orçado, gasto e restante; total de rendimentos e total gasto.
• Transações — uma lista com data, beneficiário, valor, categoria e conta; filtros e pesquisa; recategorização rápida.
• Importação — carregar um CSV, mapear as colunas, pré-visualizar e confirmar.
• Configuração do orçamento — categorias, grupos (Habitação, Alimentação, Transportes) e valores mensais.
• Contas — conta à ordem, poupança, cartão de crédito, dinheiro, com saldos.
• Relatórios — despesas por categoria ao longo do tempo, rendimentos versus despesas, 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, beneficiário, valor, categoria, nota, ID de importação, conciliada.
• Regras — “o beneficiário contém TESCO → Supermercado”, aplicadas na importação.
• Transferências — um par de transações ligadas entre duas das suas contas, para que mover dinheiro para a poupança não conte como despesa.

Permissões

Um orçamento pessoal tem um único proprietário. Um orçamento familiar precisa de um agregado partilhado que seja dono dos dados, com cada parceiro a iniciar sessão separadamente. Em qualquer dos casos, ninguém fora desse agregado pode ver uma linha que seja. Teste iniciando sessão com um segundo utilizador sem qualquer ligação.

Tratar bem o dinheiro

As apps financeiras falham em pequenas falhas embaraçosas. Inclua estas regras no seu pedido:

• Guarde os valores como inteiros da menor unidade (cêntimos, pence) mais um código de moeda. Os números de vírgula flutuante produzem totais como 0.30000000000000004.
• Os sinais são consistentes. As despesas são negativas e os rendimentos positivos, ou use um campo de direção separado — mas nunca os dois.
• As transferências não são despesas. Ligue os dois lados de uma transferência e exclua-os dos totais por categoria.
• Os reembolsos reduzem a despesa na categoria original, em vez de contarem como rendimento.
• Os meses seguem o fuso horário do utilizador, 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. A multimoeda exige taxas de câmbio e uma decisão sobre qual taxa usar.

Como as transações entram

Com a importação de CSV, evite duplicados: 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 chegue já categorizada.

Se acrescentar mais tarde uma ligação bancária, as chaves de API do fornecedor têm de ficar no servidor, e nunca deve pedir aos utilizadores as palavras-passe do banco. Veja como manter as chaves de API seguras.

Exemplo de primeiro pedido

Crie uma app web de orçamento familiar para duas pessoas. Usamos limites por categoria: as categorias estão agrupadas (Habitação, Alimentação, Transportes, Lazer, Poupança), cada uma com um valor mensal de orçamento. O ecrã inicial mostra este mês: orçado, gasto e restante por categoria com barras de progresso, além do total de rendimentos e do total gasto. Temos várias contas (conta à ordem, poupança, cartão de crédito). As transações têm data, beneficiário, valor, conta, categoria e nota. Guarde os valores como cêntimos inteiros com um código de moeda. As transferências entre as nossas contas são pares ligados e não contam como despesa; os reembolsos reduzem a despesa na sua categoria. Acrescente importação de CSV: carregar, mapear as colunas uma vez por banco e lembrar esse mapeamento, pré-visualizar, ignorar duplicados e aplicar regras de beneficiário como “contém TESCO → Supermercado”. Relatórios: despesas por categoria por mês e rendimentos versus despesas nos últimos 12 meses. Cada um de nós inicia sessão com email e palavra-passe e partilhamos um agregado; ninguém mais pode ver os nossos dados. Com base de dados, pensado para telemóvel.

Passos de construção

1. Categorias e vista deste mês com dados de exemplo. Verifique as contas à mão num conjunto pequeno.
2. Lista de transações e categorização rápida. Mudar uma categoria deve ser um único toque.
3. Importação de CSV. Experimente exportações reais do seu banco. Importe o mesmo ficheiro duas vezes e confirme que nada se duplica.
4. Regras. Acrescente os dez beneficiários que cobrem a maior parte das suas despesas.
5. Transferências e reembolsos. Teste ambos e verifique os totais por categoria.
6. Início de sessão e agregado. Veja como acrescentar início de sessão à sua app.
7. Relatórios. Quando já houver alguns meses de dados.
8. Revisão de segurança. Percorra a lista de verificação de segurança para apps criadas com IA antes de confiar nela com dados reais.

Erros comuns

• Dinheiro em vírgula flutuante. Use cêntimos inteiros.
• Contar transferências como despesas. As suas contribuições para a poupança vão parecer excesso de gastos.
• Importações duplicadas. Cada reimportação duplica as despesas sem uma verificação de duplicados.
• Começar pelas ligações bancárias. Muito trabalho e risco antes de saber se a app é útil.
• Guardar palavras-passe do banco ou números de cartão. Nunca.
• Não haver exportação. As pessoas querem os seus dados numa folha de cálculo; acrescente uma exportação em CSV.
• Categorias em excesso. Vinte é suficiente; trezentas é uma folha de cálculo.

Quando uma app de orçamento pronta é a melhor escolha

As apps de orçamento já estabelecidas oferecem ligações bancárias seguras com muitas instituições, apps móveis e anos de tratamento de casos especiais. Se a sincronização bancária automática é o mais importante para si, uma delas é a escolha prática.

Crie a sua própria quando o seu método não encaixa no modelo delas, quando não quer que os seus dados financeiros sejam guardados por outra empresa, quando uma importação de CSV algumas vezes por mês basta, ou quando está a construir 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 vive hoje numa folha de cálculo, como transformar uma folha de cálculo numa app explica a mudança. Para acompanhar despesas de um negócio ou de uma equipa em vez de um orçamento familiar, veja como criar um registo de despesas.

Criar com a Mythex

A Mythex pode construir esta app de orçamento a partir do pedido acima: descreve-a no chat, verifica-a na pré-visualização em tempo real e publica-a. Acrescenta uma base de dados Postgres dedicada quando a app precisar dela. O início de sessão é com a solução que você traz, e o mesmo vale para qualquer fornecedor de dados bancários: guarda as chaves como segredos do projeto e o agente integra-as no servidor. A Mythex não tem ligações bancárias incluídas. Como ponto de partida, o modelo de painel de orçamento assenta na importação de CSV e em relatórios de variação.

Perguntas