60 lines
1.5 KiB
Markdown
60 lines
1.5 KiB
Markdown
# 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.
|