Home
/

Resumen del Proyecto

Zapenu

Plataforma de Pedidos Digitales

Plataforma multi-tenant de pedidos digitales con pagos integrados, notificaciones en tiempo real y arquitectura optimizada en costos

Infrastructure Architecture
5 capas
Zapenu Infrastructure Architecture

Arquitectura del Sistema

Arquitectura de 5 capas

11 Services
Homero

Frontend Público

Menú digital para clientes

React 19 + Vite
Cache 5 min
Marge

Frontend Admin

Dashboard de gestión

React 19 + Vite
Cache 1 min
Cloudflare Edge

CDN + Functions

Cache, Auth, Proxy

Cloudflare
Cache 5min (Homero)
Auth (Marge)
Edge Functions
Barto
3001

API Principal

Gestión de productos, órdenes, usuarios

Node.js + Express + TSOA
REST + gRPC
Omnipago
4000

Microservicio de Pagos

Integración con MercadoPago

Node.js 16 + Express
REST
PostgreSQL (Supabase)

DB Principal

Datos de operaciones, productos, órdenes

PostgreSQL (RDS + omnipago)

DB de Pagos

Schema payments_gateway

Cloudflare R2

Almacenamiento de Objetos

Almacenamiento de imágenes (S3-compatible)

MercadoPago

Pasarela de pagos

Procesamiento de transacciones, Webhooks

WAHA
3000

WhatsApp API

Notificaciones en tiempo real

Supabase

Auth + Storage

Autenticación JWT, Row Level Security

Flujos de Datos Clave

Decisiones de Diseño y Trade-offs

Por qué:Homero público con cache agresivo, Marge con auth y datos sensibles
Trade-off:Duplicación de código vs. Independencia de deploy, optimización de bundle, seguridad por separación
Alternativas:Single SPA with code-splitting
Por qué:Menos infraestructura, precio predictivo, RLS incorporado
Trade-off:Vendor lock-in vs. Rápido para MVP, bajo mantenimiento inicial
Alternativas:Auth0 + RDS independiente, Firebase
Por qué:Type safety end-to-end, OpenAPI automático, validación integrada
Trade-off:Menos flexible vs. Menos código repetitivo, mejor DX
Alternativas:Express manual, NestJS, Fastify
Por qué:Costo: $0 egress fees (vs AWS), S3-compatible
Trade-off:Menos maduro vs. Ahorro significativo en costos de salida
Alternativas:AWS S3, MinIO self-hosted
Por qué:Costo cero (usa WhatsApp no oficial), control total
Trade-off:No oficial, puede romperse vs. Sin costo de licenciamiento
Alternativas:Twilio, MessageBird, WATI
Por qué:Separación de responsabilidades, aislamiento de fallas de pagos
Trade-off:Complejidad de deployment vs. Aislamiento de fallas, escalabilidad independiente
Alternativas:Integrado en barto (monolito)

Consideraciones de Costos

Costo Total

Estimado Mensual

$5-20/mes

+ 2.99% + IVA por transacción

Infraestructura Gratuita

Supabase
$0
Cloudflare R2
$0
Cloudflare Pages
$0
WhatsApp WAHA
$0 (marginal)

Desglose de Costos

7 Servicios
VPS Backend

Infraestructura propia

$5-20/mes
Supabase
Gratuito

Infraestructura propia

$0
Cloudflare R2
Gratuito

Infraestructura propia

$0
Cloudflare Pages
Gratuito

Infraestructura propia

$0
WhatsApp WAHA
Gratuito

Infraestructura propia

$0 (marginal)
GitHub Actions
Gratuito

Infraestructura propia

$0
MercadoPago Fees
Variable

% por transacción

2.99% + IVA

Drivers de Costo Futuros

VPS Backend
Si escala: $20-50/mes
Supabase
$25+/mes si escala
Cloudflare Pages
$20/mes si 10x tráfico

Riesgos de Escalamiento

10x tráfico en Homero

Mitigation: Upgrade a Pro

100x imágenes subidas

Mitigation: Compresión previa, límites de tamaño

1000x pedidos/día

Mitigation: Pool tuning, migración a Pro

Viralización WhatsApp

Mitigation: Fallback a email/SMS