146 lines
4.4 KiB
Markdown
146 lines
4.4 KiB
Markdown
# 💰 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:
|
|
|
|
1. **Vá para o Supabase Dashboard**
|
|
2. **Clique em "SQL Editor"**
|
|
3. **Cole o conteúdo do arquivo** `sql/emprestimos-tables.sql`
|
|
4. **Execute o script** clicando em "Run"
|
|
|
|
### 2. Verificar Tabelas Criadas
|
|
|
|
Após executar, você deve ter as seguintes tabelas:
|
|
|
|
- **`emprestimos`** - Registros principais dos empréstimos
|
|
- **`emprestimo_devolucoes`** - Histórico de devoluções/parcelas
|
|
|
|
### 3. Estrutura das Tabelas
|
|
|
|
#### Tabela `emprestimos`:
|
|
```sql
|
|
- 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`:
|
|
```sql
|
|
- 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
|
|
|
|
1. **Criar empréstimo:**
|
|
- Valor: R$ 1.000,00
|
|
- Descrição: "Empréstimo para despesas pessoais"
|
|
|
|
2. **Primeira devolução:**
|
|
- Valor: R$ 300,00
|
|
- Restante: R$ 700,00
|
|
- Status: Ativo
|
|
|
|
3. **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.
|