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

7.7 KiB

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.

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

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.