73 lines
4.1 KiB
Markdown
73 lines
4.1 KiB
Markdown
<!-- SPDX-License-Identifier: GPL-3.0-only -->
|
|
# Erster nativer Engine-Durchlauf: Schreibtisch und Trainingslager
|
|
|
|
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`. 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. Ungebundene 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.
|
|
|
|
## 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 <world.obw>
|
|
<new-output-directory>` prüft mit privat bereitgestellten Weltdaten tatsächliche
|
|
Buchung, Preisabzug, Anfragewiederholung und OBS-Speicherrundreise. 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.
|