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

2026-07-19 21:36:35 -05:00
parent 2e7abc7e72
commit fe7b2019c2
79 changed files with 7686 additions and 187 deletions
@@ -1,29 +1,11 @@
-# Arquitectura tecnológica
+# Tecnología — ARI Shopping v4.1

-```text
-Browser
-  ↓
-Next.js 15 App Router
-  ├─ Server Components / SSR / metadata SEO
-  ├─ React Client Components
-  │   ├─ Motion microinteractions
-  │   ├─ Radix/shadcn UI
-  │   └─ Zustand persisted cart
-  ├─ Headless catalog interface
-  │   ├─ Local mock JSON
-  │   ├─ Shopify Storefront GraphQL
-  │   └─ Medusa Store REST
-  └─ next/image optimization
-      ↓
-Docker standalone :80
-      ↓
-Gitea Actions → Registry → Argo CD → Kubernetes
-```
-
-## Decisiones
-
- Mobile-first y componentes interactivos aislados como Client Components.
- Datos y layout principal renderizados desde Server Components.
- Modelo de dominio independiente del proveedor e-commerce.
- Carrito local persistente; posteriormente puede sincronizarse con checkout remoto.
- Las imágenes reales de Ari Shopping viven en `public/images`.
+- Next.js 15.5.10.5.10 App Router y React 19.
+- TypeScript estricto.
+- Tailwind CSS 4.
+- Radix UI para Drawer y Dialog.
+- Motion usado selectivamente en el hero; las tarjetas usan CSS para reducir JavaScript.
+- Zustand persistente para carrito y favoritos.
+- Catálogo headless intercambiable: mock, Shopify o Medusa.
+- Imágenes WebP preoptimizadas con thumbnails de 560 px y fuentes PDP de hasta 1200 px.
+- Contenedor Next.js standalone, no-root, puerto 80 y `/api/health`.