REQ-080 Calcular tempos do ciclo comercial

Calcular tempos do ciclo comercial

Problema / Contexto

O sistema deve calcular tempos a partir dos eventos reais de transição, incluindo Lead→Abordagem, Abordagem→Need Validated, Need→Pré-Proposta, Pré-Proposta→Proposta, Proposta→Decisão e ciclo total.

História de usuário

Como gestor, sócio, vendedor, quero acompanhar quanto tempo cada oportunidade leva em cada etapa, para identificar onde o ciclo comercial consome mais tempo.

Comportamento esperado

1. Ler histórico de eventos do caso.
2. Calcular duração entre marcos válidos.
3. Consolidar por oportunidade e período.
4. Exibir onde há maior permanência.

Papel da IA

Não se aplica.

Regras de negócio

• RN1: Usar timestamps reais de eventos.
• RN2: Casos ainda abertos não devem ser tratados como concluídos.
• RN3: Mudança retroativa auditada exige recálculo.

Dados envolvidos

• evento_inicio — timestamp — sim — fato
• evento_fim — timestamp — não — fato
• duracao_etapa — duração — não — indicador
• ciclo_total — duração — não — indicador

Critérios de aceite

• Dado caso concluído com eventos completos, quando calcular ciclo, então duração deriva dos timestamps registrados.
• Dado caso aberto, quando calcular ciclo, então etapas futuras não recebem duração fictícia.

Exceções e erros

• Eventos ausentes devem sinalizar dado incompleto.

Fora de escopo

• Previsão de duração futura por ML.

Dúvidas em aberto

• Nenhuma dúvida aberta identificada nas fontes atuais.

Histórico

Data	O que mudou	Quem	Referência
2026-09-15	Criado no pacote de requisitos do MVP	LC Verum	Índice do MVP - Requisitos
2026-09-16	Numerado e importado para a documentação	Luiz	Registro de Mudanças