Konzept Mehrere Handelsplattformen: Polymarket US, spaeter Kalshi (#622-#629)

Ein Kunde mit US-Wohnsitz soll ueber Polymarket US handeln - eine eigene, CFTC-regulierte Boerse, an der die heutige CLOB-Anbindung nicht verwendbar ist. Das Konzept macht Plattform zu einem Begriff im Core, laesst Module ihre Plattformen erklaeren und haelt Strategievarianten je Plattform im Modul. Begruendungen zu #622-#629 in docs/ROADMAP.md, Bauanleitung in docs/archiv/konzepte/KONZEPT-Multi-Plattform.md. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 10:54:00 +02:00
parent 94716157cf
commit 05979406c7
3 changed files with 445 additions and 0 deletions
@@ -408,6 +408,80 @@ Abgleich der unabhängig erhobenen Buchhaltung gegen die eigene Trading-DB. Nied
 aber der eigentliche Prüfwert des Moduls: **Abweichungen zwischen beiden Quellen sind das
 Signal.**
 ### Mehrere Handelsplattformen (#622–#627)
 **Anlass (16.09.2026):** Ein Kunde mit Wohnsitz in den USA kann KYC machen. polymarket.com sperrt
 US-IPs, er muss über **Polymarket US** handeln — eine eigene, CFTC-regulierte Börse mit eigener
 API. Von der heutigen CLOB-Anbindung ist dort nichts verwendbar: andere Anmeldung (Ed25519 statt
 EIP-712/HMAC), Märkte per Slug statt Token-ID, USD statt USDC, automatische Abwicklung statt
 Redeem, andere Gebührenformel, eigener Liquiditätspool.
 Richard hat entschieden: Wir bauen nicht nur einen zweiten Adapter, sondern machen **Plattform zu
 einem Begriff im Core**, damit später Kalshi ein weiterer Adapter ist und kein weiterer Umbau.
 Module erklären ausdrücklich, welche Plattformen sie bedienen; Strategien dürfen sich je Plattform
 unterscheiden.
 **Warum in B und nicht in C:** Es entsteht kein neues Strategiemodul, sondern ein weiterer Weg, die
 gebauten Module an echtes Geld zu bringen. Die Abhängigkeit von A bleibt: Ohne Betriebsfreigabe
 (#621) und Feldtest handelt auch der US-Kunde nicht live.
 **Die zwei Auflagen, die das Konzept trägt:**
 1. **Der Global-CLOB-Code wird umhüllt, nicht umgebaut.** `PolymarketClobClient` bleibt Zeile für
   Zeile, wie er ist; der Global-Adapter übersetzt nur. Ein Fundament, das den bewährten Geldpfad
   verändert, wäre teurer als der US-Kunde wert ist.
 2. **Die Plattform-Erklärung eines Moduls wirkt im Handelspfad**, nicht nur in der Anzeige. Das
   Order-Gateway lehnt ab, was das auslösende Modul nicht erklärt hat — dieselbe Lehre wie #569/#570.
 → [archiv/konzepte/KONZEPT-Multi-Plattform.md](./archiv/konzepte/KONZEPT-Multi-Plattform.md)
 ### [B] #622 — PL-0: Voraussetzungen für den US-Kunden klären
 Keine Programmierarbeit, aber ohne sie ist #625 nur lesend baubar: API-Schlüssel des Kunden,
 Serverstandort (US-Standort gegen US-IP-Sperre von polymarket.com), ob es für die Retail-API eine
 Testumgebung gibt, und unsere Rolle beim automatisierten Handel auf einem fremden KYC-Konto.
 ### [B] #623 — PL-1: Plattform-Fundament im Core
 `PlatformId`, `PlatformCapabilities`, neutrale Verträge mit `InstrumentRef` statt `TokenId`,
 Registry, Global-Adapter als Hülle, Spalte `platform` mit Vorgabe `polymarket-global`.
 **Akzeptanz: Verhalten unverändert, Diff an `PolymarketClobClient.cs` leer.** `TokenId` steht in
 73 Dateien — deshalb bleibt es als Eigenschaft erhalten und zieht schrittweise um.
 ### [B] #624 — PL-2: Module erklären ihre Plattformen
 **Auslöser: sobald #623 abgeschlossen ist.**
 `IPolyTraderModule.SupportedPlatforms` mit Vorgabe „nur Global" — ein Modul, das nichts erklärt,
 verhält sich wie heute. Kennzeichen in Modul-Tab und Kontenansicht (Desktop und WebUI aus einer
 Core-Regel, wie seit #560), Warnung bei Konten ohne Modul, Sperre im Order-Gateway.
 Warum Erklärung **und** Fähigkeiten: Dass eine Plattform alles Nötige *hat*, heißt nicht, dass die
 Strategie dort *geprüft* ist.
 ### [B] #625 — PL-3: Adapter Polymarket US
 **Auslöser: sobald #623 abgeschlossen ist; echte Orders zusätzlich erst nach #622.**
 Erst lesend, dann Demo gegen das echte US-Buch, dann Orders. Die Retail-API hat keine dokumentierte
 Sandbox — Demo gegen Produktion ist damit der einzige Weg zur Messphase.
 ### [B] #626 — PL-4: ResolutionFarming für Polymarket US
 **Auslöser: sobald #624 und #625 abgeschlossen sind.**
 Erste Strategie für den US-Kunden, weil sie keine fremden Wallet-Daten braucht. Die US-Gebühr
 `Θ·p·(1−p)` ist nahe 0,95 sehr klein, Maker bekommen einen Rabatt, und der Redeem (#146) entfällt.
 Global-Schwellen sind wegen des getrennten Pools **nicht** übertragbar — Startwerte kommen aus der
 Messphase.
 ### [B] #627 — PL-5: Accounting für Polymarket-US-Konten
 **Auslöser: sobald #625 abgeschlossen ist.**
 Keine Chain, keine Data-API: Aktivität, Saldo und Balance-Ledger kommen aus der US-API, in USD.
 Macht nebenbei #147 (US-Steuerschicht) greifbar — der US-Kunde ist genau dieser Fall.
 ---
 ## C — Neue Strategiemodule
@@ -543,6 +617,27 @@ keine API existiert. Berührt auch #151 — die Fingerprint-Baseline wäre von d
 Prüfplan: [pruefplaene/PREDICTALYTICS-PRUEFPLAN-Master-Auswahl.md](./pruefplaene/PREDICTALYTICS-PRUEFPLAN-Master-Auswahl.md)
 ### [D] #628 — PL-6: CopyTrading plattformübergreifend
 **Auslöser: sobald #625 abgeschlossen ist und Richard entschieden hat, ob sich das lohnt.**
 Auf Polymarket US sind fremde Wallets nicht sichtbar; CopyTrading hat dort keine eigenen Master.
 Denkbar wäre: Master weiter auf Polygon beobachten, auf dem passenden US-Markt ausführen.
 **Warum nicht beschlossen:** Nicht jeder Markt existiert in den USA, der Pool ist getrennt, Kurse
 und Gebühren weichen ab — der Einstieg liegt systematisch anders als beim Master, und genau dieser
 Abstand entscheidet heute über die Rentabilität (#163).
 → [archiv/konzepte/KONZEPT-Multi-Plattform.md](./archiv/konzepte/KONZEPT-Multi-Plattform.md)
 ### [D] #629 — PL-7: Adapter Kalshi
 **Auslöser: sobald #623 abgeschlossen ist und ein Kunde Kalshi konkret braucht.**
 Vorbereitet, nicht beschlossen. Zugleich der Prüfstein für #623: Kommt der Adapter ohne Änderung an
 einem Modul aus, trägt die Abstraktion.
 → [archiv/konzepte/KONZEPT-Multi-Plattform.md](./archiv/konzepte/KONZEPT-Multi-Plattform.md) §7
 ---
 ## T — Technische Schuld
@@ -42,6 +42,7 @@ Was hier **nicht** mehr gilt, ist der **Status**. Fortschrittsangaben, Häkchen
 | `KONZEPT-Modul-Accounting.md` | A-1/A-2/A-4 ✅, A-3 ist **B6**, A-5 ist **B7** |
 | `KONZEPT-Modul-Supervisor.md` | S-0–S-4 ✅, Live-Key-Test ist **B5** |
 | `KONZEPT-Modul-DataDriven.md` | **D1** — nicht beschlossen, es gibt keinen Umsetzungsplan |
 | `KONZEPT-Multi-Plattform.md` | #622–#627 (B), #628–#629 (D) — Polymarket US, Plattform-Abstraktion, Kalshi |
 ### Einzeldokument
@@ -0,0 +1,349 @@
 # Konzept: Mehrere Handelsplattformen (Polymarket US, später Kalshi)
 **Angelegt am 16.09.2026.** Planungsstand und Reihenfolge stehen im Deploymentcenter
 (Items #622–#629), nicht hier. Diese Datei ist die Bauanleitung und die Begründung.
 ---
 ## 1. Anlass und Ziel
 Ein Kunde mit Wohnsitz in den USA soll PolyTrader nutzen. Er darf polymarket.com nicht verwenden
 (US-IPs gesperrt), wohl aber **Polymarket US** — eine eigene, CFTC-regulierte Börse (QCX LLC als
 Designated Contract Market, QC Clearing LLC als Clearingstelle) mit KYC. Der Kunde kann KYC machen.
 Polymarket US ist technisch **ein anderer Handelsplatz**, nicht eine Variante desselben. Keine
 Zeile der heutigen CLOB-Anbindung ist dort verwendbar (siehe Abschnitt 2). Daraus folgen drei Ziele:
 1. **Ein zweiter Plattform-Adapter** für Polymarket US.
 2. **Plattform als Konzept im Core**, sodass ein dritter Handelsplatz (Kalshi) ein weiterer Adapter
   ist und kein weiterer Umbau.
 3. **Module erklären, welche Plattformen sie bedienen können** — sichtbar in Desktop und WebUI und
   wirksam im Handelspfad. Strategien dürfen sich je Plattform unterscheiden.
 ---
 ## 2. Was Polymarket US anders macht
 Quelle: offizielle Doku `https://docs.polymarket.us` (Stand 16.09.2026). Vor dem Bau erneut prüfen —
 die Plattform ist jung und ändert sich (Gebühren wurden am 16.09.2026 angehoben).
 | | Polymarket Global (heute) | Polymarket US |
 |---|---|---|
 | Endpunkte | CLOB, Gamma, Data-API getrennt | `api.polymarket.us` (authentifiziert), `gateway.polymarket.us` (öffentlich) |
 | Echtzeit | CLOB-WSS, Alchemy/Polygon | `wss://api.polymarket.us/v1/ws/private` (Orders, Positionen, Saldo), `/v1/ws/markets` (Buch, Trades; max. 10 Märkte je Verbindung) |
 | Anmeldung | L1 EIP-712 mit Wallet-Key → L2 HMAC (apiKey/secret/passphrase) | Key-ID + Ed25519-Secret; Header `X-PM-Access-Key`, `X-PM-Timestamp` (ms, ±30 s), `X-PM-Signature` = Base64(Ed25519(`timestamp + method + path`)) |
 | Konto | Wallet / Proxy-Wallet, kein KYC | KYC-Person (iOS-App), Schlüssel unter `polymarket.us/developer`, Secret wird **nur einmal** angezeigt |
 | Markt-Identität | conditionId + tokenId je Ausgang | `marketSlug`; Ausgang über `intent` bzw. `outcomeSide` YES/NO |
 | Order | signierte Order (EIP-712), Preis als Zahl, FOK/GTC/GTD | `POST /v1/orders`: `intent` (`BUY_LONG`, `SELL_LONG`, `BUY_SHORT`, `SELL_SHORT`), `price {value, currency}`, `quantity` oder `cashOrderQty`, TIF `DAY/GTC/GTD/IOC/FOK`, `participateDontInitiate` (Post-only), `manualOrderIndicator`, `synchronousExecution` |
 | Weitere Order-Wege | — | Modify, Preview, Close-Position, Sammel-Orders, Cancel-All |
 | Geld | USDC auf Polygon | USD per Karte, ACH, Wire |
 | Abwicklung | On-Chain-Redeem nötig (#146) | automatisch zu 1 $ / 0 $, kein Redeem |
 | Gebühr | Taker in bps je Kategorie (`FeeModel`) | `Θ · C · p · (1−p)`; Taker Θ = 0,0695 (ab 16.09.2026), Maker-Rabatt Θ = −0,0125; Banker's Rounding auf Cent |
 | Limits | eigene je Endpunkt | 20 Anfragen/s je Schlüssel bzw. je IP; 429 → Backoff. „Global Rate Limit Exceeded" nach 5 s ist Latenzschutz, **kein** Limit |
 | Testumgebung | — | Retail-API: keine dokumentierte Sandbox. Preprod nur für die Exchange-API (OAuth), Zugang über onboarding@polymarket.us |
 | Liquidität, Marktangebot | globaler Pool, voll | eigener US-Pool, kleineres Angebot |
 **Zwei Folgen, die das Design bestimmen:**
 - Die **Gebührenformel** ist eine andere *Form*, nicht nur ein anderer Satz. Ein „Satz in bps" reicht
  als Modell nicht. Nahe 0,95 ist die US-Gebühr winzig, bei 0,50 am höchsten.
 - **Fremde Wallets sind nicht sichtbar.** Alles, was CopyTrading heute beobachtet (Polygon-Logs,
  Data-API-Activity), gibt es für den US-Pool nicht.
 ---
 ## 3. Ist-Zustand im Code
 PolyTrader ist modular (Core + Module), aber **Polymarket Global ist überall stillschweigend
 vorausgesetzt**:
 | Stelle | Bindung |
 |---|---|
 | [`IClobClient`](../../../src/PolyTrader.Core/Services/IClobClient.cs) | `tokenId`, `isNegRisk`, `actualFeeBps`, Decimals-Overrides — CLOB-Begriffe im Vertrag |
 | [`PolymarketClobClient`](../../../src/PolyTrader.Core/Services/PolymarketClobClient.cs), [`PolymarketApiService`](../../../src/PolyTrader.Core/Services/PolymarketApiService.cs) | direkt von Modulen aufgelöst; Registrierung von `IClobClient` sogar im CopyTrading-Modul |
 | [`AccountState`](../../../src/PolyTrader.Core/Models/AccountState.cs) | `WalletAddress`, `ApiPassphrase`, `PrivateKey` — Global-Zugangsdaten als feste Felder |
 | [`Position`](../../../src/PolyTrader.Core/Models/Position.cs), `core_positions` | Primärschlüssel `(AccountId, IsDemo, TokenId)` |
 | [`MarketData`](../../../src/PolyTrader.Core/Models/MarketData.cs), `core_markets` | `ConditionId`, `ClobTokenIds`, `NegRisk` |
 | [`FeeModel`](../../../src/PolyTrader.Core/Trading/FeeModel.cs) | statisch, bps je Kategorie |
 | `Streaming/AlchemyWssClient`, `BlockchainWss` | Polygon |
 | CopyTrading | 10 Dateien gegen CLOB/API/Chain |
 | ResolutionFarming | hat schon `IFarmingMarketSource`, `IMarketResolutionSource` — **gutes Vorbild** |
 | Accounting | hat schon `IActivitySource`, `ITransferSource`, `IBalanceAnchorSource` — ebenso |
 | Supervisor | nur `CounterfactualJob` liest über die API |
 `TokenId` kommt in 73 Dateien vor. Ein Umbau in einem Schritt ist ausgeschlossen.
 ---
 ## 4. Leitentscheidungen
 1. **Die Plattform gehört zum Konto, nicht zur Installation.** Eine Installation kann Konten
   mehrerer Plattformen führen. Ob der Netzweg das zulässt (US-Standort gegen US-IP-Sperre von
   polymarket.com), ist eine Betriebsfrage (#622), keine Architekturfrage.
 2. **Der Global-CLOB-Code wird umhüllt, nicht umgebaut.** Signierung, Betragsrechnung und
   Orderablauf von `PolymarketClobClient` bleiben Zeile für Zeile, wie sie sind. Der
   Global-Adapter übersetzt nur zwischen neutralem Vertrag und bestehendem Client. Das ist die
   direkte Anwendung von `.agents/rules/clob.md`.
 3. **Module sprechen gegen Plattform-Verträge**, nicht gegen `Polymarket*`-Klassen. Das Muster
   existiert schon in ResolutionFarming und Accounting und wird verallgemeinert.
 4. **Logik fragt nach Fähigkeiten, nicht nach Namen.** `if (caps.PublicTraderActivity)` statt
   `if (platform == PolymarketGlobal)`. Ein neuer Handelsplatz bringt seine Fähigkeiten mit, und
   bestehende Module entscheiden richtig, ohne ihn zu kennen.
 5. **Module erklären ihre Plattformen ausdrücklich.** Fähigkeiten allein reichen nicht: Dass eine
   Plattform alles Nötige *hat*, heißt nicht, dass die Strategie dort *geprüft* ist. Die Erklärung
   ist eine Freigabe, die Fähigkeiten sind eine Plausibilitätsprüfung.
 6. **Strategievarianten leben im Modul**, als Profil je Plattform — kein „ResolutionFarmingUS"-Modul.
   Die fachliche Idee bleibt eine; Gebühren, Schwellen und Marktquelle unterscheiden sich.
 7. **Global bleibt die Vorgabe.** Jede neue Spalte bekommt `polymarket-global` als Standardwert.
   Bestehende Installationen merken nach der Migration nichts.
 ---
 ## 5. Architektur
 ### 5.1 Plattform und Fähigkeiten
 ```csharp
 namespace PolyTrader.Core.Platforms;
 /// Stabile Kennung, wird in der Datenbank gespeichert – nie umbenennen.
 public readonly record struct PlatformId(string Value)
 {
    public static readonly PlatformId PolymarketGlobal = new("polymarket-global");
    public static readonly PlatformId PolymarketUs     = new("polymarket-us");
    public static readonly PlatformId Kalshi           = new("kalshi");
 }
 public sealed record PlatformCapabilities(
    bool PublicTraderActivity,     // fremde Trades beobachtbar (CopyTrading)
    bool OnChainSettlement,        // Redeem nötig, Chain-Transfers als Buchungsquelle
    bool PostOnlyOrders,
    bool OrderModify,              // Preis ändern ohne Cancel+Neu
    bool MakerRebate,
    bool FractionalQuantity,
    bool NativeDemoEnvironment,    // echte Testumgebung der Plattform
    IReadOnlySet<TimeInForce> TimeInForce,
    string SettlementCurrency);    // "USDC", "USD"
 ```
 ### 5.2 Verträge
 Neutral formuliert, je Plattform einmal implementiert. Aufgelöst über eine Registry, nie direkt.
 | Vertrag | Aufgabe | Global-Adapter hüllt | US-Adapter spricht |
 |---|---|---|---|
 | `IMarketCatalog` | Märkte suchen, nach Enddatum/Kategorie filtern, Auflösungsstatus | Gamma-API, `MarketSyncService` | `gateway` Markets/Events/Settlement |
 | `IOrderBookSource` | Buch, BBO | CLOB `/book` | `gateway` Book/BBO |
 | `IOrderGateway` | Platzieren, Ändern, Canceln, offene Orders | `PolymarketClobClient` | `POST/…/v1/orders` |
 | `IPortfolioSource` | Positionen, Saldo, Aktivität | Data-API, Chain | Portfolio, Account-Balances |
 | `IMarketStream` / `IAccountStream` | Echtzeit | CLOB-WSS, Alchemy | `/v1/ws/markets`, `/v1/ws/private` |
 | `IFeeModel` | Gebühr für (Preis, Menge, Rolle) | heutiges `FeeModel` | `Θ·C·p·(1−p)` |
 | `ISettlementHandler` | Was nach Auflösung zu tun ist | Redeem (#146) | nichts, nur Abgleich |
 | `ITraderActivitySource` | fremde Trades | Polygon, Data-API | **nicht vorhanden** |
 > **Stand nach #623 (18.09.2026):** Gebaut sind `IMarketCatalog`, `IOrderBookSource`, `IOrderGateway`,
 > `IPortfolioSource`, `IFeeModel`, gebündelt in `IPlatformAdapter` (`src/PolyTrader.Core/Platforms/`).
 > Die Streams, `ISettlementHandler` und `ITraderActivitySource` entstehen **mit ihrem ersten zweiten
 > Nutzer**, nicht auf Vorrat: Streams mit #625, Abwicklung mit #146 bzw. #625, Trader-Aktivität mit #628.
 > Die Registry löst den ganzen Adapter auf (`registry.ForAccount(account).Orders`), nicht einzelne
 > Verträge per Typ.
 ```csharp
 public interface IPlatformRegistry
 {
    IReadOnlyList<PlatformId> Available { get; }
    PlatformCapabilities Capabilities(PlatformId p);
    T Get<T>(PlatformId p) where T : class;      // wirft, wenn Plattform den Vertrag nicht hat
    bool TryGet<T>(PlatformId p, out T? service) where T : class;
 }
 ```
 `IClobClient` bleibt bestehen, bis CopyTrading umgestellt ist; `IOrderGateway` für Global delegiert
 darauf. Es gibt keinen Tag, an dem beides gleichzeitig umgeschrieben wird.
 ### 5.3 Instrument und Order
 ```csharp
 /// Ein handelbarer Ausgang auf einer Plattform. Key ist innerhalb der Plattform eindeutig.
 /// Global:  Key = tokenId,            MarketKey = conditionId
 /// US:      Key = "{marketSlug}:YES", MarketKey = marketSlug
 /// Kalshi:  Key = "{ticker}:YES",     MarketKey = ticker
 /// Gleichheit nur über (Platform, Key).
 public sealed record InstrumentRef(PlatformId Platform, string Key, string MarketKey = "", string Outcome = "");
 public sealed record OrderRequest(
    InstrumentRef Instrument,
    OrderSide Side,                 // Buy / Sell  (US: → intent BUY_LONG usw.)
    decimal LimitPrice,             // immer Wahrscheinlichkeit 0..1 – Adapter rechnet um (Kalshi: Cent)
    decimal? Quantity,              // Kontrakte/Shares
    decimal? NotionalUsd,           // alternativ Betrag
    TimeInForce Tif,
    bool PostOnly,
    string OriginModule,            // für die Plattform-Sperre (5.6) und das Journal
    string CorrelationId);
 ```
 Plattformspezifisches (Global: `negRisk`, Tick-Size, Decimals; US: `manualOrderIndicator`,
 `synchronousExecution`) bleibt **im Adapter**. Der US-Adapter setzt `manualOrderIndicator` fest auf
 `AUTOMATIC` — ein Bot, der sich als manuell ausgibt, ist ein Compliance-Fehler, keine Einstellung.
 ### 5.4 Konten und Zugangsdaten
 - `core_accounts.platform` (Vorgabe `polymarket-global`).
 - Zugangsdaten je Plattform, verschlüsselt wie F1 (`EncryptedStringConverter`):
  - Global: wie heute (Wallet, Key, Secret, Passphrase, PrivateKey).
  - US: Key-ID in `ApiKey`, Ed25519-Secret in `ApiSecret`. `WalletAddress`, `PrivateKey`,
    `PayoutAddress` leer.
  - Kalshi: Key-ID + privater Schlüssel.
  Die bestehenden Felder reichen für US und Kalshi. Eine eigene Tabelle je Plattform wäre sauberer,
  kostet aber eine zweite Migration der F1-Verschlüsselung. **Entscheidung: vorhandene Felder
  wiederverwenden**, die Kontenansicht zeigt je Plattform nur die passenden Felder mit passender
  Beschriftung. Neu prüfen, falls eine Plattform mehr als vier Geheimnisse braucht.
 - Die Passwortsperre vor Konten und Geheimnissen (#567) gilt unverändert; Geheimnisse bleiben
  Desktop-only (WebUI-Parität).
 ### 5.5 Datenbank
 | Tabelle | Änderung |
 |---|---|
 | `core_accounts` | `+ platform` |
 | `core_positions` | **keine Änderung** (Entscheidung in #623): Eine Position gehört zu einem Konto, das Konto zu genau einer Plattform. `(AccountId, IsDemo, TokenId)` bleibt eindeutig, solange `TokenId` den plattformeindeutigen `InstrumentRef.Key` hält. Eine eigene Spalte wäre eine zweite Wahrheit, die auseinanderlaufen kann |
 | `core_markets` | `+ platform`; Schlüssel `(Platform, Id)` |
 | Modultabellen mit Token-Bezug (`ct_`, `rf_`, `acc_`) | `+ platform` mit Vorgabe, je Modul im jeweiligen Schritt |
 `Position.TokenId` bleibt, wie es ist, und hält `InstrumentRef.Key`. Die 73 Fundstellen ziehen
 schrittweise um, statt in einem Commit.
 Die lesenden Methoden von `IMarketRepository` (`GetById`, `FindByTokenId`, `GetActive`) liefern seit #623
 nur Global-Märkte — ihre Aufrufer arbeiten mit Gamma-IDs und Token-IDs.
 **Migration `AddPlatformColumns`:** Es gibt keine automatischen Migrationen beim Start. Vor dem ersten
 Start einer Fassung mit #623 muss auf dem Server `dotnet ef database update --project src/PolyTrader.Core`
 laufen, sonst scheitert jede Abfrage an der fehlenden Spalte `Platform`.
 ### 5.6 Module erklären ihre Plattformen („Auslöser")
 Erweiterung von [`IPolyTraderModule`](../../../src/PolyTrader.Core/Modularity/IPolyTraderModule.cs),
 abwärtskompatibel über Default-Implementierungen:
 ```csharp
 /// Plattformen, für die dieses Modul geprüft und freigegeben ist.
 /// Vorgabe: nur Polymarket Global – ein Modul, das nichts erklärt, verhält sich wie heute.
 IReadOnlySet<PlatformId> SupportedPlatforms => new HashSet<PlatformId> { PlatformId.PolymarketGlobal };
 /// Grund, warum das Modul eine erklärte Plattform in dieser Installation trotzdem nicht bedienen kann
 /// (fehlende Fähigkeit, fehlender Schlüssel). null = bedienbar.
 string? GetPlatformBlocker(PlatformId platform, PlatformCapabilities caps) => null;
 ```
 **Eine Stelle für die Regeln.** Wie `ModuleActivationView` seit #560 liegt die Auswertung im Core
 (`ModulePlatformView`), und Desktop und WebUI zeigen dasselbe:
 | Wo | Was man sieht |
 |---|---|
 | Modul-Tab (Desktop, WebUI) | je Modul Plattform-Kennzeichen: ✓ bedienbar, ⚠ erklärt aber blockiert (mit Grund), — nicht erklärt |
 | Kontenansicht | je Konto die Module, die es bedienen |
 | Dashboard-Warnung | aktives Konto, das kein aktives Modul bedient; aktives Modul ohne passendes Konto |
 **Wirksam an zwei Stellen:**
 1. **Zuteilung:** Ein Modul bekommt nur Konten, deren Plattform es erklärt und nicht blockiert.
   Module filtern nicht selbst — sie fragen den Core nach „meinen Konten".
 2. **Handelspfad:** Die Registry reicht jedem Modul ein `IOrderGateway`, das `OriginModule` prüft
   und eine Order für eine nicht erklärte Plattform **ablehnt und ins Journal schreibt**. Das ist die
   zweite Sicherung nach dem Muster von `TradingGate` (#570): Eine Sperre, die nur in der Oberfläche
   existiert, hält keinen Programmierfehler auf.
 **Erste Erklärungen:**
 | Modul | Global | US | Begründung |
 |---|---|---|---|
 | CopyTrading | ✓ | — | braucht `PublicTraderActivity`; plattformübergreifend siehe #628 |
 | ResolutionFarming | ✓ | ✓ (ab #626) | nur eigene Marktdaten nötig, US-Gebühr nahe 1 sehr klein |
 | Accounting | ✓ | ✓ (ab #627) | Quellen je Plattform |
 | Supervisor | ✓ | ✓ | liest Journal und Dossiers, handelt nicht; `CounterfactualJob` über `IMarketCatalog` |
 ### 5.7 Strategieprofile je Plattform
 Ein Modul, das mehrere Plattformen erklärt, hält Einstellungen **je Plattform**
 (`rf_settings.platform`). Das Profil legt fest:
 - Gebührenmodell (aus der Registry, nie hart kodiert) — betrifft jeden Netto-Edge-Check.
 - Schwellen (Einstiegspreis, Mindest-Edge, Mindestliquidität). Bei getrenntem, kleinerem US-Pool
  sind Global-Werte **nicht** übertragbar; Startwerte stammen aus der Messphase.
 - Order-Stil: auf US lohnt Post-only wegen des Maker-Rabatts; auf Global zahlt der Maker 0.
 - Abwicklung: Global mit Redeem, US ohne.
 Die fachliche Logik (Kandidatenbewertung, Sizing, Risikogrenzen) bleibt gemeinsam und testbar ohne
 Plattform.
 ### 5.8 Demo-Modus
 Demo bleibt eine Eigenschaft des Kontos (`IsDemo`). Demo-Fills rechnen gegen **das Buch der Plattform
 des Kontos**, mit deren Gebührenmodell. Da die US-Retail-API keine Sandbox hat, ist Demo gegen das
 echte US-Buch der einzige Weg zur Messphase — und damit Pflicht vor dem Livegang.
 ---
 ## 6. Umsetzungsschritte
 | Item | Schritt | Voraussetzung | Ergebnis |
 |---|---|---|---|
 | #622 | **PL-0** Voraussetzungen US-Kunde | — | KYC, API-Schlüssel, Serverstandort, Rolle geklärt |
 | #623 | **PL-1** Plattform-Fundament | — | Verträge, Registry, Global-Adapter, DB-Spalten; **Verhalten unverändert** |
 | #624 | **PL-2** Plattform-Erklärung der Module | #623 | Anzeige + Zuteilung + Sperre im Gateway |
 | #625 | **PL-3** Adapter Polymarket US | #623; für echte Orders #622 | erst lesend, dann Demo, dann Orders |
 | #626 | **PL-4** ResolutionFarming für US | #624, #625 | Profil je Plattform, Messphase |
 | #627 | **PL-5** Accounting für US | #625 | US-Quellen statt Data-API/Chain |
 | #628 | **PL-6** CopyTrading plattformübergreifend | #625 + Entscheidung | nicht beschlossen |
 | #629 | **PL-7** Adapter Kalshi | #623 + konkreter Bedarf | nicht beschlossen |
 ### Akzeptanzkriterien
 **PL-1**
 - Alle bestehenden Tests grün, ohne Anpassung ihrer Erwartungen.
 - Diff an `PolymarketClobClient.cs` ist leer. Backup trotzdem vor Beginn (Regel).
 - Migration auf einer Kopie der Server-Datenbank: Bestandspositionen haben danach
  `platform = polymarket-global` und denselben `OutcomeKey` wie vorher `TokenId`.
 - Neue Tests: Registry löst je Plattform auf; Global-Adapter reicht Aufrufe 1:1 an den Client durch.
 **PL-2**
 - Ein Modul ohne Erklärung verhält sich exakt wie heute.
 - Test: Order über das Gateway mit nicht erklärter Plattform → abgelehnt, Journal-Eintrag, keine
  HTTP-Anfrage.
 - Desktop und WebUI zeigen für dieselbe Konfiguration dieselben Kennzeichen (ein gemeinsamer Test
  gegen `ModulePlatformView`).
 **PL-3**
 - Signatur gegen die Beispielwerte der Doku geprüft (Einheitentest mit festem Schlüssel und Zeitstempel).
 - Lesend gegen Produktion: Märkte, Buch, Positionen, Saldo des Kundenkontos.
 - 429 → Backoff; „Global Rate Limit Exceeded" → **kein** Drosseln (siehe Abschnitt 2).
 - Secret nie im Log, nie im WebUI, verschlüsselt at-rest.
 - Erste echte Order erst nach PL-4-Messphase und mit Freigabe durch Richard.
 **PL-4**
 - Netto-Edge-Check nutzt das US-Gebührenmodell (Test mit p = 0,50 und p = 0,97).
 - Demo-Messphase mit definiertem Zeitraum und Auswertung, bevor Live freigegeben wird.
 ---
 ## 7. Ausblick Kalshi
 Kalshi ist der Prüfstein für PL-1: Lässt sich der Adapter bauen, **ohne ein Modul anzufassen**, trägt
 die Abstraktion. Bekannte Unterschiede (vor dem Bau gegen die aktuelle Kalshi-Doku prüfen): eigene
 Anmeldung mit signierten Anfragen und privatem Schlüssel, Märkte über Ticker, Preise in Cent, eigene
 Gebührenformel, eigene Demo-Umgebung. Genau deshalb ist `LimitPrice` im Vertrag eine Wahrscheinlichkeit
 0..1 und die Umrechnung Sache des Adapters.
 ---
 ## 8. Offene Fragen
 | Frage | Wer | Item |
 |---|---|---|
 | Gibt es für die Retail-API eine Testumgebung? | Anfrage an Polymarket US | #622 |
 | Wo läuft die Installation des US-Kunden, und darf sie zugleich Global-Konten führen? | Richard | #622 |
 | Rechtliche Einordnung unserer Rolle bei automatisiertem Handel auf einem fremden KYC-Konto | Richard / Rechtsberatung | #622 |
 | Lohnt CopyTrading mit Global-Signal und US-Ausführung trotz anderer Kurse? | Entscheidung | #628 |
 | Reihenfolge gegenüber Themenbereich A (Abnahme, #621 Betriebsfreigabe) | Richard | — |