Release v1.3.0 — Sprint 4

---

🤖 Sprint 4 — IA, Búsqueda Semántica y Expansión del Catálogo

Período: 23/06/2026 – 06/07/2026

✅ Nuevas funcionalidades

RF17 — Búsqueda semántica por IA

• Motor de búsqueda semántica con embeddings Gemini (gemini-embedding-001)
• Generación automática de vectores al iniciar el sistema (AUTO_EMBED_CATALOG)
• Resultados enriquecidos con score de similitud y metadatos del catálogo

RF18 — Recomendaciones personalizadas por IA

• Integración del endpoint /api/recommendations/:userId con el ai-engine
• Resolución de tmdbIds a documentos reales de MongoDB con fallback por géneros
• Interfaz de recomendaciones con tarjetas explicativas por preferencias del usuario

RF20 — Continuar viendo

• Historial de reproducción persistido por usuario
• Reanudación automática desde el último punto de visualización
• Sección "Continuar viendo" en el Home con progreso visual

Integración Retina Latina

• Soporte de iframe para reproductores externos (instantvideocloud, Vimeo, páginas externas)
• Importación de 38+ películas peruanas del catálogo de Retina Latina
• Script scrape-retinalatina.js para sincronización futura del catálogo

🎨 Mejoras de interfaz

• Hero con animación de zoom, fade inferior y botón de play
• Overlay de reproducción en cards al hover
• Score en color ámbar, headers de sección con gradiente
• Spinner de carga animado
• Fallback visual para películas sin poster (CSS + onError)
• Paginación del catálogo persistida en URL (mantiene página al volver atrás)
• Corrección del doble cuadro en la barra de búsqueda

🔧 Infraestructura y mejoras internas

• Bootstrap automático al levantar el sistema (cuentas base + catálogo curado)
• Módulo de estadísticas por película (views, ratings, duración promedio)
• Seed expandido a 12 páginas con filtro de poster obligatorio
• Corrección de bug en auth.middleware.js
• Scripts de mantenimiento: fix-catalog.js, fix-missing-posters.js, set-watch-link.js

🧪 QA

• Pruebas funcionales sobre búsqueda semántica y recomendaciones IA
• Validación de embeddings y similitud vectorial
• Revisión de compatibilidad de reproductores (video nativo, YouTube, iframe externo)

👥 Equipo

Rol	Responsable
Backend (recomendaciones IA + seed + infra)	Emanuel Cabeza
Backend (búsqueda semántica + auth fix)	Marcelo Palacios
Backend IA engine	Alexander Soto
Frontend (recomendaciones + series)	Gabriel Tang
Frontend (admin panel + continuar viendo + reseñas)	Juan Loayza
Frontend (progreso de reproducción)	Adrian Rivera
QA	Luis Morales

---