Connect Almanac UI to revision-bound career history (by Codex)

This commit is contained in:
Codex committed 2026-10-28 19:08:42 +01:00
1 parent 4b6c18f654
commit 959154c3c0
18 files changed
+405 -44

No files matched your search

+1 -1
View File
@@ -6,7 +6,7 @@ Die normale Classic-Konfiguration bleibt unverändert; die neue Oberfläche
wird ausdrücklich mit `OPENBMH_BUILD_MODERN_UI=ON` gebaut.
Der [opt-in Engine-Einstieg](integration/ENGINE_ENTRY.md) lädt inzwischen eine
echte Modern-OBS-Karriere und bindet Schreibtisch, Trainingslager, Aufstellung, Taktik, Training, Bank, Eintrittspreis, Umfeld, Werbung, Spielerverträge, Vereinskalender, Spielverlegung und Vereinsfreundschaftsspiele an die
echte Modern-OBS-Karriere und bindet Schreibtisch, Trainingslager, Aufstellung, Taktik, Training, Bank, Eintrittspreis, Umfeld, Werbung, Spielerverträge, Vereinskalender, Spielverlegung, Vereins-/Nationalfreundschaftsspiele und den Almanach an die
Session. Kader und Profile zeigen die tatsächlichen Sessionwerte; Spielertausch
verwendet die bestätigte Engineaktion. Preisbestätigung, Buchung und Speichern als neue OBS-Datei sind echte
Engineoperationen. Dieser Einstieg ist auf diesen Umfang begrenzt; die übrigen
+1 -1
View File
@@ -38,7 +38,7 @@ Implementierung in der Spiel-Engine.
| Bank | [Sparbuch, Immobilien, Aktien und Kredit](desktop/bank/README.md) |
| Bilanz | [Aktuelle Bilanz und Zukunftsplanung](desktop/balance/README.md) |
| Verträge | [Kaderdaten, Angebote, Versicherung und Prämien](desktop/contracts/README.md) |
| Almanach | [Jahreskalender, Tagespartien und historische Spielberichte](desktop/almanac/README.md) |
| Almanach | [Echte Archivjahre, Tagespartien und historische Spielberichte](desktop/almanac/README.md) |
| Paarungsanordnung | [Mittige Ergebnisse und innenliegende Wappen](desktop/fixtures/README.md) |
| Berichte | [Tabellen, Stärken, Ligaspiele, übrige Spiele und Profile](desktop/reports/README.md) |
| Freundschaftsspiele | [Vereins-/Nationalgegner, echte Angebote und bestätigte Buchungen](desktop/friendlies/README.md) |
+24 -4
View File
@@ -2,9 +2,9 @@
Stand: 24. Oktober 2026. Dieser Vertrag beschreibt die native
Präsentationsschnittstelle des [Almanachs](README.md). Er ist kein neues
Engine-Speicherformat. Die gegenwärtige Quelle ist ein unveränderliches
Pseudoarchiv; eine spätere Modern-Sessionprojektion kann denselben
Lesevertrag bedienen.
Engine-Speicherformat. Die separate Demo verwendet ein unveränderliches
Pseudoarchiv. Seit 28. Oktober 2026 bedient auch die tatsächliche Modern-Session
diesen Lesevertrag im echten Engine-Einstieg.
## Besitz und Lesezugriff
@@ -20,7 +20,27 @@ Ergebniskopien zurück und verändern weder Archiv noch Revision,
Änderungsmarkierung, Geld oder RNG. Die App hält ihre Navigation nur in
flüchtigen Feldern. Das Laden eines UI-Demostands ändert den
Abfragestichtag, importiert aber kein Enginearchiv. Bestehende `.obs`-
Dateien und F10-Daten werden von diesem Paket weder gelesen noch geändert.
Dateien und F10-Daten werden von dieser Demoquelle weder gelesen noch geändert.
### Tatsächliche Sessionquelle
`ModernSession::ui_read({kind:"almanac",query:<Request>})` kapselt
`query_almanac` und liefert die normale Snapshot-Hülle mit `data.kind`,
`data.query` und `data.result`. Die UI validiert Karriere, Welt, Datenrevision,
Manager, Spielstandsrevision, Abfrageidentität und gespeicherte Datumswerte.
Sie lädt die vier Anfragearten bei Bedarf über den seriellen Worker. Der
begrenzte Cache wird bei einem geänderten Kontext verworfen; er wird nicht in
den Spielstand geschrieben. Die Datenquelle sind hier die tatsächlichen
Almanachaufzeichnungen im OBS, einschließlich der von der Engine verfügbaren
abgeschlossenen Saisons. Es gibt keinen Import des Pseudoarchivs in eine OBS.
Die archivierten Namen und Aufstellungen werden unverändert übernommen.
Fehlende Positionen bleiben unbekannt. Ein Enginebefund zu widersprüchlichen
Phasenangaben ist als #18 erfasst. Die UI kennzeichnet ein gemeldetes,
entschiedenes Elfmeterschießen mit gleichem Heim-/Auswärtswert als unklare
Phasenüberlieferung und zeigt den gelieferten Endstand. Sie rekonstruiert kein
Ersatzresultat. Die folgenden Demo-Validierungsdetails bleiben für den
getrennten `DemoSource` gültig.
## Requests und Antworten
+57
View File
@@ -16,6 +16,63 @@ Native Quellen sind
[demo_almanac.hpp](../../../../src/modern/ui/demo_almanac.hpp) und
[demo_almanac.cpp](../../../../src/modern/ui/demo_almanac.cpp).
## Echter Engineanschluss · 28. Oktober 2026
Aufbauend auf `0.3` / `4b6c18f` ist der vorhandene Almanach-Presenter an die
abgeschlossenen Spiele der geladenen Modern-Karriere angebunden. Der Read
`almanac` kapselt die bestehende `query_almanac`-Projektion in dieselbe
Karriere-/Welt-/Manager-/Revisionshülle wie die anderen Engineansichten:
```json
{"kind":"almanac","query":{"kind":"index"}}
{"kind":"almanac","query":{"kind":"calendar","year":2026}}
{"kind":"almanac","query":{"kind":"day","date":"2026-08-08"}}
{"kind":"almanac","query":{"kind":"match","id":"match:2026-167"}}
```
`data.query` wiederholt die gebundene Abfrage; `data.result` enthält die
bestehende Archivantwort. Es werden keine Spiele, Statistiken oder Ereignisse
im Client erzeugt. Die bisherige Präsentationsdemo bleibt eine eigene Quelle.
Der Schreibtisch öffnet den Kalender des neuesten vorhandenen Kalenderjahrs.
Der Jahrpicker zeigt die tatsächlich archivierten Jahre. Nur Tage mit
abgeschlossenen Partien sind anklickbar. Daraus führen die Tagespaarungen mit
mittigem Ergebnis zum vollständigen Spielbericht, seinen Aufstellungen und
Ereignissen. „Zurück“ und Escape gehen genau eine Ebene zurück; das X schließt
das Fenster. Lange Tageslisten sind auch per Tab/Enter erreichbar. Der Fokus
auf einer Partie scrollt diese beim Zurückgehen wieder ins Sichtfeld; die
Ergebnisspalte bleibt mittig trotz Scrollbalken.
Die Bridge fragt ausschließlich bei Bedarf auf ihrem seriellen Hintergrund-
Worker ab. Die UI hält höchstens je einen Index, Jahreskalender, Spieltag und
Detailbericht. Wiederholtes Öffnen derselben Ansicht verwendet diesen Cache.
Ein geänderter Karriere-/Welt-/Manager-/Revisionskontext verwirft den Cache.
Der Renderer liest keine Session und veröffentlicht keine veraltete Antwort.
Ein leeres Archiv zeigt das aktuelle Karrierejahr ohne erfundene Spieltage.
Historische Namen, Manager, Aufstellungen und Ereignisse stammen aus dem
Archiv. Unbekannte Positionen werden nicht aus dem heutigen Kader ergänzt.
Vorhandene Wappen werden ausschließlich anhand stabiler Vereins-IDs aus der
aktiven Welt aufgelöst; das ist kein historisches Grafikarchiv. Der gemeinsame
Wappenpfad unterstützt dabei den Silver-Kontrastfix.
Beim tatsächlichen Anschluss wurde [Engine-Issue #18](https://github.com/Weyoune/openbmh/issues/18)
gefunden: einzelne abgeschlossene Datensätze melden ein Elfmeterschießen mit
0:0. Der Presenter zeigt bei solchen widersprüchlichen Angaben den gelieferten
Endstand und „Spielphasen nicht eindeutig überliefert“. Er erfindet weder
Elfmeterschüsse noch eine Ersatzentscheidung. Die unveränderten Rohdaten
bleiben im Prüfbeleg erhalten; der Recorder/Engine-Read muss separat geprüft
werden. Andere gelieferte Phasenwerte werden ohne neue Spielregeln dargestellt.
Öffnen, Jahrwechsel, Navigation und Speichern verändern keine Archivspiele
oder RNG-Zustände. Die private QA enthält einen regulär erzeugten OBS-Stand
mit 1.965 Spielen über 2026/2027, tatsächliche Rohantworten, Neustartprüfungen,
leere Archive und Aufnahmen in drei Themes:
`bmh_4k_ui/docs/qa/engine-almanac-2026-10-28/`. Die native Laufzeitprüfung läuft
unter Linux; Windows-/macOS-Ausführung wurde nicht durchgeführt.
Die folgenden Abschnitte beschreiben weiterhin die **getrennte Demoquelle**.
## Drei Ansichtsebenen
Das Desktop-Icon „Almanach“ öffnet zunächst den **Jahreskalender**.
+19 -2
View File
@@ -1,5 +1,5 @@
<!-- SPDX-License-Identifier: GPL-3.0-only -->
# Nativer Engine-Einstieg: Schreibtisch, Trainingslager, Aufstellung und Vorbereitung
# Nativer Engine-Einstieg: Schreibtisch, Vereins-/Nationalplanung und Archiv
Der opt-in Einstieg lädt eine bestehende Modern-Karriere aus einer OBS-Datei.
Er ist ein erster vertikaler Integrationsschritt, kein vollständiger spielbarer
@@ -17,7 +17,7 @@ werden. Die Quelle wird nicht in DemoSource überführt.
## Gebundener Umfang
- `ModernSession::ui_read`: `session`, `desktop`, `camps`, `squad`, `lineup`, `tactics`, `training`, `bank`, `stadium`, `credit`, `environment`, `advertising`, `contracts`, `calendar`, `scheduling`, `friendly-plan`; parameterisierte Angebote über `friendly`. Karriere, Manager,
- `ModernSession::ui_read`: `session`, `desktop`, `camps`, `squad`, `lineup`, `tactics`, `training`, `bank`, `stadium`, `credit`, `environment`, `advertising`, `contracts`, `calendar`, `scheduling`, `friendly-plan`; parameterisierte Angebote über `friendly` und Archivabfragen über `almanac`. Karriere, Manager,
Mannschaft, Datum, Saison, Geld, Lagerqualitäten und Angebote kommen aus der
Engine. Katalog und Engine müssen dieselbe Welt-ID und Datenrevision haben.
- Der bestehende RmlUI-Schreibtisch verwendet die gemeinsamen App-Buttons und
@@ -258,3 +258,20 @@ ab; reale Teststände werden über die OBS-Speicheraktion erzeugt.
Die privaten Bilder, Eingangsspielstände und Replaybefehle liegen unter
`bmh_4k_ui/docs/qa/engine-entry-2026-10-27/`. Plattformgrenzen stehen im dortigen
Prüfbericht; ein CI-Build ist keine interaktive Windows-/macOS-Abnahme.
## Almanach · 28. Oktober 2026
Der bestehende Almanach-Presenter liest nun abgeschlossene Partien der echten
Karriere über `ui_read {kind: "almanac", query: ...}`. Index, Jahreskalender,
Tagespaarungen und Spielbericht werden bei Bedarf auf dem seriellen Worker
abgefragt und an Karriere, Welt, Manager und Revision gebunden. Die UI hält
höchstens einen Index, Kalender, Tag und Detailbericht. Es gibt keine
zusätzlichen Almanachabfragen in jedem Schreibtisch-Snapshot.
Archivierte Namen, Aufstellungen, Ereignisse und Phasenwerte ersetzen die
bisherigen Dummydaten im echten Einstieg. Unsichere Phasenangaben aus dem
festgestellten Engine-Befund #18 sind gekennzeichnet; es werden keine Tore oder
Entscheidungen rekonstruiert. Vorhandene Wappen kommen über die stabile
Vereins-ID aus der aktiven Welt. Das Speichern als neue OBS erhält die bereits
aufgezeichneten Archivbytes und beide RNGs. Einzelheiten und private QA stehen
im [Almanach-Menüdokument](../desktop/almanac/README.md).