All Finance

Lista lançamentos de um mês (mes/ano) ou de um período livre (de/ate), até 300, os mais antigos primeiro, com filtros opcionais: `texto` (descrição), `pessoa` (quem recebeu ou pagou), `forma` (pix, boleto, debito, ted, transferencia, cartao, investimento, pagamento, tarifa, salario, outros), `valor_min`/`valor_max`, `categoria_id`, `sem_categoria`, `tipo` (entrada/saida). Volta `totais` e `porCategoria` somados no banco sobre TODOS os lançamentos do filtro, sem transferência entre contas próprias e sem oculto (marcados `naoConta` na lista) — use ESSES números; NUNCA some a lista `linhas`. Se `truncado` for true, a lista é um recorte: `total_no_periodo` é o número real.

buscar_transacoes

Parcelas de cartão já lançadas pelo banco, mês a mês daqui para frente, por cartão, mais os parcelamentos em curso. Use para 'quanto tenho de parcela até dezembro', 'quanto ainda devo de parcelado'. Mês ausente = mês sem parcela.

calendario_parcelas

Cartões de crédito conectados: limite, disponível, valor A PAGAR da fatura em aberto, vencimento, última fatura fechada, o que já entrou no ciclo. `aPagar.fechado=true` = valor publicado pelo banco (pode afirmar); `false` = ESTIMATIVA (diga que é estimativa). Use para 'quanto está minha fatura', 'quando vence'.

listar_cartoes

Categorias visíveis do usuário (nome, tipo Entrada/Saída, bloco) e os blocos. Use para saber os nomes EXATOS antes de falar de uma categoria; nunca invente categoria que não está aqui.

listar_categorias

Data de HOJE em Brasília, mês/ano corrente, contas disponíveis (pf/pj) e primeiro nome do usuário. CHAME PRIMEIRO, antes de qualquer outra ferramenta: é daqui que saem `mes` e `ano` para 'esse mês', 'mês passado', 'ano que vem'.

contexto_atual

Gasto do mês dividido nos três baldes do método Cerbasi — Sonhos (o que se guarda para projetos), Burocracia (contas obrigatórias) e Qualidade de vida — com o que ficou fora (transferência, fatura, empréstimo) e a cobertura. Se houver categorias 'a confirmar', os percentuais ainda não são confiáveis: o usuário classifica no app.

gasto_por_balde

Planilhas de investimento de um ano: nome e saldo inicial.

listar_investimentos

Objetivos do usuário: 'acumular' (juntar um valor num prazo) ou 'padrao_de_vida' (verba mensal por um prazo). O quanto investir por mês / o capital equivalente já vêm calculados — não recalcule.

listar_objetivos

Orçado e realizado por categoria num mês, com totais de entradas e saídas. Use para 'quanto gastei em <categoria>', 'estourei o orçamento?', 'como está meu orçamento'. Compra no cartão conta no mês em que a FATURA é paga, não no mês da compra — o campo `criterio` explica.

realizado_por_categoria

Só o PLANO (valor projetado) por categoria num ano ou num mês — sem o realizado. Para comparar plano com gasto real, use realizado_por_categoria.

get_orcamento