# 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
