🛠️ Prototyp Dokumentation

Version 0.2 · Stand: 1. März 2026

Technische Architektur, IT-Umfeld und Deployment des MoPilot-Prototyps. Betreiber: ZEO Carsharing (Region Bruchsal) + Car&RideSharing Community eG (cc)

Systemarchitektur

NUTZER (Browser)
mopilot.website / zeo-kunden.mopilot.website
        │ HTTPS
        ▼
HETZNER CX33 (142.132.232.211)
  └── COOLIFY / Traefik (Reverse Proxy, SSL via Let's Encrypt)
        ├── FRONTEND  – Next.js 14 :3000
        └── BACKEND   – FastAPI :8000
              ├── PostgreSQL :5432
              └── Redis :6379
                    │
              ANTHROPIC CLOUD API
              Claude Sonnet (rollenspez. System-Prompt)

Tech Stack

Schicht	Technologie	Details
Frontend	Next.js 14	Node 20, TailwindCSS, Leaflet.js
Backend	FastAPI	Python 3.11, Anthropic SDK, SSE-Streaming
KI-Modell	Claude Sonnet	Anthropic Cloud API, rollenspez. System-Prompts
Datenbank	PostgreSQL :5432	User, ChatMessages, Stations, Vehicles, Tariffs, FAQs
Cache	Redis :6379	Session-Verwaltung
Authentifizierung	JWT	8h Token-Gültigkeit, bcrypt Passwort-Hashing
Infrastruktur	Hetzner CX33	Server IP: 142.132.232.211
Deployment	Coolify	Docker Compose, Auto-SSL, Health Checks
CI/CD	GitHub Actions	Auto-Deploy bei Push auf master (~90 Sek.)
DNS	IONOS	A-Records für mopilot.website Subdomains

Backend API-Endpunkte

POST /api/auth/login     → JWT-Token (8h Gültigkeit)
POST /api/chat/send      → KI-Antwort (rollenspezifisch + Chat-History)
GET  /api/knowledge/     → Wissensbasis / FAQs
GET  /api/stations/      → Stationsdaten
GET  /api/vehicles/      → Fahrzeugdaten
GET  /api/tariffs/       → Tarife
GET  /api/health         → {"status": "ok"}

CI/CD Pipeline

Vollautomatisch via GitHub Actions. Trigger: Push auf master-Branch. Dauer: ~60–90 Sekunden.

git push→ GitHub Actions→ SSH auf Hetzner→ git pull→ Coolify Rebuild→ LIVE

Sub-Projekte

✅ Livezeo-kunden.mopilot.website1. März 2026

Öffentlicher Endkunden-Assistent für ZEO Carsharing. Entwickelt in einer einzigen Claude Code Session (35 Dateien, 2.736 Codezeilen).

🔜 Geplanthotline.mopilot.websiteIn Planung

Internes Tool für Hotline-Mitarbeiter (Vianova eG). Zweispaltiges Layout, Gesprächsleitfaden, Dunkel-Modus. Geschätzter Aufwand: 3–4 Tage.

Datenbasis (ZEO)

🚗

vehicles.json

9 Fahrzeugmodelle

💶

tariffs.json

2 Tarife (eco, eco plus)

📍

stations.json

12 Musterstationen

❓

faq.json

18 FAQs in 3 Kategorien