platform-marketing-content/docs/03-requerimientos/RF-PMC-008-ANALYTICS.md
rckrdmrd 74b5ed7f38 feat: Complete documentation update and orchestration configuration
- Update vision, architecture and technical documentation
- Update module definitions (PMC-001 to PMC-008)
- Update requirements documentation
- Add CONTEXT-MAP.yml and ENVIRONMENT-INVENTORY.yml
- Add orchestration guidelines and references

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 05:38:31 -06:00

371 lines
7.2 KiB
Markdown

---
id: "RF-PMC-008"
title: "Analytics Module"
type: "Requirement"
status: "Done"
priority: "Media"
module: "analytics"
project: "platform_marketing_content"
version: "1.0"
rf_count: 8
created_date: "2025-12-08"
updated_date: "2026-01-04"
---
# 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