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
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
@@ -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.