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

17 KiB

Nativer Engine-Einstieg: Schreibtisch, Vereins-/Nationalplanung und Archiv

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, calendar, scheduling, friendly-plan; parameterisierte Angebote über friendly und Archivabfragen über almanac. 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/.

Vereinskalender und Spielverlegung

Der Kalender liest den vollständigen Saisonbereich aus meta.season.startDate/endDate. Die bestehende Geometrie berechnet nur Gregorianische Tage/Wochentage; Paarungen, Ereignisse und Status werden aus dem Read übernommen. Allgemeine Wettbewerbstermine werden nicht als bestätigte eigene Spiele ausgegeben. Länder-/Ligafilter sind im ersten Vereinsanschluss lesend; Nationalkalender und Freundschaftsspielplanung bleiben getrennte Pakete.

Verlegen verwendet exakt die movable-IDs und targetDates des scheduling-Read. Eine eigene Bestätigung sendet fixture.reschedule {matchId, date}. Zielauswahl und abgebrochene Bestätigungen verändern keine Revision. Die frisch zurückgelesenen Kalender-/Verlegungsdaten sind danach maßgeblich, nicht eine optimistische Änderung der UI-Tabelle.

Eine explizit angebotene Rücknahme verwendet {action: undo, date}. Das Datum ist der vom Read gemeldete Nachholtermin, nicht ein geratener ursprünglicher Termin oder eine vermeintlich letzte Aktion. Bestätigte Änderungen bleiben als neue OBS-Dateien und nach vollständigem Neustart erhalten; eine Rücknahme kann auch erst nach dem Laden erfolgen. Beide RNGs, Konto und Spielzeit bleiben dabei unverändert. Der Verfügbarkeitsbefund nach Undo (#16) ist mit cbde7b3 behoben und per Karriererundreise nachgeprüft. Die Oberfläche folgt weiterhin den jeweils aktuellen Freigaben. Private Nachweise: bmh_4k_ui/docs/qa/engine-calendar-2026-10-28/.

Vereinsfreundschaftsspiele

Die vorhandene Planungsansicht verwendet Enginegegner, aktuelle Stärken und gespeicherte Buchungen. Der neue reine Runtime-Read friendly-plan hat keinen Payload außer kind; die normale Manager-/Karriere-/Revisionshülle gilt. Er liefert teamId, opponents mit team, competitionId, strength sowie bookings mit id, date, home, away. Die Daten lesen die bestehenden 30 Planzeilen und aktuellen Runtime- Ligen; sie erzeugen keine Buchungen. Fehlende Rang-/Spieldaten bleiben unbekannt.

friendly {opponentId, home} ist eine reine Kosten-/Datumsabfrage. Der Client prüft Paarung, Scope, Zahler und menschlichen Gegner gegen die Sitzung. Nur bereitgestellte Tage werden zur Auswahl freigegeben. Nach der letzten Bestätigung sendet friendly.book die IDs/Ort/Datum sowie acceptCost und gegebenenfalls opponentConsent. Zustimmung des gegnerischen Managers ist im lokalen Hotseat ein eigener namentlicher Dialog; sie wird nicht aus seiner Teilnahme abgeleitet. Das ist kein Authentifizierungsmodell für spätere Netzwerkclients. Alte oder fremde Angebote werden nicht umgebunden.

Nach bestätigter Buchung werden Plan/Kalender/Konto neu gelesen. Gespeicherte Paarung, Heim/Auswärts und tatsächliche Kosten bleiben nach OBS-Neustart erhalten. Es gibt keinen UI-Preis, pauschale Spielzahl, versteckte Sofortbuchung bei der Gegnerwahl oder einen vom Frontend erfundenen Slotdeckel von 20 Spielen. Nationalplanung bleibt bis zum eigenen Anschluss gesperrt. Private Nachweise: bmh_4k_ui/docs/qa/engine-friendlies-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.

Almanach · 28. Oktober 2026

Der bestehende Almanach-Presenter liest nun abgeschlossene Partien der echten Karriere über ui_read {kind: "almanac", query: ...}. Index, Jahreskalender, Tagespaarungen und Spielbericht werden bei Bedarf auf dem seriellen Worker abgefragt und an Karriere, Welt, Manager und Revision gebunden. Die UI hält höchstens einen Index, Kalender, Tag und Detailbericht. Es gibt keine zusätzlichen Almanachabfragen in jedem Schreibtisch-Snapshot.

Archivierte Namen, Aufstellungen, Ereignisse und Phasenwerte ersetzen die bisherigen Dummydaten im echten Einstieg. Unsichere Phasenangaben aus dem festgestellten Engine-Befund #18 sind gekennzeichnet; es werden keine Tore oder Entscheidungen rekonstruiert. Vorhandene Wappen kommen über die stabile Vereins-ID aus der aktiven Welt. Das Speichern als neue OBS erhält die bereits aufgezeichneten Archivbytes und beide RNGs. Einzelheiten und private QA stehen im Almanach-Menüdokument.

Tabellen und Stärken · 28. Oktober 2026

report-index und league-report {leagueId,filter} liefern aktive Ligen, Tabellenfilter und Kaderstärken für den vorhandenen Berichtspresenter. Die Berechnung bleibt bei ComputeLeagueTable/TeamAverage. Reine Ansichtsänderungen verändern keine Revision oder RNGs; erfolgreiche Sessionmutationen verwerfen veraltete Berichts-/Kaderdaten. Vereins-/Spielerprofile verwenden squad für das angefragte Team. Nicht projizierte Qualifikationsregeln werden nicht durch Demo-Zonen ersetzt. Details.