Vortex Engine / TiendaNube Recommendations Core

Recomendaciones Nexus-grade para storefronts que no pueden esperar datos perfectos.

El MVP queda preparado para Vercel, App Router, Prisma y widgets de upsell/cross-sell con una estrategia de fallback robusta desde el dia cero.

OAuth 2.0 de TiendaNube con persistencia en Prisma/PostgreSQL.

Cold start inteligente: related by category/tag y fallback a best sellers.

Script storefront sin dependencias con Quick Add via LS.cart.addItem.

Arquitectura base

El repo nace con un pipeline listo para conectar una app de TiendaNube real: install, callback, HMAC, recommendations API y storefront widget.

Auth Core

`/oauth/tiendanube/install`, `/oauth/tiendanube/callback`, sesiones firmadas y asociacion opcional del script manual.

Recommendation Engine

`/api/v1/recommendations` resuelve related products por senales semanticas y rellena con best sellers cuando el store no tiene data suficiente.

Injector

`public/vortex-injector.js` detecta Product Page o Cart, consulta la API y renderiza Quick Add dentro del DOM de TiendaNube.