# Design: Módulo de Empréstimos no Internet Banking

**Data:** 2026-03-09
**Branch:** feat/monetarie-adjustments

## Objetivo

Adicionar módulo de empréstimos ao IB abaixo de Investimentos, seguindo o mesmo padrão visual.

## Estrutura

### 1. LoansHubView (Hub)

**Summary Cards (3 cards):**
- Saldo Devedor Total (accent/teal)
- Próxima Parcela (valor + data de vencimento)
- Parcelas em Atraso (quantidade + valor total, destaque vermelho se > 0)

**Gráfico de Linhas (Chart.js):**
- Duas linhas sobrepostas por contrato ativo:
  - Saldo devedor (cor primária, descendente)
  - Total pago acumulado (cor success/verde, ascendente)
- Baseado nos dados de parcelas (due_date + balance_after + paid_amount)
- Contratos liquidados mostram linha completa até zero

**Listagem com Tabs de Filtro:**
- Tabs: Todos | Em dia | Em atraso | Liquidados
- Card: produto, contrato, valor emprestado, saldo devedor, parcela (ex: 12/36), taxa
- Tag de status: em dia (success), em atraso (danger), liquidado (secondary)
- Click navega para detalhe

### 2. LoanDetailView (Detalhe)

**Header Card (gradiente navy→teal):**
- Nome do produto + status tag
- Contrato, data do empréstimo, vencimento, taxa, amortização (PRICE/SAC)

**Summary Cards (4 cards):**
- Valor Emprestado | Saldo Devedor | Total Pago | Parcelas em Atraso

**Cronograma de Parcelas (tabela paginada):**
- Colunas: Nº | Vencimento | Valor | Principal | Juros | Status | Pago
- Status: pendente (info), paga (success), vencida (danger), parcial (warn)
- Paginação com primeira/anterior/próxima/última

**Histórico de Pagamentos:**
- Lista de pagamentos com data, valor, método, referência

### 3. Backend

- `GET /merchants/:id/loans/portfolio` — portfolio com totais e lista de empréstimos
- `GET /merchants/:id/loans/:id` — detalhe com parcelas paginadas e pagamentos

### 4. Navegação

- Ícone: HandCoins (lucide-vue-next)
- Posição: abaixo de Investimentos
- i18n: chaves `loans.*` em pt-BR

## Decisões

| Decisão | Escolha | Motivo |
|---------|---------|--------|
| Listagem | Tabs de filtro | Interface limpa, filtragem rápida |
| Summary cards | Saldo + Próxima parcela + Em atraso | Informação acionável |
| Gráfico | Saldo devedor + Total pago sobrepostos | Visão completa do progresso |
| Detalhe | Cronograma + Histórico pagamentos | Informação completa para cooperado |
| Ícone nav | HandCoins | Diferenciado dos demais ícones |