61 lines
4.5 KiB
Markdown
61 lines
4.5 KiB
Markdown
<!-- 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.
|