CLX-Storefront¶
Storefront de e-commerce de Compulandia. Es la tienda pública: catálogo, búsqueda, carrito, checkout y cuentas de cliente. No guarda estado propio de negocio — todo lo lee del backend Medusa V2, del CMS Payload y del índice de Algolia.
Construido con Next.js 15 (App Router, React Server Components) y desplegado como contenedor Docker.
| Documento | Para qué |
|---|---|
| Arquitectura | Componentes, dependencias externas, flujo de checkout |
| Inventario de funcionalidades | Qué hace hoy la tienda, de contenido a pagos y entregas |
| Design System y UX/UI | Tokens, componentes, reglas responsive y línea base de accesibilidad |
| Runbook | Deploy, variables de entorno, logs, rollback, fallas frecuentes |
| Pipeline de despliegue | Automatizar el deploy con GitHub Actions: requerimientos, decisiones y plan por fases |
| Decisiones (ADR) | Por qué el sistema es como es |
| Integraciones | Contratos con Algolia y con endpoints del backend |
| Deuda con el upstream | Punto de fork, por qué no migramos, upgrade de dependencias pendiente |
| Typesense como alternativa a Algolia | Trabajo, reversibilidad y costo de migrar el motor de búsqueda después de lanzar |
Requisitos¶
Serie de documentos estáticos que reconstruyen, por partes, el requisito funcional detrás de lo implementado. Se escriben a partir del inventario del repositorio, no de una especificación previa.
| Documento | Alcance |
|---|---|
| RF-000 — Plataforma base de tienda | Capacidades del starter oficial de Medusa para Next.js |
| RF-001 — Contenido editorial desde el CMS | Portada, páginas, navegación, formularios y bloques |
| RF-002 — Búsqueda de catálogo con Algolia | Autocompletado, facetas, orden y estado en la URL |
| RF-003 — Ficha de producto | Variante enlazable, precio especial y stock por sucursal |
| RF-004 — Geografía del checkout | Departamento y ciudad de Paraguay con señal de cobertura |
| RF-005 — Entrega y retiro | Retiro en sucursal, promesa de plazo y cotización en vivo |
| RF-006 — Pagos locales | Bancard QR con cuenta regresiva y confirmación en vivo |
| RF-007 — Financiación y crédito | Simulador de cuotas y solicitud protegida por reCAPTCHA |
| RF-008 — Inicio de sesión con Google | Autenticación federada y alta automática de cliente |
| RF-009 — Contacto por WhatsApp | Acceso permanente al canal de atención |
| RF-010 — Actualización de plataforma | Salir del release candidate de React 19 y de Next.js 15.5 |
| RF-011 — Metadata y SEO | Origen del dato por ruta: editable en el CMS, derivado del catálogo o fijo |
El código vive en
https://github.com/CompulandiaTI/EcommerceV2Frontend (rama de integración:
develop).