# 💰 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 outros relatórios personalizados que você crie.

---

**🎉 Sistema pronto para uso!** 

Agora você tem controle total sobre os empréstimos da Maiara com uma interface profissional e funcionalidades completas.