Documentação Completa do Sistema
📊 Dashboard Visão Geral
Página inicial do sistema com resumo financeiro em tempo real. Apresenta todos os indicadores principais da banca em um único painel.
- Saldo Total: Soma de todos os caixas das contas bancárias cadastradas
- Recebido / Enviado: Total de pagamentos recebidos e enviados no período
- Taxas: Soma de todas as taxas bancárias descontadas nos pagamentos e despesas
- Despesas: Total de despesas operacionais lançadas
- Lucro: Cálculo automático: Recebido - Enviado - Despesas - Taxas
- Caixa Inicial: Saldo de abertura configurado no sistema
- Win/Loss: Total de resultados ganhos e perdidos dos clientes
- Gráficos: Evolução semanal dos principais indicadores
📝 Como usar
O Dashboard atualiza automaticamente conforme você lança pagamentos, despesas e resultados. Use como visão rápida da saúde financeira da banca.
💵 Pagamentos Financeiro
Gerencia todos os recebimentos e envios de dinheiro relacionados aos clientes. Cada pagamento pode ser marcado como "Recebido" (cliente pagou a banca) ou "Enviado" (banca pagou o cliente).
- Lançar pagamento: Selecione o cliente, tipo (recebido/enviado), valor, conta bancária e observação
- Taxas automáticas: Ao selecionar uma conta bancária, o sistema calcula a taxa conforme a tabela configurada (fixa ou percentual)
- Saldo do cliente: Atualiza automaticamente conforme pagamentos são lançados
- Relatório por semana: Filtre pagamentos por semana para fechamento
- Editar/Excluir: Corrija lançamentos com auditoria automática
- Status do cliente: Visualize saldo devedor ou credor de cada cliente em tempo real
📝 Como usar
Quando um cliente fizer um depósito, lance como "Recebido". Quando ele solicitar um saque, lance como "Enviado". O sistema desconta taxas bancárias automaticamente da conta selecionada.
👥 Clientes Cadastro
Cadastro completo de todos os apostadores da banca. Cada cliente possui saldo automático calculado a partir de pagamentos, resultados e repasses.
- Cadastrar cliente: Nome (obrigatório)
- Saldo automático: O sistema calcula sozinho baseado em pagamentos + resultados - repasses
- Busca rápida: Encontre clientes pelo nome em qualquer tela do sistema
- Editar dados: Atualize nome ou telefone do cliente
- Exclusão protegida: Não é possível excluir cliente com saldo diferente de zero
- Histórico completo: Todas as transações do cliente são mantidas para auditoria
📝 Como usar
Cadastre o cliente antes de lançar pagamentos ou resultados. O saldo inicial é zero e vai ajustando automaticamente conforme as operações.
🏆 Resultados Operação
Lançamento dos ganhos e perdas dos clientes nas apostas. É aqui que se registra se o cliente ganhou (win) ou perdeu (loss) em cada aposta.
- Lançar resultado: Selecione o cliente, tipo (win/loss) e valor
- Semana automática: O resultado é vinculado à semana atual do sistema
- Observação: Adicione descrição do jogo ou aposta para referência
- Editar/Excluir: Corrija resultados lançados incorretamente
- Impacto no cliente: Win aumenta o saldo do cliente; Loss diminui
📝 Como usar
Após cada aposta ser definida, lance o resultado imediatamente. Win = cliente ganhou, Loss = cliente perdeu. O saldo do cliente atualiza automaticamente.
🔄 Repasses Financeiro
Transferência de saldo entre a banca e o cliente. Usado quando há necessidade de ajustar o saldo sem ser por pagamento direto.
- Lançar repasse: Selecione o cliente origem, cliente destino, valor e descrição
- Impacto: Repasse de um Cliente diretamente para o outro, sem passar pelo caixa da banca.
- Histórico: Todos os repasses ficam registrados para consulta
- Edição: Corrija repasses lançados incorretamente
📝 Como usar
Use repasses para ajustes de saldo, bonificações ou correções. O valor é debitado da banca e creditado no cliente automaticamente.
💳 Despesas Operacionais Financeiro
Controle de todos os gastos da banca que não são relacionados a pagamentos de clientes. Aluguel, internet, luz, taxas, etc.
- Lançar despesa: Descrição, valor, conta bancária (opcional) e observação
- Taxas bancárias automáticas: Ao pagar de uma conta que incide taxa, o sistema calcula e desconta a taxa bancária automaticamente
- Coluna Taxa: Visualize a taxa descontada em cada despesa na tabela
- Impacto no caixa: Despesa com conta selecionada desconta direto do saldo daquela conta
- Despesa sem conta: Não afeta nenhum caixa individual, apenas o Caixa Total
- Edição/Exclusão: Corrija ou remova despesas lançadas
📝 Como usar
Lance todas as despesas da banca (aluguel, luz, internet, taxas). Se a despesa sair de uma conta bancária específica, selecione-a para desconto automático. A taxa bancária é calculada conforme a configuração do sistema.
🏦 Caixas Contas
Gerenciamento de contas bancárias da banca. Cada conta possui saldo independente, histórico de movimentações e taxas configuráveis.
- Cadastrar conta: Nome, saldo inicial
- Tipo Corrente: Contas operacionais da banca
- Saldo em tempo real: Calculado automaticamente conforme pagamentos, despesas, transferências e taxas
- Transferências: Mova dinheiro entre contas internas
- Configurar taxas: Defina taxa fixa e/ou percentual por faixa de valor
- Editar/Excluir: Altere dados da conta (saldo recalculado automaticamente)
📝 Como usar
Cadastre todas as contas bancárias da banca. O saldo inicia com o valor informado e se atualiza conforme as operações. Contas IRON são usadas para pagamentos de clientes e têm taxas automáticas.
🤝 Sócios Gestão
Controle de sócios da banca com cálculo automático de saldo baseado na porcentagem de participação. Cada sócio tem saldo individual, aportes e retiradas.
- Cadastrar sócio: Nome e porcentagem de participação (ex: 50%, 30%, 20%)
- Saldo automático: Calculado conforme lucro da banca × porcentagem do sócio
- Aportes: Lançe quando o sócio investir dinheiro na banca
- Retiradas: Lançe quando o sócio sacar dinheiro da banca
- Transferências entre sócios: Mova saldo de um sócio para outro
- Exclusão protegida: Não é permitido excluir sócio com saldo diferente de zero
- Resumo geral: Veja saldo de todos os sócios em uma tela
📝 Como usar
Cadastre todos os sócios com suas porcentagens. O saldo de cada um calcula automaticamente conforme a banca vai lucrando. Use aportes e retiradas para movimentar dinheiro entre sócios e a banca.
⬆️ Aportes e Retiradas Sócios
Movimentação de dinheiro entre os sócios e a banca. Aportes são investimentos (dinheiro entrando na banca) e retiradas são saques (dinheiro saindo da banca).
- Lançar aporte: Sócio investe dinheiro na banca (aumenta saldo do sócio e da banca)
- Lançar retirada: Sócio saca dinheiro da banca (diminui saldo do sócio e da banca)
- Observação: Adicione descrição para cada movimentação
- Data: Registro automático da data do lançamento
- Impacto no caixa: Aportes aumentam o caixa geral; retiradas diminuem
- Histórico: Todas as movimentações ficam registradas por sócio
📝 Como usar
Use aportes quando um sócio colocar dinheiro novo na banca. Use retiradas quando um sócio quiser sacar parte do lucro. O sistema atualiza os saldos automaticamente.
📈 Relatórios Análise
Relatório geral da banca com indicadores financeiros consolidados. Mostra o panorama completo desde o início da operação.
- Total Recebido / Enviado: Acumulado de todos os pagamentos
- Total Taxas: Soma de todas as taxas bancárias (pagamentos + despesas)
- Total Despesas: Soma de todas as despesas operacionais
- Win/Loss: Total acumulado de resultados dos clientes
- Lucro: Recebido - Enviado - Despesas - Taxas
- Caixa Inicial: Saldo de abertura do sistema
- Caixa Total: Lucro + Depósitos - Retiradas + Caixa Inicial
- Devedores e ganhadores : Lista de clientes com saldo negativo e positivo
📝 Como usar
Use o relatório geral para ver a saúde financeira total da banca desde o início. Ideal para reuniões com sócios e tomada de decisões estratégicas.
📅 Fechamento Semanal Periódico
Relatório detalhado por semana específica. Mostra todos os indicadores financeiros de um período selecionado para análise de desempenho.
- Selecionar semana: Escolha a semana desejada no dropdown
- Recebido / Enviado: Totais da semana selecionada
- Taxas: Soma das taxas da semana
- Despesas: Total de despesas operacionais da semana
- Lucro da semana: Cálculo automático
- Caixa da semana: Lucro + Depósitos - Retiradas + Caixa Inicial
- Contas detalhadas: Saldo de cada conta bancária naquela semana
- Exportar PDF: Gere relatório em PDF para enviar aos sócios
📝 Como usar
Selecione a semana que deseja analisar. O sistema mostra todos os números daquela semana específica. Exporte em PDF para compartilhar com sócios.
📆 Fechamento Geral Período
Relatório por período customizável. Defina data inicial e final para análise de qualquer intervalo de tempo.
- Definir período: Selecione data inicial e data final
- Todos os indicadores: Mesmos dados do fechamento semanal, mas para período customizado
- Semanas múltiplas: O sistema agrupa automaticamente todas as semanas dentro do período
- Contas detalhadas: Saldo de cada conta no período selecionado
- Exportar PDF: Gere relatório em PDF para qualquer período
📝 Como usar
Use para análise de períodos específicos (ex: mês de março, trimestre, etc.). Ideal para demonstrações contábeis e fechamentos mensais.
📝 Anotações Utilitário
Bloco de notas integrado ao sistema. Registre informações importantes, lembretes ou observações sobre a operação.
- Criar nota: Título e conteúdo livre
- Editar: Atualize notas existentes
- Excluir: Remova notas antigas
- Organização: Visualize todas as notas em lista
📝 Como usar
Use para registrar senhas de contas, observações sobre clientes, lembretes de pagamentos ou qualquer informação importante da banca.
⚙️ Configurações Sistema
Painel de controle do sistema. Configure nome da banca, taxas bancárias, caixa inicial e gerencie backups.
- Nome da Banca: Personalize o nome exibido no sistema e nos PDFs
- Taxas Bancárias: Configure taxa fixa (valor absoluto) e/ou percentual por faixa de valor
- Caixa Inicial: Defina o saldo de abertura do sistema (base para cálculos)
- Configurar Semanas: Crie semanas de operação com data de início e fim
- Exportar Backup: Gere arquivo .db completo para download
- Importar Backup: Restaure banco de dados a partir de arquivo .db
- Restaurar Padrão: Retorna o sistema ao estado inicial (⚠️ apaga todos os dados)
📝 Como usar
Configure as taxas bancárias antes de começar a operar. O caixa inicial deve refletir o dinheiro real que a banca possui no início. Faça backups regularmente.
👤 Usuários Admin
Gerenciamento de usuários do sistema. Controle quem tem acesso e qual o nível de permissão de cada um.
- Cadastrar usuário: Nome de usuário, senha e nível de acesso
- Nível Admin: Acesso total a todas as funcionalidades
- Nível Padrão: Pode lançar dados mas não excluir
- Nível Visualização: Apenas consulta, sem permissão para lançar
- Alterar senha: Troque a senha do seu próprio usuário
- Excluir usuário: Remova acessos desnecessários
📝 Como usar
Crie usuários para cada pessoa que opera a banca. Funcionários de entrada de dados podem ter nível "Padrão". Sócios podem ter "Visualização" para acompanhar resultados.
📋 Auditoria Segurança
Registro completo de todas as ações realizadas no sistema. Saiba quem fez o quê e quando.
- Log de ações: Cada criação, edição e exclusão é registrada com usuário, data e hora
- Detalhes: Veja exatamente o que foi alterado (valores antigos e novos)
- Busca por usuário: Filtre ações de um usuário específico
- Busca por ação: Filtre por tipo (criar, editar, excluir)
- Transparência: Ideal para resolver conflitos entre operadores
📝 Como usar
A auditoria roda automaticamente. Use para verificar quem lançou ou alterou um dado específico. Essencial para segurança e controle interno.
↔️ Transferências Contas
Movimentação de dinheiro entre contas bancárias internas da banca. Transfira saldo de uma conta para outra.
- Lançar transferência: Selecione conta de origem, conta de destino e valor
- Impacto: Origem perde saldo, destino ganha saldo
- Sem taxas: Transferências internas não geram taxas bancárias
- Histórico: Todas as transferências registradas
- Edição: Corrija transferências incorretas
📝 Como usar
Use quando precisar mover dinheiro entre contas da banca (ex: da conta operacional para a conta IRON). Não afeta o Caixa Total, apenas a distribuição entre contas.
📆 Gestão de Semanas Períodos
Controle dos períodos de operação da banca. Cada semana agrupa pagamentos, resultados e despesas para fechamento.
- Criar semana: Defina número, data de início e data de término
- Label: Nome descritivo para identificação (ex: "Semana 1 - Janeiro")
- Editar: Altere datas de semanas existentes
- Excluir: Remova semanas vazias (sem lançamentos)
- Fechamento: Selecione a semana nos relatórios para ver resultados do período
📝 Como usar
Crie semanas conforme a banca opera (semanal, quinzenal, mensal). Todos os lançamentos são vinculados à semana ativa. Isso permite fechamentos periódicos organizados.
