feat: AI studio pipeline + sistema robusto de fondos en cards

[Z1Code]

Resumen

• agrega pipeline IA de imagen profesional de producto con soporte multi-referencia y mejoras de robustez
• agrega post-proceso especializado de remocion de fondo con fallback de proveedores
• agrega crop server-side para imagenes generadas
• agrega sistema global de fondos de cards (settings + presets color/gradiente + generacion IA con Gemini)
• integra ProductCard con configuracion global y fallback seguro al estilo actual

Endpoints

• POST /api/admin/products/[id]/ai-image (mejorado)
• POST /api/admin/images/crop
• POST /api/admin/card-backgrounds/generate

Impacto UI/UX

• ProductForm con controles avanzados para autogeneracion IA
• AdminImageUpload con recorte
• Admin Settings con panel completo de fondos para cards
• ProductCard con modo estudio + fondos configurables globales

Labels

• enhancement
• ai
• frontend
• backend

Reviewer

• reviewer externo pendiente (GitHub no permite solicitar review al autor del PR)

QA Checklist

Fase 1 - backend IA/remocion

• Caso sin claves de proveedores: no rompe generacion, respuesta clara
• Solo removebg: aplica y registra proveedor
• Solo clipdrop: aplica y registra proveedor
• Ambos activos: respeta BACKGROUND_REMOVAL_PROVIDER_ORDER
• removebg falla y clipdrop funciona: fallback correcto
• Ambos fallan: error controlado, sin 500 opaco
• Imagen con alpha real: no postproceso innecesario
• Imagen sin alpha: fuerza pipeline de remocion

Fase 2 - modo estudio/card

• Producto con 1 imagen: comportamiento tradicional intacto
• Producto con multiples variantes IA: autoplay fluido
• Click en card cambia angulo correctamente
• Hover pausa autoplay; al salir reanuda
• Movil touch: cambio manual estable
• prefers-reduced-motion: sin autoplay
• Fondo intercambiable funciona con PNG transparente
• Sin silueta rara en hover ni recortes visuales

Fase 3 - fondos globales en settings

• Activar/desactivar fondos personalizados funciona
• Selector por card se puede habilitar/deshabilitar
• Fondo default global se refleja en /shop
• Alta de preset color funciona y persiste
• Alta de preset gradiente funciona y persiste
• Generacion IA de fondo crea preset imagen en settings
• Fondo IA generado puede marcarse como default
• Restaurar presets base funciona

Regresion global

• npm run build
• npm run test:fit-guide
• npm run lint global (bloqueado por error preexistente en src/hooks/useAdminTheme.ts)
• Smoke test manual de /api/admin/products/[id]/ai-image
• Verificacion visual de cards en /shop

Nota tecnica

npm run lint global mantiene un error preexistente en src/hooks/useAdminTheme.ts (react-hooks/set-state-in-effect) y warnings historicos de otras areas no introducidos por este PR.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
ivaniabeauty	Ready	Preview, Comment	Feb 6, 2026 7:32pm