@

Phase 0: Test-Fundament & Architektur-Doku - IBKRTrader.Tests (xUnit + NSubstitute + FluentAssertions), nur Unit-Tests - Repo-lokale NuGet.config: Test-Pakete in Allowlist ergaenzt - Hauptprojekt: Test-Unterordner aus SDK-Globbing ausgeschlossen - docs/ARCHITECTURE.md: Plan + Phasen-Checkliste - grundregeln.md: .NET 10, Launcher-Modell; DB-Passwort entfernt Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> @
2026-07-27 09:58:49 +02:00
parent ebeb035e92
commit 9abad277c2
7 changed files with 253 additions and 7 deletions
@@ -0,0 +1,135 @@
+# IBKRTrader – Architektur & Implementierungsplan
+
+Umbau von IBKRTrader auf das **Polytrader-Grundprinzip**:
+**harter Core + beliebig viele unabhängige Module + ein Launcher, der die Fenster der
+einzelnen Module öffnet.** Statt Polymarket wird über Interactive Brokers gehandelt.
+
+> Polytrader dient als *konzeptionelle* Vorlage (Python/FastAPI + tkinter-Launcher + Web-UI),
+> nicht als Code-Vorlage. IBKRTrader ist ein C#/.NET-10-WinForms-Framework.
+
+---
+
+## 1. Zielarchitektur
+
+```
+Program.cs (DI-Bootstrap)
+│
+├── CORE  (harter Kern – kennt KEIN Modul)
+│   ├── Settings          AppSettings + settings.json
+│   ├── Logging           rtb + Logs/[Modul]/[Level]
+│   ├── Database          MySQL/Dapper + Migrationen (core_)
+│   ├── IBKR              Marktdaten [vorhanden] + Orders [neu]
+│   ├── Portfolio         Positionen/Balance/P&L (core_)          [neu]
+│   ├── Execution + Risk  Signal → Prüfung → Order → Buchung      [neu]
+│   ├── Workers           WorkerEngine + Core-Worker
+│   └── Modules           IModule-Vertrag + ModuleRegistry        [neu]
+│
+├── MODULES  (unabhängige Strategien – Abhängigkeit nur Modul → Core)
+│   └── CongressTrading   Scraper + Repo + Worker [vorhanden]
+│                         + Strategie + Fenster [neu]
+│
+└── UI
+    ├── LauncherForm      Basis: Core-Status, Worker-Grid, Logs, Settings,
+    │                     Modul-Liste mit „Fenster öffnen"-Buttons
+    └── ModuleFormBase    Basisklasse für eigenständige Modul-Fenster
+```
+
+### Kernregeln (siehe auch `.agents/rules/grundregeln.md`)
+- Core kennt kein Modul. Module hängen sich über DI + `IModule` ein. Abhängigkeit nur Modul → Core.
+- DB-Tabellen: `{ModulKürzel}_name` (Core = `core_`, CongressTrading = `ct_`).
+- Jeder Worker ist unabhängig ein-/ausschaltbar, hat eigenen Zeitplan, ist manuell triggerbar.
+- **Strategie lebt im Modul, nicht im Core.** Der Core stellt nur Primitive bereit
+  (Orders, Portfolio, Risiko); das Modul liefert nur ein `TradeSignal` an den `ExecutionService`.
+
+### Festgelegte Entscheidungen
+| Thema | Festlegung |
+|---|---|
+| Modul-Fenster | Eigenständige Top-Level-Fenster; Launcher trackt `Key → Form`, fokussiert bei Re-Open |
+| Demo-Betrieb | IBKR **Paper-Account** (Port 4002); Umschaltung Paper/Live via `TradingSettings.Mode` |
+| Tests | `IBKRTrader.Tests` (xUnit + NSubstitute + FluentAssertions), **nur Unit**, alles Externe gemockt |
+| DoD je Phase | `dotnet test` (Unit) grün **und** Build sauber |
+
+---
+
+## 2. Abbildung Polytrader → IBKRTrader
+
+| Polytrader | Rolle | IBKRTrader |
+|---|---|---|
+| `main.py` + `api/server.py` lifespan | Entry-Point, Orchestrierung, Background-Loops | `Program.cs` (DI) + `WorkerEngine` |
+| `config.py` | zentrale Config | `SettingsService` / `AppSettings` |
+| `database/` | Buchführung | `DatabaseService` + Migrationen + Repos |
+| `polymarket_client.py` | Plattform-Anbindung | `IIbkrClient` (Marktdaten + Orders) |
+| `trade_manager.py` | Positionen/Balance/P&L | `PortfolioService` |
+| `trade_engine.py` | Signal → Risiko → Order | `ExecutionService` + `RiskService` |
+| `trader_monitor.py` | Datenquelle pollen → Signal | Modul-Worker (z. B. `CT-ScrapeWorker`) |
+| `demo_wallet.py` | Handel ohne echtes Geld | IBKR Paper-Account |
+| `desktop_gui.py` | Launcher-Fenster | `LauncherForm` |
+| `frontend/` (Sidebar → Pages) | Ansichten | Launcher-Panels + je Modul ein Fenster |
+| `telegram_notifier.py` | Benachrichtigungen | `NotificationService` (später) |
+| `module_checker.py` | Integritätscheck | Startup-Self-Check (später) |
+
+---
+
+## 3. Teststrategie
+
+- Eigenes Projekt **`IBKRTrader.Tests`** (`net10.0-windows`), im `.slnx`.
+- **Nur Unit-Tests**, deterministisch, schnell, laufen bei jedem Build/Commit.
+- Externe Abhängigkeiten hinter Interfaces (`IIbkrClient`, `IOrderService`, `IPortfolioService`,
+  `IRiskService`, `ICongressRepository` …) → in Tests via **NSubstitute** gemockt.
+- Echtes MySQL/IBKR-Paper/Scraping wird **manuell** je Meilenstein geprüft (nicht automatisiert).
+
+| Komponente | Beispiel-Testfall |
+|---|---|
+| `RiskService` | Sizing bei 5 % Budget; Ablehnung bei Slippage; globaler Pause-Schalter blockt |
+| `ExecutionService` | Signal → gemockte Risk/Order/Portfolio; Buchung & Ablehnungsgründe |
+| `CapitolTradesScraper` | Parser gegen Fixture `ct_raw.html` (deterministisch, kein Netz) |
+| `ModuleRegistry` / `IModule` | Registrierung, Worker-Sammlung, `CreateWindow` liefert Fenster |
+| `WorkerBase` | Interval-Loop, Trigger, Fehler → `Status=Error`, Cancellation |
+| `AppSettings` / `SettingsService` | Laden/Serialisieren, Paper/Live-Port-Auswahl (4002/4001) |
+| `WindowManager` | Fenster-Tracking, Re-Open fokussiert bestehendes Fenster |
+
+WinForms selbst wird **nicht** unit-getestet – Logik in Services/Manager halten, Forms dünn.
+
+---
+
+## 4. Phasenplan (Checkliste)
+
+### Phase 0 – Fundament & Doku ✅
+- [x] `grundregeln.md` auf .NET 10 + Launcher-Modell aktualisiert (+ DB-Passwort entfernt)
+- [x] `docs/ARCHITECTURE.md` angelegt
+- [x] `IBKRTrader.Tests` (xUnit + NSubstitute + FluentAssertions) angelegt, im `.slnx`
+- [x] Repo-lokale `NuGet.config` (Test-Pakete in Allowlist ergänzt)
+- [x] Erster Smoke-Test grün (`dotnet test` → 2/2 bestanden)
+
+### Phase 1 – Modul-System formalisieren (Refactoring, kein Verhaltensänderung)
+- [ ] `Core/Modules/IModule.cs` (`Key`, `DisplayName`, `Description`, `Version`, `RegisterServices`, `InitializeAsync`, `GetWorkers`, `CreateWindow`)
+- [ ] `Core/Modules/ModuleRegistry.cs`
+- [ ] `CongressTradingModule` → `IModule`
+- [ ] `Program.cs` iteriert über Registry statt CongressTrading hart zu nennen
+- [ ] Tests: `ModuleRegistry`, `WorkerBase`, `CapitolTradesScraper` (gegen `ct_raw.html`)
+
+### Phase 2 – Launcher-UI + Modul-Fenster
+- [ ] `Form1` → `LauncherForm`; Kern-Panels behalten (Workers, Logs, Settings, Core-Status)
+- [ ] Modul-Panel: Liste aus `ModuleRegistry`, je Modul „Fenster öffnen"
+- [ ] `UI/ModuleFormBase.cs` + `UI/WindowManager.cs` (Fenster-Tracking)
+- [ ] `Modules/CongressTrading/UI/CongressTradingForm.cs` (erstes Modul-Fenster)
+- [ ] Tests: `WindowManager`
+
+### Phase 3 – Trading-Kern (Core)
+- [ ] `Core/Trading/IIbkrClient.cs` (+ Adapter auf `IBKRGatewayService`)
+- [ ] `Core/Trading/IOrderService.cs` + Implementierung (Market/Limit, Paper+Live)
+- [ ] `Core/Trading/PortfolioService.cs` + Migrationen `core_position`, `core_trade`, `core_account_snapshot`
+- [ ] `Core/Trading/RiskService.cs` (Sizing, Limits, Slippage, Profit-Target, globaler Pause-Schalter)
+- [ ] `Core/Trading/ExecutionService.cs` (`TradeSignal` → Risiko → Order → Buchung)
+- [ ] `TradingSettings` in `AppSettings` (Mode Paper/Live, Risikoparameter)
+- [ ] Tests: `RiskService`, `ExecutionService` (voll gemockt)
+
+### Phase 4 – CongressTrading als vollständige Strategie
+- [ ] `CongressTradingStrategy`: neue Scrape-Trades → `TradeSignal` an `ExecutionService`
+- [ ] Modul-Fenster: offene/geschlossene Positionen, P&L, Strategie-Ein/Aus, Parameter
+- [ ] Tests: Signal-Erzeugung
+
+### Phase 5 – Feinschliff (optional)
+- [ ] `NotificationService` (Telegram o. Ä.) + periodische Reports
+- [ ] Startup-Self-Check (analog `module_checker`)
+- [ ] Dashboard-Panel im Launcher (Gesamt-Balance/P&L über alle Module)