diff --git a/docs/new_ui/AGENTS.md b/docs/new_ui/AGENTS.md new file mode 100644 index 0000000..6401848 --- /dev/null +++ b/docs/new_ui/AGENTS.md @@ -0,0 +1,8 @@ +# Modern UI documentation + +- Maintain Modern UI design and migration notes under `docs/new_ui` on branch `0.3`. +- Put desktop menus in `desktop//`; training camps use `desktop/trainingcamp/`. +- Record the source revision, visible data, interactions and outstanding engine decisions. +- Clearly distinguish the HTML prototype, a native RmlUI implementation and engine behaviour. +- Update the relevant document with each substantive UI change and link it from the index. +- Use German for these user-facing design notes. Keep proprietary reference assets out of this repository. diff --git a/docs/new_ui/README.md b/docs/new_ui/README.md new file mode 100644 index 0000000..519198d --- /dev/null +++ b/docs/new_ui/README.md @@ -0,0 +1,15 @@ +# Modern UI · Dokumentation für 0.3 + +Hier pflegen wir den Stand der Modern UI sowie die Grundlage für ihre Übernahme +nach RmlUI. Desktop-Menüs erhalten jeweils ein eigenes Unterverzeichnis. +Die HTML-Vorschau ist ein POC; eine Beschreibung hier bestätigt noch keine +Implementierung in der Spiel-Engine. + +| Bereich | Dokument | +|---|---| +| Desktop | [Statusleiste, Gestaltung und Fenster](desktop/README.md) | +| Trainingslager | [Alle 18 Angebote, Qualitätswerte und Bedienung](desktop/trainingcamp/README.md) | + +Jeder Bereich nennt die geprüfte Quelle, bestehende Funktionen und offene +Entscheidungen für die Engine-Anbindung. Die Architekturgrundlage bleibt der +[Engine-Split](../ENGINE_SPLIT.md). diff --git a/docs/new_ui/desktop/README.md b/docs/new_ui/desktop/README.md new file mode 100644 index 0000000..c6c1418 --- /dev/null +++ b/docs/new_ui/desktop/README.md @@ -0,0 +1,78 @@ +# Desktop · Modern UI + +Stand: 23. Oktober 2026. Diese Beschreibung bezieht sich auf den bestehenden +HTML-POC. Die native RmlUI-Umsetzung und die Anbindung an die Modern-Engine +werden für 0.3 separat entwickelt. + +## Informationsleiste + +Ganz links stehen **Vereinswappen, Vereinsname und Managername** als gemeinsame +Identität. Rechts davon folgen Spieltag bzw. Saisonvorbereitung, Saison und +Guthaben. Die OpenBMH-Wortmarke entfällt auf dem Desktop; das Hauptmenü behält +seine eigene Gestaltung. Ein Klick auf die Vereinsidentität öffnet weiterhin +die Desktopoptionen. Rechtsklick auf die freie Fläche bleibt ebenfalls möglich. + +Die Leiste ist im logischen Referenzraum 148 Pixel hoch. Der aktuelle POC zeigt +Verein, Manager, Termin und Guthaben aus seinem fiktiven Spielzustand. + +## Gestaltung in den Einstellungen + +**Einstellungen → Anzeige → Gestaltung** enthält drei gleichwertige +Vorschaukarten. Jede zeigt die Kombination aus Desktop und Untermenüfenster. +Ein separater Theme-Button in der Informationsleiste entfällt. + +| Theme | Darstellung | +|---|---| +| Midnight Glass | Dunkles Glas, ruhige Blautöne, Mint | +| Silver Glass | Helle Glasflächen, dunkle Beschriftung, Silberblau | +| Matchday | Graphit, klare Flächen, dezente warme und rote Akzente | + +Die Auswahl ändert zunächst nur den Einstellungsentwurf und bleibt beim +Wechsel der Einstellungskategorie erhalten. Erst **Anwenden** übernimmt sie, +wechselt Desktop und Untermenüs gemeinsam und schließt die Einstellungen. +Abbrechen oder Escape verwirft die Auswahl. Der angewendete Look bleibt nach +dem Neuladen erhalten. Positionen, Widgetgrößen, Fixierungen und Spielwerte +werden durch einen Theme-Wechsel nicht verändert. + +Die Vorschaukarten gibt es auch in den Einstellungen des Hauptmenüs; dort +bleiben die Kategorien auf Anzeige und Sound begrenzt. Beim Wechsel zum +Desktop wird die dort gespeicherte Gestaltung verwendet. + +## Fenstermaße und Skalierung + +Der gemeinsame 4:3-Rahmen für Untermenüs nutzt im logischen Desktop von +3840 × 2160 Pixeln folgende Maße: + +| Eigenschaft | Bisher | Aktuell | +|---|---:|---:| +| Breite | 2560 px | 2720 px | +| Höhe | 1920 px | 2040 px | +| Abstand oben / unten | je 120 px | je 60 px | +| Abstand links / rechts | je 640 px | je 560 px | +| Seitenverhältnis | 4:3 | 4:3 | + +Die zusätzlichen Flächen stehen den Menüs zur Verfügung; Fenster und Inhalte +skalieren mit dem Desktop. Auf breiteren Bildschirmen bleibt das Verhältnis +erhalten. Die Fenster berühren den oberen oder unteren Bildschirmrand nicht. + +Der bisherige HD-Desktop unter `desktop/index.html` bleibt erhalten. +Der neue Desktop ist unter `desktop/modern.html` erreichbar. Die hier +beschriebenen Änderungen betreffen den HTML-POC. + +## Quellen und Prüfung + +Privates Repository `bmh_4k_ui`, Commit `19969d430e38eadae7ff7a9d1fb381ab02c395de`: + +- `desktop/modern.html`, `desktop/modern-desktop.css`, + `desktop/modern-desktop.js`: Informationsleiste und Desktop. +- `desktop/settings-menu.js`, `desktop/settings-window.css`: Entwurf, + Theme-Auswahl und Vorschaukarten. +- `desktop/table-window.css`: gemeinsamer 4:3-Fensterrahmen. +- `docs/qa/desktop-chrome-2026-10-23/README.md`: Vorher-/Nachher-Bilder, + passende POC-Zustände und 124 erfolgreiche Browserprüfungen. Geprüft wurden + unter anderem 33 Menürouten in drei Themes sowie die Darstellung bei + 1280 × 720, 1920 × 1080, 2560 × 1440 und 3440 × 1440. + +## Menükatalog + +[Trainingslager: alle 18 Ziele mit Qualitätswerten, Preisen und Bedienung](trainingcamp/README.md). diff --git a/docs/new_ui/desktop/trainingcamp/README.md b/docs/new_ui/desktop/trainingcamp/README.md new file mode 100644 index 0000000..89b3ad6 --- /dev/null +++ b/docs/new_ui/desktop/trainingcamp/README.md @@ -0,0 +1,98 @@ +# Trainingslager · Modern UI + +Stand: 23. Oktober 2026. Bestandsaufnahme des HTML-POC, noch keine native +RmlUI- oder Modern-Engine-Implementierung. + +Es gibt **18 Trainingslager**: sechs in Deutschland, neun im übrigen Europa +und drei im Nahen Osten. **Anbieternamen, Preise und Qualitätswerte sind fiktive +POC-Daten**. Die Orte sind reale geografische Bezugspunkte. Es handelt sich +nicht um recherchierte Angebote realer Hotels oder Trainingszentren. + +Die vier Qualitätswerte werden getrennt als Sterne angezeigt: +**Platzqualität, Fitnessgeräte, Verpflegung und Unterkunft**. Deutschland und +Europa verwenden eine Skala von 0 bis 5, der Nahe Osten von 0 bis 6 Sternen. +Die Tabelle gibt die tatsächlich hinterlegten Werte wieder; eine gemeinsame +Hotel-Sternebewertung gibt es nicht. + +## Deutschland · 6 Trainingslager + +| ID | Trainingslager | Ort / Land | Platz | Fitness | Verpflegung | Unterkunft | Preis | +|---:|---|---|---:|---:|---:|---:|---:| +| 3 | Wellness Resort Ulm | Ulm · Deutschland | 2 | 3 | 2 | 2 | 145.000 € | +| 5 | Ball-Arena Potsdam | Potsdam · Deutschland | 3 | 2 | 3 | 2 | 175.000 € | +| 8 | Sportpark Sauerland | Schmallenberg · Deutschland | 1 | 1 | 1 | 1 | 25.000 € | +| 9 | Trainingshof Harz | Goslar · Deutschland | 2 | 2 | 2 | 2 | 55.000 € | +| 10 | Alpencamp Allgäu | Kempten · Deutschland | 3 | 3 | 2 | 3 | 195.000 € | +| 11 | Leistungszentrum Schwarzwald | Freiburg · Deutschland | 5 | 5 | 4 | 5 | 490.000 € | + +## Europa · 9 Trainingslager + +| ID | Trainingslager | Ort / Land | Platz | Fitness | Verpflegung | Unterkunft | Preis | +|---:|---|---|---:|---:|---:|---:|---:| +| 0 | Kraftmühle Łódź | Łódź · Polen | 4 | 4 | 4 | 4 | 410.000 € | +| 1 | Vitalpark Vinadio | Vinadio · Italien | 4 | 4 | 4 | 3 | 450.000 € | +| 2 | Kraftwerk Stettin | Stettin · Polen | 4 | 4 | 3 | 4 | 420.000 € | +| 4 | Sportzentrum Groningen | Groningen · Niederlande | 4 | 4 | 4 | 4 | 485.000 € | +| 6 | Camp Royal Saint-Denis | Saint-Denis · Frankreich | 5 | 4 | 5 | 4 | 650.000 € | +| 7 | Elite-Fußballcamp Ancona | Ancona · Italien | 5 | 5 | 5 | 5 | 840.000 € | +| 12 | Algarve Performance Camp | Faro · Portugal | 5 | 4 | 5 | 5 | 920.000 € | +| 13 | Costa del Sol Sport Resort | Málaga · Spanien | 5 | 5 | 5 | 4 | 895.000 € | +| 17 | Riviera Trainingscamp Belek | Belek · Türkei | 5 | 5 | 5 | 4 | 790.000 € | + +## Naher Osten · 3 Trainingslager + +| ID | Trainingslager | Ort / Land | Platz | Fitness | Verpflegung | Unterkunft | Preis | +|---:|---|---|---:|---:|---:|---:|---:| +| 14 | Doha Elite Football Resort | Doha · Katar | 6 | 6 | 6 | 6 | 2.800.000 € | +| 15 | Abu Dhabi Royal Training | Abu Dhabi · VAE | 6 | 6 | 6 | 6 | 3.200.000 € | +| 16 | Dubai Platinum Sports Camp | Dubai · VAE | 6 | 6 | 6 | 6 | 3.600.000 € | + +## Bedienung im POC + +- Drei Regionsschalter: Deutschland, Europa, Naher Osten. Ein Wechsel wählt + das erste Lager der Region aus. +- Eine eigene Karte je Region; Länder mit Lagern sind heller. Es gibt keine + zusätzliche Ortsliste. Orts- und Landesname erscheinen in der Detailansicht. +- Ein Klick auf eine Kartenmarkierung übernimmt die Auswahl. Hover oder + Tastaturfokus zeigt vorübergehend ein anderes Lager; danach kehren die + Details zur gespeicherten Auswahl zurück. +- Die Detailansicht enthält ein eigenes Lagermotiv, Namen, Ort, vier + Qualitätswerte, Preis und Schwerpunktregler. Die Bilder füllen ihren + abgerundeten Rahmen proportional aus. +- Kondition, Technik und Spiel sind jeweils von 0 bis 15 einstellbar. + Erholung ist abgeleitet und nicht direkt bedienbar: + `15 − floor((Kondition + Technik + Spiel) / 3)`. +- „Vormerken“ speichert die Auswahl im POC und zeigt eine Bestätigung. + Es entstehen keine Abbuchung, Kalenderbuchung oder Trainingswirkung. + +Ausgangsauswahl: ID 4, Sportzentrum Groningen. Schwerpunkte: Kondition 5, +Technik 4, Spiel 6; daraus folgt Erholung 10. Anfangs ist kein Lager vorgemerkt. +Die IDs entsprechen der bestehenden Array-Reihenfolge und dürfen bei einer +Migration gespeicherter POC-Ansichten nicht versehentlich neu sortiert werden. + +## Grundlage für die Engine-Anbindung + +Die UI benötigt eine stabile Lager-ID, Region, geografische Position, Name, +Ort und Land, vier Qualitätswerte, Preis und Bildreferenz. Auswahl und +Vormerkung sind getrennte Zustände; die drei einstellbaren Schwerpunkte +werden separat gespeichert. + +Vor einer wirksamen Buchung sind Preisbasis, Dauer, verfügbare Termine, +Stornierung und Trainingswirkung festzulegen. Der POC spezifiziert diese +Spielregeln nicht. Insbesondere darf aus dem angezeigten Preis kein Preis +pro Spieler oder pro Woche abgeleitet werden. + +## Quellen und Nachführung + +Quelle: privates Repository `bmh_4k_ui`, Commit `19969d430e38eadae7ff7a9d1fb381ab02c395de`. + +- `desktop/camp-menu.js`: vollständiger Angebotskatalog, Qualitätsreihenfolge, + Preise, Bildauswahl, Karteninteraktion und Vormerken. +- `desktop/camp-map-data.js`: Regionsnamen und Kartenprojektion. +- `desktop/submenus.js`: Anfangszustand und Validierung der POC-Daten. +- `docs/qa/camp-training/README.md` und `docs/qa/ui-polish/README.md`: + ergänzende Bild- und Bedienungsnachweise im privaten POC-Repository. + +Die Auflistung wurde direkt mit allen 18 Einträgen des Quellkatalogs +abgeglichen. Bei Änderungen am Angebot ist dieses Dokument zusammen mit +der jeweiligen UI-Anpassung zu aktualisieren.