Muebles San Francisco JYN: e-commerce en desarrollo
Proyecto de comercio electrónico en desarrollo para Muebles San Francisco JYN, pensado para extender la presencia comercial de la marca hacia venta online real. Incluye flujo completo de compra, autenticación, checkout, pagos y control de inventario, con reglas específicas para productos por encargo.
Reto
Construir el e-commerce de Muebles San Francisco JYN con operaciones transaccionales seguras, control de inventario por tipo de producto y una capa administrativa capaz de operar órdenes y pagos sin inconsistencias.
Solución
Se implementó una arquitectura modular por dominios con reglas transaccionales en checkout, cancelación y confirmación de pagos. Además se incorporaron guards de autorización, rate limiting y validación de entorno para fortalecer la seguridad operativa mientras el sistema sigue evolucionando.
Resultados
- Flujo completo de compra desde catálogo hasta orden confirmada
- Panel admin funcional para operaciones diarias de órdenes y pagos
- Manejo correcto de productos por encargo sin bloqueo de stock
- Consistencia de montos monetarios usando enteros en colones
- Base escalable para evolucionar promociones, envíos y catálogo
Detalle técnico
Stack y tecnologías
- - Next.js 16 + React 19 + TypeScript
- - PostgreSQL + Prisma
- - better-auth (email/password y opcional Google)
- - Zustand para estado cliente (carrito, dirección, UI)
- - Zod para validación
- - Tailwind + componentes custom y Radix
Cómo está organizado
- - src/app: rutas y layouts de shop/auth/admin
- - src/features: dominios (products, orders, payments, checkout, inventory, account)
- - src/shared: UI reusable y lógica pura de dominio
- - src/lib: infraestructura (prisma, auth, env, email, rate limit)
- - Reglas de capas documentadas en ARCHITECTURE.md
Módulos clave
- - Orders: place-order y cancel-order transaccionales
- - Payments: confirmación/rechazo con guardas de estado
- - Inventory: control por producto y modo made-to-order
- - Auth: guards requireAdmin/requireAdminAction
- - Checkout: pasos de dirección y verificación final
Riesgos / deuda técnica
- - Reglas de negocio de estados pueden crecer en complejidad
- - Dependencia de Redis externo para rate limiting
- - Manejo de concurrencia en inventario requiere monitoreo continuo
- - Costos de email/notificaciones pueden crecer con volumen
¿Necesitas construir o mejorar un sistema?
Lo aterrizamos con criterio técnico, foco operativo y una ejecución limpia.