🏗️ Plattform – Overview
Ziel
Die Plattform stellt eine technische Grundlage für die Entwicklung, den Betrieb und die Erweiterung von modularen Softwarelösungen bereit.
Sie basiert auf einer Microservice-Architektur und ermöglicht die parallele Entwicklung und Ausführung mehrerer unabhängiger Services.
Kernidee
Die Plattform ist verantwortlich für:
- Bereitstellung zentraler Infrastruktur
- Bereitstellung gemeinsamer Funktionen (z. B. Authentifizierung)
- Orchestrierung und Betrieb von Services
Architektur-Ansatz
- Service-orientiert (Microservices)
- Containerisiert (Docker)
- Headless (API-first)
- Erweiterbar (Plug-in-ähnliche Services)
Abgrenzung
Plattform
- stellt Fähigkeiten bereit
- verwaltet Infrastruktur
- definiert Standards
Services
- implementieren Business Logik
- nutzen Plattform-Funktionen
Zielbild
Plattform ├── Auth / User / Security ├── Routing / Proxy ├── Monitoring └── Runtime (Docker) Services ├── Service A ├── Service B └── Service C Touchpoint ├── Web (React SPA/PWA – bündelt alle Service-Tabs, ein Touchpoint mit zwei │ Zugriffsarten: installiert als PWA oder im normalen Browser-Tab – │ technisch dieselbe Anwendung, kein separater zweiter Touchpoint) └── Trading Companion App (Capacitor-Wrapper, kein eigenes Backend)
Abgrenzung Touchpoint: Keine eigene Business-Logik, kein eigenes Backend/ keine eigene Datenhaltung – konsumiert ausschließlich Plattform-Fähigkeiten und Service-APIs. Cross-cutting: ein Touchpoint kann mehrere Services bündeln, statt zu genau einem zu gehören (im Unterschied zu Services, die genau einer fachlichen Domäne zugeordnet sind).
Migrationshinweis: platform/frontend/ (Doku) verschiebt sich
konzeptionell nach touchpoint/web/ – die React-SPA bündelt alle Service-Tabs
und stellt selbst keine Fähigkeit bereit, die andere Services nutzen,
sondern konsumiert deren APIs. Betrifft nur die Dokumentations-Ablage,
nicht den Code (der Frontend-Container läuft unverändert). Die
platform/architecture/overview.md listet "Frontend" ohnehin schon
gleichrangig neben den anderen Containern, nicht als Platform-internen
Baustein – die Doku-Struktur zieht damit nur nach, was in der
Deployment-Realität schon so ist.
Laufzeitumgebung
- Raspberry Pi als Host
- optional zusätzliche Nodes (z. B. Worker)
- Zugriff über:
- Heimnetz
- Internet (über Proxy/Tunnel)
Entwicklungsmodell
- Documentation-first
- AI-assisted (Claude)
- iterative Weiterentwicklung
Entwicklungsworkflow
Git Push (Remote immer voraus)
Das Remote-Repository hat stets Commits, die lokal fehlen. Standardmäßiger Push-Ablauf:
Docker Build & Restart
Changelog
| Version | Datum | Änderungen |
|---|---|---|
| 1.2 | 2026-07-13 | Korrektur: PWA und Browser sind kein zwei separate Touchpoints, sondern dieselbe React-SPA (siehe platform/frontend/overview.md) – zu einem Touchpoint "Web" zusammengeführt. Migrationshinweis ergänzt: Frontend-Doku gehört konzeptionell zu touchpoint/web/, nicht zu platform. |
| 1.1 | 2026-07-13 | Zielbild um dritte Top-Level-Kategorie "Touchpoint" ergänzt (parallel zu Plattform und Services) – ausgelöst durch die neue Trading Companion App, die weder Business-Logik noch Plattform-Infrastruktur bereitstellt, sondern reine Konsumseite mehrerer Services ist |
| 1.0 | 2026-06-25 | Initiale Version |