Fluxos Principais

Descrição dos principais fluxos de uso do sistema.

Fluxo de locação

O fluxo completo desde o cadastro do imóvel até o recebimento do aluguel:

┌─────────────────────────────────────────────────────────────┐
│                    FLUXO DE LOCAÇÃO                         │
└─────────────────────────────────────────────────────────────┘

1. CADASTRO
   ├── Cadastrar imóvel (status: Disponível)
   ├── Cadastrar proprietário
   └── Vincular proprietário ao imóvel

2. CAPTAÇÃO DE LEAD
   ├── Cadastrar cliente interessado
   ├── Registrar preferências de busca
   └── Agendar visita

3. VISITA
   ├── Corretor agenda visita (status: Agendada)
   ├── Cliente confirma (status: Confirmada)
   ├── Visita realizada (status: Realizada)
   └── Imóvel reservado (status: Reservado)

4. PROPOSTA
   ├── Criar proposta vinculando imóvel + cliente + corretor
   ├── Registrar valor proposto e condições
   ├── Status: Em Análise → Negociando
   └── Decisão: Aprovada ✓ | Recusada ✗

5. CONTRATO
   ├── Converter proposta aprovada em contrato
   ├── Tipo: Locação | Indexador: IGPM / IPCA / Fixo
   ├── Definir datas de início/fim e dia de vencimento
   ├── Status contrato: Ativo
   └── Status imóvel: Alugado

6. FINANCEIRO (recorrente)
   ├── Pagamento gerado mensalmente
   ├── Tipo: Aluguel | Método: PIX / Boleto
   ├── Vence no dia definido no contrato
   ├── Locatário paga → status: Pago
   └── Em atraso → status: Inadimplente + alerta

7. COMISSÃO DO CORRETOR
   ├── Comissão calculada sobre o contrato
   ├── Status: Pendente → Aprovada → Paga
   └── Corretor recebe notificação

8. RENOVAÇÃO / ENCERRAMENTO
   ├── Alerta automático 30 dias antes do vencimento
   ├── Renovar: cria novo período
   └── Encerrar: contrato Encerrado
               imóvel: Disponível

---

Fluxo de venda

1. Imóvel disponível
        ↓
2. Visita agendada e realizada
        ↓
3. Proposta criada (tipo: Venda)
   Valor proposto, condições de pagamento, validade
        ↓
4. Negociação
        ↓
5. Proposta aprovada
        ↓
6. Contrato de venda gerado
   Imóvel → status: Vendido
        ↓
7. Pagamento registrado
        ↓
8. Comissão do corretor aprovada e paga

---

Fluxo de cadastro inicial (onboarding)

1. Usuário cria conta com e-mail e senha
        ↓
2. Sistema detecta que não há empresa associada
        ↓
3. Usuário é redirecionado para o cadastro da imobiliária
        ↓
4. Usuário preenche dados da imobiliária:
   - Razão social
   - CNPJ
   - E-mail e telefone
        ↓
5. Conta criada com perfil Administrador
        ↓
6. Acesso ao dashboard liberado

---

Fluxo de notificações

O sistema gera alertas automáticos com base em eventos de negócio:

Evento	Notificação enviada para
Contrato vencendo em 30 dias	Admin e Financeiro
Pagamento em atraso	Admin e Financeiro
Nova proposta	Admin e Corretor responsável
Visita confirmada	Corretor responsável
Comissão aprovada	Corretor

As notificações aparecem em tempo real no sistema — ícone com badge e alerta na tela.

---

Fluxo do portal de acesso externo

Os portais são acessos separados para usuários externos (sem acesso ao sistema interno):

INQUILINO
  │ 1. Acessa o portal (endereço dedicado)
  │ 2. Faz login com e-mail e senha
  │ 3. Visualiza:
  │    - Contratos vigentes
  │    - Boletos e histórico de pagamentos
  │    - Download de comprovantes
  └── Sem acesso ao sistema interno da imobiliária

PROPRIETÁRIO
  │ 1. Acessa o portal
  │ 2. Faz login
  │ 3. Visualiza:
  │    - Seus imóveis cadastrados
  │    - Contratos e pagamentos
  └── Sem acesso ao sistema interno

SÍNDICO
  │ 1. Acessa o portal
  │ 2. Faz login
  │ 3. Visualiza:
  │    - Dados do condomínio
  │    - Moradores e unidades
  │    - Despesas e rateios
  └── Sem acesso ao sistema interno

---

Fluxo de relatórios

1. Usuário Admin ou Financeiro acessa Relatórios
        ↓
2. Seleciona o tipo de relatório:
   - Inadimplência: pagamentos em atraso
   - Receita: pagamentos recebidos por período
   - Desempenho de corretores: vendas e locações fechadas
        ↓
3. Visualiza gráficos e tabelas
        ↓
4. Exporta dados (CSV ou PDF)