151 lines
9.0 KiB
Markdown
151 lines
9.0 KiB
Markdown
<!-- SPDX-License-Identifier: GPL-3.0-only -->
|
|
# Nativer Engine-Einstieg: Schreibtisch, Trainingslager, Aufstellung und Vorbereitung
|
|
|
|
Der opt-in Einstieg lädt eine bestehende Modern-Karriere aus einer OBS-Datei.
|
|
Er ist ein erster vertikaler Integrationsschritt, kein vollständiger spielbarer
|
|
Modern-Frontend-Ersatz. Der bisherige UI-Demomodus bleibt separat erhalten.
|
|
|
|
```sh
|
|
./OpenBMH --mod /path/to/Diamond_Modern.obw \
|
|
--ui-career /path/to/career.obs --gui-assets /path/to/gui-resources
|
|
```
|
|
|
|
`--ui-scene camp` öffnet unmittelbar das Trainingslager. `--ui-theme` und
|
|
`--ui-size` bleiben als visuelle Overrides verfügbar. `--ui-state` bezeichnet
|
|
weiterhin einen Demo-JSON-Stand und kann nicht mit `--ui-career` kombiniert
|
|
werden. Die Quelle wird nicht in DemoSource überführt.
|
|
|
|
## Gebundener Umfang
|
|
|
|
- `ModernSession::ui_read`: `session`, `desktop`, `camps`, `squad`, `lineup`, `tactics`, `training`, `bank`, `stadium`, `credit`. Karriere, Manager,
|
|
Mannschaft, Datum, Saison, Geld, Lagerqualitäten und Angebote kommen aus der
|
|
Engine. Katalog und Engine müssen dieselbe Welt-ID und Datenrevision haben.
|
|
- Der bestehende RmlUI-Schreibtisch verwendet die gemeinsamen App-Buttons und
|
|
Styles. Kalender, Vereinskasse, Porträt und ein tatsächlich gemeldeter nächster
|
|
Gegner sind gebunden; fehlende Beträge bleiben unbekannt. Andere Widgets werden
|
|
noch nicht befüllt. Aufstellung und Spielerprofile sind ebenfalls angebunden;
|
|
die übrigen ungebundenen Menüs bleiben deaktiviert.
|
|
- Die vorhandene Trainingslageransicht erhält alle drei Regionen und 18 Lager
|
|
aus dem Enginevertrag. Aus dem GUI-Katalog kommen ausschließlich Bildschlüssel
|
|
und fehlende Kartenpositionen, keine Preise, Qualitäten oder Spielregeln.
|
|
- `camp.book` wird erst nach sichtbarer Preisbestätigung gesendet. Die Anfrage
|
|
erhält Karriere, stabilen Manager, Revision und Lager-ID aus dem gebundenen
|
|
Angebot. Lokale Schwerpunkte sind Entwürfe bis zur bestätigten Buchung.
|
|
Erholung wird nach der Buchung von der Engine übernommen.
|
|
- `allowedCommands` und bindende Angebotssperren gelten auch im Frontend.
|
|
Ausreichendes Bargeld wird nicht als zusätzliche erfundene Grenze eingeführt;
|
|
maßgeblich bleibt die Engine mit ihrer vorhandenen Kreditlogik.
|
|
|
|
## Kader und Aufstellung
|
|
|
|
Der vorhandene Aufstellungs-Presenter erhält aktuelle Kaderreihenfolge, Namen,
|
|
Positionen, Fähigkeiten und verfügbare Werte aus den beiden Engine-Reads. Ein
|
|
Klick auf einen Zahlenwert öffnet das bekannte Profil mit Enginewerten und dem
|
|
belegten Fotoasset beziehungsweise der Silhouette. Status und Anzahl auf der
|
|
Bank kommen aus den Rollenflags des Read, nicht aus den Demo-Grenzen.
|
|
Unbelegte Motivation, Tore, Vorlagen, Spiele und Noten bleiben unbekannt.
|
|
|
|
Zwei Spieler anzuklicken öffnet eine Bestätigung. Erst danach sendet die Bridge
|
|
`lineup.commit` mit der vollständigen Permutation aller stabilen Spieler-IDs,
|
|
Karriere, Manager und erwarteter Revision. Die Engine prüft die Aufstellung;
|
|
der Client zieht keine eigenen Spielregeln oder Spielerwerte nach. Abbruch und
|
|
Ansichtswechsel ändern keine Enginewerte. Ein erfolgreich bestätigter Tausch
|
|
bleibt nach dem Speichern als neue OBS-Datei und einem Prozessneustart erhalten.
|
|
|
|
Das Spielfeld verwendet die gelieferten Koordinaten samt `depthMax`/`laneMax`.
|
|
Unbekannte Koordinaten werden nicht durch eine Demoformation ersetzt. Eigene
|
|
Formationen, Anweisungen, Schützen, Positionsziehen und ein Hallen-Umschalter
|
|
bleiben in diesem echten Einstieg bis zu ihren eigenen Engineanschlüssen
|
|
unverfügbar; die vollständige Demo behält ihre getrennte Bedienung.
|
|
Die erweiterten Nachweise liegen unter `bmh_4k_ui/docs/qa/engine-lineup-2026-10-28/`.
|
|
|
|
## Taktik und Training
|
|
|
|
Beide bestehenden Presenter sind im echten Einstieg angebunden. Ihre Werte,
|
|
Bereiche und Ballbudgets stammen aus den jeweiligen Engine-Reads. Die Taktiktafel
|
|
verwendet die tatsächlich gelieferten Aufstellungskoordinaten einschließlich
|
|
`depthMax`/`laneMax`; eine unbekannte Formation wird nicht ersetzt. Die neutralen
|
|
Taktikbezeichnungen des Vertrags bleiben erhalten.
|
|
|
|
Änderungen sind zunächst lokale Entwürfe. „Zurücksetzen“ verwirft sie, Schließen
|
|
übernimmt nichts. „Anwenden“ fragt nach Bestätigung und sendet dann
|
|
`tactics.commit` beziehungsweise `training.commit` mit Karriere, Manager,
|
|
erwarteter Revision und neuer requestId. Der Client prüft die vom Read genannten
|
|
Bereiche/Budgets; die maßgebliche Anwendung und weitere Prüfung bleiben bei der
|
|
Engine. Bei noch nicht eingerichtetem Training weist die UI auf die erstmalige
|
|
Einrichtung mit Anwenden hin. Öffnen des Menüs initialisiert es nicht heimlich.
|
|
|
|
Training zeigt den aktuellen Engine-Kader und dessen Stärke statt der statischen
|
|
Katalogwerte. Typen, Bereiche und Spielerintensität sind bearbeitbar. Die vier
|
|
Automatikschalter spiegeln die gespeicherten Bildschirmflags, sind hier aber
|
|
schreibgeschützt; ihr Byte wird vom Client nicht geschrieben. Auch die vorhandenen
|
|
Spielerschwerpunkte bleiben bis zu einem entsprechenden Commit-Vertrag
|
|
schreibgeschützt. Unbelegte Überlastungsschwellen aus der Demo werden im echten
|
|
Einstieg nicht als neue Engine-Regeln eingeführt.
|
|
|
|
Die Hintergrundaufträge liefern nach dem Commit einen neuen zusammenhängenden
|
|
Snapshot. Rückmeldung und Änderungsstatus folgen der Engineantwort; ein bestätigter
|
|
No-op wird nicht als neue ungespeicherte Änderung ausgegeben. Taktik und Training
|
|
bleiben in einer neuen OBS-Datei und nach Prozessneustart erhalten. Private Belege:
|
|
`bmh_4k_ui/docs/qa/engine-sports-2026-10-28/`.
|
|
|
|
## Bank und Eintrittspreis
|
|
|
|
Die [Bankansichten](../desktop/bank/README.md) nutzen tatsächliche Konten,
|
|
Anlagen und Kursverläufe. Sparbuchtransfer und Anlagenhandel werden im vorhandenen
|
|
Zahleneditor eingegeben, separat bestätigt und über `bank.commit` gebucht.
|
|
Kurswerte sind ohne zusätzliche Bankgebühren gekennzeichnet; die tatsächlichen
|
|
Kosten liegen weiterhin bei der Engine. Fehlende Firmenlabels werden durch
|
|
Kennungen ausgewiesen, nicht durch Unternehmen aus den Demodaten ersetzt.
|
|
|
|
Ein neuer Bankkredit wird zuerst per reinem `credit`-Read berechnet. Die UI hält
|
|
nur die bestätigte Vorschau und deren Editliste; noch kein Enginezustand ändert
|
|
sich. Endgültiges Buchen hat eine eigene Bestätigung. Änderungen bereits
|
|
laufender Kredite bleiben bis zur vollständigen Gebührenvorschau gesperrt.
|
|
Die finanzielle Übersicht erfindet weder Kreditsaldo noch Zins-/Tilgungsplan.
|
|
|
|
Der [Eintrittspopover](../desktop/entry-price/README.md) bleibt kompakt und
|
|
verwendet aktuelle Preise/Grenzen aus `stadium`. Erst Bestätigen sendet
|
|
`ticket.commit`. Das gemeinsame Control akzeptiert einen bestätigten Auftrag;
|
|
ein asynchroner Client veröffentlicht ausschließlich die spätere Engineantwort.
|
|
Preise und Vermögenswerte überleben die neue OBS-Datei und den Neustart.
|
|
Private Belege: `bmh_4k_ui/docs/qa/engine-finance-2026-10-28/`.
|
|
|
|
## Ausführung und Dateien
|
|
|
|
Laden, Reads nach einer Aktion, Buchen und Speichern laufen seriell über einen
|
|
Hintergrundauftrag. RmlUI-Objekte bleiben auf dem UI-Thread. Während eines
|
|
Auftrags sind Bestätigungen gesperrt. Die DTO-Grenze prüft übereinstimmende
|
|
Kontexte; Geld wird einmal exakt als ganzzahlige Minor Units gelesen. Es gibt
|
|
keine Rundreise über Fließkommazahlen und keine zusätzliche Preiskalkulation.
|
|
Nach einem unklaren Mutationsfehler bleibt der Stand vorsichtshalber ungespeichert
|
|
markiert und weitere Buchungen gesperrt.
|
|
|
|
Die Diskette schreibt eine **neue** OBS-Datei. Die Eingangsdatei und bereits
|
|
bestehende Ziele werden nicht überschrieben. `--ui-file-export /new/file.obs`
|
|
setzt das Ziel für automatisierte QA; sonst erscheint der native Dateidialog.
|
|
Beim Beenden mit ungespeicherten Änderungen erscheint eine Bestätigung.
|
|
Noch offen sind das vollständige Laden-/Speichern-Menü, Überschreiben mit
|
|
Bestätigung, Karrierestart, weitere Untermenüs und Anstoß im echten Einstieg.
|
|
Die Demoabläufe sind davon ausdrücklich getrennt.
|
|
|
|
## Prüfung
|
|
|
|
`modern_engine_dto_tests` ist synthetisch und prüft Kontextschutz, exakte große
|
|
Geld-/Revisionswerte, fremde/veraltete Angebote, National-Sperre und ungültige
|
|
Schwerpunkte. Der opt-in `modern_engine_bridge_probe prepare|verify|verify-lineup|verify-sports <world.obw>
|
|
<new-output-directory>` prüft mit privat bereitgestellten Weltdaten tatsächliche
|
|
Buchung, Preisabzug, Anfragewiederholung und OBS-Speicherrundreise. `verify-lineup` prüft zusätzlich tatsächlichen Tausch,
|
|
Wiederholung, abgewiesene alte Revision und gespeicherte Aufstellung. `verify-sports` prüft Taktik/Training, Anfragewiederholung,
|
|
alte Revision und gespeicherte Pläne. Er ist kein
|
|
bedingungsloser CTest und verteilt keine Originaldaten.
|
|
|
|
`--ui-script` unterstützt `engine-wait` zum Abwarten realer Hintergrundaufträge.
|
|
Snapshots enthalten `engine_view` einschließlich gelesener DTOs, Antwort und
|
|
lokalem Entwurf. Der Demo-Befehl `checkpoint` lehnt Enginekarrieren ausdrücklich
|
|
ab; reale Teststände werden über die OBS-Speicheraktion erzeugt.
|
|
|
|
Die privaten Bilder, Eingangsspielstände und Replaybefehle liegen unter
|
|
`bmh_4k_ui/docs/qa/engine-entry-2026-10-27/`. Plattformgrenzen stehen im dortigen
|
|
Prüfbericht; ein CI-Build ist keine interaktive Windows-/macOS-Abnahme.
|