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

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