Map existing native providers and remaining Engine integration work (by Codex)

This commit is contained in:
Codex committed 2026-10-27 07:06:08 +01:00
1 parent 8f96945c43
commit d8beaecd6f
2 files changed
+62

No files matched your search

@@ -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 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 Engine-Interna auf ein neues Protokoll umschreiben. Ein schlanker Adapter um die
vorhandenen C++-Dienste und `ModernSession::read()` genügt als erster Schritt. 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 ## Zuerst fest vereinbaren
@@ -0,0 +1,60 @@
<!-- SPDX-License-Identifier: GPL-3.0-only -->
# 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.