ERP Casa Fuerte
Sistema de gestão financeira, operacional e administrativa. Este manual guia você pelo uso diário do sistema de forma clara e prática.
O ERP Casa Fuerte centraliza toda a operação financeira, administrativa e operacional em um único sistema seguro e acessível pelo navegador. Ele substitui planilhas e controles manuais, garantindo rastreabilidade completa de cada movimentação.
Módulos disponíveis
Regras fundamentais do sistema
- Toda movimentação financeira é registrada em Transações
- Toda transação precisa de uma categoria
- Transações podem ser ✔ Pago ou ⏳ Pendente
- Relatórios consideram apenas transações marcadas como Pago
- Cafeteria e Bazar são centros de custo separados do financeiro geral
- Comprovantes financeiros e fotos de funcionários ficam em armazenamento privado
O acesso ao sistema é feito pela tela de login em /login.
- Abra o endereço do sistema no seu navegador
- Informe seu e-mail no campo correspondente
- Informe sua senha
- Clique em Entrar
- Em caso de sucesso, o sistema abre o painel inicial em /app
Se você esqueceu a senha, use o fluxo de recuperação disponível na própria tela de login.
- Na tela de login, clique em "Esqueceu?"
- Informe o seu e-mail cadastrado
- Aguarde o e-mail de recuperação chegar na sua caixa de entrada
- Abra o link recebido no e-mail
- Defina a nova senha na tela /update-password
- Após definir, faça login novamente com a nova senha
Quando um Admin cria um novo usuário no sistema, o acesso é concedido por convite.
- O Admin cria o usuário em /app/settings/users
- O sistema envia automaticamente um e-mail de convite para o endereço cadastrado
- O novo usuário abre o link recebido
- Define sua senha de acesso pelo fluxo de primeiro acesso
- Depois disso, pode fazer login normalmente com e-mail e senha
O ERP possui 4 perfis operacionais. O acesso de cada usuário é definido pelo seu perfil e protegido tanto na interface quanto no banco de dados.
- Acesso total ao ERP
- Gerencia usuários
- Ajusta categorias e métodos
- Exclui transações gerais
- Acessa todos os módulos
- Acesso financeiro amplo
- Cria, edita e exclui transações
- Gerencia funcionários e veículos
- Acessa relatórios
- Não administra usuários
- Opera a Cafeteria
- Consulta fornecedores
- Não acessa funcionários
- Não exclui transações
- Não vê cadastro de membros
- Consulta dashboards
- Consulta transações
- Consulta relatórios
- Consulta cadastros visíveis
- Não realiza alterações
Tabela de permissões por módulo
| Módulo / Ação | Admin | Financeiro | Op. Cafeteria | Leitura |
|---|---|---|---|---|
| Transações — criar / editar | ✔ Sim | ✔ Sim | ✘ Não | ✘ Não |
| Transações — excluir | ✔ Sim | ✔ Sim | ✘ Não | ✘ Não |
| Cafeteria — registrar venda/compra | ✔ Sim | ✔ Sim | ✔ Sim | ✘ Não |
| Bazar — registrar venda/saída | ✔ Sim | ✔ Sim | ✘ Não | ✘ Não |
| Funcionários — criar / editar | ✔ Sim | ✔ Sim | ✘ Não | ✘ Não |
| Funcionários — consultar | ✔ Sim | ✔ Sim | ✘ Não | ✔ Sim |
| Veículos — criar / editar | ✔ Sim | ✔ Sim | ✘ Não | ✘ Não |
| Membros — criar / editar | ✔ Sim | ✔ Sim | ✘ Não | ✘ Não |
| Membros — consultar | ✔ Sim | ✔ Sim | ✘ Não | ✔ Sim |
| Fornecedores — criar / editar | ✔ Sim | ✔ Sim | ✘ Não | ✘ Não |
| Fornecedores — consultar | ✔ Sim | ✔ Sim | ✔ Sim | ✔ Sim |
| Relatórios — visualizar / exportar | ✔ Sim | ✔ Sim | ✘ Não | ✔ Sim |
| Categorias e Métodos — criar/editar | ✔ Sim | ✔ Sim | ✘ Não | ✘ Não |
| Administração de Usuários | ✔ Sim | ✘ Não | ✘ Não | ✘ Não |
A tela inicial /app é o ponto de entrada após o login. Ela apresenta um resumo rápido do estado financeiro atual.
Ações rápidas disponíveis
Na tela inicial você encontra atalhos diretos para as áreas mais usadas:
- Nova Transação — abre o formulário de lançamento financeiro
- Cafeteria — acessa o módulo de caixa da Cafeteria
- Bazar — acessa o módulo do Bazar
- Funcionários — acessa o cadastro de funcionários
O dashboard mensal em /app/dashboard oferece uma visão financeira detalhada com filtro por mês.
Como usar
- Acesse /app/dashboard
- Use o filtro de mês para selecionar o período desejado
- Consulte os KPIs no topo da página
- Role para ver o gráfico de resumo mensal
- Verifique a tabela de despesas pendentes para identificar compromissos em aberto
O módulo de transações em /app/transactions é o coração financeiro do sistema. Toda entrada de dinheiro ou pagamento realizado passa por aqui.
Como registrar uma transação
- Acesse /app/transactions e clique em Nova Transação
- Selecione o tipo: Entrada ou Saída
- Escolha a categoria (deve combinar com o tipo escolhido)
- Informe a contraparte conforme as regras do contexto
- Selecione o método de pagamento
- Informe o valor (positivo) e a data
- Escolha o status: Pago ou Pendente
- Opcionalmente, adicione uma descrição e um comprovante
- Clique em Salvar
Regras de contraparte por tipo de transação
| Categoria | Contraparte permitida |
|---|---|
| Dízimos | Membro ou Dizimista Anônimo |
| Ofertas e Doações | Membro ou entrada anônima |
| Venda Cafeteria/Bazar | Cliente Consumidor ou Membro |
| Despesas gerais | Fornecedor ou vazio (sem contraparte) |
| Despesas de funcionário | Fornecedor ou vazio |
| Despesas de veículo | Fornecedor ou vazio |
Status das transações
Entra nos relatórios e no saldo consolidado.
Não entra nos relatórios. Aparece como pendência.
Comprovantes
Você pode anexar um comprovante a qualquer transação financeira. Formatos aceitos:
Limite máximo: 5 MB por arquivo.
Quando um comprovante é anexado, o card da transação exibe o link "Comprovante". O arquivo fica em armazenamento privado e só pode ser acessado por usuários autenticados.
Filtrando e consultando transações
A lista de transações em /app/transactions suporta os seguintes filtros:
Excluindo uma transação
- Localize a transação em /app/transactions
- Clique em Excluir na transação desejada
- Confirme a ação na caixa de diálogo
- Aguarde a mensagem de sucesso ou erro
O módulo da Cafeteria em /app/cafeteria funciona como um centro de custo independente. Todas as movimentações aqui registradas são separadas do financeiro geral.
Use este formulário para registrar uma venda realizada na Cafeteria.
- Selecione a categoria da venda
- Escolha a contraparte: Cliente Consumidor ou Membro
- Selecione o método de pagamento (se aplicável)
- Informe o valor e a data
- Adicione uma descrição, se desejar
- Anexe o comprovante, se existir
- Clique em Salvar
Use este formulário para registrar uma compra ou saída de caixa da Cafeteria.
- Selecione a categoria da saída
- Escolha o fornecedor responsável pela compra (ou deixe vazio)
- Selecione o método de pagamento
- Informe o valor e a data
- Adicione uma descrição e comprovante, se necessário
- Clique em Salvar
Na parte inferior da tela da Cafeteria, você encontra o histórico de transações do módulo, com filtros por tipo, status e categoria.
O módulo do Bazar em /app/bazar segue a mesma lógica da Cafeteria: é um centro de custo separado do financeiro geral, com vendas e saídas próprias.
- Registrar venda — use Cliente Consumidor ou Membro como contraparte
- Registrar saída — use fornecedor quando aplicável, ou deixe a contraparte vazia
- Visualizar o lucro do módulo (entradas − saídas)
- Consultar o histórico de transações do Bazar
O módulo de funcionários em /app/employees concentra o cadastro completo de colaboradores, seus dados pessoais, profissionais e o histórico de pagamentos vinculados.
Campos disponíveis no cadastro
Na tela de detalhe de cada funcionário, há um formulário dedicado para registrar pagamentos e despesas vinculadas a ele.
- Acesse /app/employees e abra a ficha do funcionário
- Role até a seção Registrar pagamento/despesa
- Preencha categoria, valor, data e status
- Se aplicável, selecione o fornecedor vinculado (ou deixe vazio)
- Clique em Salvar
Essas movimentações entram na tabela geral de transações com source_module = employee e aparecem no histórico daquele funcionário.
O cadastro é preservado. O funcionário deixa de aparecer em novos lançamentos.
Só disponível quando não existem transações vinculadas. A foto privada também é removida.
Cada funcionário pode ter uma foto de perfil privada vinculada ao seu cadastro.
Limite máximo: 2 MB por arquivo.
O módulo de veículos em /app/vehicles permite cadastrar a frota e registrar despesas como manutenção, combustível, seguro e outros custos operacionais.
Informações do cadastro
Tela de detalhe do veículo
- Atualizar nome e placa
- Registrar despesa vinculada ao veículo
- Ver total de despesas pagas
- Consultar o histórico financeiro completo do veículo
- Excluir o veículo (somente quando não existir histórico)
Como registrar uma despesa de veículo
- Acesse /app/vehicles e abra a ficha do veículo
- Clique em Registrar despesa
- Preencha categoria, valor, data e status
- Selecione o fornecedor (ou deixe vazio)
- Clique em Salvar
O módulo de membros em /app/members existe para que dízimos, ofertas, doações e outras entradas possam ser vinculadas a pessoas específicas da congregação — sem reutilizar o cadastro de fornecedores.
Campos do cadastro de membro
Para que serve o cadastro de membros
- Vincular dízimos — obrigatório informar Membro ou Dizimista Anônimo
- Vincular ofertas e doações — aceita Membro ou entrada anônima
- Registrar vendas da Cafeteria e Bazar para membros identificados
- Consultar o histórico financeiro de cada membro
O módulo de fornecedores em /app/suppliers centraliza o cadastro de empresas e pessoas que prestam serviços ou fornecem produtos para a organização.
Campos disponíveis na ficha
O sistema suporta 4 tipos de fornecedor:
Fornecedor Ativo vs. Inativo
- Ativo: aparece nos seletores de novos lançamentos
- Inativo: não aparece em novos lançamentos, mas permanece visível no histórico e em edições antigas onde já estava vinculado
Excluindo um fornecedor
- Abra a ficha do fornecedor em /app/suppliers/[id]
- Clique em Excluir
- Confirme a ação
O módulo de relatórios em /app/reports consolida as informações financeiras para prestação de contas, fechamento mensal e análise anual.
- Acesse /app/reports
- Selecione o mês desejado no filtro
- Selecione o ano
- Consulte o resumo de receitas, despesas e saldo
- Analise os totais por categoria
Casos de uso mais comuns
- Fechamento mensal
- Prestação de contas para liderança
- Comparação entre meses do ano
- Análise por categoria de despesa
O relatório anual consolida todos os meses do ano informado em uma única visão.
- Em /app/reports, selecione o ano desejado
- O sistema exibe a consolidação de todos os meses
- Compare os resultados mês a mês
- Exporte se necessário (veja aba Exportar)
As exportações usam exatamente a mesma base de dados exibida na tela — sem diferenças.
Ideal para impressão e compartilhamento formal.
Ideal para análises adicionais e cruzamento de dados.
- Aplique os filtros de mês/ano desejados
- Clique em Exportar PDF ou Exportar Excel
- Aguarde o download do arquivo
Em /app/settings/categories, Admin e Financeiro podem gerenciar as categorias usadas em todas as transações.
- Criar categoria de Entrada ou Saída
- Editar o nome de categorias existentes
- Excluir categorias sem histórico vinculado
- Consultar listas separadas por tipo
1. Categoria que já possui transações não pode ser excluída.
2. Categoria com histórico não pode trocar entre Entrada e Saída. Apenas renomear é permitido.
Em /app/settings/payment-methods, Admin e Financeiro gerenciam os métodos de pagamento disponíveis nos formulários.
Em /app/profile, qualquer usuário pode consultar suas informações de conta.
- Ver nome cadastrado
- Ver e-mail de acesso
- Ver o perfil atual (Admin, Financeiro, etc.)
- Consultar um resumo de permissões
- Sair da conta
Para dar acesso ao sistema a um novo colaborador:
- Acesse /app/settings/users
- Clique em Convidar usuário
- Informe o e-mail e o nome do novo usuário
- Selecione o perfil de acesso: Admin, Financeiro, Operador Cafeteria ou Leitura
- Clique em Enviar convite
- O sistema envia automaticamente o e-mail de convite com instruções para definição de senha
Para cada usuário cadastrado, o Admin pode realizar as seguintes ações:
- Editar nome — atualizar o nome de exibição
- Alterar perfil — mudar de Admin para Financeiro, por exemplo
- Bloquear usuário — impede o login sem excluir o cadastro
- Desbloquear usuário — reativa o acesso
- Reenviar convite — para usuários que ainda não aceitaram o convite
- Enviar redefinição de senha — para usuários ativos que precisam trocar a senha
Informações exibidas por usuário
| Situação | Mensagem comum | O que fazer |
|---|---|---|
| Login falhou | E-mail ou senha incorretos | Revisar as credenciais e tentar novamente |
| Campo obrigatório ausente | Revise os campos obrigatórios | Preencher todos os campos obrigatórios e reenviar |
| Categoria errada para o tipo | A categoria não pertence a este tipo | Escolher categoria de Entrada para entradas e de Saída para saídas |
| Comprovante com formato inválido | Envie em PDF, JPG, PNG ou WebP | Converter o arquivo para um formato aceito |
| Comprovante acima do limite | O comprovante deve ter no máximo 5 MB | Comprimir o arquivo e tentar novamente |
| Foto de funcionário inválida | Envie uma foto em JPG, PNG ou WebP | Usar uma imagem no formato suportado |
| Foto acima do limite | A foto deve ter no máximo 2 MB | Reduzir o tamanho da imagem |
| Sem permissão para excluir | Você não tem permissão para excluir | Solicitar a um Admin ou Financeiro |
| Tentativa de excluir veículo com histórico | Exclusão bloqueada | Não é possível excluir veículos com despesas vinculadas |
| Tentativa de excluir funcionário com histórico | Exclusão bloqueada | Usar a opção Inativar em vez de excluir |
| Categoria em uso não pode ser excluída | Categoria com histórico não pode ser removida | Desativar ou apenas renomear a categoria |
| Método de pagamento em uso | Não é possível excluir | Criar um novo método e parar de usar o antigo |
| Usuário bloqueado tentando acessar | Acesso negado | Admin deve desbloquear o usuário antes |
| Último Admin sendo rebaixado | O último Admin não pode perder acesso | Promover outro usuário a Admin primeiro |
| Entradas com fornecedor como contraparte | Contraparte inválida para entradas | Usar Membro, anônimo ou deixar vazio conforme a categoria |
- Fornecedores: podem ser excluídos por Admin e Financeiro. Se já tiverem transações, o histórico financeiro permanece e as transações ficam sem fornecedor vinculado.
- Veículos: só podem ser excluídos quando não há histórico financeiro vinculado.
- Funcionários: só podem ser excluídos quando não há histórico. Com histórico, use a opção Inativar.
| Termo | Significado |
|---|---|
| Entrada | Receita recebida — dinheiro que entra na organização |
| Saída | Despesa ou pagamento registrado — dinheiro que sai |
| Saldo | Diferença entre entradas pagas e saídas pagas no período |
| Pendente | Transação comprometida mas ainda não liquidada. Não entra nos relatórios |
| Pago | Transação concluída. Considerada no saldo e nos relatórios |
| Comprovante | Arquivo financeiro (PDF, imagem) anexado a uma movimentação |
| Contraparte | A pessoa ou entidade envolvida na transação (fornecedor, membro, etc.) |
| Centro de custo | Separação operacional por módulo: Geral, Cafeteria, Bazar, Funcionário, Veículo |
| Dizimista Anônimo | Opção especial para dízimos sem identificação de membro |
| Cliente Consumidor | Opção especial para vendas da Cafeteria/Bazar sem identificação de membro |
| Admin | Perfil com acesso total ao sistema, incluindo administração de usuários |
| Financeiro | Perfil com acesso operacional amplo, sem administrar usuários |
| Operador Cafeteria | Perfil restrito à operação da Cafeteria |
| Leitura | Perfil somente consulta, sem capacidade de alteração |
| RLS | Row Level Security — controle de acesso no banco de dados por linha. Garante que cada perfil veja apenas o que é permitido |
| Auditoria | Registro automático de ações relevantes no sistema (quem fez o quê e quando) |
| Snapshot | Cópia do nome/rótulo salva no momento do lançamento para preservar o histórico mesmo após exclusões |
| source_module | Campo interno que identifica de qual módulo a transação veio (general, cafeteria, bazar, employee, vehicle) |