Arquitectura
Cómo está construido MyBotBox — el modelo C4, el pipeline de solicitudes, la multi-tenencia y el flujo de datos de ejecución.
MyBotBox es una plataforma multi-tenant para construir, desplegar y ejecutar flujos de trabajo de agentes de IA. Esta sección es la referencia de diseño del sistema: cómo encajan las piezas, cómo se autentica y autoriza una solicitud, cómo se aíslan los tenants y cómo se ejecuta realmente un flujo de trabajo.
Estas páginas describen la arquitectura alojada. El mismo código base puede ser autoalojado — cada dependencia externa (base de datos, caché, cola, almacenamiento, correo electrónico, proveedor LLM) está detrás de un puerto intercambiable, por lo que puedes apuntarlo a tu propia infraestructura.
En resumen
graph LR
subgraph BUILD ["Build"]
A[Visual Canvas] --> B[190 Blocks]
end
subgraph ENGINE ["Engine"]
C[Serializer] --> D[Executor DAG]
D --> E[30 Block Handlers]
end
subgraph DEPLOY ["Deploy"]
F[REST API]
G[Webhook]
H[Schedule / Poll]
I[Chat]
end
B --> C
E --> F & G & H & IUn flujo de trabajo se crea en un canvas de ReactFlow, se serializa en un grafo de ejecución, es ejecutado por un ejecutor DAG topológico que despacha cada nodo a un handler tipado, y se despliega como una versión inmutable accesible por API, webhook, programación, sondeo o chat.
En esta sección
Modelo C4
Vistas de Contexto → Contenedor → Despliegue → Componente → Código de la plataforma.
Pipeline de solicitudes
Las puertas compartidas de autenticación, autorización y límite de velocidad por las que pasa cada llamada a la API.
Multi-tenencia
Organizaciones, espacios de trabajo, flujos de trabajo, el modelo de permisos y el identificador YID.
Ejecución y flujo de datos
Cómo una ejecución avanza desde el disparador hasta los handlers, los registros y la medición de costes.
Tecnología
| Capa | Tecnología |
|---|---|
| Runtime | Bun, Turborepo monorepo |
| Framework | Next.js 16 (App Router), React 19, TypeScript (strict) |
| Base de datos | PostgreSQL 17 (Cloud SQL) + pgvector, Drizzle ORM (90 tablas) |
| Caché / límite de velocidad | Memorystore Redis 7 (ventana deslizante), fallback en memoria |
| Cola | Cloud Tasks + Cloud Functions (despacho asíncrono, sondeo) |
| Autenticación | Firebase Auth (OAuth, SSO/SAML, TOTP), cookie de sesión JWT |
| IA | 17 adaptadores de proveedor (OpenAI, Anthropic, Gemini, Bedrock, …) |
| Pagos | Stripe (suscripciones + medición de uso) |
| Alojamiento | Google Cloud Run (despliegue canario azul-verde) |
| Observabilidad | OpenTelemetry, Sentry, Datadog |