platform-marketing-content/docs/05-user-stories/EPIC-007-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

139 lines
3.1 KiB
Markdown

---
id: "EPIC-007"
title: "Analytics"
type: "Epic"
status: "Done"
priority: "Media"
project: "platform_marketing_content"
phase: 3
story_points: 25
user_stories_count: 5
created_date: "2025-12-08"
updated_date: "2026-01-04"
---
# 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