235 lines
14 KiB
Markdown
235 lines
14 KiB
Markdown
<!-- SPDX-License-Identifier: GPL-3.0-only -->
|
|
# 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.
|
|
|
|
```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`, `squad`, `lineup`, `tactics`, `training`, `bank`, `stadium`, `credit`, `environment`, `advertising`, `contracts`, `calendar`, `scheduling`. 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](../desktop/bank/README.md) 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](../desktop/entry-price/README.md) 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](../desktop/environment/README.md) 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](../desktop/advertising/README.md) 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](../desktop/contracts/README.md) 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](../desktop/calendar/README.md) 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](../desktop/postpone/README.md) 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 bekannte Verfügbarkeitsbefund nach Undo ist als Engine-Frage #16
|
|
erfasst. Die Oberfläche folgt weiterhin den jeweils aktuellen Freigaben.
|
|
Private Nachweise: `bmh_4k_ui/docs/qa/engine-calendar-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.
|