Primeiro commit

EMPRESTIMOS-SETUP.md

@@ -0,0 +1,145 @@
+# 💰 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.