Backend (BoostAPI)
El backend de Boost CRM se llama BoostAPI. Es una aplicacion NestJS 11 que se conecta a una base de datos MySQL 8 mediante TypeORM y se despliega en Render.
BoostAPI no renderiza UI. Su trabajo es:
- Validar acceso interno (autenticacion JWT + RBAC granular).
- Persistir el dominio propio del CRM (grupos, leads, contactos, oportunidades, cotizaciones, agenda, interacciones).
- Resolver datos operativos del ERP externo Zauru sin delegar esa verdad al frontend.
- Gestionar comunicaciones omnicanal (WhatsApp, Instagram, Messenger) a traves de un servicio de comunicaciones externo.
Repositorio
Section titled “Repositorio”El codigo fuente vive en un repositorio independiente (BoostAPI), separado del monorepo del frontend.
Para detalles internos sensibles (credenciales, seeds de produccion, configuraciones de empresa), consulta los archivos
.mdprivados dentro deBoostAPI/docs/.
Arquitectura a vista de pajaro
Section titled “Arquitectura a vista de pajaro”Browser/Mobile | v Monorepo Web (Next.js) --- BFF Layer ---> BoostAPI (NestJS) | | | +---------+----------+ | | | | v MySQL Zauru ERP AWS S3 Monorepo Native (Expo) | | Communications +--- BFF via Web -----------------> (WhatsApp/Meta)Secciones de esta documentacion
Section titled “Secciones de esta documentacion”- Arquitectura – Modulos, patrones, capas del sistema
- Autenticacion y RBAC – JWT, roles, permisos, flujo de login
- Referencia de API – Todos los endpoints organizados por dominio
- Interacciones y Mensajeria – WhatsApp, webhooks, tiempo real
- Webhooks – Endpoints de ingestion y configuracion
- Modelo de Datos – Tablas, relaciones, entidades
- Integraciones Externas – Zauru, Communications, S3
- Variables de Entorno – Configuracion y setup local
- Despliegue – Render, modos de runtime, CORS
- Errores comunes – Problemas frecuentes y soluciones
- Roadmap – Estado actual y plan a futuro
