Omegha — Plataforma E-Commerce de Planos
Plataforma e-commerce completa para la comercialización de planos de vivienda: catálogo con carrusel, carrito persistente, pago con Mercado Pago Checkout Pro y un panel de administración con reportes, auditoría y gestión de productos.
- Mercado Pago Checkout Pro integrado con flujo completo server-side
- Panel admin con dashboard analítico, CRUD de planos y gestión de órdenes
- Validación Zod en 3 capas: cliente, Server Action y constraints en BD
- Roles customer/admin con middleware y guards server-side independientes
Capturas del sistema
Haz clic en cualquier imagen para ampliarla. Navega con las flechas o el teclado.
Módulos del sistema
Seis módulos que cubren todo el ciclo de compra: desde el catálogo hasta la auditoría del administrador.
Tienda & Catálogo
- Catálogo de planos con carrusel (Embla Carousel)
- Carrito de compras persistido en localStorage (Zustand)
- Filtros y búsqueda de productos
- Página de detalle con galería de imágenes
- Contador animado y carrusel infinito
Pasarela de Pagos
- Mercado Pago Checkout Pro (redirección segura)
- Procesamiento 100% server-side (Server Actions)
- Preferencia de pago con external_reference
- URLs de retorno: éxito, fallo y pendiente
- Vinculación automática MP preference ↔ orden interna
Portal del Cliente
- Registro y login con email + contraseña
- Historial de órdenes con estado en tiempo real
- Descarga de planos al completar pago
- Recuperación de contraseña por email
- Perfil editable con datos personales
Panel de Administración
- Dashboard con KPIs: ventas, productos, órdenes, clientes
- CRUD completo de planos (imágenes + archivos)
- Gestión de órdenes con cambio de estado
- Lista de clientes registrados
- Configuración de la plataforma
Reportes & Analítica
- Historial de ventas por mes (gráficas)
- Distribución de inventario por tipo de plano
- Ingreso total y ticket promedio
- Últimas 5 órdenes y productos recientes
- Productos más vendidos
Seguridad & Auditoría
- JWT en cookies HTTP-only (Supabase Auth)
- RLS habilitado en todas las tablas
- Roles: customer / admin / superadmin
- Validación Zod en 3 capas: client → server → DB
- Tabla admin_logs inmutable (append-only)
Stack tecnológico
Full-stack con Next.js App Router, Supabase BaaS, Mercado Pago y TypeScript strict en toda la app.
Frontend
Backend
Arquitectura
Flujo de compra y pago
Del carrito al comprobante en pocos pasos, con seguridad server-side en cada etapa.
Cliente agrega al carrito
Zustand persiste el carrito en localStorage. Sin login obligatorio hasta el checkout.
Completa datos en Checkout
Formulario con React Hook Form + Zod. Validación en cliente antes de enviar.
createOrderAction (Server)
Server Action crea la orden en BD con status "pending". Verifica autenticación con requireAuth().
createPreferenceAction (MP)
Genera preferencia en la API de Mercado Pago con external_reference vinculado a la orden. Access Token solo en servidor.
Pago en Mercado Pago
Redirección a Checkout Pro. El cliente paga con tarjeta, Yape, Plin o transferencia.
Retorno y confirmación
MP redirige a /cuenta?status=success|failure|pending con order_id. La orden se actualiza automáticamente.
Logros técnicos
Decisiones de arquitectura que hacen de Omegha una plataforma segura, auditable y lista para escalar.
Integración completa con Mercado Pago Checkout Pro: preferencia server-side, retorno automático y vinculación con órdenes internas
RLS habilitado en todas las tablas de PostgreSQL + 3 clientes Supabase: Browser, Server (cookies) y Admin (Service Role)
Validación en 3 capas independientes: Zod en cliente, Server Action revalida, y constraints en la base de datos
Middleware Next.js protege /admin/*: sin sesión redirige a /login, sin rol admin reescribe a /404 (oculta la existencia)
Dashboard analítico con 9 métricas: ventas por mes, distribución de inventario, ticket promedio e ingreso total
CRUD completo de planos con subida de imágenes y archivos a Supabase Storage desde el panel admin
Sistema de roles customer/admin/superadmin con guards server-side (requireAdmin) independientes del middleware
Tabla admin_logs inmutable (append-only): registra cada acción del administrador para auditoría completa
Construimos tu e-commerce con
pagos reales y panel admin
Tiendas online completas con Mercado Pago, Stripe o Yape integrado, panel de administración a medida, reportes de ventas y seguridad de nivel empresarial.