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

13 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, bank, stadium, credit, environment, advertising, contracts. 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 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 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/.

Umfeld und Werbung

Die sechs Umfeldkarten zeigen tatsächliche Sterne, Monatskosten und Nachwuchsränge/-ligen. Jede Änderung fragt nach Bestätigung des Monatsbudgets und sendet dann environment.commit. Es wird kein Guthaben sofort abgebucht und keine Nachwuchsentwicklung im UI simuliert.

Werbung zeigt alle von der Engine gelieferten Angebote für vierzehn Banden, Trikot und TV. Eine eigene Bestätigung bindet Firma, Laufzeit und Preis an die genaue, revisionierte Offer-ID. Navigation verwendet die tatsächliche Länge der Liste, auch bei ausgelassenen Angebotsplätzen oder vorhandenen Vertrags-/Optionszeilen. Nach einem Commit wird die lokale Auswahl verworfen, damit eine von der Engine umsortierte Bande nicht falsch markiert bleibt.

Die drei Vereinsbudgets verwenden denselben Zahleneditor samt Review. budget.commit erhält die jeweilige ID und den Betrag exakt einmal in Minor Units. Capabilities, verfügbare Budgets, Höchstbeträge und laufende Lieferungen werden auch im Frontend beachtet. Die Finanzvorschau ist die gelieferte monatliche Vereinsprognose, keine UI-Summe nur der Werbeverträge.

Native Tests bestätigen acht echte Änderungen, schreibgeschützte Abbrüche, einen sauberen bestätigten No-op, bestehende Liefersperren und OBS-Neustarts. Nachweise: bmh_4k_ui/docs/qa/engine-commerce-2026-10-28/.

Spielerverträge

Die drei Vertragstabellen zeigen tatsächliche Gehälter, Laufzeiten, Versicherung und Kaderwerte. Öffnen und Browsing fragen keine Gehaltsforderung ab. Erst „Forderungen abfragen“ verwendet den vorhandenen Command quote.request {kind: contract, playerId}. Der Read liefert danach die Quote-ID, vier Forderungen und die maximale Monatsvergütung. Entwürfe und Zahleneditor allein verändern diese Enginewerte nicht.

Erst eine gesonderte Bestätigung sendet contract.offer mit exakter Quote-ID, Jahren und monthlySalary in Minor Units. Der Client zeigt Annahme oder Ablehnung aus der tatsächlichen Antwort; ein Original-Ablehnungsflag sperrt gegebenenfalls den nächsten Versuch. Keine UI-Zufallszahl oder Demoforderung ersetzt diese Entscheidung. Versicherung und Prämien bleiben hier lesend.

Ergänzter Runtime-Command: contract.cancel

Der Payload ist {quoteId: "quote:contract-<id>"}; die gemeinsame Hülle benötigt requestId, careerId, expectedRevision, owner.managerId und kind wie die anderen Commands. Die Capability wird nur am Vereinsschreibtisch bekanntgegeben. Die Engine prüft die genaue Quote sowie deren Manager und Verein, schließt sie und erhöht die Sessionrevision. Sie verändert keine Vertragsdaten und weder spult sie Zufall zurück noch zieht sie neuen. Eine falsche/verbrauchte Quote führt zu stale_quote; eine alte Revision zu stale_revision. Dieselbe requestId erhält die bereits bekannte Antwort, ohne erneut zu schließen.

Dies ergänzt die aktuelle Runtime-Implementierung; die allgemeinen JSON-Schemas bleiben der separat gekennzeichnete Entwurf. Beim bloß lokalen Schließen ohne angefragte Quote ist kein Command nötig. Nach einem echten Cancel bleibt eine andere Schreibtischaktion möglich. In der geprüften Modern-Karriere blieb auch der gespeicherte RNG bei der Forderungsabfrage gleich; erst die tatsächlichen Vertragsentscheidungen änderten ihn. Der UI-Code setzt diesen Sonderfall nicht als Regel fest. Neue OBS-Datei und Neustart erhalten den tatsächlichen Vertrag und die Sperren, ohne einen offenen Quote-Owner zu hinterlassen. Private Belege: bmh_4k_ui/docs/qa/engine-contracts-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.