Files
Dreierpack-Manager/docs/new_ui/integration/ENGINE_ENTRY.md
T

4.1 KiB

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.

./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.