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,29 @@
+# Arquitectura tecnológica
+
+```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`.