v4.0.0

Changelog 📥

[4.0.0] — 27/07/2026

🇪🇸 Espanhol, mais bancos e categorias que não quebram ao renomear

Esta versão faz três coisas: ensina o Fluxo a falar espanhol, amplia bastante os bancos reconhecidos na importação e conserta um problema antigo de arquitetura que só aparecia quando você renomeava uma categoria.

O Fluxo passou a falar espanhol

Espanhol rioplatense de verdade (voseo: arrastrá, elegí, cargá) e vocabulário financeiro correto — a fatura do cartão é resumen, lançamento é movimiento, parcela é cuota. Junto com o texto muda a moeda, o formato de número e data, os nomes das categorias, o dicionário de categorização automática (o app não vai adivinhar "Ecogas" com um dicionário brasileiro) e
os perfis de banco preferidos na detecção.

Na v4.0 o idioma era escolhido num arquivo de configuração. Desde a v4.1 há um botão na tela.

Muito mais bancos reconhecidos

Antes, só o PDF do Mercado Pago era entendido de verdade; o resto caía num leitor genérico de CSV que funcionava "na sorte" do cabeçalho. Agora existe uma lista de perfis, e o Fluxo identifica o arquivo pelo conteúdo:

• Brasil: Nubank (extrato e fatura, que têm formatos diferentes), Itaú, Bradesco, Banco do Brasil, Inter, C6 e o Mercado Pago.
• Argentina: Mercado Pago, Galicia, Santander, BBVA, Brubank, Ualá e Naranja X.

**Cada perfil é honesto sobre o quanto se pode confiar nele.**Os conferidos contra um arquivo real estão marcados como confiança alta. Os montados a partir da documentação do formato só são aceitos quando o nome do banco aparece no arquivo — e, se nada casar, o Fluxo usa o leitor genérico em vez de arriscar. A regra que guiou tudo: em dado financeiro, errar calado é pior do que não
reconhecer.

Renomear categoria não bagunça mais nada

Até então o nome da categoria era também o identificador dela. Renomear "Renda" para "Salário" obrigava o Fluxo a reescrever o nome em todas as transações, regras e metas — e qualquer parte do programa que ainda esperasse "Renda" parava de funcionar em silêncio.

Agora cada categoria tem um identificador interno que nunca muda:

• renomear é instantâneo e não toca em nenhum lançamento;
• as categorias que você criou nunca são traduzidas — o nome que você escolheu
  é o que fica;
• renomear uma categoria padrão faz o Fluxo entender que a sua escolha vale mais
  que a tradução dele.

A conversão do banco é automática, numa única operação, depois de salvar uma cópia em data/backups/fluxo-pre-v4-*.db. Se algo der errado, nada é alterado.

A conversão reconhece os nomes originais do Fluxo. Se você renomeou uma categoria padrão antes de atualizar, ela vira categoria sua — funciona, mas o app perde o significado dela. Para corrigir:

node scripts/remapear-categoria.mjs --listar        # ver o que tem
node scripts/remapear-categoria.mjs salario income  # ensaio, não grava
node scripts/remapear-categoria.mjs salario income --aplicar

Correções

Transferência para você mesmo não é despesa. Dinheiro que você manda da sua conta para outra conta sua era contado como gasto e inflava a projeção do mês.

Parcelas em extratos em espanhol. O rótulo era procurado só em português; num extrato em espanhol ("cuota 2/6"), as parcelas futuras não eram detectadas, o ciclo da fatura saía errado e o agrupamento de regras falhava — sem dar erro.

Data de geração do PDF virando transação. O rodapé do extrato traz a data em que o arquivo foi gerado, no mesmo formato de uma data de lançamento. O leitor confundia as duas e engolia a transação seguinte, gravando a data de emissão e o endereço da empresa no lugar da data e do estabelecimento reais. O mais desconfortável: as somas continuavam corretas, porque o valor estava certo — o erro passava por qualquer conferência de total.

---

Próxima versão — planejado

Mais bancos, à medida que houver extratos reais para conferir. A estrutura já aceita: adicionar banco é acrescentar um perfil declarativo, não escrever código de leitura. O que falta é arquivo — a prioridade é fatura de cartão, que é o que o app entende menos e onde estão as parcelas.