[Feature] [Avanzado] Endpoint de informe con tiempos y porcentajes

[Andres-Torrez]

Descripción

Implementar la lógica analítica que calcula, a partir de las detecciones
guardadas, el tiempo total de aparición por marca y el porcentaje respecto
a la duración total del vídeo. Este informe es el entregable principal
que el cliente quiere ver.

Tareas

• Implementar función calculate_report(video_id) en db/ que agrega
  los intervalos de detections por marca
• Calcular total_time_seconds y percentage para cada marca
• Incluir en el informe: nombre de marca, tiempo total, porcentaje,
  confianza media y número de apariciones
• Exponer el informe en GET /videos/{id}/report
• Probar con un vídeo donde aparezcan al menos 2 marcas distintas

Tecnologías

PostgreSQL, SQLAlchemy, FastAPI, Python

Criterios de aceptación

• El informe devuelve tiempo total y porcentaje por cada marca detectada
• Los porcentajes de todas las marcas suman ≤ 100%
  (pueden aparecer simultáneamente en pantalla)
• El resultado se verifica manualmente contra el vídeo
• Output real del endpoint pegado en el PR

Rama: feature/endpoint-informe
Columna: Backlog
Sprint: S3 · Avanzado
Labels: feature sprint-3-avanzado