4.4 KiB
4.4 KiB
💰 Sistema de Empréstimos - Guia de Configuração
📋 Sobre o Sistema
O sistema de empréstimos permite controlar o dinheiro que a Maiara pega emprestado da empresa e suas devoluções parciais ou totais.
🎯 Funcionalidades:
- ✅ Registro de empréstimos com valor total e descrição
- ✅ Devoluções parciais com qualquer valor até quitar
- ✅ Controle automático do valor restante
- ✅ Histórico completo de todas as devoluções
- ✅ Status automático (Ativo/Quitado)
- ✅ Dashboard visual com resumos financeiros
🛠️ Configuração do Banco de Dados
1. Executar Script SQL
Acesse seu painel do Supabase e execute o script SQL:
- Vá para o Supabase Dashboard
- Clique em "SQL Editor"
- Cole o conteúdo do arquivo
sql/emprestimos-tables.sql - Execute o script clicando em "Run"
2. Verificar Tabelas Criadas
Após executar, você deve ter as seguintes tabelas:
emprestimos- Registros principais dos empréstimosemprestimo_devolucoes- Histórico de devoluções/parcelas
3. Estrutura das Tabelas
Tabela emprestimos:
- id (UUID) - Chave primária
- pessoa (VARCHAR) - Nome da pessoa (padrão: 'Maiara')
- valor_total (DECIMAL) - Valor total emprestado
- valor_restante (DECIMAL) - Valor ainda não devolvido
- descricao (TEXT) - Motivo/descrição do empréstimo
- data_emprestimo (DATE) - Data do empréstimo
- status (VARCHAR) - ativo, quitado, cancelado
- created_at, updated_at (TIMESTAMP)
Tabela emprestimo_devolucoes:
- id (UUID) - Chave primária
- emprestimo_id (UUID) - Referência ao empréstimo
- valor_devolvido (DECIMAL) - Valor desta devolução
- data_devolucao (DATE) - Data da devolução
- observacoes (TEXT) - Observações sobre a devolução
- created_at, updated_at (TIMESTAMP)
🎮 Como Usar o Sistema
1. Acessar a Página
- No menu lateral, clique em "Empréstimos"
- Você verá o dashboard com resumos financeiros
2. Criar Novo Empréstimo
- Clique em "Novo Empréstimo"
- Preencha os dados:
- Pessoa: Maiara (padrão)
- Valor Total: Valor emprestado
- Data: Data do empréstimo
- Descrição: Motivo (opcional)
- Clique em "Criar Empréstimo"
3. Registrar Devolução
- Na lista de empréstimos, clique no botão 💰 (verde)
- Preencha:
- Valor da Devolução: Qualquer valor até o restante
- Data da Devolução: Data do pagamento
- Observações: Detalhes (opcional)
- Clique em "Registrar Devolução"
4. Acompanhar Status
- 🟠 Ativo: Ainda tem valor a receber
- 🟢 Quitado: Totalmente pago
- 🔴 Cancelado: Empréstimo cancelado
📊 Dashboard de Resumos
O sistema mostra automaticamente:
- 💰 Total em Aberto: Soma de todos os valores restantes
- ✅ Total Quitado: Soma de todos os empréstimos pagos
- 👤 Empréstimos Ativos: Quantidade de empréstimos em aberto
🔄 Funcionalidades Automáticas
✨ Cálculos Automáticos:
- Valor restante é atualizado automaticamente a cada devolução
- Status muda para "quitado" quando valor restante = 0
- Histórico completo de todas as movimentações
🛡️ Validações:
- Não permite devolver mais que o valor restante
- Campos obrigatórios validados
- Datas não podem ser futuras (opcional)
🎯 Exemplo de Uso
Cenário: Maiara pega R$ 1.000 emprestado
-
Criar empréstimo:
- Valor: R$ 1.000,00
- Descrição: "Empréstimo para despesas pessoais"
-
Primeira devolução:
- Valor: R$ 300,00
- Restante: R$ 700,00
- Status: Ativo
-
Segunda devolução:
- Valor: R$ 700,00
- Restante: R$ 0,00
- Status: Quitado ✅
🚀 Benefícios do Sistema
- ✅ Controle total do fluxo de caixa
- ✅ Transparência nas movimentações
- ✅ Histórico completo para auditoria
- ✅ Interface intuitiva e fácil de usar
- ✅ Cálculos automáticos sem erros
- ✅ Relatórios visuais em tempo real
🔧 Manutenção
Backup dos Dados:
Os dados ficam seguros no Supabase com backup automático.
Relatórios:
Todos os dados podem ser exportados via SQL ou integração futura com Google Sheets.
🎉 Sistema pronto para uso!
Agora você tem controle total sobre os empréstimos da Maiara com uma interface profissional e funcionalidades completas.