# Requerimientos Funcionales - PMC-008 Analytics

**Módulo:** Analytics
**Versión:** 1.0.0
**Fecha:** 2025-12-08

---

## Dashboards

### RF-PMC-008-001: Ver Dashboard Principal

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-001 |
| **Nombre** | Ver Dashboard Principal |
| **Prioridad** | P1 |
| **Actor** | Todos los roles |

**Widgets:**
- Quick stats (campañas activas, assets mes, tasa aprobación)
- Actividad reciente
- Acciones pendientes

**Criterios de aceptación:**
- [ ] Dashboard carga correctamente
- [ ] Datos actualizados
- [ ] Responsive en diferentes pantallas

---

### RF-PMC-008-002: Ver Dashboard de Producción

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-002 |
| **Nombre** | Ver Dashboard de Producción |
| **Prioridad** | P2 |
| **Actor** | Creative, Tenant Admin |

**Widgets:**
- Volumen de generación (gráfico de líneas)
- Estado de cola (gauge)
- Uso de modelos/workflows (pie chart)
- Tasa de error
- Tiempo promedio de procesamiento

**Criterios de aceptación:**
- [ ] Gráficos interactivos
- [ ] Filtro de período funciona
- [ ] Datos en tiempo real para cola

---

### RF-PMC-008-003: Ver Dashboard de Campañas

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-003 |
| **Nombre** | Ver Dashboard de Campañas |
| **Prioridad** | P2 |
| **Actor** | Creative, Analyst, Tenant Admin |

**Widgets:**
- Funnel de campañas por estado
- Tasa de aprobación primera iteración
- Tiempo promedio brief → aprobación
- Assets por campaña
- Top clientes

**Criterios de aceptación:**
- [ ] Métricas calculadas correctamente
- [ ] Drill-down en gráficos
- [ ] Filtro por cliente/período

---

### RF-PMC-008-004: Ver Dashboard de Recursos

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-004 |
| **Nombre** | Ver Dashboard de Recursos |
| **Prioridad** | P2 |
| **Actor** | Tenant Admin |

**Widgets:**
- Storage usado vs cuota
- Generaciones mes vs límite
- Distribución de storage por tipo
- Proyección de uso

**Criterios de aceptación:**
- [ ] Progress bars claras
- [ ] Alertas en >80% uso
- [ ] Breakdown por tipo de asset

---

### RF-PMC-008-005: Aplicar Filtros Globales

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-005 |
| **Nombre** | Aplicar Filtros Globales |
| **Prioridad** | P1 |
| **Actor** | Todos los roles |

**Filtros:**
- Período (hoy, semana, mes, custom)
- Cliente
- Usuario

**Criterios de aceptación:**
- [ ] Filtros aplican a todos los widgets
- [ ] Persistencia durante sesión
- [ ] Reset disponible

---

## Reportes

### RF-PMC-008-006: Generar Reporte de Actividad Mensual

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-006 |
| **Nombre** | Generar Reporte de Actividad Mensual |
| **Prioridad** | P2 |
| **Actor** | Tenant Admin |

**Contenido:**
- Resumen ejecutivo
- Campañas del período
- Assets generados
- Uso de recursos
- Comparativa con período anterior

**Formatos:**
- PDF
- Excel

**Criterios de aceptación:**
- [ ] Reporte generado correctamente
- [ ] Datos precisos
- [ ] Formato profesional

---

### RF-PMC-008-007: Generar Reporte de Campaña

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-007 |
| **Nombre** | Generar Reporte de Campaña |
| **Prioridad** | P2 |
| **Actor** | Creative, Tenant Admin |

**Datos de entrada:**
- campaign_id: UUID

**Contenido:**
- Datos de campaña y brief
- Assets generados/aprobados
- Timeline de actividad
- Participantes

**Criterios de aceptación:**
- [ ] Reporte específico de campaña
- [ ] Incluye thumbnails de assets
- [ ] PDF descargable

---

### RF-PMC-008-008: Generar Reporte de Cliente

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-008 |
| **Nombre** | Generar Reporte de Cliente |
| **Prioridad** | P3 |
| **Actor** | Analyst, Tenant Admin |

**Datos de entrada:**
- client_id: UUID
- date_range: object

**Contenido:**
- Proyectos y campañas
- Assets entregados
- Histórico de actividad

**Criterios de aceptación:**
- [ ] Filtro de período funciona
- [ ] Exportable en PDF/Excel

---

### RF-PMC-008-009: Programar Reporte Automático

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-009 |
| **Nombre** | Programar Reporte Automático |
| **Prioridad** | P3 |
| **Actor** | Tenant Admin |

**Opciones:**
- Frecuencia (semanal, mensual)
- Destinatarios (emails)
- Tipo de reporte

**Criterios de aceptación:**
- [ ] Programación guardada
- [ ] Email enviado automáticamente
- [ ] PDF adjunto

---

### RF-PMC-008-010: Ver Historial de Reportes

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-010 |
| **Nombre** | Ver Historial de Reportes |
| **Prioridad** | P3 |
| **Actor** | Tenant Admin |

**Datos de salida:**
- Lista de reportes generados
- Fecha, tipo, generador
- Link de descarga

**Criterios de aceptación:**
- [ ] Reportes listados
- [ ] Descarga disponible (30 días)
- [ ] Filtro por tipo/fecha

---

## Métricas

### RF-PMC-008-011: Consultar Métricas Raw

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-011 |
| **Nombre** | Consultar Métricas Raw |
| **Prioridad** | P2 |
| **Actor** | Tenant Admin |

**Descripción:**
API para consultar métricas agregadas.

**Parámetros:**
- metric_type
- dimensions
- period
- filters

**Criterios de aceptación:**
- [ ] API retorna datos correctos
- [ ] Agregaciones funcionan
- [ ] Paginación para grandes volúmenes

---

### RF-PMC-008-012: Exportar Datos de Métricas

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-012 |
| **Nombre** | Exportar Datos de Métricas |
| **Prioridad** | P3 |
| **Actor** | Tenant Admin |

**Formatos:**
- CSV
- JSON

**Criterios de aceptación:**
- [ ] Filtros aplicados
- [ ] Formato correcto
- [ ] Útil para BI externo

---

## Personalización

### RF-PMC-008-013: Guardar Vista Personalizada

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-013 |
| **Nombre** | Guardar Vista Personalizada |
| **Prioridad** | P3 |
| **Actor** | Creative, Tenant Admin |

**Datos de entrada:**
- name: string
- dashboard: string
- config: object (filtros, widgets visibles)

**Criterios de aceptación:**
- [ ] Vista guardada
- [ ] Cargable posteriormente
- [ ] Por usuario

---

### RF-PMC-008-014: Establecer Vista por Defecto

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-014 |
| **Nombre** | Establecer Vista por Defecto |
| **Prioridad** | P3 |
| **Actor** | Creative, Tenant Admin |

**Descripción:**
Marcar una vista guardada como la que se carga al abrir dashboard.

**Criterios de aceptación:**
- [ ] Vista se carga automáticamente
- [ ] Una sola vista por defecto por dashboard

---

### RF-PMC-008-015: Eliminar Vista Guardada

| Campo | Valor |
|-------|-------|
| **ID** | RF-PMC-008-015 |
| **Nombre** | Eliminar Vista Guardada |
| **Prioridad** | P3 |
| **Actor** | Creative, Tenant Admin |

**Criterios de aceptación:**
- [ ] Vista eliminada
- [ ] Si era default, se usa vista estándar

---

## Resumen

| Prioridad | Cantidad |
|-----------|----------|
| P1 | 2 |
| P2 | 6 |
| P3 | 7 |
| **Total** | **15** |

---

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