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

218 lines
16 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.
# Stadion · native Modern UI
<!-- provider:start -->
## Demo-Datenprovider und Bauvormerkungen
Stand: 26. Oktober 2026. Die Preis- und Bauvorlagen der Innenansicht stammen aus dem
privaten HTML-Stand `69eec91c`, `desktop/stadium-menus.js`. Der native
Provider in [demo_stadium.hpp](../../../../src/modern/ui/demo_stadium.hpp)
und [demo_stadium.cpp](../../../../src/modern/ui/demo_stadium.cpp) übernimmt
die acht Stadionblöcke, acht Ausstattungseinträge und vierzehn unabhängige
Umfeldstandorte. Die kalibrierte Umfeldgestaltung stammt aus dem privaten
Sprite-Studio-Commit `82914ae809b12f69c6abfaa7addfcecc7378dd81`.
`state.stadium` enthält genau `club`, `budget`, `blocks`, `facilities` und
`periphery`.
Ein Block besitzt `places`, `seats`, `roof` und `job`; eine Einrichtung
`level` und `job`; dies gilt auch für die vierzehn Umfeldstandorte.
Laufende Aufträge enthalten Zielwerte, Wochen und
Kosten. Eintritt bleibt ausschließlich im gemeinsamen obersten
Modellfeld `ticket`. Ansicht, Zukunftsschalter, Kurven, Filter und
Dialogentwürfe gehören zur lokalen App-Navigation.
Der fiktive Ausgangsbestand umfasst ein separates Baubudget von
50.000.000 angezeigten Währungseinheiten, die acht Blockkapazitäten
3.000/6.000/3.000/5.000/3.000/6.000/3.000/7.000 und die
Ausstattungsstufen 1/2/1/1/2/2/2/1. Gespeicherte Geldwerte und Quotes
sind Minor Units aus dem Währungsmanifest: Faktor 1 bei null und Faktor
100 bei zwei Nachkommastellen. Das echte Vereinsguthaben wird nicht als
Baubudget verwendet oder verändert.
Blöcke bleiben in Tausenderschritten zwischen dem Istbestand und ihrem
individuellen Maximum. Die acht Höchstkapazitäten betragen
8.000/18.000/8.000/14.000/8.000/18.000/8.000/14.000. Je zusätzliche
tausend Plätze gelten 300.000/375.000/300.000/350.000/300.000/375.000/
300.000/350.000 sowie 30/37/30/25/30/37/30/25 angezeigte Bauwochen.
Sitzplätze kosten zusätzlich 45 Prozent, Überdachung 30 Prozent der
jeweiligen Blockrate. Ein neues Merkmal wird für sämtliche Zielplätze
berechnet; ein vorhandenes Merkmal nur für zusätzliche Plätze. Bereits
vorhandene Sitze oder Dächer können nicht entfernt werden. Ein reiner
Merkmalsausbau ohne Platzplus ist zulässig; ein unveränderter oder
kostenloser Entwurf bleibt gesperrt.
Flutlicht, Anzeigetafel, Rasenheizung, V.I.P.-Lounge, Rasenzustand,
Stadionkomfort, Stadionzustand und Stadionsicherheit verwenden ihre
jeweiligen festen HTML-Raten und Wochen. Heizung und V.I.P.-Lounge sind
auf Stufe 2, die übrigen Einrichtungen auf Stufe 4 begrenzt. Mehrere
Stufen können in einem Auftrag übersprungen werden; Kosten zählen die
Stufendifferenz, Wochen bleiben die feste Vorlage des Eintrags.
Der einzige Providerbefehl lautet `{kind:"build",request:...}`. Der
Blockrequest enthält genau `kind`, `index`, `places`, `seats`, `roof`,
der Ausstattungs- beziehungsweise Peripherierequest `kind`, `index`, `level`. Beim Commit wird die
Quote erneut aus dem aktuellen Bestand berechnet. Ungültige Stufen,
Abbau, laufende Aufträge, No-op, Doppelbuchung oder unzureichendes
Baubudget werden atomar abgewiesen. Zusätzliche fremde Aktions- oder
Zustandsfelder werden nicht still übernommen. Restbudget plus Summe
sämtlicher korrekt bepreister laufender Aufträge bleibt stets exakt
50.000.000 angezeigte Einheiten.
`migrate_demo_stadium()` ergänzt ein vollständig fehlendes Stadionobjekt
oder erweitert einen gültigen alten Vierfelderbestand um die Peripherie.
Ein bestehender fehlerhafter Bestand wird unverändert
abgewiesen, nicht repariert. Verein und Stadionname werden über echte
Katalogreferenzen gebunden; ohne vorhandenen Stadionnamen erscheint
„Stadion“. Die fiktiven Blöcke und Stufen werden weder aus der OBW-
Kapazität noch aus einer Classic-Initialisierung berechnet. Ein leerer
Katalog benötigt keine erfundenen Vereins- oder Stadion-IDs.
**OpenBMH deviates from the original:** Native Baukosten sind ausdrücklich
an die Währungspräzision gebunden und Aufträge werden streng gegen die
Preisformeln sowie die Budgetsumme validiert. Die Ansicht verwendet
vorhandene Katalogidentität statt des festen HTML-Stadionnamens. Es gibt
keine automatische Bauabwicklung in diesem Paket.
Ein vorgemerkter Block zählt in der aktuellen Kapazität als gesperrt
mit null Plätzen; die Zukunftsansicht zählt seine Zielkapazität. Dies
gilt auch für einen reinen Sitz-/Dachumbau. Aufträge werden nur vorgemerkt:
Wochen laufen nicht ab, Blöcke werden nicht fertiggestellt und keine
Engine, Sitzung, Zufallsquelle, Spielzeit, Weltdatei oder fremde
Finanz-/Vertragsdaten werden verändert. Eine spätere Modern-Session-
Anbindung muss tatsächliche Bauabwicklung und deren Regeln liefern.
Synthetische Prüfungen stehen in
[modern_stadium_ui_tests.cpp](../../../../tests/modern_stadium_ui_tests.cpp).
Der isolierte Komponententest ist grün: acht Blockvorlagen, sämtliche
legalen Ausstattungsstufen, Sitz-/Dachkosten, Tausenderschritte, EUR mit
null und zwei Nachkommastellen, Budgeterhaltung, Stale-Quote-Ablehnung,
Rollback, strenge Migration, JSON-Checkpoint-Roundtrip, leere Kataloge
und unveränderte Welt-/Fremdmodelldaten. Ein Datumwechsel stellt keine
Aufträge fertig. Der tatsächliche native Prüfstand folgt im UI-Abschnitt;
diese Providerprüfung behauptet keine native Plattformabnahme.
<!-- provider:end -->
## Native Ansichten und Bedienung
Die native Oberfläche folgt dem HTML-Gold `69eec91c`, insbesondere `stadium-menus.js`, `stadium-window.css`, `stadium-menus.css` und den Themeüberschreibungen. Acht Innenblöcke A–H sind sowohl über die unveränderten Buchstaben-Hitregionen auf der proportional dargestellten Innenansicht als auch über die acht rechten Karten erreichbar. Darunter stehen die acht Ausstattungen mit den gemessenen Stufengrafiken. Midnight, Silver und Matchday teilen die Geometrie und Schriftgrößen. Die Bilddateien und die 28 stufenbezogenen Zuschnitte liegen ausschließlich im getrennten GUI-Paket.
Die Block- und Ausstattungsdialoge verwenden lokale Entwürfe. Neue Plätze lassen sich in Tausenderschritten über den gemeinsamen Mengeneditor oder den direkten Regler ändern. Sitzplätze und Überdachung bleiben nach einem vorhandenen Ausbau aktiviert; ein Abbau wird nicht angeboten. Stufenkarten zeigen Vorschau, Mehrkosten und die aktuelle Auswahl. Der Kostenüberblick wird aus dem Provider nachgerechnet, bevor „Bauen“ einen einzigen Auftrag verbindlich vormerkt. Abbrechen und Escape verwerfen den Entwurf ohne Buchung. Auch während der Rückkehr aus dem Mengeneditor bleiben Sourceinstanz, Welt und Quellrevision gebunden. Ein zwischenzeitlich geänderter Stand darf keinen anderen Auftrag stillschweigend erhalten.
Nach dem Vormerken zeigt „Zukunft“ Zielplätze beziehungsweise Zielstufen, „Aktuell“ den unveränderten Bestand und die im Bau gesperrte Kapazität. Die Wochenangabe ist eine unveränderliche fiktive Vorschau, kein laufender Fortschritt. Eine Ausstattungsstufe wird nicht fertiggestellt. Das Ausbaubudget ist die separate Demogröße des Providers, das sichtbare Desktopkonto bleibt davon unberührt.
Die Stadiondaten besitzen sechs deterministische Vorschaukurven über 24 Spieltage, Kurvenumschalter, absolute und relative Darstellung sowie die Referenztabelle. Relative Kurven verwenden ihr eigenes Maximum; absolut gilt das Maximum aller sechs Datensätze, auch wenn eine Reihe ausgeblendet ist. Die Einnahmenkurve bleibt wie im Gold `Zuschauer×13`; ein Ticketwechsel berechnet nur den benötigten Zuschauerschnitt `ceil(94000/Preis)` neu. Bei Preis 0 erscheint ein Gedankenstrich. Der tatsächliche Eingangs-Ticketwert des Snapshots wird beibehalten, nicht für Referenzbilder auf 13 zurückgesetzt.
Die Preisknöpfe 00–25 verwenden den gemeinsamen obersten Sourcewert `ticket`. Ein anderer Preis öffnet eine explizite Bestätigung; erst deren Annahme führt den gebundenen Ticketbefehl aus. Auswahl des bereits aktuellen Preises ist ein No-op. Abbruch verändert weder Ticket noch Revision. Der gemeinsame Ticketpopover wird nicht zur Vorabzuweisung eines angeklickten Preises missbraucht; es gibt keinen zweiten Stadion-Ticketzustand.
Die Panoramaansicht setzt die unveränderten 34 PNGs anhand des kalibrierten
Exports zusammen. Die 1920 × 1080 große Referenzfläche wird proportional in den
Stadioninhalt eingepasst. PNG-Leinwände, Alpha, Anker, Versätze, Skalierungen,
Objekt-IDs und stabile Z-Reihenfolge bleiben erhalten. Die Panoramaansicht
besitzt neben dem äußeren Fenstertitel „Stadion“ keine
weitere Kopfzeile, Kapazitäts- oder Budgetanzeige. Bild, Untertitel und
Navigation sind mit gleichmäßigem Außenabstand angeordnet. Die sichtbare Szene
enthält ausschließlich die Bilder; unsichtbare Trefferflächen tragen weder
Rahmen noch eingeblendete Objektnamen. Maus oder Tastaturfokus zeigen den
Funktionsnamen als Untertitel unter dem Bild, bei Bauaufträgen zusätzlich
„noch … Wochen“. Unten stehen genau „Zurück“ zur Innenansicht und der
umschaltbare Knopf „Zukunft“. Zukunft zeigt die vorgemerkten Bauten fertig,
ohne sie im Demomodell abzuschließen.
Verkehr (ID 0) besitzt Stufen 0–4, Parkplatz (ID 4) Stufen 0–3, alle anderen
Standorte 0–1. IDs 1–5 sind Arcade-Spielhalle, Einkaufszentrum, Clubhaus,
Parkplatz und Restaurant; IDs 6–9 vier unabhängige Imbissbuden, IDs 10–13
vier unabhängige Fan-Shops. Jeder Umfeldauftrag erlaubt genau die nächste
Stufe. Eine vorhandene Stufe 1 kann hier nur auf 2 erweitert werden; die
Innenausstattungen behalten ihre eigene Mehrstufenwahl. Der Umfeldbau öffnet
Vorschau, Zielstufe, fiktive Kosten und feste Bauzeit mit „Bauen“/„Abbrechen“.
Laufende oder vollständig ausgebaute Standorte bleiben für neue Aufträge
gesperrt und für Untertitel erreichbar.
Im aktuellen Bild verwendet ein Verkehrsbau bereits das Zielpanorama plus
Baumarker. IDs 1–5 zeigen Zielgebäude und zugehöriges Baustellenoverlay,
IDs 6–13 ausschließlich ihren Marker bis zur Zukunftsvorschau. Das Panorama
bleibt Wiese/Wald ohne Skyline oder Animation. Die Stadionvariante folgt der
physischen fertigen Blockgröße, in Zukunft der Zielkapazität; gesperrte Blöcke
verkleinern nur die verfügbare Kapazitätszahl, nicht die fertige Stadiongrafik.
Die fünf gewöhnlichen Kapazitätsstufen wechseln bei
10.000/25.000/50.000/75.000 Plätzen. Die sechste Grafik ist dem Super-Stadion
vorbehalten: Jeder der acht Innenblöcke muss sein individuelles Platzmaximum
erreichen, vollständig bestuhlt und überdacht sein. „Aktuell“ prüft den fertigen
Bestand, „Zukunft“ berücksichtigt gebuchte Zielzustände. Eine feste
100.000-Plätze-Grenze entscheidet diesen Vollausbau nicht.
Der Vollausbauzustand des Exports ist ausschließlich Referenz, kein Startbestand.
Die Demo startet Verkehr/Parkplatz/Restaurant auf Stufe 1, andere Standorte auf 0.
Die native Regelkorrektur vom 26. Oktober 2026 basiert auf `8b3b51d`.
Synthetische Grenztests prüfen jeden Block einzeln unter seinem Maximum, ohne
Dach und ohne vollständige Bestuhlung sowie den gebuchten Vollausbau. Die
Stadion- und DemoSource-Komponententests bestehen. Fünf frische native Läufe
bei Midnight/1080p bestehen mit 100/100 Prüfbedingungen einschließlich aller
vierzehn Umfeldbereiche, genau zwei Navigationsknöpfen und unveränderten
Spieldaten beim Wechsel zwischen „Aktuell“ und „Zukunft“.
Die Umfeldpreise pro Stufe sind in angezeigten Einheiten 700.000/800.000/
1.800.000/650.000/450.000/550.000, je Imbiss 90.000 und je Fan-Shop 140.000.
Bauwochen sind 12/14/28/16/9/12, je Imbiss 4 und je Fan-Shop 6. Diese Werte
sind ausdrücklich lokale Demoannahmen. Es gibt keinen Wochenfortschritt,
keine Fertigstellungsaktion und keinen Bauabbruch nach Buchung; „Abbrechen“
im Dialog verwirft ausschließlich den ungebuchten Entwurf. Engine, echte
Finanzen und Weltdateien bleiben unberührt.
Der getrennte GUI-Import erfolgt nach der allgemeinen GUI-Vorbereitung mit
`python3 tools/modern_ui/prepare_stadium_assets.py --studio /path/to/sprite-studio
--output /path/to/gui-resources`. Der Befehl prüft den freigegebenen Exporthash
`7e3e6a013703b392964a0151b17b00d40fb582ea6f51ce125345e080e49cbada`
sowie sämtliche Bildhashes und nativen Abmessungen vor dem Kopieren. Bilder
und private Konfiguration werden nicht Teil des öffentlichen Quellbestands.
Fehlende Umfeldressourcen ergeben eine explizite Meldung im GUI.
View, Zukunftswahl, sechs Kurvenschalter, Skala, Dialog und Entwurf liegen nur in `stadium_view_`. Der gemeinsame Build einschließlich der parallel übernommenen M9-Engineänderungen und alle 29 Regressionstests bestehen. Die native Grundmatrix umfasst alle drei Themes bei 720p/1080p, sämtliche Block-/Facility-Zuordnungen, alle Stufenzuschnitte, aktuelle/geplante Darstellung und Datenansichten. Fünf funktionale Läufe prüfen lokale Entwürfe, Schrittfehler, genau eine Budgetbuchung, Pending-Sperren, gemeinsame Ticketwerte 0/25 in Desktop/Bilanz und einen echten Checkpoint-Neustart. Die gezielten Abschlussläufe bestätigen den Bildbeschnitt, die sichtbare Kapazitätsbeschriftung und Home/End am tatsächlich per Maus fokussierten Regler; die Navigation zum richtigen Range erfolgt über dessen interne Vorfahren. Ein eigener unabhängiger Abschluss besteht 27/27 Prüfungen mit identischem Quellmodell und Checkpoint nach Cancel. Alle früheren Aufnahmen behalten ihre tatsächlichen Runtimehashes. Die privaten Bilder, UI-Demostände und Replays liegen unter `docs/qa/stadium-batch-2026-10-25/`. Dies ist eine Linux-/OpenGL-Bildprüfung; eine visuelle Windows-/macOS-Laufzeitabnahme wird daraus nicht abgeleitet.
## Prüfung des kalibrierten Umfelds · 26. Oktober 2026
Der Linux-/OpenGL-Build mit höchstens zwei parallelen Baujobs besteht. Nach
vollständigem Neulinken der Modern-Testprogramme bestehen alle 30
`modern_*`-Tests. Zusätzlich zur bisherigen Innenprüfung decken die synthetischen
Tests alle vierzehn Standorte, jede nächste Verkehr-/Parkplatzstufe,
übersprungene Ziele, laufende Aufträge, Budgeterhaltung in beiden
Währungspräzisionen, JSON-Roundtrip und alte gültige Vierfelderbestände ab.
Die echte DemoSource-Grenze prüft Vormerkung, Revision, Stale-/Doppelsperre,
Speichern/Laden und Migration. Fehlerhafte Bestände bleiben unverändert.
Der Szenentest prüft alle Kapazitätsgrenzen direkt darunter und exakt darauf,
kalibrierte Anker/Hitflächen, stabile Ebenen sowie Baustellen/Zukunft und
unveränderte Exportdaten. Der Import weist beschädigte PNGs und einen
veränderten Kalibrierungsexport vor einer Ausgabeänderung ab.
Die privaten nativen Bediennachweise, Eingabeskripte, Screenshots, DOMs,
Runtime-/Inputhashes und ladbaren Demo-Checkpoints liegen im lokalen Bündel
`periphery-2026-10-26/`. Drei Themes bei 1280 × 720 und 1920 × 1080 prüfen
Bildproportionen, Trefferflächen und Untertitel. Weitere Läufe prüfen alle
14 unabhängigen Neubauten, Abbrechen/Escape ohne Modelländerung,
Tab/Leertaste/Escape, ausgebaut gesperrte Standorte, je einen Auftrag pro
Revision, Bauwochen-Untertitel, aktuelle Marker/Overlays, fertige Zukunft,
Rückkehr zur Innenansicht sowie echten Neustart mit laufenden Aufträgen.
Fertige Fixturestände prüfen Verkehr 0–4 und Parkplatz 0–3. Insgesamt bestehen
171/171 strukturierte Prüfungen aus 15 nativen Erstläufen sowie zwei
Import-Ablehnungsprüfungen; das Bündel enthält 130 Screenshots dieses Ausgangsstands. Die bereits
abgenommenen privaten Belege vom 25. Oktober bleiben historisch erhalten.
Die anschließende Nachprüfung der reinen Bildansicht ohne innere Kopfzeile
liegt im privaten Bündel `periphery-picture-only-2026-10-26/`: sieben native
Läufe, 50 neue Screenshots und 201/201 Prüfbedingungen. Sie bestätigt in allen
Themes und beiden Größen den äußeren Fenstertitel, fehlende Kapazitäts-/
Budgetzeilen, genau zwei Navigationsknöpfe, 16:9 und gleichen Außenabstand,
Hover-Bauwochen, Zukunft/Rückkehr und unveränderte Demo-/Checkpointdaten.
Innenansicht und Stadiondaten behalten ihre Informationen. Die beiden
gezielten Stadion-/DemoSource-Komponententests bestehen ebenfalls.
Das bestehende Innen-Demomodell endet bei zusammen 96.000 Plätzen. Sind dabei
alle acht Blöcke vollständig bestuhlt und überdacht, erscheint die sechste
Stadiongrafik. Bereits ein fehlendes Dach, Stehplätze oder ein Block unter seinem
Maximum lassen die gewöhnliche Kapazitätsgrafik bestehen. Ausschließlich
gebuchter Vollausbau erscheint erst in „Zukunft“ als Super-Stadion. Diese Regel
gehört zur nativen UI-Demo; sie ändert weder Classic noch eine Engineberechnung.
Baufortschritt, Fertigstellung und Abbruch eines
gebuchten Auftrags bleiben offene Engineentscheidungen. Die Prüfung belegt
keine Windows-/macOS-Laufzeitabnahme und keine neue Classic-Freigabe.