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

3.1 KiB

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