- 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>
371 lines
7.2 KiB
Markdown
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
|