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
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
```
┌─────────────────────────────┐
┌──────────────────────┐
│ KONG API Gateway │
│ 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 │
└────┬────┘ └─────┬───────┘ └─────┬──────┘
│ │ │
│ │ │
┌────▼─────────────────────────▼──────────────────────────▼────┐
│ Redis (3 DBs) │
│ DB 1: Caching & Locks │
│ DB 2: Calendar Sync State │
└───────────────────────────────────────────────────────────────┘
│
┌────▼────────────────────────────┐
│ External Services │
├─────────────────────────────────┤
│ • Advoware REST API │
│ • EspoCRM (VMH) │
│ • Google Calendar API │
│ • 3CX API (ralup.my3cx.de) │
│ • Vermieterhelden WordPress │
└─────────────────────────────────┘
│ ▼ │
│ ┌──────────────────┐ │
│ │ │ │
┌─────────┼─────────▶│ Motia │◀──────────┼──────────┐
│ │ │ (Middleware) │ │ │
│ │ │ Event-Driven │ │ │
│ │ │ │ │ │
│ │ └──────────────────┘ │ │
│ │ ▲ │ │
│ │ │ │ │
│ │ ┌─────────┴─────────┐ │ │
│ │ │ │ │ │
▼ ▼ ▼ ▼ ▼ ▼
┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐
│ Y │ │VMH/CRM│ │Google │ │Advo- │ │ 3CX │ │Vermie-│
│ KI │ │EspoCRM│ │Calen- │ │ware │ │Tele- │ │terHel-│
│Assist.│ │ │ │ dar │ │ │ │fonie │ │den.de │
└───────┘ └───────┘ └───────┘ └───────┘ └───────┘ └───────┘
AI CRM Calendar Kanzlei Calls Leads
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
### 0. KONG API Gateway