diff --git a/docs/new_ui/integration/MVP_FOR_CLAUDE.md b/docs/new_ui/integration/MVP_FOR_CLAUDE.md index e2f36fe..aacb90e 100644 --- a/docs/new_ui/integration/MVP_FOR_CLAUDE.md +++ b/docs/new_ui/integration/MVP_FOR_CLAUDE.md @@ -6,6 +6,8 @@ JSON bleibt die Austauschform. Die ausführlichen Schemas sind ein Arbeitsentwur wir müssen nicht vor dem ersten Menü alle 75 Definitionen implementieren oder Engine-Interna auf ein neues Protokoll umschreiben. Ein schlanker Adapter um die vorhandenen C++-Dienste und `ModernSession::read()` genügt als erster Schritt. +Die [konkreten nativen Anschlussstellen](NATIVE_BINDING_MAP.md) unterscheiden +bereits austauschbare Providerreads von noch direkt verwendeten Demohelfern. ## Zuerst fest vereinbaren diff --git a/docs/new_ui/integration/NATIVE_BINDING_MAP.md b/docs/new_ui/integration/NATIVE_BINDING_MAP.md new file mode 100644 index 0000000..947d9cf --- /dev/null +++ b/docs/new_ui/integration/NATIVE_BINDING_MAP.md @@ -0,0 +1,60 @@ + +# Konkrete Anschlussstellen der nativen UI + +Stand: Nachtpaket 27. Oktober 2026. Die Oberfläche läuft weiterhin ausdrücklich +als UI-Demo. Diese Übersicht ergänzt den [gestuften Einstieg](MVP_FOR_CLAUDE.md) +um die tatsächlich vorhandenen C++-Anschlussstellen; sie definiert kein weiteres +Protokoll und verlangt keine neue Enginearchitektur. + +## Vorhandene Providergrenzen + +In [model.hpp](../../../src/modern/ui/model.hpp) liefert `DataSource::snapshot()` +eine besitzende `Snapshot`-Kopie mit `revision`, unveränderlichem Weltkatalog und +JSON-`state`. `apply(Action)` nimmt Revision, semantische Aktionsart und JSON-Wert +entgegen; das Ergebnis nennt Erfolg, neue Revision oder Fehler. Der derzeitige +`state` ist ein UI-Präsentationsstand, kein serialisierter `GameState` und kein +OBS-Format. Porträtindizes sind nur Demoidentitäten, keine Engine-Manager-IDs. + +| Bereich | Tatsächliche Anschlussstelle | Nächster Integrationsschritt | +|---|---|---| +| Desktop und lokale Einstellungen | `snapshot()` / `apply()`; aktiver Demo-Kontext über `demo_career_context` | Enginekontext, stabile IDs, verfügbare Aktionen und ausdrücklich deklarierte Geldeinheiten auf eine UI-Projektion abbilden. Globale Anzeige-/Soundpräferenzen bleiben getrennt. | +| Almanach | `read_almanac(Json)`; verwendet in `almanac_screens.inc` | Vorhandene Archivreads liefern; Paging, historische Unsicherheiten und Ereignisreihenfolge erhalten. | +| Allgemeine Statistiken | `read_statistics(Json)`; verwendet in `statistics_screens.inc` | Autoritative bestehende Statistikdienste statt der Demoantworten liefern. | +| Live-Ticker | `read_live(Json)`; native Live-Projektion in `live_screens.inc` | Gemeinsamen Live-Snapshot und echte Manager-/Match-IDs liefern. Replaycursor und lokale Vorschau sind keine Engineuhr oder bestätigte Eingriffe. | + +Die drei `read_*`-Methoden antworten in der Basisklasse ausdrücklich mit +`*_unavailable`. Nur `DemoSource` liefert heute die synthetischen Aufzeichnungen +und Vorschauen. Keine Basisklasse startet dafür ein Match oder konstruiert einen +Beispielwert als Ersatz für fehlende echte Daten. + +## Direkte Demoprojektionen noch gezielt ersetzen + +Ein anderer `DataSource` allein bindet noch nicht jedes Untermenü vollständig +an die Engine: Manche Presenter rufen weiterhin ausdrücklich Demohelfer auf. +Vor Aktivierung eines echten Karrierebetriebs müssen deren Reads und Mutationen +an den jeweiligen vorhandenen Dienst angeschlossen werden. Fehlende Dienste +bleiben unverfügbar; die UI übernimmt deren Dummyformeln nicht. + +| Presenter / Datei unter `src/modern/ui` | Heutiger Demoaufruf bzw. Inhalt | +|---|---| +| `career_report_screens.inc` | `demo_achievements` und `demo_highscores`: fiktive Vereinssaisons und Managerwertung. Endtabellen/Titel bzw. tatsächlichen Highscore liefern. | +| `rankings_screens.inc` | `demo_scorer_rows` und `demo_fairplay_rows`: Kader-/Kartenprojektionen. Belegte Scorerwerte und Strafpunkte nach Engine-Regeln liefern. | +| `national_screens.inc` | `query_national_ui`: ausdrücklich keine echten Nominierungen oder FIFA-Termine; unbekannte Werte bleiben leer. Nationalkader, Turnierhistorie und tatsächliche verfügbare Termine liefern. | +| `news_screens.inc` | `demo_news_view`: bereichsgetrenntes Präsentationsjournal. Semantische Ereignisse über den vorhandenen Katalog rendern und deren Zuständigkeit erhalten. | +| Bank, Verträge, Stadion, Transfers und Planung | Bestehende `demo_*`-Projektionen und `DemoSource`-Aktionen. Tatsächliche Angebote, Kosten, Grenzen und revisionierte Mutationen anbinden. | + +Der [native Pressekatalog](../desktop/news/NATIVE_CATALOG.md) ist bereits eine +reine wiederverwendbare Komponente: `NewsCatalog::from_event` / `from_almanac`, +explizite `news_money_from_dto`-Konvertierung und historisches Journal. Er erzeugt +selbst keine Ereignisse. Die zwölf anfänglichen Nachrichten sind markierte +Demodaten; sie werden nicht zum automatischen Ersatz einer echten Pressequelle. + +## Erster sinnvoller gemeinsamer Durchlauf + +Zunächst eine tatsächliche Karriere mit einem Manager über Desktop und genau +ein Menü anbinden. Dessen Lesen muss unverändert lassen; dessen bestätigte +Aktion muss den bestehenden Engine-/Revisionsschutz verwenden. Danach Rollen, +weitere Menschen und weitere Menüs schrittweise ergänzen. Der +[umfangreiche JSON-Entwurf](README.md) beschreibt Zielverträge, nicht schon eine +fertige gemeinsame Adapterimplementierung. Die Umsetzung wird in +[Issue #15](https://github.com/Weyoune/openbmh/issues/15) verfolgt.