Add read-only Almanac desktop and match history views (by Codex)

This commit is contained in:
Codex committed 2026-10-24 04:04:33 +02:00
1 parent af60e499a2
commit d42c855843
29 files changed
+2009 -35

No files matched your search

+9
View File
@@ -45,6 +45,15 @@ Pro Spiel (`AlmanacMatch`):
## Für die UI (Codex)
Der [native und HTML-Almanachprototyp](../new_ui/desktop/almanac/README.md)
liegt mit Pseudodaten vor. Der [Lesevertrag](../new_ui/desktop/almanac/DATA_CONTRACT.md)
beschreibt die Abfragen `index`, `calendar`, `day` und `match` für eine spätere
konstante Modern-Sessionprojektion. Dort sind auch die F10-Grenzen festgehalten:
Teilstände nur bei vollständigem Nachweis ableiten, die ET-Teilnahme beim
Elfmeterschießen nicht raten, historische Tabellen verwenden und fehlende
Kader beziehungsweise Einzelangaben neutral ausgeben. Die UI liest derzeit
keine F10-/OBS-Dateien und ändert keine Engine- oder Spielstanddaten.
- `ModernState::almanac`: `finished` (Dateiname + Bytes je Saison, mit `decode_almanac_season` lesen) und `current` (laufende Saison).
- Auswertungen (Torjäger aller Zeiten, Bilanzen, Rekorde) baut die Engine als Projektionen, sobald die Almanach-Oberfläche feststeht. Bis dahin kann die UI direkt auf den Saisons rechnen. `modern_season_sim` zeigt am Laufende ein Beispiel (`print_almanac`: Prüfung Tore gegen Ergebnis, Top-Torschützen über alle Saisons).
- Namen sind UTF-8; Wettbewerbsnamen für Pokale kommen wie im Ergebnisbildschirm aus den Texten (`type - 1` = Pokal-ID).
+6
View File
@@ -54,6 +54,12 @@ wird ausdrücklich mit `OPENBMH_BUILD_MODERN_UI=ON` gebaut.
- [Hallentabellen](desktop/indoor/README.md): bis zu 16 Vereine aus der ersten
deutschen Liga, unabhängige Platz-/Punktesortierung, Vereinsprofile und Info.
- [Almanach](desktop/almanac/README.md): eigenes Desktopicon, Jahreskalender,
Tagespaarungen und Spielberichte mit Phasenergebnissen, menschlichen Managern,
Schiedsrichter, Zuschauern, Wetter, beiden Aufstellungen/Bank und Ereignissen.
Die Vorschau verwendet unveränderliche Pseudodatensätze über zwei Saisons;
die vorbereitete Leseprojektion ist noch nicht an F10/OBS angeschlossen.
**Anstoß führt keine Aktion aus**, weder per Maus noch per Tastatur. Das gilt
auch für die direkte Aktionsschnittstelle des Demoanbieters.
+1
View File
@@ -19,6 +19,7 @@ Implementierung in der Spiel-Engine.
| Training | [Übungen, Kader, Intensität und Demo-Automatik](desktop/training/README.md) |
| Taktik | [Interaktive Diagramme und Einsatzregler](desktop/tactics/README.md) |
| Kalender | [Zwölf Monate, transponierte Wochen und Ligavorschau](desktop/calendar/README.md) |
| Almanach | [Jahreskalender, 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 | [Gegner, Austragungsort, Kostenbestätigung und Vormerkungen](desktop/friendlies/README.md) |
+10
View File
@@ -79,3 +79,13 @@ private QA-Inhalte bleiben im privaten Bestand.
`cacf8fdd5376110529afbf97c7b977aaee1d7957`: Karten, Campmotive und Menügrafiken.
- Diamond 2026/27 Modern, Datenrevision 1.3: der geprüfte Asset-Index enthält
HQ-Wappen und Spielerbilder, aber keine `asset:camp/...`-Bildschlüssel.
## Almanachsymbol
Das neue `almanac.svg` ist ein eigenständig gezeichnetes Vektorsymbol aus
Kalenderbuch und Fußball. Die GUI-Vorbereitung übernimmt
`assets/vector/desktop-almanac.svg` als `button.almanac`. Die native UI liefert
dieselbe Grafik unter `assets/modern/icons/almanac.svg` mit und kann sie auch
bei einem älteren externen GUI-Paket anzeigen. Ein OBW muss dieses Motiv
nicht enthalten. Bestehende Desktopansichten erhalten nur das zusätzliche
Icon an einer freien Stelle; vorhandene Objekte werden dabei nicht verschoben.
@@ -0,0 +1,299 @@
# Almanach · Datenvertrag der UI-Projektion
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.
## Besitz und Lesezugriff
`DataSource::read_almanac(const Json &request) const` liefert eine
JSON-Antwort. Nicht unterstützte Quellen antworten mit
`{"ok":false,"error":"almanac_unavailable"}`. `DemoSource` leitet an
`query_demo_almanac(archive, request, state.date)` weiter.
Das separat gehaltene Demoarchiv hat die Form
`{schema: "openbmh-ui-demo-almanac@1", matches: [...]}`. Es liegt nicht in
`Snapshot.state` oder UI-Demoständen. Abfragen geben eigenständige
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.
## Requests und Antworten
Requests sind Objekte mit genau den angegebenen Schlüsseln. Datumswerte
sind gültige Gregorianische ISO-Daten `YYYY-MM-DD`; Jahre sind ganze
Zahlen von 1 bis 9999. Boolesche Werte und Fließkommazahlen ersetzen keine
Ganzzahlen. Der Stichtag `as_of` ist kein frei überschreibbarer
Requestparameter: Die Datenquelle bindet ihn an das gespeicherte Datum.
| Request | Erfolgsantwort zusätzlich zu `ok: true` |
|---|---|
| `{kind: "index"}` | `years: [Jahre]`, `match_count`, `first_date`, `last_date` |
| `{kind: "calendar", year: 2025}` | `year`, `days: [{date, count, highlights: [Match-IDs]}]` |
| `{kind: "day", date: "2025-08-03"}` | `date`, `matches: [vollständige Records]` |
| `{kind: "match", id: "demo:almanac:2025:0"}` | `match: vollständiger Record` |
`years` ist aufsteigend und enthält nur Kalenderjahre sichtbarer Records.
`first_date` und `last_date` sind bei leerem Archiv `null`,
`match_count` ist dann `0`. Ein Jahreskalender enthält nur Tage mit
sichtbaren Partien, chronologisch geordnet. `count` zählt alle Partien
des Tages. `highlights` enthält in der Demo die IDs von Partien mit
Verlängerung, Elfmeterschießen oder mindestens vier Spieltoren insgesamt;
es enthält keine zusätzlichen Ergebnisse. Die Tagesabfrage erhält bei
Partien desselben Datums ihre ursprüngliche Archivreihenfolge.
Alle vier Abfragen filtern zuerst auf `record.date <= as_of`. Damit
verraten weder die Jahresauswahl noch Anzahlen, Datumsgrenzen oder direkte
Matchabfragen zukünftige Partien. Ein gültiger leerer Tag oder ein Jahr
ohne sichtbare Daten liefert ein leeres Array. Unbekannte und noch nicht
sichtbare Match-IDs liefern denselben Fehler.
Fehler haben die Form `{ok: false, error: "..."}`:
| Fehler | Bedeutung |
|---|---|
| `almanac_unavailable` | Datenquelle unterstützt diese Projektion nicht. |
| `invalid_almanac_request` | Ungültige Requestform, unbekannte Art, zusätzliche Felder oder ungültiger Wert. |
| `invalid_almanac_cutoff` | Ungültiges Stichtagsdatum. |
| `invalid_demo_almanac` | Das separat gehaltene Demoarchiv verletzt seinen Vertrag. |
| `almanac_match_not_found` | Match-ID unbekannt oder jenseits des Stichtags. |
Diese Fehlercodes beschreiben den nativen Provider. Der private
HTML-Arbeitsstand besitzt eigene Fehlerbezeichnungen; sein normalisierter
Recordaufbau und seine erfolgreichen Leseprojektionen folgen demselben
fachlichen Vertrag.
## Normalisierter Matchrecord
Alle folgenden Hauptfelder sind vorhanden. „Nullable“ bedeutet einen
expliziten JSON-Wert `null`, keinen ersatzweise erfundenen Inhalt.
| Feld | Typ und Bedeutung |
|---|---|
| `id` | Stabile, nicht leere Match-ID. |
| `date` | ISO-Kalendertag des gespielten Matches. |
| `season` | Historische Saisonbeschriftung, etwa `2025/26`; kein Kalenderjahrfilter. |
| `competition` | `{id, name, type}` mit historischen Werten; `type` beispielsweise `league`, `cup` oder `friendly`. |
| `round` | Positive ganze Spieltags- oder Rundennummer. |
| `home`, `away` | Je `{id, name, crest, manager}`; unterschiedliche stabile Vereins-IDs. |
| `result` | Getrennte Ergebnisphasen gemäß folgendem Abschnitt. |
| `referee` | Historischer Name oder `null`. |
| `attendance` | Bekannte ganze Zuschauerzahl einschließlich `0`, sonst `null`. |
| `weather` | `{temperature, rain}`; beide ganzzahlig oder `null`, Regen im Bereich `0..7`. |
| `lineups` | `{home, away}`; jede Seite entweder `null` oder `{starters: [...], bench: [...]}`. |
| `events` | Geordnetes Array der unten definierten Ereignisse. |
`crest` ist ein GUI-/Katalog-Assetverweis oder `null`. Namen und Verweise
werden als historische Snapshotwerte gehalten. Das DTO enthält keine
historischen Bildbytes und belegt deshalb nicht, dass eine später unter
demselben Assetverweis geladene Grafik dem früheren Wappenstand entspricht.
Der aktuelle Bildresolver darf eine Referenz darstellen; daraus folgt
keine zugesicherte historische Bildarchivierung.
`manager` ist entweder `{id, name}` für einen archivierten menschlichen
Manager oder `null` für die in der Demo gesichert computergesteuerte
Seite. Der Renderer zeigt dafür „Computer“. Ein künftiger Adapter darf
einen ungültigen oder unbekannten menschlichen Managerverweis nicht
stillschweigend auf diesen Computerfall abbilden.
Ein Aufstellungsspieler hat `{id, name, position?}`. `position` ist das
einzige optionale Feld dieses Teilobjekts. In der Demo wird sie beim
Archivaufbau aus dem Katalog kopiert, etwa `gk`, `def`, `mid` oder `fwd`.
Die sichtbaren Kürzel TW, ABW, MIT und STU sind reine Darstellung.
Der Renderer ersetzt fehlende historische Angaben nicht durch heutige
Kaderdaten. Die Demo bildet bei ausreichendem Kader genau einen Torwart
und zehn Feldspieler ab; alle übrigen Kaderspieler bleiben auf der Bank.
Ist das nicht möglich, bleibt die betreffende Aufstellung `null`.
Die Laufnummer eines Aufstellungsplatzes ist kein Spieler-ID-Ersatz und
keine historische Rückennummer. Historische Spieleridentitäten bleiben
auch bei gleichnamigen Personen getrennt. Katalogumbenennungen nach dem
Archivaufbau verändern weder Vereins- noch Spieler- oder Managernamen
bereits erzeugter Records.
### Ergebnisphasen
`result` enthält immer folgende Schlüssel:
| Feld | Bedeutung |
|---|---|
| `regulation` | `[Heimtore, Gasttore]` nach regulärer Spielzeit oder `null`, falls unbekannt. |
| `extra` | Ausschließlich zusätzlich in der Verlängerung gefallene Tore; bei nicht gespielter oder unbekannter Phase `null`. |
| `penalties` | Separates Ergebnis des Elfmeterschießens; ohne Elfmeterschießen `null`. |
| `final` | Spielendstand nach 90 beziehungsweise 120 Minuten, ohne Tore des Elfmeterschießens. |
| `extra_played` | Explizit bekanntes boolesches Kennzeichen für gespielte Verlängerung. |
| `penalties_played` | Boolesches Kennzeichen für gespieltes Elfmeterschießen. |
Alle bekannten Ergebnisse sind Paare nicht negativer ganzer Zahlen.
Sind reguläre Zeit und Verlängerung bekannt, gilt pro Seite
`regulation + extra == final`. Beispiel:
```json
{
"regulation": [1, 1],
"extra": [1, 1],
"penalties": [4, 3],
"final": [2, 2],
"extra_played": true,
"penalties_played": true
}
```
`extra: [0, 0]` bezeichnet eine bekannte torlose Verlängerung und ist
etwas anderes als `extra: null`. Die aktuelle Demo erlaubt bei gespielter
Verlängerung unbekannte Teilstände. Bei gesetztem `penalties_played`
verlangt ihr Validator dagegen ein bekanntes, entscheidendes
Elfmeterschießenergebnis. Das Elfmeterschießen wird niemals zum
Spielendstand addiert. Ohne gespielte Verlängerung bleibt `extra` stets
`null`.
Die booleschen Phasenkennzeichen sind in der Demo ausdrücklich bekannt.
Für einen Liveadapter mit unbekannter ET-Teilnahme muss vor der Anbindung
ein ausdrücklicher Unbekanntzustand vereinbart werden. `false` wäre dafür
kein zulässiger Ersatz; aus `decided == 2` einfach `true` abzuleiten wäre
ebenfalls unbelegt.
### Ereignisse
Jedes Ereignis enthält genau
`{kind, minute, side, player, other, detail}`. `side` ist `home` oder
`away`. `player` und `other` sind jeweils `{id, name}` oder `null`;
sie tragen keine nachträglich aus dem Kader ergänzten Werte.
| `kind` | Bedeutung von Spieler und Zusatzangaben |
|---|---|
| `goal` | Torschütze, ggf. Vorlagengeber unter `other`; `detail` bezeichnet die Torart. |
| `miss` | Schütze, ggf. Zuspieler unter `other`; gleiche Detailarten wie beim Tor. |
| `yellow` | Verwarnter Spieler. |
| `second_yellow` | Spieler mit Gelb-Rot. |
| `red` | Spieler mit direkter Roter Karte. |
| `injury` | Verletzter Spieler. |
| `substitution` | `player` kommt ein, `other` geht aus; unbekannte Beteiligte bleiben `null`. |
| `shootout` | Schütze eines einzelnen Versuchs; `detail: 1` getroffen, `detail: 0` verfehlt. |
Bei Tor und Fehlschuss bedeutet `detail: 0` Spiel, `1`
Elfmeter/Freistoß, `2` Nachschuss und `3` Ecke. Die gemeinsame Kategorie
Elfmeter/Freistoß wird nicht willkürlich in zwei Ursprünge aufgeteilt.
Die übrigen Ereignisarten verwenden in der Demo `detail: 0`.
Spielereignisse tragen Minuten ab 1, in der Verlängerung bis 120.
Shootout-Ereignisse verwenden symbolisch Minute 121. Die ursprüngliche
Arrayfolge ist bei gleicher Minute maßgeblich; insbesondere dürfen
Shootoutversuche nicht nach Spieler, Seite oder Trefferstatus umsortiert
werden. Die Anzeige sortiert Minuten stabil und nummeriert alle Versuche
einschließlich Fehlversuchen fortlaufend.
### Null, Nullwert und Validierung
`0` ist ein bekannter Wert, etwa keine Zuschauer, null Grad oder kein
Regen. `null` bedeutet fehlende Information. Leere Aufstellung, fehlender
Spieler und Computersteuerung dürfen nicht über numerische Null oder
den ersten Eintrag einer Tabelle erraten werden. Fehlende Namen und
Metadaten erscheinen neutral; ein fehlender Kader erhält keine erfundene
Startelf.
`valid_demo_almanac()` prüft den vollständigen Demoaufbau, eindeutige
Match-IDs, Ergebnis- und Ereigniskonsistenz, gültige Referenzen innerhalb
bekannter Aufstellungen, genau eine bekannte Torwartposition bei
vollständig bekannten Startpositionen, Wechsel, Platzverweise und die
Vollständigkeit eines entscheidenden Shootouts. Die Demoereignisse sind
vollständig und stimmen mit den Spieltoren überein. Dieser Validator ist
kein Ersatz für einen künftigen Adapter mit ausdrücklich unvollständigen
Engineaufzeichnungen; dort dürfen fehlende Phasen nicht durch erfundene
Ereignisse passend gemacht werden.
## Spätere Modern-Sessionprojektion und F10
Grundlage bleiben
[almanach.md](../../../new_engine/almanach.md) und
[almanac.hpp](../../../../src/modern/game/almanac.hpp). F10 enthält bereits
historische Saison-, Vereins-, Spieler-, Manager- und
Schiedsrichtertabellen, Aufstellungen, Zuschauer, Wetter und acht
Ereignisarten. Die Phasenlücke beim Ergebnis bedeutet nicht, dass F10
insgesamt nur einen Endstand und ein Ereignisprotokoll speichern würde.
Der spätere Adapter gehört an die konstante Leseseite der Modern-Session.
Er soll nur benötigte Saisons bei Bedarf dekodieren und historische
Tabellen in UI-Records auflösen. Renderer und Navigation bleiben
unabhängig von OBS, Binärdekodierung und laufenden Engineobjekten.
Abgeschlossene Archive müssen dafür nicht in jeden GUI-Snapshot kopiert
werden. Dieses Paket implementiert oder verändert diesen Adapter nicht.
Die fachliche Zuordnung für den späteren Adapter ist:
| Engine-/F10-Quelle | Normalisiertes UI-Feld |
|---|---|
| Saisonkopf und ursprünglicher Matchordinal | Stabile `id` und Saisonbeschriftung `season`. |
| `date`, `display_start_year`, `almanac_date()` | ISO-Kalendertag `date`; daraus Kalenderjahr und Cutoff. |
| `type`, `league`, `stage`, `round` sowie verfügbare Wettbewerbsmetadaten | `competition` und `round`; Ligakennung und Pokalstufe sind keine austauschbaren Indizes. |
| Saison-Clubtabelle und `home`/`away` | Historische Vereins-IDs und Namen unter `home`/`away`; Bildreferenzen sind keine historischen F10-Bildbytes. |
| `home_manager`/`away_manager` und Managertabelle | Historische menschliche Manager; gesichert `-1` bezeichnet Computer. |
| `home_goals`/`away_goals` | `result.final`, ohne Shootouttore. |
| `home_shootout`/`away_shootout`, `decided` | Separates `result.penalties` und bekannte Entscheidungsart; keine pauschale ET-Ableitung. |
| Vollständige Torereignisse und gesicherte Phaseninformation | Soweit belegt `result.regulation` und zusätzliche Tore unter `result.extra`. |
| Schiedsrichterreferenz, Zuschauer, Temperatur und Regen | `referee`, `attendance`, `weather`, nach Referenz- und Bekanntheitsprüfung. |
| Aufstellungsvektor und saisonale Spielertabelle | Historische Spieleridentitäten und Namen; `starters`/`bench` nur bei belegbarer Trennung. |
| `AlmanacEvent` und seine historischen Spielerreferenzen | Die acht `events.kind`-Werte, Minute, Seite, Spieler, zweiter Spieler und Detail. |
Die konkrete Gap-Liste für diese spätere Integration lautet:
1. **Ergebnisphasen:** `AlmanacMatch.home_goals/away_goals` enthalten den
Spielendstand ohne Shootout; separate Shootouttore sind vorhanden.
Ein eigener 90-Minuten-Stand und ein ausdrückliches ET-Kennzeichen
fehlen im Fall `decided == 2`. Reguläre Tore und zusätzliche
Verlängerungstore dürfen nur bei gesichert vollständigen Daten aus
Torereignissen und Endstand abgeleitet werden. Fehlen solche Daten,
bleiben Teilstände unbekannt. Aus Shootout oder `decided == 2` allein
darf niemals pauschal auf eine gespielte Verlängerung geschlossen werden.
2. **Matchidentität:** Ein eigenes stabiles Match-ID-Feld fehlt.
Saisonkennung plus ursprünglicher Matchordinal kann den stabilen
Projektionsschlüssel bilden. Eine aktuelle Sortier- oder Zeilennummer
reicht nicht. Die Demo verwendet entsprechend
`demo:almanac:<Saisonstartjahr>:<ursprünglicher Ordinal>`.
3. **Historische Namensstände:** Die Tabellen werden pro Saison geführt.
Vereine und Spieler werden beim ersten Eintrag ihrer stabilen ID
aufgenommen; Namen werden nicht für jeden einzelnen Matchtag erneut
eingefroren. Diese historischen Tabellen sind maßgeblich und dürfen
nicht durch heutige Kadernamen ersetzt werden.
4. **Spielerattribute:** F10-Spieler enthalten ID, Vorname, Nachname und
Nation, keine archivierte Rückennummer, Position oder Stärke.
Optionale Demo-Positionen stammen aus dem POC-Aufbau und sind keine
vorgeblich aus F10 gelesenen Daten.
5. **Startelf und Bank:** Der Enginevektor bedeutet nominell elf Starter,
anschließend Bank. Der Recorder überspringt jedoch leere Plätze.
Bei unvollständiger Startelf mit Bank kann die Grenze im Vektor allein
mehrdeutig sein. Kader von Länder- und Amateurteams fehlen ausdrücklich.
Die UI darf aus dieser Unsicherheit keine erfundene Elf konstruieren;
das normalisierte DTO trennt beide Bereiche ausdrücklich.
6. **Ereignisbedeutung:** `Goal.detail == 1` kombiniert Elfmeter/Freistoß;
`0`, `2`, `3` stehen für Spiel, Nachschuss und Ecke.
`Substitution.player` bezeichnet Ein, `other` Aus.
`kAlmanacNone == 0xffff` ist ein fehlender Verweis, kein Spieler an
Tabellenposition 0.
7. **Shootoutfolge:** Mehrere Versuche teilen typischerweise Minute 121.
Ihre ursprüngliche Arrayreihenfolge muss erhalten bleiben; jeder
Treffer und Fehlversuch zählt. Ein gesondertes Zeit- oder Sequenzfeld
für diese Kicks existiert nicht.
8. **Fehlende Rohwerte:** Manche Raw-Standardwerte unterscheiden eine
fehlende Angabe nicht von einer gültigen Null, etwa bei Zuschauern,
Temperatur und Regen. Der Adapter braucht gesichert bekannte Werte
oder `null`, keine Heuristik „0 bedeutet unbekannt“. Schiedsrichterindex
0 bezeichnet keinen ausgewählten Schiedsrichter.
9. **Referenzgrenzen:** Die Binärdekodierung prüft nicht jeden Spieler-,
Manager- oder Schiedsrichterindex. Der Adapter muss Grenzen prüfen und
unbekannte Referenzen neutral behandeln. Ein ungültiger menschlicher
Managerindex darf nicht unbemerkt als Computersteuerung erscheinen.
10. **Datumdomäne:** Datum ist aus Tageszähler und `display_start_year`
über `almanac_date()` zu übertragen. Ein Saisonstartjahr ist kein
Kalenderjahrfilter. Engine- und Schreibtischdatum müssen deshalb
ausdrücklich in die Kalenderdatumdomäne der UI übersetzt werden.
Die Wappenfrage bleibt daneben eine gesonderte Darstellungsgrenze:
Assetreferenzen sind vorhanden, historische Bildbytes sind durch den
vorliegenden Vertrag nicht belegt. Weder Namen noch Positions- oder
Bildlücken rechtfertigen einen stillen Zugriff des Renderers auf heutige
Spielwerte oder einen behaupteten vollständigen historischen Bildstand.
+147
View File
@@ -0,0 +1,147 @@
# 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).
## 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.
+5
View File
@@ -72,3 +72,8 @@ deshalb nicht ins öffentliche Quellcode-Repository. Öffentliche Zusammenfassun
[Hallentabellen](desktop/indoor/README.md): ein gemeinsames Paket mit
18 Rendererläufen, 43 Bedienzuständen und gesondertem OS-Beenden-/
Speichern-Nachtest. Aktueller Gesamtkatalog: 18 native und 18 offene Routen.
- [Almanach](desktop/almanac/README.md): Jahreskalender, Tagespartien und
Spielbericht als neues readonly Menü; alle Ergebnisphasen, Kader/Bank,
Ereignisse, alte Ansichten und unveränderte Revision/Dirty-Zustände geprüft.
Der Katalog umfasst jetzt 19 native und 18 offene Routen.
+1 -1
View File
@@ -32,7 +32,7 @@ gemeinsamen Controländerungen zusätzlich in mehreren Menüs nachgeprüft.
Die erste Gesamterfassung enthält 36 Routen, davon zwölf native Aufnahmen
und 24 ausstehende Ports. Diese historische Matrix bleibt unverändert.
Der anschließend übertragene Kalender bekommt einen eigenen Vergleich;
der aktuelle Runner erfasst 18 native Routen und 18 offene Ports.
der aktuelle Runner erfasst 19 native Routen und 18 offene Ports.
Spätere Meilensteine erfassen denselben Gesamtkatalog erneut.
Siehe [QA-Ablauf](menu-qa.md), [Typografie](typography-qa.md) und