platform-marketing-content/docs/05-user-stories/EPIC-006-AUTOMATION.md

139 lines
3.1 KiB
Markdown

# EPIC-006: Automatización
**Versión:** 1.0.0
**Fecha:** 2025-12-08
**Fase:** 2 - Personalización
---
## Descripción
Esta épica cubre los flujos automatizados con n8n que conectan CRM, generación y notificaciones.
---
## User Stories
### US-006-001: Ver Flujos de Automatización
**Como** Admin
**Quiero** ver los flujos automatizados disponibles
**Para** saber qué automatizaciones tenemos activas
**Criterios de Aceptación:**
- [ ] Lista de flujos con nombre, tipo, trigger
- [ ] Estado: activo/inactivo
- [ ] Última ejecución y conteo total
- [ ] Descripción de lo que hace cada flujo
**Prioridad:** Must Have
---
### US-006-002: Activar/Desactivar Flujo
**Como** Admin
**Quiero** activar o desactivar flujos
**Para** controlar qué automatizaciones corren
**Criterios de Aceptación:**
- [ ] Toggle de activo/inactivo por flujo
- [ ] Confirmación antes de cambiar
- [ ] Flujos inactivos no procesan eventos
- [ ] Estado persistido
**Prioridad:** Must Have
---
### US-006-003: Ver Historial de Ejecuciones
**Como** Admin
**Quiero** ver el historial de ejecuciones de un flujo
**Para** verificar que está funcionando correctamente
**Criterios de Aceptación:**
- [ ] Lista de ejecuciones con fecha, status, duración
- [ ] Filtro por status y fecha
- [ ] Click para ver detalles
- [ ] Ver datos de entrada y salida
- [ ] Ver error si falló
**Prioridad:** Should Have
---
### US-006-004: Ejecutar Flujo Manualmente
**Como** Admin
**Quiero** ejecutar un flujo manualmente con datos de prueba
**Para** verificar que funciona correctamente
**Criterios de Aceptación:**
- [ ] Botón "Ejecutar ahora" en cada flujo
- [ ] Formulario para ingresar datos de prueba
- [ ] Ejecución inmediata
- [ ] Ver resultado en tiempo real
- [ ] Registro en historial marcado como "manual"
**Prioridad:** Could Have
---
### US-006-005: Configurar Webhook Externo
**Como** Admin
**Quiero** crear endpoints de webhook
**Para** recibir eventos de sistemas externos
**Criterios de Aceptación:**
- [ ] Crear webhook con nombre y flujo destino
- [ ] URL única generada automáticamente
- [ ] Secret key generada para validación
- [ ] Copiar URL y secret al portapapeles
- [ ] Ver estadísticas de llamadas
**Prioridad:** Could Have
---
### US-006-006: Flujo: Nuevo Producto → Generar Kit
**Como** usuario del sistema
**Quiero** que al crear un producto se generen imágenes automáticamente
**Para** tener contenido listo sin acción manual
**Criterios de Aceptación:**
- [ ] Trigger: product.created
- [ ] Cargar datos del producto y marca
- [ ] Ejecutar workflow "product_photo_synthetic"
- [ ] Generar 5 variaciones
- [ ] Vincular assets al producto
- [ ] Notificar al creador del producto
**Prioridad:** Must Have (flujo predefinido)
---
## Notas Técnicas
- n8n como orquestador externo
- Comunicación via webhooks bidireccionales
- Eventos internos emitidos via EventEmitter
- Reintentos con backoff exponencial
- Rate limiting en webhooks entrantes
---
## Dependencias
- EPIC-001: Autenticación
- EPIC-002: CRM (eventos de productos)
- EPIC-004: Generación
- Infraestructura: n8n server configurado
---
**Documento generado por:** Requirements-Analyst
**Fecha:** 2025-12-08