platform-marketing-content/docs/05-user-stories/EPIC-007-ANALYTICS.md

2.9 KiB

EPIC-007: Analytics

Versión: 1.0.0 Fecha: 2025-12-08 Fase: 3 - Contenido Enriquecido


Descripción

Esta épica cubre dashboards, métricas y reportes para análisis de uso y rendimiento.


User Stories

US-007-001: Ver Dashboard Principal

Como miembro del equipo Quiero ver un resumen de la actividad Para tener visibilidad del estado general

Criterios de Aceptación:

  • Widget: Campañas activas (número)
  • Widget: Assets generados este mes
  • Widget: Tasa de aprobación promedio
  • Widget: Actividad reciente (timeline)
  • Widget: Acciones pendientes
  • Datos actualizados al cargar

Prioridad: Must Have


US-007-002: Ver Dashboard de Producción

Como creativo o admin Quiero ver métricas de generación Para entender el uso del motor IA

Criterios de Aceptación:

  • Gráfico: Generaciones por día/semana/mes
  • Gauge: Estado actual de la cola
  • Pie: Distribución por tipo de workflow
  • Stat: Tiempo promedio de generación
  • Stat: Tasa de error
  • Filtro de período funcional

Prioridad: Should Have


US-007-003: Ver Dashboard de Uso

Como Admin Quiero ver el consumo de recursos del tenant Para gestionar la capacidad

Criterios de Aceptación:

  • Barra: Storage usado vs límite
  • Barra: Generaciones mes vs límite
  • Gráfico: Tendencia de uso últimos 3 meses
  • Alerta visual cuando >80%
  • Breakdown de storage por tipo

Prioridad: Should Have


US-007-004: Generar Reporte de Actividad

Como Admin Quiero generar un reporte de actividad mensual Para tener documentación del trabajo realizado

Criterios de Aceptación:

  • Seleccionar período (mes o rango custom)
  • Preview del contenido del reporte
  • Generar PDF o Excel
  • Descarga automática cuando está listo
  • Reporte incluye: campañas, assets, usuarios activos

Prioridad: Could Have


US-007-005: Aplicar Filtros en Dashboards

Como usuario Quiero filtrar los datos de los dashboards Para ver información específica

Criterios de Aceptación:

  • Filtro de período (hoy, semana, mes, custom)
  • Filtro por cliente (en dashboards relevantes)
  • Filtros aplican a todos los widgets
  • Estado de filtros persistido en sesión
  • Botón para resetear filtros

Prioridad: Should Have


Notas Técnicas

  • Métricas pre-agregadas en tabla analytics.metrics
  • Refresh periódico de datos agregados
  • Cache en Redis para dashboards frecuentes
  • Gráficos con librería tipo Recharts o Chart.js
  • Reportes generados async para no bloquear UI

Dependencias

  • EPIC-001: Autenticación
  • EPIC-003: Proyectos (datos de campañas)
  • EPIC-004: Generación (métricas de jobs)
  • EPIC-005: Assets (métricas de storage)

Documento generado por: Requirements-Analyst Fecha: 2025-12-08