Architektur
Wie MyBotBox aufgebaut ist – das C4-Modell, die Request-Pipeline, Multi-Tenancy und der Ausführungs-Datenfluss.
MyBotBox ist eine mandantenfähige Plattform zum Erstellen, Bereitstellen und Ausführen von KI-Agenten-Workflows. Dieser Abschnitt ist die Systemdesign-Referenz: wie die einzelnen Teile zusammenpassen, wie eine Anfrage authentifiziert und autorisiert wird, wie Mandanten isoliert werden und wie ein Workflow tatsächlich ausgeführt wird.
Diese Seiten beschreiben die gehostete Architektur. Dieselbe Codebasis kann selbst gehostet werden – jede externe Abhängigkeit (Datenbank, Cache, Queue, Speicher, E-Mail, LLM-Anbieter) steckt hinter einem austauschbaren Port, sodass du sie auf deine eigene Infrastruktur ausrichten kannst.
Auf einen Blick
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 & IEin Workflow wird auf einem ReactFlow-Canvas erstellt, in einen Ausführungsgraphen serialisiert, von einem topologischen DAG-Executor ausgeführt, der jeden Knoten an einen typisierten Handler weiterleitet, und als unveränderliche Version bereitgestellt, die per API, Webhook, Zeitplan, Polling oder Chat erreichbar ist.
In diesem Abschnitt
C4-Modell
Kontext → Container → Deployment → Komponente → Code-Ansichten der Plattform.
Request-Pipeline
Die gemeinsamen Authentifizierungs-, Autorisierungs- und Rate-Limit-Prüfungen, die jeder API-Aufruf durchläuft.
Multi-Tenancy
Organisationen, Workspaces, Workflows, das Berechtigungsmodell und der YID-Bezeichner.
Ausführung & Datenfluss
Wie ein Lauf vom Auslöser über Handler bis hin zu Logs und Kostenerfassung verläuft.
Technologie
| Schicht | Technologie |
|---|---|
| Laufzeitumgebung | Bun, Turborepo-Monorepo |
| Framework | Next.js 16 (App Router), React 19, TypeScript (strict) |
| Datenbank | PostgreSQL 17 (Cloud SQL) + pgvector, Drizzle ORM (90 Tabellen) |
| Cache / Rate-Limit | Memorystore Redis 7 (Sliding Window), In-Memory-Fallback |
| Queue | Cloud Tasks + Cloud Functions (asynchroner Versand, Polling) |
| Auth | Firebase Auth (OAuth, SSO/SAML, TOTP), JWT-Session-Cookie |
| KI | 17 Anbieter-Adapter (OpenAI, Anthropic, Gemini, Bedrock, …) |
| Zahlungen | Stripe (Abonnements + Nutzungsabrechnung) |
| Hosting | Google Cloud Run (Blue-Green-Canary-Deployment) |
| Observability | OpenTelemetry, Sentry, Datadog |