Files

219 lines
13 KiB
Markdown

# Fußball-Almanach · native Modern UI
Stand: 24. Oktober 2026. Das Paket ergänzt einen eigenständigen Almanach
mit fiktiven historischen Spielen. Die private HTML-Referenz sind die mit diesem Paket eingeführten Dateien
`desktop/almanac-menu.js` und `desktop/almanac-window.css` auf Basis von
`13e44980540d9dbecaf9e667aec03cbe3fbfb3f0`. Diese Basisrevision allein
enthält das neue Menü noch nicht. Die HTML-Studie und die native
RmlUI-Umsetzung verwenden denselben normalisierten
[Datenvertrag](DATA_CONTRACT.md), bleiben aber getrennte Frontends.
Private Referenzbilder und Weltdaten gehören nicht in dieses Repository.
Native Quellen sind
[almanac_screens.inc](../../../../src/modern/ui/almanac_screens.inc),
[almanac_controls.inc](../../../../src/modern/ui/almanac_controls.inc),
[almanac.rcss](../../../../assets/modern/almanac.rcss),
[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 und am 28. Oktober im Recorder/Leser korrigiert: ältere Datensätze
konnten ein Elfmeterschießen melden 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 gemeinsame Engine-Read berichtigt jetzt
eindeutig belegte Alt-Doppelprotokolle nur in Lesekopien; unklare Fälle behalten
diese Kennzeichnung. 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**.
Anders als der Saisonkalender zeigt er Januar bis Dezember desselben
Kalenderjahres. Zwölf Monatskarten stehen in vier Spalten und drei Reihen;
innerhalb der Karte stehen Wochentage in sieben Zeilen und Wochen in
sechs Datumsspalten. Monate mit 28, 29, 30 oder 31 Tagen behalten ihre
wirkliche Wochentagslage. Der Jahresschalter bietet nur Kalenderjahre mit
bereits sichtbaren Archivspielen an. Beim ersten Öffnen wird das jüngste
solche Jahr gewählt.
Nur Tage mit gespielten Partien sind Schaltflächen. Ihr zugänglicher Name
nennt das Datum und die Anzahl der Partien. Andere Tage bleiben reine
Datumsbeschriftungen; zukünftige Tage erscheinen zusätzlich gedämpft.
Die Jahre werden aus vorhandenen Datensätzen ermittelt, nicht aus einer
festgeschriebenen Liste. Ein leeres Archiv zeigt einen verständlichen
Leerzustand; eine nicht unterstützte Datenquelle meldet die fehlende
Verfügbarkeit.
Ein Datum öffnet die **Tagespaarungen** mit allen Partien dieses Tages.
Die gesamte Paarungszeile ist anklickbar. Heimname und Wappen stehen links,
Gastwappen und Name rechts vom mittigen Ergebnis. Darunter stehen
Wettbewerb, Spieltag beziehungsweise Runde und Saison. Eine Entscheidung
nach Verlängerung trägt „n. V.“, ein Elfmeterschießen „i. E.“. Bei letzterem
zeigt die Paarungszeile das separate Ergebnis des Elfmeterschießens.
Die Paarungszeile führt unmittelbar in den **Spielbericht**, ohne
zusätzlichen Informationsdialog oder aktuelles Vereinsprofil. Der Kopf
zeigt die archivierten Vereinsnamen, Wappenreferenzen, menschlichen
Manager beziehungsweise „Computer“ und den Spielendstand ohne
Elfmeterschießen. Reguläre Spielzeit, zusätzliche Verlängerungstore und
Elfmeterschießen stehen getrennt darunter. Beispiel: regulär `1 : 1`,
Verlängerung `1 : 1`, Spielendstand `2 : 2`, Elfmeterschießen `4 : 3`.
`result.extra` enthält ausschließlich die in der Verlängerung zusätzlich
gefallenen Tore.
Schiedsrichter, Zuschauer, Temperatur und Regen gehören ebenfalls zum
Spielbericht. Die beiden Reiter **Aufstellungen** und **Ereignisse**
wechseln den darunterliegenden Inhalt. Aufstellungen zeigen beide Seiten
mit Startelf und der gesamten überlieferten Bank. Die angezeigten
Laufnummern sind Zeilenpositionen, keine behaupteten historischen
Rückennummern. Fehlende Aufstellungen heißen „Keine Aufstellung
überliefert.“; fehlende Einzelangaben erscheinen als „—“. Eine bekannte
Null bleibt dagegen sichtbar, etwa `0` Zuschauer, `0 °C` oder `0 / 7` Regen.
Die Ereignisliste enthält Tor, Fehlschuss, Gelb, Gelb-Rot, Rot,
Verletzung, Wechsel und jeden Versuch des Elfmeterschießens. Tore und
Fehlschüsse nennen Spieler, Vorlage beziehungsweise Zuspiel und die Art
Spiel, Elfmeter/Freistoß, Nachschuss oder Ecke. Beim Wechsel stehen Ein-
und Auswechslung ausdrücklich getrennt. Im Elfmeterschießen bleiben
Treffer und Fehlversuche einzeln sichtbar. Ereignisse derselben Minute
behalten ihre ursprüngliche Reihenfolge; die symbolische Minute 121 wird
als fortlaufender Versuch „i. E.“ angezeigt.
„Zurück“ und Escape führen vom Spielbericht zu den Tagespaarungen, von
dort zum Jahreskalender und schließlich zum Desktop. Der Fokus kehrt
jeweils zur aufrufenden Zeile, zum Datum oder zum Desktop-Icon zurück.
Escape schließt zuerst eine offene Jahresauswahl. Jahreswechsel setzen
Tag und Spielbericht zurück. Die aktive Registerkarte wird beim Öffnen
eines anderen Spielberichts wieder auf „Aufstellungen“ gesetzt.
## Präsentationsquelle und Speicherung
[DataSource::read_almanac()](../../../../src/modern/ui/model.hpp) ist eine
konstante Leseoperation. Die Standardimplementierung meldet
`almanac_unavailable`. `DemoSource` besitzt ein unveränderliches
Pseudoarchiv außerhalb von `Snapshot.state` und den UI-Demoständen.
Alle Abfragen verwenden das gespeicherte Demodatum als `as_of`: Sichtbar
sind ausschließlich Spiele bis einschließlich dieses Tages. Auch eine
direkte Abfrage einer bekannten zukünftigen Match-ID liefert keinen
Datensatz.
Jahr, Tag, Match-ID, Registerkarte und Jahresauswahl sind nur flüchtige
Felder der App. Navigation ruft weder `Source.apply()` auf noch erhöht
sie die Revision oder setzt den Spielstand auf geändert. Sie verändert
keine Finanzen, Manager, Kader oder Zufallsströme. Das Archiv wird beim
Speichern nicht in jeden Snapshot oder UI-Checkpoint kopiert.
Die Demo erzeugt zwölf Spiele aus zwei abgeschlossenen Saisons vor der
Saison von `manifest.start_date`; ohne dieses Feld gilt `2026-07-01` als
Demoausgangspunkt. Das ergibt drei Kalenderjahre mit mehreren Partien an
einem Tag, regulären Ergebnissen, Verlängerung und einem vollständigen
Elfmeterschießen. Vereins- und Spielernamen werden beim Aufbau aus dem
Katalog kopiert. Namen werden danach nicht aus dem aktuellen Kader neu
ermittelt. Fehlende Kader werden nicht durch erfundene Spieler ersetzt.
Die HTML-Studie verwendet eigene Pseudokader; deren Namen und Werte sind
keine zusätzlichen OBW-Daten.
Das neue Desktop-Objekt heißt `app-almanac`. Ein mitgeliefertes SVG-Icon
und die GUI-Ressourcenaufbereitung machen es unabhängig von zusätzlichen
Weltbildern verfügbar. `migrate_desktop()` ergänzt bei älteren gültigen
Layouts das fehlende Icon an einem freien Platz. Vorhandene Objekte
bleiben unverändert. Beschädigte bestehende Layoutdaten werden atomar
abgewiesen und nicht teilweise repariert. Gespeichert wird weiterhin nur
das Desktop-Layout, nicht die Almanachnavigation oder das Pseudoarchiv.
## Enginegrenze und Prüfstand
Der Renderer liest ausschließlich die Projektion über die Datenquelle.
Er öffnet keine `.obs`-Datei, dekodiert kein F10 und greift nicht auf
`ModernState` oder die laufende Session zu. Der vorhandene
[Engine-Almanach](../../../new_engine/almanach.md) und sein Speicherformat
bleiben durch dieses UI-Paket unverändert. Eine spätere konstante
Modern-Sessionprojektion soll benötigte Saisons bei Bedarf dekodieren und
dieselben Ansichten liefern. Die konkreten F10-Grenzen und die Regeln für
unbekannte Werte stehen im [Datenvertrag](DATA_CONTRACT.md).
Für das integrierte Paket sind 19 automatische Tests grün. Dazu gehören
die neuen synthetischen Providerprüfungen sowie Source-, Core- und
Desktopmigrationstests. Geprüft sind unter anderem Cutoff und leeres
Archiv, historische Namen, getrennte Ergebnisphasen, Aufstellung und Bank,
Ereignisse und Shootout, ungültige Eingaben sowie unveränderte Snapshots,
Revisionen und Änderungsmarkierungen bei Leseabfragen.
Die unabhängige native Laufzeitprüfung besteht: sechs Matrixläufe in drei
Themes bei 720p/1080p mit 96 dokumentierten Zuständen, gezielte Text-/Icon-
Nachaufnahmen, 25 Navigations-/Cutoff-/Dirty-Zustände und fünf Fokusproben.
Beide 20er-Kader sind bis zum Bankende erreichbar, ebenso alle zehn
Shootoutversuche. Die Archivnavigation verändert weder Revision noch Daten
oder vorhandene Dirty-Markierungen. Altansichten werden additiv migriert;
reines Blättern löst beim Beenden keine Speichernachfrage aus.
Die HTML-Prüfung ergänzt leeres Archiv, heute/zukünftig, unbekannte Menschen,
Nullwerte sowie direktes Elfmeterschießen ohne Verlängerung. Diese Sonderfälle
sind im nativen Renderer zusätzlich quellgeprüft; native Standard-, ET-, PK-
und Fehlwertfälle wurden tatsächlich bedient. Bilder, Skripte, Inputs und
Checkpoints liegen privat unter `bmh_4k_ui/docs/qa/almanac-2026-10-24/`.
Die Belege betreffen Linux/OpenGL und Browser, keine vollständige native
Windows-/macOS-Abnahme. Eine F10-/OBS-Anbindung ist weiterhin nicht enthalten.
## Elfmeterschuss-Korrektur · 28. Oktober 2026
Der Engine-Read liefert die nachweislich getrennten Spiel-/Elfmetertore und eine
einmalige Schussserie. Damit zeigt auch der bereits gespeicherte Referenzfall
`match:2026-446` regulär 0:0, Verlängerung 0:0 und Elfmeterschießen 2:4. Die
vorhandenen Spielstand-/Archivbytes werden nicht umgeschrieben. Die UI behält die
Kennzeichnung unklarer Phasen für nicht eindeutig rekonstruierbare Alt-Daten.
Fehlende Teilstände werden als — dargestellt; direkte Hallen-Elfmeterschießen
werden ohne behauptete Verlängerung angezeigt. [Engine-Details](../../../new_engine/almanach.md).
Private Vorher-/Nachher-QA mit denselben OBS-Dateien:
`bmh_4k_ui/docs/qa/almanac-shootout-2026-10-28/`.