Add read-only Almanac desktop and match history views (by Codex)
This commit is contained in:
1 parent
af60e499a2
commit
d42c855843
29 files changed
+2009
-35
No files matched your search
@@ -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).
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
@@ -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) |
|
||||
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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
|
||||
|
||||
Reference in new issue
Block a user