Options-Fundament und Kapitalmodell im Core; Modul OptionsWheel

Das OptionsWheel setzt auf Dingen auf, die es im Core nicht gab. Diese
Sitzung baut sie.

#298 Optionen als Instrument. InstrumentKind/OptionSpec und ein
druckbarer Instrumentenschluessel ("AAPL|20260918|C|150"); TradeSignal
und OrderRequest tragen ein optionales OptionSpec, ohne das sich der
Aktienpfad unveraendert verhaelt. Position.Notional rechnet ab jetzt mit
der Kontraktgroesse - vorher war jede Option um Faktor 100 zu klein
bewertet und damit jedes Risikolimit wirkungslos, lautlos und in die
gefaehrliche Richtung. Daneben neu BoundCapital: ein Short Put bindet
Strike x Kontraktgroesse, nicht die vereinnahmte Praemie.

#300 sell-to-open. Jeder Auftrag zerfaellt in einen schliessenden und
einen eroeffnenden Teil; der schliessende wird von keinem Limit
verhindert - auch nicht vom Kaufstopp, denn ein Rueckkauf baut eine
Verpflichtung ab. Deckungspruefung im Core, nicht im Modul: Short Call
nur mit freien Aktien, Short Put nur mit reservierbarem Bargeld.

#302-#305 Kapital- und Buchmodell. Buecher mit reservierten Namen und
Eigentumsregeln, Pool mit Caps und Headroom, Margin-Sperre in vier
Schichten, core_reservation mit Lebenszyklus, Frist, Idempotenz ueber
(SignalId, ContractKey) und Quarantaene beim Start.

#309/#310 Modul OptionsWheel: ow_-Schema mit fuenf Tabellen,
Zustandsautomat, StrikeSelector, RollDecider, PremiumMath - vollstaendig
ohne Broker testbar. Der Handelsbetrieb bleibt gesperrt, solange #299
und #294 fehlen; das Modul sagt das ueber GetActivationBlocker, statt
still nichts zu tun.

#293 --verify-order am Daemon: eine Order durch die vollstaendige Kette
(Buch, Risiko, Bindung, Order, Fill, Buchung, Abschluss). Ohne --confirm
ein Trockenlauf; Abbruch ausserhalb von Paper-Modus UND Paper-Port.

Drei Widersprueche in den Konzepten sind dabei entschieden worden:
Schicht B heisst ab jetzt "kein UNGEDECKTER Short" (der Grund der Regel
war der Kredit, nicht der Short), die Hausreserve wird einmal abgezogen
statt zweimal, und der Positionsschluessel ist eine Spalte statt eines
Sechser-Verbunds (MySQL verlangt NOT NULL fuer Schluesselspalten).
Begruendungen stehen in docs/ROADMAP.md.

Enthaelt ausserdem die noch nicht committete Arbeit aus der vorigen
Sitzung: die Fehlerbehebungen aus Epic X (WorkerBase-Intervall,
BackupWorker, --check gegen die Datenbank, CapitolTrades-429, SIGTERM)
samt DatabaseEndpoint, MysqlDumpTool und der Roadmap-Umstellung. Sie lag
im Arbeitsbaum und liess sich nicht abtrennen, weil beide Staende
dieselben Dateien beruehren.

213 -> 369 Tests, Build ohne Warnung.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

deploy/README.md

@@ -113,3 +113,54 @@ eine eigene Baustelle, unabhängig von diesem Dienst. Alternative: das Gateway b
 Windows-Rechner, der Linux-Dienst verbindet sich über Port 4002. Dann muss in der
 TWS-Konfiguration die erlaubte Client-IP eingetragen sein; der TWS-API-Verkehr ist
 **unverschlüsselt** und gehört nicht über ein unvertrautes Netz.
+
+## Anwendungssymbol
+
+Beide Betriebsformen tragen dasselbe Symbol. Die Quelle ist `icon.ico` im Projektstamm, daneben
+liegt die verlustfrei daraus entnommene `icon.png` (256×256, RGBA).
+
+| Wo es auftaucht | Woher es kommt |
+|---|---|
+| Fenster, Fensterliste, Alt-Tab der Shell | `Window.Icon`, gesetzt in `Shell/AppIcon.cs` aus der eingebetteten `icon.png` |
+| Programmdatei unter Windows (Explorer, Task-Manager) | `<ApplicationIcon>` in beiden `.csproj` – dort ist `.ico` Pflicht |
+| Anwendungsmenü und Dock unter Linux | `deploy/ibkrtrader.desktop` samt installiertem Symbol |
+| Watchdog-Dashboard des Deploymentcenters | **nicht** aus der Anwendung – im WebUI je Monitor hochzuladen |
+
+> **Warum zwei Dateien.** Für die Windows-Programmdatei ist `.ico` ein Pflichtformat – es ist eine
+> PE-Ressource, kein Anzeigeformat. Für `Window.Icon` wäre es der falsche Weg: Der X11-Rücken von
+> Avalonia dekodiert über Skia, und Skia kennt ICO nicht. Unter Windows fiele das nie auf, auf dem
+> Linux-Server bliebe das Fenster ohne Symbol – also genau dort, wo es gebraucht wird. Wird das
+> Symbol ausgetauscht, gehören **beide** Dateien getauscht; `icon.png` entsteht aus dem
+> 256×256-Eintrag der `.ico`.
+
+`--smoke-ui` prüft das Symbol mit: `[OK] Anwendungssymbol (Assets/icon.png)`. Schlägt es fehl, ist
+die `AvaloniaResource`-Zeile in `IBKRTrader.App.csproj` verlorengegangen oder die PNG beschädigt.
+Zur Laufzeit bleibt ein fehlendes Symbol folgenlos – die Oberfläche startet ohne. Genau deshalb
+muss es im Rauchtest auffallen und nicht erst auf dem Server.
+
+### Desktop-Eintrag
+
+Nur für die Shell (`IBKRTrader.App`) auf einem Linux-Rechner mit Arbeitsumgebung. Der Dienst
+braucht ihn nicht – er zeigt kein Fenster.
+
+```bash
+sudo install -m 644 icon.png /usr/share/icons/hicolor/256x256/apps/ibkrtrader.png
+sudo install -m 644 deploy/ibkrtrader.desktop /usr/share/applications/
+sudo gtk-update-icon-cache -f /usr/share/icons/hicolor
+```
+
+`Exec=` in der `.desktop` zeigt auf `/opt/ibkrtrader-app/IBKRTrader.App` und ist an die
+tatsächliche Installation anzupassen. `StartupWMClass=IBKRTrader.App` verbindet die Fenster der
+laufenden Anwendung mit dem Eintrag – der Wert ist die WM_CLASS, die Avalonia unter X11 setzt
+(am 2026-09-01 auf der Test-VM mit `xprop WM_CLASS` nachgemessen, nicht geraten).
+
+> **Nachgemessen am 2026-09-01.** Auf der Test-VM (Xvfb `:96` mit metacity) trägt das Fenster der
+> Shell `_NET_WM_ICON(CARDINAL) = Icon (128 x 128)` — das Symbol kommt also bis nach X11 durch;
+> Avalonia skaliert dabei auf 128×128 herunter. `desktop-file-validate` beanstandet die
+> `.desktop` nicht, und die drei Installationsbefehle oben laufen unverändert durch.
+>
+> Ein Fenstermanager ist für diese Prüfung **Voraussetzung**: Unter blankem Xvfb fehlt
+> `_NET_SUPPORTED` auf dem Wurzelfenster, und Avalonia setzt dann gar keine EWMH-Eigenschaften —
+> weder `_NET_WM_ICON` noch `_NET_WM_PID` oder `_NET_WM_NAME`, während die ICCCM-Eigenschaften
+> (`WM_NAME`, `WM_CLASS`, `WM_PROTOCOLS`) gesetzt sind. Wer ohne Fenstermanager misst, hält das
+> für einen Fehler der Anwendung. Auf der Test-VM liegt dafür seit dem 2026-09-01 metacity bereit.

deploy/ibkrtrader.desktop

@@ -0,0 +1,31 @@
+#
+# Desktop-Eintrag für die Avalonia-Shell (IBKRTrader.App) unter Linux.
+#
+# Wozu: Ohne diesen Eintrag kennt die Arbeitsumgebung nur das Fenster, nicht die Anwendung.
+# In Fensterleiste, Alt-Tab und Dock steht dann der generische Platzhalter – und mehrere
+# gleichzeitig laufende Anwendungen sind nicht auseinanderzuhalten. Genau dafür ist er da.
+#
+# Das Fenstersymbol selbst kommt aus der Anwendung (Shell/AppIcon.cs) und braucht diese Datei
+# nicht. Sie liefert den Rest: Name im Menü, Symbol im Dock, Zuordnung Fenster -> Anwendung.
+#
+# Einrichten (siehe deploy/README.md, Abschnitt "Desktop-Eintrag"):
+#   sudo install -m 644 icon.png /usr/share/icons/hicolor/256x256/apps/ibkrtrader.png
+#   sudo install -m 644 deploy/ibkrtrader.desktop /usr/share/applications/
+#   sudo gtk-update-icon-cache -f /usr/share/icons/hicolor   # falls vorhanden
+#
+# Exec-Pfad an die tatsächliche Installation anpassen.
+#
+[Desktop Entry]
+Type=Application
+Version=1.0
+Name=IBKRTrader
+GenericName=Trading-Framework
+Comment=Modulares Trading-Framework für Interactive Brokers
+Exec=/opt/ibkrtrader-app/IBKRTrader.App
+Icon=ibkrtrader
+Terminal=false
+Categories=Office;Finance;
+Keywords=Trading;IBKR;Interactive Brokers;Börse;
+# Verbindet die Fenster der laufenden Anwendung mit diesem Eintrag. Der Wert ist die WM_CLASS,
+# die Avalonia unter X11 setzt; nachprüfbar mit `xprop WM_CLASS` auf ein Fenster der Shell.
+StartupWMClass=IBKRTrader.App