Caterizi — Marketplace de Catering Multi-País
caterizi.comCaterizi es un marketplace de catering full-stack que conecta a clientes corporativos con caterers profesionales en varios países. La plataforma opera simultáneamente en Estados Unidos y España, atendiendo a empresas que necesitan servicios de catering fiables para eventos corporativos, reuniones y grandes celebraciones. Cada mercado funciona con su propia infraestructura de backend mientras comparten una capa de autenticación unificada, permitiendo operaciones transfronterizas fluidas bajo una sola marca. El sistema gestiona todo el ciclo de vida de un pedido de catering — desde la creación de la solicitud inicial hasta las propuestas de los caterers, la selección por parte del cliente, el procesamiento de pagos mediante Stripe Connect, la mensajería en tiempo real entre las partes y la generación automatizada de facturas. Con 59 modelos de base de datos, más de 256 endpoints API y 67 páginas de frontend, Caterizi representa un marketplace maduro, de nivel producción, construido para escalar geográficamente y gestionar flujos de trabajo complejos de catering B2B de principio a fin.
!El Desafío
La industria del catering — particularmente el segmento B2B — opera casi enteramente de forma offline. Los clientes corporativos que buscan servicios de catering normalmente dependen de recomendaciones de boca en boca, directorios obsoletos o llamadas en frío a caterers individuales. No existe una forma estandarizada de comparar ofertas, solicitar presupuestos competitivos o gestionar el proceso de pedido de forma digital. Esto genera fricción en ambos lados: los clientes dedican horas a buscar y evaluar caterers, mientras que los caterers pierden oportunidades porque carecen de visibilidad. El cliente necesitaba una plataforma que pudiera operar en mercados internacionales con diferentes idiomas, divisas, normativas fiscales y costumbres comerciales. Los mercados de EE.UU. y España tienen requisitos regulatorios fundamentalmente diferentes — desde el cumplimiento normativo en procesamiento de pagos hasta los estándares de formato de facturas. Construir una aplicación monolítica única habría sido frágil y difícil de mantener ante estos requisitos divergentes. Además, el modelo de pedidos basado en propuestas introdujo desafíos técnicos únicos. A diferencia de un checkout típico de e-commerce, los pedidos de catering implican negociación bidireccional: los clientes describen los requisitos de su evento, múltiples caterers envían propuestas personalizadas con diferentes menús y precios, y el cliente selecciona la mejor opción. Este flujo de trabajo requería comunicación en tiempo real, una máquina de estados robusta para la gestión del ciclo de vida del pedido y un sistema de pagos capaz de retener fondos y distribuirlos entre la plataforma y el caterer mediante pagos divididos.
Nuestro Enfoque
Comenzamos con sesiones de descubrimiento exhaustivas para mapear todo el ciclo de vida del pedido de catering — desde cómo los clientes corporativos buscan caterers hasta cómo los caterers presupuestan y ejecutan los pedidos. Esto informó el diseño del esquema de base de datos con 59 modelos que cubren usuarios, pedidos, propuestas, menús, pagos, facturas y comunicaciones.
Diseñamos una arquitectura multi-país con instancias separadas de NestJS por país, un servicio de autenticación compartido en PostgreSQL en auth.caterizi.com y despliegues de frontend específicos por país. Esto permitió que cada mercado evolucionara de forma independiente manteniendo una experiencia de usuario unificada e inicio de sesión único.
El sistema de propuestas y pedidos se construyó como una máquina de estados con transiciones claramente definidas — desde borrador hasta enviado, revisado, aceptado, pagado, ejecutado y completado. Cada cambio de estado activa las notificaciones correspondientes, actualiza los paneles de control y registra pistas de auditoría.
Se integró Stripe Connect en modo plataforma, permitiendo al marketplace cobrar pagos de los clientes, aplicar una comisión de plataforma y pagar automáticamente a los caterers. Esto requirió gestionar la incorporación de cuentas conectadas, la verificación de identidad y el cumplimiento normativo en las regiones de Stripe de EE.UU. y UE.
Implementamos funcionalidades en tiempo real mediante conexiones WebSocket para mensajería instantánea entre clientes y caterers, desplegamos un bot de soporte potenciado por IA utilizando Claude API con 12 funciones de herramientas personalizadas, y construimos un sistema integral de notificaciones por email con 29 plantillas y 13 secuencias automatizadas de seguimiento.
La Solución
Arquitectura Backend Multi-País
Cada país ejecuta su propia instancia de NestJS conectada a una base de datos PostgreSQL dedicada, permitiendo la evolución independiente del esquema, el cumplimiento de residencia de datos y la lógica de negocio específica del mercado. Un servicio de autenticación centralizado en auth.caterizi.com gestiona la autenticación basada en JWT en todos los mercados, permitiendo a los usuarios — particularmente a los clientes que pueden hacer pedidos en varios países — mantener una identidad única. El panel de administración, construido con Laravel, se conecta a todas las bases de datos de los países y utiliza cambio de país basado en sesión para gestionar las operaciones en todos los mercados desde una única interfaz.
Motor de Pedidos Basado en Propuestas
El flujo principal de pedidos permite a los clientes crear solicitudes detalladas de catering especificando el tipo de evento, número de comensales, requisitos dietéticos, presupuesto y cocina preferida. Estas solicitudes se difunden a los caterers elegibles de la zona, quienes pueden enviar propuestas personalizadas con menús detallados y precios. Los clientes revisan las propuestas en una interfaz de tarjetas con funcionalidad de deslizar para preseleccionar, comparan opciones lado a lado y seleccionan su caterer preferido. Todo el flujo está gestionado por una máquina de estados que garantiza la consistencia de datos y activa las acciones apropiadas en cada transición.
Pagos y Facturación
Stripe Connect gestiona todo el procesamiento de pagos en modo plataforma. Cuando un cliente acepta una propuesta, el pago se captura y retiene hasta que el pedido se ejecuta. Al completarse, la plataforma calcula automáticamente su comisión, genera facturas conformes a la normativa local (incluyendo el tratamiento fiscal adecuado para los mercados de EE.UU. y España), e inicia los pagos al caterer en su cuenta conectada de Stripe. El sistema de facturación genera documentos PDF con el formato correcto, numeración secuencial y todos los campos legalmente requeridos para cada jurisdicción.
Soporte IA y Capa de Comunicación
La mensajería en tiempo real entre clientes y caterers está potenciada por conexiones WebSocket, con persistencia de mensajes en PostgreSQL y seguimiento de confirmación de lectura. Un chatbot de soporte con IA construido sobre Claude API actúa como primera línea de atención al cliente, equipado con 12 funciones de herramientas personalizadas que pueden consultar pedidos, verificar estados, explicar funcionalidades de la plataforma y escalar a agentes humanos cuando es necesario. El sistema de notificaciones por email envía 29 tipos diferentes de plantillas a lo largo del ciclo de vida del pedido, con 13 secuencias automatizadas de seguimiento que re-enganchan a los usuarios en puntos críticos de abandono.
Resultados e Impacto
Stack Tecnológico
NestJS
Framework de API backend con arquitectura modular
Nuxt.js
Frontend con renderizado del lado del servidor y optimización SEO
Laravel
Panel de administración con RBAC y gestión multi-país
PostgreSQL
Base de datos principal para todos los servicios
Stripe Connect
Procesamiento de pagos con división de comisiones de plataforma
WebSocket
Mensajería en tiempo real entre clientes y caterers
Claude API
Chatbot de soporte con IA con 12 funciones de herramientas
JWT
Autenticación entre países mediante servicio de auth compartido
PM2 / Nginx
Despliegue en producción y gestión de procesos