Módulo 11: Contratos & Assinatura — UI

Status: Rascunho Inicial Regras de negócio: ver regras-negocio/11_contratos.md Domínio: ver dominio/contrato.md

1. Fluxo de Navegação de Telas

Exibido ao clicar em "Gerar Contrato" na tela de Proposta Aceita.

Campos Editáveis:
- E-mail do Cliente (com validação de formato)
- Telefone do Cliente (máscara internacional E.164)
Informação de Apoio:
- Alerta indicando que estes dados serão usados pelo provedor de assinaturas (DocuSign/D4Sign) para envio dos links e tokens.
Ações:
- Cancelar (fecha o modal)
- Confirmar e Gerar (inicia compilação do PDF)

A tela é organizada em abas horizontais e um painel lateral de status.

Badge do Status: Colorido conforme o estado atual.
Vigência do Contrato: Datas de início e fim.
Número do Contrato: Identificador do documento (ex: 2026-00342).
Ação Principal (contextual):
- Se GERADO: Botão "Enviar para Assinatura".
- Se AGUARDANDO_ASSINATURA: Botão "Reenviar Link" (desabilitado temporariamente após clique para evitar spam).
- Se ATIVO: Botão "Download do Contrato Assinado".
- Se CANCELADO: Botão "Reenviar Envelope" ou "Regerar Contrato".

Visualização do PDF gerado (iframe inline ou leitor de PDF embutido).
Exibe o contrato com todas as variáveis substituídas pelo motor de templates.
Rodapé com aviso jurídico de que o documento ainda não possui validade sem as assinaturas.

Lista de signatários cadastrados no contrato:
- Papel: Contratante (Cliente), Testemunha, Representante Legal.
- Dados: Nome completo, e-mail e telefone de cada um.
- Status de Assinatura: Badge de progresso por signatário (Pendente, Visualizado, Assinado).
- Histórico detalhado: IP do assinante, data/hora da assinatura (dados provenientes do callback do provedor).

Links rápidos e informações resumidas da origem comercial:
- Cliente proprietário (link para perfil)
- Veículo protegido (marca, modelo, placa, chassi)
- Proposta de origem (link para detalhes)
- Plano e opcionais selecionados com seus respectivos valores mensais congelados.

Status	Badge	Ação do Usuário
`GERADO`	Cinza / Charcoal	Permite revisar signatários e preview antes de enviar.
`AGUARDANDO_ASSINATURA`	Azul — Pulsante	Bloqueado para edição. Monitora assinaturas em tempo real.
`ATIVO`	Verde	Sucesso. PDF assinado disponível para download.
`CANCELADO`	Vermelho	Prazo expirado, recusado no provedor ou cancelado administrativamente. Permite repescagem.

Assinatura Realizada: Notifica o consultor em tempo real quando um signatário realiza o aceite do documento: "João Silva visualizou o contrato" ou "João Silva assinou o contrato".
Conclusão: Alerta flutuante no CRM ao concluir a última assinatura: "Contrato 2026-X assinado com sucesso. Ativação liberada."