Módulo 10: Vistoria — UI
Status: Rascunho Inicial Regras de negócio: ver
regras-negocio/10_vistoria.mdDomínio: verdominio/vistoria.md
1. Contexto: O CRM não é a interface da vistoria
A captura de fotos, o guia de vistoria e o app mobile do vistoriador são responsabilidade do Microserviço Externo. O CRM possui apenas a aba Vistoria dentro da Proposta para o consultor/analista acompanhar e reagir.
2. Fluxo de Navegação no CRM
3. Aba Vistoria — Dentro da Proposta
3.1 Estado: PENDENTE / EM_ANDAMENTO
- Indicador de status animado.
- Exibição do link de acesso (referência do consultor).
- Ações: Reenviar Link (novo link via Microserviço, invalida anterior) · Cancelar Vistoria.
- Exibe data/hora da solicitação e tempo decorrido.
3.2 Estado: EM_ANALISE
- Mosaico de miniaturas das fotos (URLs do Microserviço — renderizadas via
<img src>). - Lista de ressalvas detectadas, destacadas em amarelo.
- Ações (Analista de Risco / Gestor / Admin): Aprovar · Aprovar com Ressalvas · Reprovar (motivo obrigatório).
O CRM exibe fotos via URLs externas — nunca as armazena localmente.
3.3 Estado: APROVADA / APROVADA_COM_RESSALVAS
- Badge verde + data/hora + nome do analista (ou "Aprovação Automática — IA").
- Se há ressalvas: lista com peça afetada, descrição do dano e miniatura da foto de evidência.
- Botão Download do Laudo PDF (abre URL do Microserviço em nova aba).
- Ação principal: Botão "Gerar Contrato" desbloqueado e destacado.
3.4 Estado: REPROVADA
- Badge vermelho + motivo + nome do analista (ou "Reprovação Automática — IA").
- Botão Download do Laudo PDF (auditoria).
- Proposta exibida como cancelada — mensagem explicativa ao consultor.
- Ação: "Nova Proposta" — redireciona ao simulador com veículo pré-selecionado.
4. Indicadores Visuais por Status
| Status | Badge | Ícone |
|---|---|---|
PENDENTE | Azul — "Aguardando início" | 🕐 |
EM_ANDAMENTO | Amarelo — "Em andamento" | 📸 |
EM_ANALISE | Laranja — "Aguardando análise" | 🔍 |
APROVADA | Verde — "Aprovada" | ✅ |
APROVADA_COM_RESSALVAS | Verde com aviso — "Aprovada com ressalvas" | ✅⚠️ |
REPROVADA | Vermelho — "Reprovada" | ❌ |
5. Notificações ao Consultor
| Evento | Notificação |
|---|---|
| Vistoria aprovada | "Vistoria do veículo [placa] aprovada. Você já pode gerar o contrato." |
| Aprovada com ressalvas | "Vistoria aprovada com ressalvas. Verifique os detalhes antes de gerar o contrato." |
| Vistoria reprovada | "Vistoria reprovada. Motivo: [motivo]. A proposta foi cancelada." |
| Link expirado | "O link de vistoria expirou. Acesse a proposta e reenvie o link ao cliente." |