Manual do Sistema
Guia passo a passo de cada fluxo do sistema.
Introdução
O Controle Financeiro é um sistema para organizar contas a pagar e a receber, contas bancárias, categorias e cartões de crédito, com foco na fatura do cartão por mês de fechamento. Cada usuário gerencia o próprio financeiro; administradores também controlam novos acessos e os cadastros globais (grupos, categorias e contas). Este manual descreve todos os fluxos, do cadastro ao dia a dia.
1. Criar conta e entrar
Na tela inicial, clique em Comece agora ou acesse /signup. Informe nome, e-mail e uma senha (mínimo de 6 caracteres). Novas contas entram como Usuário.
Ativação por e-mail
A conta é criada inativa. Você recebe um e-mail com o link de ativação e uma tela de confirmação (/signup/success) é exibida. Abra o link para ativar em /activate-account. Se o e-mail não chegar, use Reenviar ativação em /activate/resend (ou o link na tela de login).
Entrar
Use o e-mail e a senha na página de login. Depois de autenticado, a barra superior dá acesso às áreas do sistema; o menu do usuário (canto direito) traz Meu Perfil, Ajuda, Sobre e Sair.
2. Esqueci a senha
- 1Na tela de login, clique em “Esqueci a senha”.
- 2Informe o e-mail cadastrado — você receberá um link de redefinição (válido por 1 hora).
- 3Abra o link, digite a nova senha (mínimo de 8 caracteres) e salve.
- 4Você entra automaticamente; use a nova senha nas próximas vezes.
Redefinir a senha também ativa a conta, caso ela ainda estivesse pendente de ativação.
3. Dashboard
É a visão geral do mês corrente:
- Saldo Total — soma do saldo de todas as contas (saldo inicial + ajustes + receitas pagas − despesas pagas).
- A Pagar / A Receber — pendentes do mês corrente apenas das contas marcadas como principal, incluindo a fatura prevista dos cartões.
Abaixo aparecem suas contas, os cartões cadastrados e as próximas transações. As recorrências do mês são geradas automaticamente ao abrir a tela.
4. Transações
Onde lançar despesas e receitas com vencimento, categoria e conta (ou cartão).
Resumo do mês
No topo da tela há um quadro com saldo anterior, receitas e despesas (realizadas e previstas) e saldo atual/previsto. Use o seletor de conta no resumo para analisar uma conta específica — o padrão é a conta principal. A despesa prevista inclui a fatura em aberto dos cartões, sem dupla contagem.
Criar uma transação
- 1No menu Transações, clique em “Nova transação”.
- 2Escolha o tipo (Despesa/Receita), descrição, valor e vencimento.
- 3Selecione a conta (o saldo é baixado na data de pagamento) ou um cartão de crédito (vira lançamento na fatura).
- 4Atribua categoria, adicione observações se quiser e clique em “Salvar transação”.
Valores usam o campo com máscara em Reais (R$). Para compras no cartão, o rótulo do vencimento passa a ser Data da compra e o vencimento é calculado pela fatura.
Recorrência e parcelamento
Ao marcar recorrente, escolha o intervalo (semanal, mensal ou anual) e a data final — o sistema gera as parcelas automaticamente (horizonte de 365 dias). Compras parceladas no cartão criam uma parcela por fatura, com o rótulo Parcela X de Y na descrição.
Pagar / reverter / editar / excluir
Na linha da transação, use Pagar (debita na conta selecionada) e Pendente para desfazer. Editar abre o formulário completo, com Excluir no rodapé. Em parcelas/recorrentes, escolha se remove apenas o lançamento, esta e as futuras ou toda a série.
Observações (notas)
Transações com observação exibem um ícone de nota na tabela; passe o mouse para ler o texto.
Transferência entre contas
Use Transações → Transferência para movimentar valores entre contas: saída na origem, entrada no destino, sem impacto nos totais do mês. As duas pernas ficam ligadas — editar, pagar ou excluir atualiza a outra automaticamente.
Filtros, ordenação e mês
A barra acima da tabela navega por mês (setas de ano + seletor de 12 meses) e filtra por status (Pendente/Pago) e tipo. Clique nos cabeçalhos para ordenar por data, descrição ou valor.
Colunas configuráveis
Arraste os cabeçalhos para reordenar as colunas e use o botão Colunas para mostrar/ocultar cada uma. A preferência fica salva para o seu usuário.
5. Contas
O cadastro de contas é feito por administradores. Cada conta tem nome, saldo inicial, ícone automático e pode ser marcada como principal (usada nos totais de A Pagar/A Receber).
- 1No menu Contas, clique em “Nova conta”.
- 2Informe nome e saldo inicial; marque como conta principal se desejar.
- 3Transações lançadas nessa conta atualizam o saldo automaticamente (fonte única de cálculo).
- 4Ajustes finos de saldo usam o campo de ajuste da conta, refletido no dashboard e no resumo do mês.
6. Categorias e grupos
Grupos organizam categorias por tipo (receita ou despesa). Crie grupos em /groups e categorias dentro deles em /categories. As categorias usam o grupo para agrupar lançamentos.
As categorias recebem ícone automático conforme o nome. O cadastro é restrito a administradores, e um grupo só pode ser excluído quando não possui categorias vinculadas.
7. Cartão de crédito
- 1No menu Cartão de Crédito, crie o cartão informando nome, cor, limite, final e os dias de fechamento e vencimento da fatura.
- 2Compras com pagamento em “Cartão” viram lançamentos da fatura; parceladas criam uma parcela por mês.
- 3Compare os lançamentos do mês e use o resumo da fatura para ver Fatura, Pago e Em aberto.
- 4Pague pela fatura do mês, escolhendo a conta e o valor.
Fechamento, vencimento e mês da fatura
A regra de corte é: compra até o dia do fechamento entra na fatura do mesmo mês; depois do fechamento, entra na fatura do mês seguinte. O vencimento é o dia configurado no mês correspondente. A tabela mostra a Data da compra (coluna opcional) e o Vencimento (= data da fatura).
Fatura do mês
O tile do cartão mostra, para o mês selecionado no navegador: Fatura (total do mês), Pago e Em aberto. Pagamentos parciais deixam o saldo restante como um resíduo pendente, exibido com o status Parcial.
Pagar a fatura (total ou parcial)
No bloco Pagar fatura, escolha o cartão, a conta e o valor (vem preenchido com o em aberto do mês). Se pagar o total, os lançamentos do mês são quitados; se pagar parte, os pendentes ficam Parcial e a dívida restante vira um resíduo, cobrado na mesma fatura até ser pago.
Ações em lote do mês
Acima da tabela do cartão: Pagar mês, Pendente mês e Apagar mês agem sobre todos os lançamentos do mês exibido (com confirmação). Excluir o mês é útil quando uma fatura foi importada errada. Pagamentos de fatura não são afetados.
Gerir cartões
O botão Gerir cartões abre um modal para editar (cor, final, fechamento e vencimento — as faturas são recalculadas) ou excluir o cartão. A exclusão é bloqueada quando há lançamentos vinculados.
8. Importar fatura (CSV)
- 1Na tela do cartão, clique em “Importar fatura” e selecione o arquivo CSV exportado do banco.
- 2Confira o preview com as linhas lidas e as datas convertidas para o mês da fatura.
- 3Associe cada descrição do arquivo a uma categoria — o sistema sugere automaticamente pelo texto.
- 4Valide o cartão (pelo final), confirme e importe.
O cartão precisa ter o dia de fechamento configurado. A importação ignora lançamentos duplicados (mesma data, descrição e valor) e cria as parcelas quando o arquivo indicar parcelamento. O mapa de categorias por descrição fica salvo para as próximas importações.
9. Meu perfil
No menu do usuário (barra superior), Meu Perfil permite alterar nome e trocar a senha informando a atual. Seu papel (Usuário/Administrador) aparece na tela; administradores veem ainda o total de usuários.
10. Usuários — administração
Somente Administradores veem o item Usuários no menu do usuário (em /admin/usuarios):
- 1Criar usuário: nome, e-mail, senha inicial e papel (Usuário ou Administrador).
- 2Alterar papel: use o seletor na linha do usuário (não é possível se rebaixar).
- 3Excluir: remove permanentemente a conta e todos os dados financeiros do usuário.
Administradores também são os únicos que criam/editam/excluem grupos, categorias e contas.
11. E-mail e alertas
Em Configurações (menu do usuário, somente admin), o SMTP é configurado e testado: servidor, porta, segurança, e-mail, senha de aplicativo e remetente. Use Testar conexão para validar antes de salvar e receber um e-mail de teste (com a logo do sistema).
Lembrete de vencimento
Diariamente às 07h, o sistema envia um e-mail resumindo as despesas pendentes que vencem hoje ou já venceram, até serem pagas (um envio por dia). No Gmail, ative a verificação em duas etapas e crie uma senha de aplicativo em myaccount.google.com/apppasswords.
Ativação de novas contas
O mesmo SMTP é usado para enviar os links de ativação de conta e de redefinição de senha.
12. Dicas e privacidade
- Reordene colunas arrastando os cabeçalhos e oculte as que não usa no botão Colunas.
- Use o navegador de mês no topo para revisar faturas e resumos mês a mês.
- Seus dados ficam no seu servidor, sem anúncios e sem compartilhamento com terceiros.