Historial de etapas del deal

Conserva el registro de entrada, salida y duración de cada etapa por la que pasa un deal.

Que se logra

• Resultado: evidencia cuánto tiempo permanecen las oportunidades en cada etapa y quién realizó los movimientos cuando está disponible.
• Caso de uso: un gerente de ventas detecta que las propuestas de una agencia se demoran más de lo previsto en negociación.
• Se combina con: Cambio de etapa del deal y Gestión de etapas del pipeline.

Donde esta

• Ruta: /[orgId]/deals/[id]
• Acceso en UI: Deal profile > History y tiempo mostrado al pasar por una etapa
• Componente(s): DealStatusBar.tsx, CRMTimeline.tsx

Como funciona

1. Crea un deal o muévelo a una nueva etapa.
2. El sistema abre una entrada para la etapa de destino.
3. Al salir de la etapa, cierra la entrada anterior y calcula su duración.
4. Consulta la cronología del deal para revisar sus cambios.

Reglas y validaciones

• Solo se agrega historial cuando cambia la etapa, no con cualquier edición del deal.
• Si se elimina una etapa que contiene deals, el traslado a la etapa elegida también cierra y crea entradas de historial.

Backend

• Servicios: deal-stage-history (método: find/create/patch), deals (método: create/patch), pipeline-stages (método: remove)
• Hooks relevantes solo si cambian el comportamiento visible: el seguimiento se ejecuta al crear o cambiar de etapa.
• Efectos: conserva el tiempo por etapa y el autor del cambio cuando está disponible.

Relaciones

• Requiere: Deals, pipelines y etapas.
• Dispara / afecta: Kanban y timeline del deal.

Notas

• Por confirmar: el formato y la superficie exacta de consulta completa del historial en el perfil.