Todos los proyectos
Listo2025–2026

Bodega Boost

OS de retail multi-perfil para América Latina — comerciantes, proveedores, consumidores, repartidores y personal en una sola PWA

Rol
Desarrollador único
Stack
ReactTypeScriptViteSupabaseEdge FunctionsCreemPWA
Página de inicio de Bodega Boost: «The operating system for neighborhood commerce» sobre un montaje oscuro de dueños de tienda
Abrir app en vivo

Las credenciales de cuentas de prueba para los seis perfiles (comerciante, proveedor, consumidor, repartidor, personal y ops) están disponibles a solicitud. Se rotan cuando termines de explorar o al cabo de una hora, lo que ocurra primero. Solicitar acceso

El problema

Los pequeños comercios de América Latina funcionan con hojas de cálculo, hilos de WhatsApp y herramientas fragmentadas. Necesitan un solo sistema operativo para inventario, ventas, control de caja y vitrinas de cara al cliente — sin la complejidad ni los precios de una solución empresarial. En ese mismo barrio también hay proveedores, repartidores y compradores que necesitan sus propias superficies, no módulos añadidos.

La solución

Bodega Boost es una PWA multi-perfil en React sobre Supabase que unifica las operaciones del comerciante —punto de venta, inventory, vínculos con proveedores, vitrinas para el consumidor, runtime de entregas y billing por suscripción— y a la vez atiende a proveedores, consumidores, repartidores, personal y una consola interna de ops desde la misma base de código. Construida para las restricciones de los mercados emergentes: poco ancho de banda, mobile-first, i18n en español e inglés.

Pruébalo en vivo — recorre el sitio de marketing, o solicita cuentas de prueba para entrar como cualquier perfil.

¿Qué es My Circle?

My Circle es la red personal de tiendas de barrio del consumidor. Los compradores siguen las tiendas donde compran habitualmente; esas tiendas seguidas aparecen en la sección My Circle del panel del consumidor (/c/dashboard). Desde ahí, quienes las siguen pueden:

  • Ver los broadcasts y las promociones que publican los comerciantes que siguen
  • Consultar su tier de fidelidad y sus recompensas (gems) en cada tienda
  • Hacer pedidos para recoger o a domicilio cuando el comerciante habilita el checkout de My Circle en su vitrina
  • Hacer seguimiento de los pedidos activos con estados en tiempo real y códigos de entrega

Convierte las visitas sueltas a una vitrina en una relación continua — el «círculo» de tiendas locales de confianza del consumidor, no el carrito de un marketplace genérico.

Los perfiles a fondo

Comerciante

El sistema operativo central: POS con capacidad offline (/quick-charge), inventory con órdenes de compra y escaneo de códigos de barras, libro de caja con cierre de día, campañas de CRM, analítica con un copiloto de IA (Pro), WhatsApp Hub para automatización y clasificación de intención (Pro), hub de entregas para coordinar repartidores (Pro), gestión de personal con permisos granulares y personalización de módulos sobre más de 28 presets de negocio (bodega, farmacia, salón de belleza, restaurante, hotel, etc.).

Proveedor

Portal B2B en /supplier/*: aceptar o rechazar solicitudes de vínculo de los comerciantes, gestionar el catalog de productos, ver las tiendas vinculadas y el detalle de cada una, enviar broadcasts a los comerciantes, atender los hilos de Bandeja, revisar indicadores clave y suscribirse por los tiers de Creem (free / basic / max, con límites de licencias de equipo). Los proveedores también pueden listarse en el marketplace para que los comerciantes los descubran.

Consumidor

Descubrimiento público en /c y /c/stores, y vitrinas por tienda en /c/s/:slug con navegación, carrito, pedidos por QR y traspaso del pedido a WhatsApp. Los compradores autenticados tienen un panel con My Circle (las tiendas que siguen), amigos, historial de pedidos, reservas, invitaciones de grupo, listas de compras con emparejamiento de presupuesto y tienda, notificaciones push y tokens de IA comprables para funciones de concierge.

Repartidor

App dedicada en /driver: bandeja de entregas para tomar trabajos abiertos, gestión del trabajo activo con la dirección del cliente y el estado del pedido, tiendas vinculadas y contratos con clientes, panel de ganancias con confirmación de pago, actualizaciones de ubicación (con cuota gestionada) y campana de notificaciones. Los repartidores trabajan con las tarifas de entrega que fija el comerciante — la plataforma no se lleva comisión.

Personal

Portal multi-tienda en /staff-portal: aceptar invitaciones de tiendas por /join, ver el horario y la disponibilidad semanal, solicitar días libres, reportar las horas trabajadas para aprobación de nómina, consultar las tarifas de compensación y acceder a los módulos del comerciante que le fueron delegados (POS, escaneos de inventory, etc.) según los permisos que otorgue el dueño. El personal también puede tener membresías en equipos de proveedores desde la misma cuenta.

Ops (interno)

Consola en /ops/* detrás de MFA y allowlist de IP: triage de bugs, moderación de feedback, seguimiento de sanciones, recuperación de cuentas, cola de reembolsos de Creem con recuperación de créditos, revisión de documentos del marketplace de proveedores, herramientas comerciales (retos, espacios publicitarios, patrocinadores, directorio tributario), reportes, exportación de datos e impersonación auditada de comerciantes para soporte. Los ítems de navegación se filtran por rol (ops_support → ops_commercial → ops_admin).

Profundidad de la plataforma

Lo que une a los perfiles entre sí:

  • Comercio por WhatsApp — WhatsApp Hub (Pro) con reglas de automatización, gestión de plantillas, clasificación de intención sobre los mensajes entrantes y automatización saliente medida por créditos, atada a Bandeja del comerciante.
  • Marketplace de proveedores — los comerciantes descubren proveedores mediante el conector (/supplier-connector) y levantan órdenes de compra; los proveedores gestionan el otro lado desde su portal.
  • Red de entregas — los comerciantes despachan desde el hub de entregas; los pedidos de My Circle del consumidor entran a la bandeja del repartidor; las ganancias y los contratos se llevan por tienda.

Escala de ingeniería

Alcance de desarrollador único con disciplina de producción: 163 Edge Functions (BFF de analítica, APIs del consumidor, pipeline de WhatsApp, webhooks de billing, cron jobs de ops), 698 migraciones SQL, compuertas de entitlements en cliente y servidor con pruebas de sincronización, passkeys, runtime de PIN para los flujos sensibles y proveedores de pago de LATAM (MercadoPago, Wompi, Webpay, Yape/Plin) detrás de funciones de checkout que reconocen el país.

Mi rol

Responsabilidad de punta a punta: arquitectura, frontend, esquema y migraciones de Supabase, Edge Functions, billing con Creem/RevenueCat, integración con WhatsApp, auditorías de seguridad, i18n, suite de pruebas e2e y documentación de lanzamiento.

Puntos clave

  • Seis tipos de cuenta — comerciante, proveedor, consumidor, repartidor, personal y ops interno — desde una sola base de código en React
  • POS offline-first con sincronización por IndexedDB para conectividad inestable (Starter+)
  • WhatsApp Hub con clasificación de intención, reglas de automatización y mensajería saliente medida por créditos (Pro)
  • My Circle para el consumidor — seguir tiendas del barrio, pedir para recoger o a domicilio, subir de tier de fidelidad y hacer seguimiento de los pedidos en un solo panel
  • 163 Edge Functions, 698 migraciones SQL, i18n EN/ES, billing con Creem + RevenueCat

Retos

Resultados

  • PWA en producción sobre Cloudflare Pages, con el billing de Creem en vivo en bodegaboost.com
  • 54 specs e2e de Playwright y 151 archivos de pruebas unitarias que cubren los flujos centrales de comerciante, consumidor y proveedor
  • Postura de seguridad validada con una revisión de authz previa al lanzamiento — RLS sólida, problemas de RPC remediados
  • Más de 28 presets de categoría de negocio que activan automáticamente los módulos pertinentes (farmacia, salón de belleza, restaurante, hotel, etc.)

Trabajemos juntos

manuel@manuelvargas.dev

Abierto a roles de tiempo completo y a contratos freelance. Respondo en menos de 48 horas.