verú · tienda de ropa · Astro estático

Arquitectura de verú

Una tienda completa sin servidor: el catálogo se construye en el build, el carrito vive en el navegador y el pedido sale por WhatsApp. Tres vistas: contenedores, flujos y despliegue. Haz clic en cualquier caja; reproduce un flujo para ver el recorrido.

este repo persona o máquina de trabajo servicio externo tráfico
Detalle

Haz clic en un contenedor

Cada caja es una pieza que corre por separado: el navegador de quien compra, el almacenamiento local, el sitio estático o un servicio externo. Las líneas son llamadas reales: protocolo y qué viaja.

Por qué sin backend

El catálogo son 17 productos que cambian poco: se resuelven en el build y cada uno tiene su URL propia. No hay base de datos, ni API, ni costo por venta. La parte dinámica (carrito, favoritos, checkout) es JavaScript sin framework en el navegador.

Por qué WhatsApp y no una pasarela

El checkout arma el pedido y abre WhatsApp con el detalle. El pago se coordina a mano por Yape, Plin, transferencia o contra entrega: la página solo muestra las instrucciones, no cobra nada. Es una demo de marca inventada, sin pagos reales.

Qué guarda el navegador

Cuatro claves en localStorage: carrito, favoritos, historial de pedidos y último pedido. Los precios no se leen de ahí: se resuelven de nuevo desde los datos del build en cada render.

Secuencias · una por flujo · los mismos pasos que reproduce el C4
Despliegue · lo que hay y lo que cambiaría

Hoy un build local que produce archivos estáticos. El destino final está por confirmar.

El resultado es un directorio dist/ sin proceso en ejecución. La tienda usa rutas reales (/producto/…), así que necesita raíz propia: un subdominio, no una subcarpeta.

Hoy · build en el PC Windows

npm run build (Astro 4, sharp)dist/
20 páginas: portada, 17 productos, checkout, confirmación…estático
sitemap sin checkout ni confirmación@astrojs/sitemap
host y subdominio finalpor confirmar
cómo llega dist/ al hostpor confirmar

El repo no trae workflow de despliegue; el código vive en GitHub.

→ mismo dist/ →

Al crecer · un backend en las costuras

raíz propia, cualquier hosting estáticosin cambios de código
catálogo desde un CMS en vez de products.jsondocumentado, no hecho
pasarela de pago en vez de WhatsAppdocumentado, no hecho

docs/ARCHITECTURE.md describe esos puntos de extensión; ninguno está implementado.