02 / 14

Stack frontend

Web + Mobile compartiendo design system.

Web

Next.js 15

App Router · React 19 · RSC

Mobile

Expo SDK 52

React Native 0.76 · Expo Router 4

Design

Tamagui 1.112

Tokens compartidos web↔mobile

Estado

TanStack Query v5

Cache + mutations · React 19 compatible

Validación

Zod 3.23

Schemas compartidos con backend

Fonts

Sora + Instrument Serif + JetBrains Mono

Google Fonts

03 / 14

Stack backend

Supabase + Vercel Fluid Compute. Sin servidores que mantener.

BD

Postgres (Supabase)

13 tablas · RLS · ES256 JWT

API

Next.js Route Handlers

22 endpoints · Bearer JWT

Auth

Supabase Auth

OTP correo · sesiones cookie/JWT

Storage

Supabase Storage

Bucket product-images · RLS upload

Pagos

Wompi

Nequi · Daviplata · PSE · tarjeta · contraentrega

Email

Resend

Free 10k/mes · DKIM/SPF

Push

Expo Push API

Server-side wrapper · best-effort

Logística

Servientrega · Coordinadora

Configurable por seller

DevOps

Vercel · EAS · pnpm + Turborepo

Auto-deploy desde GitHub master

04 / 14

Arquitectura

Diagrama de capas end-to-end.

┌─ Usuario ─────────────────────────────────────────────┐
│  Comprador  ·  Vendedor  ·  Admin (en cualquier role) │
└──────────┬─────────────────────────────┬──────────────┘
           ▼                             ▼
   ┌──────────────┐               ┌──────────────┐
   │  Mobile      │               │  Web + PWA   │
   │  Expo SDK 52 │               │  Next.js 15  │
   └──────┬───────┘               └───────┬──────┘
          │ Bearer JWT                    │ Cookies
          ▼                               ▼
   ┌────────────────────────────────────────────┐
   │       API REST (Next.js Route Handlers)    │
   │  /api/{products,orders,push,wishlist,...}  │
   └─────────────────────┬──────────────────────┘
                         ▼
   ┌────────────────────────────────────────────┐
   │   Supabase Postgres  ·  13 tablas  ·  RLS  │
   │   profiles · sellers · orders · wishlists  │
   │   notifications · outbox_events · …        │
   └────┬───────────────────────────────────────┘
        ├─► Wompi (pagos)
        ├─► Resend (emails)
        └─► Expo Push API (notifs)

05 / 14

Modelo de datos

13 tablas core con Row Level Security.

Catálogo

profiles · 1:1 auth.users
cities · CO seed
categories · 12 seed
sellers · KYC verificado
products · status + images JSONB
product_variants · precio + inventario

Transacciones

orders · status enum + snapshot
order_items · seller_id por item
reviews · UNIQUE(order_item)
coupons + coupon_redemptions
addresses · default único
wishlists · UNIQUE(user, product)
notifications · inbox + read_at
outbox_events · audit trail

06 / 14

Flujo de compra

7 pasos · trazables 100% en outbox_events.

[1] Buyer navega /api/products
[2] addToCart() → cookie httpOnly
[3] POST /api/orders/place
    ├─► insert orders + order_items
    ├─► insert outbox_events (order.created)
    ├─► notifySellersNewOrder() → push + inbox
    └─► sendOrderConfirmationEmail()
[4] Wompi procesa pago → /api/wompi/webhook
[5] Seller: PATCH /orders/[number]/status
    ├─► validate transition (graph)
    ├─► insert outbox_events
    ├─► notifyBuyerOrderStatusInbox()
    ├─► notifyBuyerOrderStatus() → push
    └─► sendOrderStatusEmail()
[6] Buyer recibe push + inbox
[7] delivered → review habilitado

07 / 14

Auth · Seguridad

RLS + Bearer JWT + service role server-side.

Supabase Auth con ES256. Tokens firmados con curva elíptica P-256. kid rotable sin downtime.
RLS en todas las tablas. Las consultas con el cliente anon solo retornan filas que pertenecen al usuario autenticado.
Service role solo en server-side (Route Handlers + Server Actions) para operaciones cross-user (notificar a un seller cuando otro buyer compra).
Admin allow-list hardcoded por user.id y email. No hay rol "admin" en BD (evita escalación accidental).
Mobile biométrico: sesión bloqueada al matar la app, requiere TouchID/FaceID para desbloquear sin volver a hacer OTP.

08 / 14

API · 22 endpoints

REST con Bearer JWT. Documentado en /equipo/api-guide.html.

      Públicos (3)

      GET /api/products

      GET /api/products/[slug]

      GET /api/sitemap.xml

      Órdenes (3)

      POST /api/orders/place

      GET /api/orders/[number]

      PATCH /api/orders/[number]/status

      Productos seller (3)

      POST /api/products

      PATCH /api/products/[id]

      DELETE /api/products/[id]
    
      Buyer (8)

      GET POST /api/wishlist

      GET POST PATCH DELETE /api/addresses

      GET PATCH /api/notifications

      Push (3)

      POST DELETE /api/push/register

      POST /api/push/notify

      Admin (3)

      GET /api/admin/stats

      GET PATCH /api/admin/sellers

      GET /api/admin/orders

      Otros (2)

      POST /api/reviews

      POST /api/coupons/validate

09 / 14

Mobile · features nativos

5 nativos críticos · cada uno wireado end-to-end.

Feature	Lib	Backend wiring
Push notifications	expo-notifications	POST /api/push/register · server-side Expo Push API
Cámara + galería	expo-image-picker	Upload directo a Supabase Storage (RLS por seller_id)
Biométrico	expo-local-authentication	Session-lock in-memory · pantalla /lock
Share WhatsApp	expo-sharing	Deep link whatsapp://send + fallback wa.me
OTA updates	eas-cli update	Canal preview/production · sin App Store re-review

10 / 14

DevOps · CI/CD

Auto-deploy desde GitHub master. Sin pipeline custom.

git push origin master
  ↓
Vercel webhook
  ↓
pnpm install · turbo build --filter=@plazi/web
  ↓
Next.js build · Edge CDN + Fluid Compute
  ↓
Live en plazi.co (~2 min)

# Mobile (separado de Vercel)
eas build --platform android --profile preview
  ↓
EAS Cloud (~10 min)
  ↓
APK descargable desde expo.dev

11 / 14

Observabilidad

Logs Vercel + outbox_events para auditoría completa.

Vercel Logs · 100% de las invocaciones server (route handlers + server actions). Streaming live disponible.
outbox_events · audit trail en BD. Visible en /admin/reportes con filtros y resumen KPIs por tipo de evento.
Notif inbox · cada user puede ver su historial de eventos relevantes (order_new, order_status, promo, review).
typecheck en CI · pnpm typecheck corre en cada PR (failsafe pre-merge).
Sentry · no integrado. Opcional para producción si crece el volumen.

12 / 14

Escala

Costo objetivo: $0 a 100 sellers · $500 USD/mes a 10k.

Tier	Sellers	Costo infra (USD/mes)
Bootstrap	0 – 100	$0 (Vercel Hobby · Supabase Free)
MVP	100 – 1.000	~$45 (Vercel Pro · Supabase Pro)
Crecimiento	1.000 – 10.000	~$500 (Compute add-ons · Supabase Team)
Escala	10.000+	~$2.500 (dedicated Postgres · CDN paid)

Modelo serverless: el costo escala lineal con tráfico. Sin sorpresas.

13 / 14

Roadmap técnico

Pendientes operativos y evoluciones.

Inmediato (0-30 días, operativo)

Aplicar migración SQL 20260606130000 en Supabase Studio
Conectar dominio plazi.co a Vercel (DNS + cert)
eas build → APK Beta + distribución a piloto
Wompi merchant producción · Resend dominio verificado

Mediano plazo (30-90 días, técnico)

Sentry integrado para observabilidad de producción
Apple Developer + TestFlight + Play Store
Algolia o Postgres FTS para búsqueda escalable
Outbox event processor (worker async) para emails/notifs masivos
Vercel BotID para protección anti-bots

14 / 14

¿Preguntas técnicas?

Acceso al repo + due diligence completo bajo NDA.

CTO: Sebastián Martínez · sebastian@inventagency.co
Repo: github.com/SebasInvent/plazi (privado)
Docs: plazi.co/equipo/portal-documentacion.html

Plazi