[Infrastructure] Flujo de publicación y build del frontend desde backoffice

[cdryampi]

Objetivo

Dise�ar e implementar el flujo de publicaci�n del tema desde backoffice para lanzar un build/deploy del frontend y mostrar su estado al usuario.

Alcance

• Definir endpoint backend seguro para disparar publicaci�n.
• Elegir integraci�n real de despliegue (webhook/CI/CD/Dokploy/GitHub Actions/etc.).
• Modelar BuildJob o entidad equivalente con estados:
  • pending
  • running
  • success
  • failed
• Mostrar estado, timestamp y error b�sico en backoffice.
• Separar guardar de publicar.

Decisiones a cerrar

• Proveedor real de deploy (pendiente de definir por producto/infra).
• Si habr� historial de builds y rollback desde UI.
• Nivel de logs visible para el usuario.

Criterios de aceptaci�n

• Existe un mecanismo trazable para publicar tema desde backoffice.
• La acci�n no bloquea la UI y devuelve estado consultable.
• El flujo est� documentado para operaciones y desarrollo.
• Se contemplan errores de deploy y reintentos b�sicos.

Dependencias

• Epic [EPIC] Personalización del portal público y publicación de tema desde backoffice #99
• Backend de tema [Backend] Persistir configuración de tema del portal en SiteSettings #100
• Editor de tema [Backoffice] Editor de tema del portal con presets, custom colors y preview #101
• Frontend runtime [Frontend] Aplicar tema dinámico del portal mediante CSS variables #102

[cdryampi]

Cerrado. El flujo de publicación ya está implementado:

• POST /api/v1/site-settings/publish/ → crea BuildJob + dispara Celery task
• BuildJob con estados: pending → running → success/failed
• GET /api/v1/site-settings/builds/ → historial consultable
• Backoffice: botón 'Publicar' con polling de estado y feedback visual
• theme_config se copia a theme_config_published en la publicación

Nota: la integración con build real de frontend (webhook CI/CD) queda como mejora futura,
la simulación actual con time.sleep(5) en Celery task es suficiente para el MVP.