Files
Dreierpack-Manager/docs/new_ui/desktop/calendar/README.md
T

96 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Kalender · native Modern UI
## Echter Engine-Einstieg · 28. Oktober 2026
`--ui-career` verwendet jetzt denselben Zwölfmonatsrenderer mit einem vollständigen
`calendar`-Read von `meta.season.startDate` bis `endDate`. Die Geometrie erzeugt
nur Monatstage und Gregorianische Wochentage; sie erzeugt keine Ligapartien.
Alle konkreten Paarungen, Runden, Status, Ergebnisse und verlegten Termine kommen
unverändert aus der Engine. Datumsauswahl ist ein lokaler UI-Zustand und verändert
weder Sessionrevision, Geld, Spieltag noch Zufall.
Gelbe Termine haben eine tatsächliche eigene Kalenderpartie; Freundschaftstage
verwenden ihre vorhandene grüne Markierung. Kleine neutrale Marken zeigen
allgemeine Wettbewerbstermine. Ein Pokal- oder Länderspieltermin ohne gelieferte
Paarung wird als solcher benannt, ohne eigene Teilnahme oder einen Gegner zu
erfinden. Fehlende Termine heißen „keine eingetragenen Termine“, nicht pauschal
„spielfrei“. Nach einer Verlegung nennt die Terminzeile auch das ursprüngliche
Datum. Die Bezeichnungen stammen aus den gelieferten Ereignisarten.
Der erste Anschluss betrifft den Vereinskalender. Land und Liga zeigen die
aktuelle Zuordnung, bleiben aber lesend, bis die Engine Kalender anderer Ligen
liefert. Diese Felder besitzen symmetrische Innenabstände, da kein Dropdownpfeil
aktiv ist. Der Nationalkalender und die Freundschaftsspielplanung erhalten eigene
Anschlusspakete; sie werden nicht mit Vereins-Demodaten befüllt.
Private Nachweise mit drei Themes/1080p, Silver/720p und tatsächlichen OBS-Dateien:
`bmh_4k_ui/docs/qa/engine-calendar-2026-10-28/`.
## Getrennte Präsentationsdemo
Stand: 24. Oktober 2026. Quelle ist das unveränderte private HTML-Mockup
`bmh_4k_ui`, Referenzrevision `a7f8e39c8cb562a09d85dabae81e62a981afeb85`:
`desktop/management-menus.js`, `league-preview.js`, `table-window.css` und
`menu-themes.css`. Native Ansicht: `src/modern/ui/calendar_screen.inc`.
## Gestaltung und Bedienung
Zwölf Monatskarten von Juli bis Juni stehen in einem Raster mit vier Spalten
und drei Reihen. Innerhalb jedes Monats stehen **die Wochentage in sieben
Zeilen**, die Wochen in sechs Spalten. Diese transponierte Originalanordnung
wird beibehalten. Leere Randplätze enthalten keine künstlichen Datumsknöpfe.
Monatsnamen und Tageszahlen verwenden 30 logische Pixel, Wochentage 24.
Sonntagsbeschriftungen sind rot, Ligatermine gelb. Der gewählte Tag erhält
den thematischen Hintergrund und einen vollständigen inneren Rahmen.
Unter dem Kalender steht genau eine Terminzeile; darunter liegen die
gleich großen Auswahlfelder Land und Liga. Es gibt keinen zusätzlichen Footer.
Maus, Leertaste und Enter wählen einen Tag. Fokus bleibt beim neu gerenderten
Tagesknopf. Pfeiltasten verschieben das Datum nicht eigenmächtig. Länder- und
Ligawechsel erhalten den Tag und ändern ausschließlich die Vorschau.
Escape schließt zunächst die geöffnete Auswahl, danach das Menü. Rechtsklick
schließt das Untermenü wie im HTML. Datums- und Ligawahl bleiben nach
Wiederöffnen und Laden eines UI-Demostands erhalten.
## Daten und Enginegrenze
Der Demoanbieter liefert `calendar` mit Saisonbeginn, gewähltem Tagesindex,
Liga-ID sowie die lokale Planung aus [Freundschaftsspielen](../friendlies/README.md)
und [Verlegen](../postpone/README.md). Die Vormerkungen und Verlegungen
ändern die angezeigten Termine der eigenen Liga; bei fremder Ligavorschau
bleiben deren Vorschautermine unverändert.
Unbekannte Ligen, ungültige Tagesindizes und nicht ganzzahlige Eingaben
werden atomar abgewiesen. Die Saison stammt aus dem Demodatum; sie ist
nicht auf das Jahr der HTML-Vorschau festgelegt.
Die Vorschautermine sind deterministische Dummydaten: zwei Begegnungen je
Gegner, erste Runde am Saisonindex 30, danach sieben Tage Abstand. 18 Vereine
ergeben 34, 20 Vereine 38 Spieltage. Ist der verwaltete Verein in der Liga,
zeigt die Vorschau dessen Termine; ansonsten die des ersten Vereins der
angezeigten Liga. Die Manageridentität wird dadurch nicht geändert.
**Dies ist keine Spielplanerzeugung für die Engine.** Es gibt weder Zufall
noch Sessionzugriffe. Der spätere Sessionadapter ersetzt die Terminvorschau
durch echte Spieltage, Pokale, Verlegungen und Freundschaftsspiele. Die
zugehörigen nativen Planungsmenüs und farbigen Freundschaftsmarkierungen
sind als reine UI-Vorschau angebunden. Bestätigte Vormerkungen sind grün
markiert und erscheinen mit Gegner in der Terminzeile.
## QA
Der unabhängige Vergleich nutzt alle drei Themes bei 1280 × 720 und
1920 × 1080. Für den Datumsvergleich wurde ein isolierter Demostand auf
2027/28 gesetzt, damit auch der 29. Februar aus der HTML-Referenz prüfbar ist.
Die ursprüngliche Weltdatei bleibt unverändert. Abweichende Vereinsnamen aus
Diamond gegenüber der HTML-Demo werden ausdrücklich als Datenunterschied
behandelt.
Synthetische Regression prüft Gregorianische Schaltjahre einschließlich
2100, Wochentagspositionen, zwei Begegnungen je Gegner, 18-/20-Vereinsgrößen,
atomare Ablehnung und Wiederherstellung. Die Renderer-QA prüft zusätzlich
sichtbare Wochentage, Auswahlrahmen, Terminzeilen, Tastatur/Fokus und
Länder-/Ligawechsel. Land und Liga verwenden jetzt die gemeinsamen Footerpicker mit identischer
Popupschrift und separater Markierungsspalte. Das bewusste erneute Wählen
des gleichen Landes setzt seine erste Liga zurück; Escape verwirft die Auswahl.