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

156 lines
8.8 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.
# Freundschaftsspiele · native Modern UI
Stand: 24. Oktober 2026, natives Planungspaket. Die unveränderte private
HTML-Referenz `bmh_4k_ui` steht auf
`a7f8e39c8cb562a09d85dabae81e62a981afeb85`; die relevanten Produktdateien
entsprechen `494a25611de847f23bf714bfdab6708387f581a7`.
Maßgeblich sind `desktop/management-menus.js`, `league-preview.js`,
`advertising-friendlies-window.css` und die gemeinsamen Tabellen- und
Theme-Regeln. Native Quellen sind
[planning_screens.inc](../../../../src/modern/ui/planning_screens.inc),
[planning_controls.inc](../../../../src/modern/ui/planning_controls.inc),
[calendar_screen.inc](../../../../src/modern/ui/calendar_screen.inc) und
[planning.rcss](../../../../assets/modern/planning.rcss).
Private Referenzbilder und Weltdaten werden nicht mitgeliefert.
## Ansicht und Ablauf
Die Gegnerphase zeigt Verein und Wappen, Stärke, Platz und Spiele. Nur der
verwaltete Verein fehlt in seiner eigenen Ligaauswahl; ausländische Vereine
sind als Gegner zulässig. Land und Liga wechseln unabhängig von der
Ligavorschau des normalen Kalenders und der Berichte. Zielstruktur sind
fünf deutsche Ligen mit je 18 Vereinen und die vier Auslandsländer Spanien,
Italien, Frankreich und England als Vorschau und Gegnerquelle. Vorhandene
Katalogligen und deren Vereinszahlen werden gelesen; eine ausländische
Auswahl eröffnet keine andere Karriere. Die Vorschautermine unterstützen
insbesondere 18 Vereine mit 34 und 20 Vereine mit 38 Spieltagen.
Die Dialogfolge der HTML-Referenz bleibt erhalten:
1. Gegner wählen oder „Termin auswählen“ öffnen: Dialog „Austragungsort“.
2. „Heim“ oder „Auswärts“ übernehmen: Dialog „Freundschaftsspiel · Kosten“.
3. „Termin wählen“ bestätigen: Kalenderphase mit zwölf Monaten von Juli
bis Juni, vier Spalten und drei Reihen.
4. Freien Tag auswählen und „Termin vormerken“ betätigen: lokale
Vormerkung mit Bestätigung. Nach dem Schließen führt der Fokus zur
Schaltfläche „Vorgemerkte Spiele“.
Gegner und Austragungsort werden bereits bei ihrer Auswahl gespeichert.
Abbrechen oder Escape im Dialog erhält diese Auswahl, erzeugt aber kein
Spiel. Escape in der Kalenderphase führt zur Gegnerphase zurück. Tab
bleibt innerhalb eines offenen Dialogs; nach dessen Schließen wird der
aufrufende Knopf wieder fokussiert. Die Vormerkungsliste ist nach Datum
sortiert und zeigt Datum, Gegner und Heim/Auswärts.
Der Kostenbeitrag ist eine reine Demoanzeige:
`(Heim ? 25000 : 12000) + ursprünglicher Gegnerindex × 500`.
Der Index stammt aus der vollständigen Katalogreihenfolge der gewählten
Gegnerliga, bevor der eigene Verein aus der sichtbaren Liste entfernt wird.
Keine Bestätigung zieht diesen Betrag vom Guthaben ab.
## Termine, Zustand und Speicherung
[demo_calendar.hpp](../../../../src/modern/ui/demo_calendar.hpp) und
[demo_calendar.cpp](../../../../src/modern/ui/demo_calendar.cpp) stellen den
Präsentationsvertrag bereit. `DemoSource` hält unter `calendar` den
Saisonbeginn `start`, den gemeinsamen Tagesindex `selected`, die mit
`reports.league` synchronisierte Vorschau `league` sowie die getrennte
Gegnerauswahl `friendly_league`, `opponent`, `home` und
`friendly_stage` (`0` Gegnerphase, `1` Kalenderphase). Die Vormerkungen
liegen in `friendlies` als `{day, opponent, league, home}`. Vereins- und
Ligaangaben sind stabile Katalog-IDs. Leere oder einzelne Vereinsbestände
dürfen `opponent: ""` zeigen; ohne gültigen Gegner bleibt Vormerken gesperrt.
Die `calendar`-Aktionen `friendly-country`, `friendly-league`,
`friendly-opponent`, `friendly-venue`, `friendly-stage` und `friendly-book`
ändern ausschließlich diesen Demozustand. `select` wählt weiter den
geteilten Kalendertag. Der Provider prüft den vorhandenen und den geplanten
Zustand, bevor er eine Änderung übernimmt. Ungültige Typen, unbekannte IDs,
der eigene Verein als Gegner und zusätzliche Aktionsfelder werden
abgewiesen. `DemoSource` weist zusätzlich veraltete Revisionen zurück.
Freie Termine beginnen am Saisonindex 7, also am 8. Juli, und müssen vor
dem nächsten 1. Juli liegen. Ligaspiele einschließlich ihrer
[Verlegungen](../postpone/README.md) und vorhandene Freundschaftsspiele
belegen den Kalender der eigenen Karriere. Eine fremde Vorschau in
`calendar.league` verändert diese Prüfung nicht. Derselbe Tag kann nicht
zweimal reserviert werden; maximal 20 Vormerkungen sind erlaubt. Frühe und
belegte Tage sind in der Kalenderphase gesperrt; nach 20 Einträgen sind
„Termin auswählen“ und „Termin vormerken“ gesperrt. Im normalen Kalender
erscheinen eigene Vormerkungen nur bei Vorschau der eigenen Liga.
Speichern und Laden erhält Auswahl, Kalenderphase und Vormerkungen.
`migrate_demo_calendar()` ergänzt fehlende Planungsfelder älterer
Checkpoints und validiert das vollständige Ergebnis atomar. Vorhandene
ungültige Werte, beschädigte Einträge und Terminüberschneidungen werden
abgewiesen und nicht repariert. Ein Wechsel des ersten verwalteten Vereins
setzt dessen Kalenderplanung zurück; Änderungen weiterer Manager bei
unverändertem erstem Verein erhalten sie.
## Referenzmaße und bewusste Abweichungen
Die Referenzvermessung verwendet eine logische Inhaltsfläche von
2612 × 1864. Die Gegnerliste beginnt bei `(0,148)` und ist 2612 × 1584
groß; ihre Spalten sind 58/14/14/14 Prozent breit. Der Kopf ist 66 Einheiten
hoch bei Schriftgröße 27, Datenzeilen 78 bei Schriftgröße 35. Der untere
Bereich beginnt bei y1770 und ist 94 Einheiten hoch. Die Kalenderphase
verwendet `(0,148,2612,1424)` mit Monatsabständen von 22; darunter liegen
Terminübersicht und drei Aktionsknöpfe. Die mittigen Dialoge sind 1840
Einheiten breit, die Ort-Auswahl 496, der Kostendialog 720,5 Einheiten hoch.
Diese Maße beschreiben den HTML-Maßstab; ihre native Übereinstimmung gehört
zur gesonderten Laufzeitprüfung.
**OpenBMH deviates from the original:** Die Saison folgt dem gespeicherten
Demodatum einschließlich tatsächlicher Schaltjahre statt dem festen
HTML-Jahr 2027/28. IDs ersetzen veränderliche Vereins- und Ligaindizes.
Vereine, Wappen und Kader stammen aus dem geladenen OBW; die Stärke wird
mit der bestehenden Berichtsprojektion aus vorhandenen Kaderattributen
bestimmt. Fehlende Stärken bleiben „—“. Die HTML-Formel `79 − i % 9` wird
nicht als tatsächliche Vereinsstärke ausgegeben. Platz `i + 1` und Spiele
`26` bleiben ausdrücklich Demoangaben.
Nach dem Kostendialog erhält ein bereits gültiger gewählter Tag den Fokus;
sonst wird chronologisch der erste freie Tag ab Index 7 fokussiert. Die
HTML-Referenz greift stattdessen auf den ersten freien Knopf ihrer nach
Wochentagen angeordneten DOM-Reihenfolge zurück, im Referenzdefault auf
den 12. Juli. Der native Fokus verändert den gespeicherten gewählten Tag
nicht eigenmächtig.
## Prüfstand und Enginegrenze
`tests/modern_planning_tests.cpp` und die Planungsfälle in
`tests/modern_ui_core_tests.cpp` sind grün. Die synthetischen Tests prüfen
unter anderem stabile IDs, Gebührenindex, 18-/20-Vereinsvorlagen,
Schaltjahresgrenzen, freie/belegte Termine, das 20er-Limit, fehlerhafte
Eingaben einschließlich Ganzzahlüberlauf, atomare Ablehnung, Migration und
Speicher-Roundtrip. Die Sourceintegration prüft auch Planung bei fremder
Ligavorschau, unveränderte Finanzen und Manager sowie die vollständige
Ablehnung kollidierender Checkpoints.
Der gemeinsame Paketbuild und alle 18 ausgewählten Regressionstests bestehen.
Die unabhängige native Prüfung umfasst 18 Matrixläufe in drei Themes bei
720p/1080p, 43 Bedienzustände und gezielte Nachprüfungen der visuellen
Sperrkennzeichnung. Die beschriebenen P1-/P2-Befunde sind behoben. Bilder,
Skripte und ladbare UI-Demostände liegen privat unter
`bmh_4k_ui/docs/qa/planning-batch-2026-10-24/`. Diese Nachweise betreffen
Linux/OpenGL und die dokumentierten Fälle, keine vollständige
Windows-/macOS-Laufzeitabnahme oder allgemeine Freigabe der Modern UI.
Es entstehen ausschließlich lokale UI-Vormerkungen. Der Provider
konstruiert keine Engine oder Session, verbraucht keinen RNG und ändert
weder OBW-Welt noch Geld, Ergebnisse oder echte Spielpläne. Der spätere
Sessionadapter muss verbindliche Terminregeln, Gegnerzusagen, Kosten und
Matchanlage gesondert liefern; die Demo bestätigt diese Regeln nicht.
Der Austragungsort heißt nativ „Heimspiel“ statt des im Gold fest gebundenen
„Heimspiel in Frankfurt“. Die Demo erfindet keinen Ortsdatensatz für andere
verwaltete Vereine. Beim Wechsel über OS-Beenden → Speichern wird eine offene
Planungsauflage verworfen; der Speicherbildschirm bleibt per Tab bedienbar.
## Nationalkontext
Im Nationalkontext ersetzt die [eigene Nationalansicht](../national/README.md)
diese Vereinsprojektion. Sie liest die aktive Manageridentität, zeigt keine
erfundenen Vereinsleistungen oder Nationalstatistiken und hält eventuelle
Dummy-Vormerkungen vollständig vom Vereinskalender und Geld getrennt.