Port environment, advertising and Toto menus to native Modern UI (by Codex)

This commit is contained in:
Codex committed 2026-10-24 11:12:25 +02:00
1 parent 0aa0ed68ca
commit d92cfc3110
36 files changed
+1805 -13

No files matched your search

+2 -2
View File
@@ -1,8 +1,8 @@
# Abfragen für die neue Oberfläche (M6)
Michaels Entscheidung: Die neue Oberfläche wird **je Menü** an die Modern-Engine angebunden. Jedes Menü bekommt feste Abfragen (und später Aktionen), die die Engine baut und hier dokumentiert; Codex stellt Menü für Menü vom Demo auf die Abfrage um. Die Demo bleibt nutzbar.
Vereinbarter Ablauf: Die neue Oberfläche wird **je Menü** an die Modern-Engine angebunden. Jedes Menü bekommt feste Abfragen (und später Aktionen), die die Engine baut und hier dokumentiert; Codex stellt Menü für Menü vom Demo auf die Abfrage um. Die Demo bleibt nutzbar.
**Reihenfolge (Michael):** Zuerst wird die GUI mit Demodaten fertig gebaut. Danach legt Codex je Menü fest, welche Daten es braucht, und die Engine liefert die passende Abfrage. Später soll alles auf ein durchgehendes JSON-Format umgestellt werden; die Antworten verwenden deshalb schon jetzt überall dieselben Teilobjekte, damit sie sich zu einem gemeinsamen JSON-Zustand zusammensetzen lassen.
**Reihenfolge:** Zuerst wird die GUI mit Demodaten fertig gebaut. Danach legt Codex je Menü fest, welche Daten es braucht, und die Engine liefert die passende Abfrage. Später soll alles auf ein durchgehendes JSON-Format umgestellt werden; die Antworten verwenden deshalb schon jetzt überall dieselben Teilobjekte, damit sie sich zu einem gemeinsamen JSON-Zustand zusammensetzen lassen.
## Vertrag
+7
View File
@@ -69,6 +69,13 @@ wird ausdrücklich mit `OPENBMH_BUILD_MODERN_UI=ON` gebaut.
Die gemeinsame Zahleneingabe bietet sechs Vorschlagswerte, Tastaturbedienung,
lokale Entwürfe und eine zweite Bestätigung vor Geldänderungen.
- [Umfeld](desktop/environment/README.md): sechs Förderbereiche mit jeweils
0–6 Sternen, Monatskostenvorschau, Jugendständen und eigenem Vereinswappen.
- [Werbung](desktop/advertising/README.md): 14 Banden, Trikot- und TV-Verträge,
je drei Angebotsvarianten, drei Budgets und Vorschau der Gesamtsummen.
- [TOTO](desktop/toto/README.md): roter Elferwette-Schein mit sechs unabhängigen
Spalten, Gesamteinsatz, Tippvorschlag, Vormerkung und letztem Schein.
**Anstoß führt keine Aktion aus**, weder per Maus noch per Tastatur. Das gilt
auch für die direkte Aktionsschnittstelle des Demoanbieters.
+3
View File
@@ -20,6 +20,9 @@ Implementierung in der Spiel-Engine.
| Taktik | [Interaktive Diagramme und Einsatzregler](desktop/tactics/README.md) |
| Kalender | [Zwölf Monate, transponierte Wochen und Ligavorschau](desktop/calendar/README.md) |
| Zahleneingabe | [Entwurf, Vorschläge und Bestätigung](desktop/number-entry/README.md) |
| Umfeld | [Förderstufen, Betreuung und Jugend](desktop/environment/README.md) |
| Werbung | [Banden, Trikot, TV und Budgets](desktop/advertising/README.md) |
| TOTO | [Sechs Tipp-Spalten und Vormerkung](desktop/toto/README.md) |
| Bank | [Sparbuch, Immobilien, Aktien und Kredit](desktop/bank/README.md) |
| Bilanz | [Aktuelle Bilanz und Zukunftsplanung](desktop/balance/README.md) |
| Verträge | [Kaderdaten, Angebote, Versicherung und Prämien](desktop/contracts/README.md) |
+142
View File
@@ -0,0 +1,142 @@
# Werbung und Vereinsausgaben · native Modern UI
Stand: 24. Oktober 2026. Die native Ansicht übernimmt das private
HTML-Mockup `bmh_4k_ui`, Referenzrevision
`9db6926d7f3d89a7c4219ae38f274766f060783a`. Maßgeblich sind
`desktop/finance-menus.js`, `finance-menus.css`,
`advertising-friendlies-window.css` und `menu-themes.css`.
Native Quellen:
[advertising_screens.inc](../../../../src/modern/ui/advertising_screens.inc),
[advertising_controls.inc](../../../../src/modern/ui/advertising_controls.inc),
[advertising.rcss](../../../../assets/modern/advertising.rcss) und
[demo_advertising.hpp](../../../../src/modern/ui/demo_advertising.hpp).
Private Referenzbilder und Weltdaten werden nicht öffentlich mitgeliefert.
## Aufbau und Bedienung
Oben stehen vierzehn Werbebanden in zwei Reihen mit sieben Spalten. Jede
Bande zeigt „Platz frei“ oder ihren vereinbarten Sponsor sowie ihre
Bandennummer. Darunter folgen die vier Bildkarten Trikotwerbung,
Fanartikel, Öffentlichkeitsarbeit und Fanbetreuung. TV-Rechte liegen
links unten, der Angebots- und Summenbereich rechts daneben. Banden,
Trikot und TV sind als Vertragsplätze auswählbar; die drei übrigen
Bildkarten öffnen die jeweilige Budgeteingabe.
Die Auswahl eines freien Platzes zeigt ein fiktives Angebot mit Sponsor,
Dauer und Monatsbetrag. Zwei Pfeile blättern zyklisch durch drei Angebote
mit zwölf, vierundzwanzig und sechsunddreißig Monaten Laufzeit. Erst
„Annehmen“ speichert die Vereinbarung. Bei einem belegten Platz erscheinen
der laufende Sponsor und Vertrag; Pfeile und Annahme sind gesperrt.
„Schließen“ beziehungsweise „Abbrechen“ hebt nur die lokale Auswahl auf,
eine bestehende Vereinbarung bleibt erhalten.
Escape und Rechtsklick heben zunächst eine offene Vertragsauswahl auf.
Im Budgeteditor schließt Escape zuerst die Zahleneingabe. Die
Schließen-Schaltfläche des Fensters beendet wie in der HTML-Vorlage das
Menü. Die Bedienelemente behalten eindeutige IDs und zugängliche Namen;
Beschriftungen verwenden begrenzte Textbreiten.
Die drei Ausgabenfelder erlauben ganze angezeigte Währungseinheiten von
0 bis 99.999.999. Vorschläge steigen bei Fanartikeln um 50.000 und bei
Öffentlichkeitsarbeit beziehungsweise Fanbetreuung um 5.000. Dies sind
Vorschlagsabstände, keine Beschränkung auf solche Vielfachen. Die
Zahleneingabe enthält acht Rohziffern, MAX und C; sie ist kein
arithmetischer Taschenrechner. „Übernehmen“ führt zur zweiten
Bestätigung. Ändern oder Abbrechen verändert keinen gespeicherten Wert.
Einnahmen sind die Summe der sechzehn Vertragsbeträge, Ausgaben die Summe
der drei Budgets, Saldo deren Differenz. Es handelt sich um fiktive
Monatswerte. Annahme und Budgetänderung buchen keine Ein- oder Auszahlungen
auf das gemeinsame Konto.
## Datenvertrag und Revisionsschutz
Der Provider arbeitet auf dem vollständigen Präsentationszustand und
besitzt ausschließlich dessen oberstes Feld `advertising`:
```text
advertising:
spending: [Fanartikel, Öffentlichkeitsarbeit, Fanbetreuung]
contracts: 16 × {sponsor, months, amount}
```
Alle gespeicherten Geldwerte sind Minor Units von `manifest.currency`.
Bei null Nachkommastellen entspricht eine gespeicherte Einheit einer
angezeigten Einheit, bei zwei Nachkommastellen sind es hundert. Der
Budgeteditor übergibt ganze Anzeigeeinheiten; der Provider multipliziert
sie genau einmal mit diesem Faktor. Vorhandene gültige Centwerte werden
beim Laden nicht still gerundet.
Die Plätze 0 bis 13 bezeichnen Banden, 14 Trikotwerbung und 15 TV-Rechte.
Ein freier Vertrag hat `sponsor: -1`, `months: 0`, `amount: 0`. Aktive
Verträge haben einen bekannten Anbieterindex, 12/24/36 Monate und einen
positiven Betrag innerhalb des Geldlimits. Für Banden und Trikot gibt es
zehn fiktive Sponsoren, für TV fünf Sender. Die Auswahlformel folgt der
HTML-Referenz; sie verwendet weder Zufall noch aktuelle Engineangebote.
`migrate_demo_advertising()` ergänzt bei älteren UI-Demoständen das
vollständig fehlende Werbefeld mit freien Plätzen und den Startbudgets
50.000 / 15.000 / 10.000. Ein vorhandenes Werbefeld wird streng validiert:
fehlerhafte Typen, unbekannte Felder, unzulässige Indizes und beschädigte
Verträge führen zur atomaren Ablehnung. Es werden keine teilweise
beschädigten Bestände repariert.
`edit_demo_advertising()` unterstützt zwei Änderungen:
- `{kind: "accept", slot, offer}` berechnet das gewählte Angebot erneut
und übernimmt es nur in einen weiterhin freien Platz.
- `{kind: "spending", index, value}` bestätigt genau eines der drei
Budgets in ganzen Anzeigeeinheiten.
Beide Aktionen validieren den gesamten Werbezustand und publizieren erst
dann die vollständige Kopie. `demo_advertising_quote()` und
`demo_advertising_view()` liefern ausschließlich Leseprojektionen.
**OpenBMH deviates from the original:** Auswahl und Angebotsnummer bleiben
flüchtige App-Felder und ersetzen die gespeicherten Navigationsfelder
des HTML-Prototyps.
Eine sichtbare Quote und jeder Budgetentwurf sind an Welt und beobachtete
Source-Revision gebunden. Veraltete Bestätigungen werden nicht auf einen
inzwischen veränderten Stand angewandt.
## Referenzgeometrie und Ressourcen
Die logische Inhaltsfläche beträgt 2612 × 1864. Der Bandenbereich ist
310 hoch, mit 16 Einheiten Abstand zwischen den Knöpfen. Die vier
636,5 × 650 großen Bildkarten beginnen bei y346 und haben 22 Einheiten
Abstand. TV liegt bei `(0,1032,596,638)`, der Detailbereich bei
`(636,1032,1976,828)`. Im Angebot sind Sponsorbild, Pfeile und Fakten in
430 / 84 / verbleibende Breite aufgeteilt. Drei Summenspalten stehen am
unteren Rand. Midnight, Silver und Matchday verwenden dieselbe Anordnung.
Die GUI-Schlüssel `advertising.panel.0` bis `.3` referenzieren die vier
unveränderten Quadranten des vorhandenen Bilderatlas. TV verwendet
`art.advertising-tv-v1.png`. Diese festen GUI-Bilder gehören zum
GUI-Ressourcenpaket, nicht in die OBW-Welt oder deren Assetindex. Es werden
keine neuen Originalbilder in öffentliche Tests oder Dokumente kopiert.
## Prüfstand und Enginegrenze
Die synthetischen Komponententests in
[modern_advertising_ui_tests.cpp](../../../../tests/modern_advertising_ui_tests.cpp)
prüfen beide Währungspräzisionen, die drei Angebotsarten, aktive
Vertragssperren, alle sechzehn Plätze, Betragsgrenzen und große Summen,
Nullwerte, ungültige Eingaben, atomare Migration sowie unveränderte
Konten und Katalogdaten.
Die native Linuxprüfung ist mit Midnight, Silver und Matchday jeweils bei
1920 × 1080 und 1280 × 720 erfolgreich ausgeführt. Defaultansicht,
Angebot und aktiver Vertrag wurden gegen die HTML-Vorlage geprüft;
Bildpositionen, Bandenbeschriftungen und Hinweiszeilen sind abgeglichen.
Der Interaktionslauf prüft Null und MAX, Entwurf/Review/Ändern/Abbruch,
Trikot und TV, aktuelle Angebotsbindung nach einer Budgetänderung sowie
unveränderte Konten. Escape, Rechtsklick und Fensterschließen sind mit
unveränderten Modell- und Revisionswerten geprüft. Ein durch den nativen
`checkpoint`-Befehl geschriebener UI-Demostand wurde in einer zweiten
Appinstanz mit exakt gleichem Modell wieder geladen; die lokale Auswahl
startet dort bei `-1`. Dies dokumentiert Linux-Ergebnisse und keine
Laufzeitprüfung anderer Plattformen.
Es gibt keine Anbindung an Engine, Classic-Initialisierung, Session,
Spielzeit oder Zufallsströme. Vereinbarungen laufen in dieser Demo nicht
monatlich ab und erzeugen keine echten Buchungen. Ein späterer
Sessionadapter muss verbindliche Werbeverträge und Ausgabenregeln liefern.
+38
View File
@@ -0,0 +1,38 @@
# Umfeld
Stand: 24. Oktober 2026. Die native Ansicht übernimmt die Diamond-3.6-
Anordnung des privaten HTML-Golds `bmh_4k_ui`, Revision `9db6926d`:
`desktop/submenus.js`, `submenus.css` und `table-window.css`. Sechs Karten
stehen um Ball und Vereinswappen: drei Nachwuchsstufen, Co-Trainer,
Vereinsarzt und Masseur. Alle drei Glas-Themen behalten diese Anordnung.
Jede Karte bietet eine Nulltaste und **sechs** Sterne. Ein Klick wählt den
Budgetwert unmittelbar; erneut gewählte Werte bleiben bestehen. Gold sieht
hier keinen Ausgabenentwurf oder Bestätigungsdialog vor. Der neue
Präsentationszustand `environment.levels` enthält sechs Ganzzahlen von
0 bis 6; seine Startwerte sind `2,3,4,3,4,2`. Die OBW-Tabelle `staff` bleibt
schreibgeschützt und wird nicht als zweite Budgetquelle verwendet.
Die fiktiven Monatsgrundpreise betragen 2.000/3.000/5.000 für Nachwuchs und
7.500/6.000/4.500 für Personal. Der Kartenbetrag ist Grundpreis mal Sternzahl,
in der internen kleinsten Währungseinheit. Null Sterne ergeben echte
Vorschaukosten von null; sechs Sterne bleiben vollständig verfügbar.
Die Jugendplätze 11./1. Liga, 3./2. Liga und 7./1. Liga sind feste
Demobeispiele. Sie entstehen weder aus Spielen noch aus den Sternen.
Die Auswahl bucht kein Guthaben ab, ändert keine Mitarbeiterverträge und
simuliert weder Nachwuchs noch Training, Zeit oder Zufall. Classic und
Engine bleiben unverändert. Der geladene erste Manager liefert lediglich
das tatsächliche Vereinswappen; es werden keine Mitarbeiternamen erfunden.
Die Bilder gehören zum separaten GUI-Ressourcensatz, nicht zur OBW-Welt;
Sterne sind native SVG-Formen und benötigen kein besonderes Schriftglyph.
Migration ergänzt nur einen fehlenden Umfeldzustand. Vorhandene ungültige
Werte werden atomar abgewiesen. Synthetische Prüfungen stehen in
`tests/modern_environment_ui_tests.cpp`. Gemeinsamer Build und alle 24
Regressionstests sind erfolgreich. Die native Abnahme umfasst alle drei
Themen bei 1280×720 und 1920×1080: sechs Karten und 42 Bedientasten, Budgets
0/6 samt Kosten, Tastatur/Fokus, vollständige Grafiken, Wappen und einen
echten Prozessneustart aus gespeichertem UI-Checkpoint. Die übrigen
Zustandsfelder einschließlich Guthaben bleiben dabei unverändert. Es
besteht kein offener P1/P2-Befund für diese Ansicht.
+53
View File
@@ -0,0 +1,53 @@
# TOTO · Elferwette
Stand: 24. Oktober 2026. Native RmlUI-Übertragung der HTML-Vorlage
`desktop/toto-menu.js` und `toto-window.css`, Referenzrevision `9db6926d`
im privaten Mockup-Repository. Roter Druck, warmer Papiergrund und blaue
Kreuze bleiben in allen drei Themes erhalten. Grafiken und Bedienung
werden nicht durch einen alternativen Wettbildschirm ersetzt.
## Sichtbare Daten
Links steht ein festes Vorschauprogramm aus neun Partien der ersten und
zwei Partien der zweiten deutschen Liga. Vereinsnamen und Wappen stammen
aus dem schreibgeschützten OBW-Katalog. Paarungen kommen aus derselben
synthetischen Spielplanprojektion wie die Berichte; aktuelle Berichtfilter
ändern das TOTO-Programm nicht. Die Vorschau verwendet Runde 27 und das
Startjahr der geladenen Welt. Fehlende Vereine werden nicht erfunden;
bei unvollständigem Programm bleibt die Vormerkung gesperrt.
Rechts enthält der Schein sechs unabhängige Spalten mit je elf Reihen.
Jede Reihe erlaubt genau eine Auswahl aus 1/0/2; erneutes Anklicken entfernt
das Kreuz. Die erste Spalte ist vorbelegt, weitere Spalten sind leer.
Der Tippvorschlag und das Leeren wirken nur auf die ausgewählte Spalte.
Der Gesamteinsatz wird über die gemeinsame Zahleneingabe bearbeitet:
0–99.999.999 ganze Anzeigeeinheiten, Vorschläge 1.000–6.000 und gesonderte
Betragsbestätigung. Eine Vormerkung braucht einen positiven Einsatz,
mindestens eine vollständige Spalte und keine teilweise ausgefüllte Spalte.
„Letzter Schein“ liest eine unabhängige Kopie der zuletzt übernommenen
Spalten und des Einsatzes. Spätere Eingaben ändern diese Kopie nicht.
## Bedienung und Zustand
Tab führt zu den Spaltenköpfen, jeweils einer Tippzelle pro Spalte sowie
den normalen Fenster-/Aktionsbuttons. Pfeile navigieren über alle 18 Zellen
je Spiel beziehungsweise elf Reihen. Home/End springen zur ersten/letzten
Zelle, mit Ctrl zusätzlich zur ersten/letzten Reihe. Fokussieren verändert
weder Tipps noch ausgewählte Spalte. Escape schließt zunächst den Dialog
und stellt den vorherigen Fokus wieder her.
`DemoSource.state.toto` enthält die sechs Spalten, den Einsatz in kleinster
Währungseinheit und den letzten Schein. Lokale Dialog-/Fokusflags sind kein
Spielstand. Aktionen sind revisionsgebunden; abgewiesene Eingaben und
fehlerhafte alte Checkpoints lassen den Zustand unverändert. Nur fehlende
TOTO-Felder werden beim Laden ergänzt. Screenshots werden zusammen mit
UI-Checkpoints und JSONL-Bedienschritten gesichert.
Es gibt keine Auszahlung, Auswertung oder Geldbuchung. Die Vorschau ruft
keine Match-, Saison- oder Zufallsfunktion auf. Ein späterer Engineadapter
muss Spielprogramm, Annahmeschluss und tatsächliche Buchungsregeln liefern.
Classic und OBW-Format bleiben davon unberührt. Die synthetischen Tests
prüfen unabhängige Spalten, leere/teilweise Scheine, tiefe Ergebniskopien,
Geldpräzision, Revisionsschutz und Wiederherstellung. Renderer-/HTML-Vergleich:
[gemeinsame Menü-QA](../../menu-qa.md).
+16 -1
View File
@@ -87,7 +87,22 @@ deshalb nicht ins öffentliche Quellcode-Repository. Öffentliche Zusammenfassun
Die 20 ausgewählten Regressionstests bestehen nach Übernahme der parallel
eingetroffenen Engineänderungen. Screenshots, UI-Demostände und Eingabeskripte
liegen privat unter `docs/qa/finance-batch-2026-10-24/`.
Aktueller Katalog: **22 native und 15 noch offene Routen**.
Nach diesem Paket: **22 native und 15 noch offene Routen**.
Die Finanzprüfung umfasst echte Linux-/OpenGL-Aufnahmen. Windows-/macOS-
Laufzeitdarstellung wird dadurch nicht als abgenommen ausgegeben.
- [Umfeld](desktop/environment/README.md), [Werbung](desktop/advertising/README.md)
und [TOTO](desktop/toto/README.md): weiteres gemeinsames Paket mit drei
Themes bei 720p/1080p. Direkte Förderstufen, Angebotsannahme, Geldentwürfe,
TOTO-Spalten und letzter Schein wurden durch die native Ereignisverarbeitung
geprüft. TOTO: 138 erfolgreiche Zustandsprüfungen, 18 vermessene
Layoutzustände und gezielte Schlussaufnahmen der korrigierten Elemente.
Echte Checkpoints und Neustarts ergänzen die Browser-/Rendererprüfung.
Die 24 Regressionstests bestehen. Private Nachweise:
`docs/qa/club-batch-2026-10-24/`.
Aktueller Katalog: **25 native und 12 noch offene Routen**.
CSS-Hintergrundbilder werden in der HTML-QA zusätzlich vollständig dekodiert,
bevor Screenshots entstehen. Das verhindert falsche Meldungen über fehlende
oder abgeschnittene Atlaskacheln im Umfeld beziehungsweise in Werbung.
+7 -1
View File
@@ -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 22 native Routen und 15 offene Ports.
der aktuelle Runner erfasst 25 native Routen und 12 offene Ports.
Spätere Meilensteine erfassen denselben Gesamtkatalog erneut.
Siehe [QA-Ablauf](menu-qa.md), [Typografie](typography-qa.md) und
@@ -45,3 +45,9 @@ Das immobilienspezifische HTML-Seitenverhältnis war verzerrt und wurde auf
die ursprüngliche 2×3-Atlaskachel korrigiert. Native Bilder bleiben proportional;
der HTML-Randbeschnitt von 1 % ist als kleine verbleibende Bildabweichung
im privaten Nachweis dokumentiert.
Das Paket Umfeld/Werbung/TOTO wurde mit 24 Regressionstests sowie den drei
Themes bei 720p/1080p geprüft. Korrigiert sind die Bandennummernausrichtung,
der Abstand der Werbehinweise, die TOTO-Saisonzeile und die Bildbox der
Kreuze. Die Referenzaufnahme wartet jetzt auch auf vollständig dekodierte
CSS-Hintergrundbilder; frühe Teilbilder gelten nicht als Produktabweichung.