feat(ecommerce): migrate Ari Shopping to Next.js 15 headless storefront v4

2026-07-19 19:37:41 -05:00
parent 383b644929
commit f263a9cc55
76 changed files with 1607 additions and 0 deletions
@@ -0,0 +1,59 @@
+# ARI Shopping Headless Storefront v4.0
+
+Código base moderno para la tienda online ARI Shopping.
+
+## Stack
+
+- Next.js 15 con App Router y Server Components.
+- React 19 y TypeScript estricto.
+- Tailwind CSS 4.
+- Componentes accesibles estilo shadcn/ui sobre Radix UI.
+- Motion for React para microinteracciones.
+- Zustand con persistencia local para el carrito.
+- Adaptadores headless para catálogo local, Shopify Storefront API o Medusa.
+- `next/image` para optimización de imágenes.
+- Docker multi-stage con salida standalone.
+
+## Funcionalidad incluida
+
+- Header promocional cyan/amarillo/magenta.
+- Búsqueda predictiva.
+- Hero promocional Bento.
+- Carrusel horizontal de novedades.
+- Catálogo con búsqueda y filtros sin recarga.
+- PDP dinámica con galería, zoom, variantes y recomendados.
+- Botón móvil persistente para añadir al carrito.
+- Carrito lateral con Zustand y persistencia.
+- SEO y metadata con App Router.
+- Endpoint `/api/health`.
+- Arquitectura preparada para Shopify o Medusa.
+
+## Desarrollo
+
+```bash
+cp .env.example .env.local
+npm install
+npm run dev
+```
+
+## Variables headless
+
+El valor predeterminado es:
+
+```text
+HEADLESS_PROVIDER=mock
+```
+
+Proveedores preparados:
+
+```text
+mock
+shopify
+medusa
+```
+
+Los adaptadores Shopify y Medusa incluyen la conexión inicial y un punto claro para completar el mapeo al modelo `Product`.
+
+## Compatibilidad GitOps
+
+El contenedor Next.js escucha en el puerto `80`, por lo que mantiene compatibilidad con el Service y Deployment existentes que apuntaban al frontend Nginx.