bsiggel/motia
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(docs): Revise architecture overview and diagram for clarity and accuracy

Browse Source
This commit is contained in:
bitbylaw
2026-02-09 10:55:31 +00:00
parent 8dc699ec9e
commit 64b8c8f366
1 changed files with 36 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

66
bitbylaw/docs/ARCHITECTURE.md
View File

@@ -2,51 +2,49 @@
## Systemübersicht ## Systemübersicht
Das bitbylaw-System ist eine event-driven Integration zwischen Advoware, EspoCRM, Google Calendar, Vermieterhelden und 3CX Telefonie, basierend auf dem Motia Framework. Die Architektur folgt einem modularen, mikroservice-orientierten Ansatz mit klarer Separation of Concerns. Das bitbylaw-System ist eine event-driven Integration Platform mit Motia als zentraler Middleware. Motia orchestriert die bidirektionale Kommunikation zwischen allen angebundenen Systemen: Advoware (Kanzlei-Software), EspoCRM/VMH (CRM), Google Calendar, Vermieterhelden (WordPress), 3CX (Telefonie) und Y (assistierende KI).
### Kernkomponenten ### Kernkomponenten
``` ```
┌─────────────────────────────┐ ┌──────────────────────┐
│ KONG API Gateway │ │ KONG API Gateway │
│ api.bitbylaw.com │ │ api.bitbylaw.com │
│ (Auth, Rate Limiting) │ │ (Auth, Rate Limit) │
└──────────────┬──────────────┘ └──────────┬───────────┘
│ │
┌──────────────────────────┼──────────────────────────┐
│ │ │
┌────▼────────┐ ┌──────▼─────────┐ ┌─────▼──────┐
│ Vermieter- │ │ Motia │ │ 3CX │
│ helden.de │────────▶│ Framework │◀────────│ Telefonie │
│ (WordPress) │ │ (Middleware) │ │ (ralup) │
└─────────────┘ └────────┬───────┘ └────────────┘
Leads Input │ Call Handling
│ │
┌───────────────────────────┼───────────────────────────┐ ┌────────────────────┼────────────────────┐
│ │ │ │ │ │
┌────▼────┐ ┌──────▼──────┐ ┌──────▼─────┐ │ ▼ │
│Advoware │ │ VMH │ │ Calendar │ │ ┌──────────────────┐ │
│ Proxy │ │ Webhooks │ │ Sync │ │ │ │ │
└────┬────┘ └─────┬───────┘ └─────┬──────┘ ┌─────────┼─────────▶│ Motia │◀──────────┼──────────┐
│ │ │ │ │ │ (Middleware) │ │ │
│ │ │ │ │ │ Event-Driven │ │ │
┌────▼─────────────────────────▼──────────────────────────▼────┐ │ │ │ │ │ │
│ Redis (3 DBs) │ │ │ └──────────────────┘ │ │
│ DB 1: Caching & Locks │ │ │ ▲ │ │
│ DB 2: Calendar Sync State │ │ │ │ │ │
└───────────────────────────────────────────────────────────────┘ │ │ ┌─────────┴─────────┐ │ │
│ │ │ │ │ │ │
┌────▼────────────────────────────┐ ▼ ▼ ▼ ▼ ▼ ▼
│ External Services │ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐
├─────────────────────────────────┤ │ Y │ │VMH/CRM│ │Google │ │Advo- │ │ 3CX │ │Vermie-│
│ • Advoware REST API │ │ KI │ │EspoCRM│ │Calen- │ │ware │ │Tele- │ │terHel-│
│ • EspoCRM (VMH) │ │Assist.│ │ │ │ dar │ │ │ │fonie │ │den.de │
│ • Google Calendar API │ └───────┘ └───────┘ └───────┘ └───────┘ └───────┘ └───────┘
│ • 3CX API (ralup.my3cx.de) │ AI CRM Calendar Kanzlei Calls Leads
│ • Vermieterhelden WordPress │ Context Management Sync Software Handling Input
└─────────────────────────────────┘
``` ```
**Architektur-Prinzipien**:
- **Motia als Hub**: Alle Systeme kommunizieren ausschließlich mit Motia
- **Keine direkte Kommunikation**: Externe Systeme kommunizieren nicht untereinander
- **Bidirektional**: Jedes System kann Daten senden und empfangen
- **Event-Driven**: Ereignisse triggern Workflows zwischen Systemen
- **KONG als Gateway**: Authentifizierung und Rate Limiting für alle API-Zugriffe
## Komponenten-Details ## Komponenten-Details
### 0. KONG API Gateway ### 0. KONG API Gateway