Files
Dreierpack-Manager/docs/new_ui/main-menu/opening/README.md
T

66 lines
3.8 KiB
Markdown

# Saisonvorbereitung bis zum Desktop
Die native RmlUI-Demo übernimmt Teilnehmerseiten, automatische Ziehung und
Paarungsübersicht aus dem privaten HTML-Mockup (`season-opening.js/.css`,
Goldquelle `97c19979`). Die drei Teilnehmerseiten zeigen UEFA-Cup,
Champions League und Pokalsieger mit Phase, Saisonspanne und Hervorhebung
der eigenen Vereine. Es folgt die Ziehung mit aktuellem Paar, drei vorigen
Paaren, Pause und Überspringen; die vollständige Übersicht führt zum Desktop.
Heimnamen stehen rechtsbündig, Auswärtsnamen linksbündig; Wappen liegen innen
neben dem mittigen Trennzeichen. Escape und Rechtsklick verlassen diese Folge
nicht. Die Grafik behält ihr tatsächliches Seitenverhältnis.
## Präsentationsdaten
`opening_flow` gehört ausschließlich zum JSON-Demostand. Es enthält Schema 1,
`created`, `phase`, `revealed`, `playing`, stabile Vereins-IDs in `order` und
die Teilnehmer unter `entrants`. Die Phasen sind `uefa`, `champions`, `winners`,
`draw`, `overview`, `done`. `opening.flow` nimmt die Aktionen `next`, `reveal`,
`toggle`, `pause`, `skip` und `finish` entgegen; ungültige oder veraltete
Anfragen lassen Quelle, Revision und Dirty-Marke unverändert.
Die Teilnehmer sind ausdrücklich fiktiv: erste vier verfügbare Vereine der
ersten deutschen Katalogliga im UEFA-Cup, anschließend je einer in Champions
League und Pokalsiegerwettbewerb. Es wird keine echte Qualifikation behauptet.
Der Lostopf enthält höchstens 64 unterschiedliche deutsche Vereine deutscher
Ligen. Ein eigener LCG mit festem Seed `20270701` folgt dem Gold-Demoalgorithmus;
er verwendet keine Engine-Zufallsquelle. Kleine Kataloge zeigen ihre tatsächliche
Anzahl und eindeutige Leerzustände; eine ungerade Restzahl wird vor der Paarbildung
gekürzt. Es werden keine Gegner dupliziert und keine Engine-Freilose berechnet.
Die spätere DFB-Pokalansicht unter Übrige Spiele verwendet dieselbe gespeicherte
Reihenfolge, mit weiterhin leeren Ergebnissen.
## Fortsetzen und Fehlerfälle
Die UI schreibt einen eigenen Fortsetzungsvermerk unter
`userdata/ui-demo/<world-hash>/opening-progress.json`. Er enthält den Demostand,
die Ansicht und eine Manifestkennung. Eine Änderung wird zuerst vorbereitet
und atomar gesichert, dann in der Quelle veröffentlicht. Bei Schreibfehlern
bleibt der letzte Stand erhalten. Eine angehaltene Automatik erzeugt keine
Fehlermeldungsschleife; „Erneut versuchen“ ist eine bewusste neue Aktion.
Fokusverlust pausiert die Ziehung, ohne nachträglich Lose aufzuholen.
Beim nächsten Start derselben Modern-Welt wird eine offene Vorbereitung
fortgesetzt, einschließlich Pause und Reihenfolge. Der Vermerk zählt nicht
als manuelles Speichern und macht die Partie nicht sauber. Ein ausdrücklich
geladener Spielstand hat Vorrang vor einem älteren Fortsetzungsvermerk.
Die abgeschlossene Vorbereitung hinterlässt einen `done`-Vermerk, der beim
Start keine ältere offene Vorbereitung wieder aufleben lässt.
Alte Demo-Checkpoints ohne Flow werden migriert: `pending` beginnt die
Teilnehmerfolge, `complete` bleibt abgeschlossen. Bereits vorhandene
inkonsistente Flowdaten werden abgewiesen. Dies ist kein neues Engine- oder
OBS-Spielstandformat. Match-/Saison-Engine und Anstoß bleiben unverändert;
Anstoß ist weiterhin ohne Aktion.
## Nachweise
Die synthetische Suite `modern_opening_ui_tests` prüft deterministische
Reihenfolge, kleine Kataloge, Übergänge, veraltete Anfragen, pausierte
Rundreisen, Migration und Dirty-Restore. Der tatsächliche native Bedienlauf
prüft zusätzlich Neustart, Autosicherungsfehler mit Rücknahme und explizite
Wiederaufnahme sowie den Vorrang ausdrücklich geladener Checkpoints.
Bilder, Eingaben und UI-Zustände liegen privat unter
`docs/qa/opening-batch-2026-10-26`. Browser-Themes werden über die tatsächlichen
Optionen eingestellt und im DOM geprüft; ein URL-Parameter allein genügt nicht.