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

414 lines
25 KiB
Markdown

<!-- SPDX-License-Identifier: GPL-3.0-only -->
# Nativer Engine-Einstieg: Schreibtisch, Vereins-/Nationalplanung und Archiv
Der Einstieg kann eine neue Runtime-Modern-Karriere aus dem vorhandenen Wizard
erzeugen oder eine bestehende Modern-Karriere aus einer OBS-Datei laden.
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`, `file-metadata`, `camps`, `squad`, `lineup`, `tactics`, `training`, `bank`, `stadium`, `credit`, `environment`, `advertising`, `contracts`, `calendar`, `scheduling`, `friendly-plan`, `report-index`, `league-report`, `league-fixtures`, `other-index`, `other-fixtures`, `player-rankings`, `fairplay`, `statistics`, `toto`; 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](../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 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](../desktop/friendlies/README.md) 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](../desktop/almanac/README.md).
## 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](../desktop/reports/README.md).
## Ligaspiele · 28. Oktober 2026
`league-fixtures {leagueId,round?}` bindet den vorhandenen Begegnungspresenter
an die tatsächlichen Paarungen und Ergebnisse. `round` beginnt bei 1;
weggelassen wird der nächste Engine-Spieltag verwendet. Länder, Ligen und
Rundengrenzen kommen aus `report-index`. Rundenpfeile stoppen am Rand; ein
Wechsel zwischen 38 und 34 Spieltagen begrenzt die Auswahl. Profile verwenden
dieselben aktuellen Kader-Reads wie Tabellen/Stärken.
Offene/verlegte Paarungen enthalten `result: null`, keine vermeintlichen
Torzahlen aus Statusmarkern (#19). Der Controller bindet die Antwort an den
Snapshot und verwirft sie nach einer Sessionmutation. Browsing ändert weder
Revision, RNG noch Archiv. Private Nachweise mit realer Verlegung/Rücknahme:
`bmh_4k_ui/docs/qa/engine-fixtures-2026-10-28/`. „Übrige Spiele“ bleibt
vorerst separat. [Vertrag und Bedienung](../desktop/reports/README.md).
## Übrige Spiele · 28. Oktober 2026
`other-index` nennt aktive Wettbewerbsansichten mit ihren verknüpften Gruppen
und Phasen. `other-fixtures {viewId,round?}` delegiert an die vorhandene reine
Modern-Pokalprojektion. Beide Antworten verwenden die übliche revisionsgebundene
Snapshot-Hülle. Runden ohne abgeschlossene Vorgänger beziehungsweise ohne
Auslosung bleiben ohne Paarungen; es gibt keinen Demoersatz. Hin-/Rückspiele,
Verlängerungs-/Elfmetermarker und geplante Datumszeilen bleiben unterscheidbar.
Vereinsprofile verwenden die gemeldeten Teilnehmer, Spielerprofile ausschließlich
tatsächlich vorhandene Runtime-Kader. [Vertrag und Grenzen](../desktop/reports/README.md).
## Spielerstatistiken und Fairplay · 28. Oktober 2026
Die bestehenden Presenter lesen tatsächliche Ereignisse der aktuellen Saison.
`player-rankings {leagueId,scope}` liefert vier fertig sortierte Kategorien mit
Gleichstandsplätzen, archivierter Identität und optionalem aktuellem Kaderbezug.
Der Vereinsbereich filtert die Beiträge vor dem Zusammenzählen nach Verein;
Leistungen vor einem Transfer werden nicht dem neuen Verein zugeschlagen.
`fairplay` liefert Karten/Strafpunkte für alle aktuellen Vereine der ersten
Liga, einschließlich Nullzeilen. Die Darstellungsgewichte ändern keine Sperren.
Beide Reads verwenden report-index und den üblichen Karriere-/Manager-/Welt-/
Revisionskontext. Tabs bleiben lokal, Sessionmutationen verwerfen den Cache.
Profile zeigen aktuelle Kaderwerte oder ausdrücklich unbekannte Angaben bei
nur noch archivierten Personen. [Spielerstatistiken](../desktop/scorers/README.md)
und [Fairplay](../desktop/fairplay/README.md) beschreiben Umfang und Grenzen.
## Neuanlage aus dem Hauptmenü · 29. Oktober 2026
Ohne `--modern-ui-demo` erzeugt der Abschluss des Wizards eine echte Session
über `confirm_manager`/`finish`. `--ui-career` bleibt der direkte OBS-Einstieg.
Ein reiner `opening`-Read liefert tatsächliche Teilnehmer und Pokalpaarungen;
die vorhandene Introgestaltung zeigt diese Daten ohne zweite Auslosung.
Erst nach Abschluss erscheint der gebundene Schreibtisch. Anstoß bleibt gesperrt.
[Karriereanlage](../main-menu/entry/README.md) und
[Saisonvorbereitung](../main-menu/opening/README.md) beschreiben den Ablauf.
Beim Beenden einer ungespeicherten echten Partie stehen Abbrechen, Speichern
und beenden sowie Ohne Speichern beenden zur Auswahl. Ein abgebrochener oder
fehlgeschlagener Save schließt die Partie nicht; vorhandene Zieldateien werden
weiterhin nicht überschrieben. Der vollständige moderne Dateibibliotheksdialog
ist ein getrenntes Folgepaket.
## Nationaltrainer und menschliche Identität · 29. Oktober 2026
Beim temporären Recordtausch hält die Session nun die stabile Identität des
wirklich ausgewählten Menschen (#20). Manager.slot ist der logische Mensch,
runtimeSlot der tatsächliche aktuelle Record. Der Schreibtisch/Scope verwenden
die passende Manager-ID, Name und Porträtart; wartende Menschen verlieren ihre
Vereinszuordnungen nicht. UI-Commands verwenden wie bisher IDs und Revisionen,
keine aus der Anzeige geratenen Recordnummern. Alte OBS ohne Darstellungsfelder
bleiben unterstützt. Details: [Nationalteams](../../new_engine/nationalteams.md).
## Echte Dateibibliothek
Siehe [Speichern/Laden](../desktop/save-load/README.md). Der Engine-Einstieg
öffnet nun den vorhandenen RmlUI-Dateidialog für echte OBS-Dateien, einschließlich
Metadaten, bestätigtem Ersetzen, Umbenennen/Löschen und Import/Export. Der normale
Hauptmenü-Ladeweg führt in dieselbe Bibliothek. Ein fehlerhafter Ladevorgang ersetzt
die aktive Session nicht. Die Demo-Dateiverwaltung bleibt separat.
## Toto
Die bestehende Sechs-Spalten-Oberfläche ist an den tatsächlichen
[Toto-Read und die Abgabe](../desktop/toto/README.md) angebunden. Entwürfe,
Vorschläge und Kostenprüfungen sind rein; erst die bestätigte Abgabe oder
Rücknahme ändert die Karriere. Die Abrechnung bleibt am Spieltagsende.
## Stadionangebote und Bauzustand
[Stadion](../desktop/stadium/README.md) verwendet tatsächliche Blöcke,
Ausstattungen, Außenobjekte und Statistikdaten. Exakte Angebote können innerhalb
ihres Besitzers bearbeitet, bestätigt oder verworfen werden. Der Firmenpreis
bleibt bei Zieländerungen erhalten; Kosten und Bauzeiten kommen aus der Session.
Die GUI hält keine eigene Bau- oder Finanzsimulation. Beim Beenden werden
Angebotsbesitzer vor dem Speichern freigegeben.
## Eintrittseditor beim Quellenwechsel
Der vorab erzeugte Vorschau-Eintrittseditor darf nicht weiterverwendet werden,
wenn die tatsächliche Karriere die Preview-Quelle ablöst. Der Owner unterscheidet
Preview- und Enginebindung ausdrücklich: Beim ersten Engine-Binden wird der
vorhandene Editor noch vor Freigabe seines Datenproviders zerstört und mit den
Sessioncallbacks neu erzeugt. Vorschau-Welt-/Ansichtswechsel setzen diese Bindung
zurück. Das gilt für Neuanlage und Hauptmenü-Laden, nicht nur für den direkten
`--ui-career`-Einstieg. Ein eigener End-to-End-Gegenfall öffnet nach der Neuanlage
und nach Speichern/Laden den kompakten Eintrittseditor.
Der Gegenfall zu #22 wurde nativ reproduziert: SIGSEGV beim ersten
Eintrittswidget nach normaler Neuanlage, Aufruf im alten Preview-Callback.
Mit ausdrücklicher Bindungsunterscheidung öffnet derselbe Ablauf regulär.
Der anschließende lange Durchlauf ist in Silver/1080p und Matchday/720p geprüft:
Neuanlage, echtes Intro, Aufstellung/Training, Taktikbestätigung, Sparbucheinzahlung,
Stadionauftrag, Berichte, echte Dateibibliothek, Eintrittsänderung, Restore und
Hauptmenü-Laden nach vollem Prozessneustart. Beide Übergänge öffnen danach das
native Eintrittswidget. Beim Restore werden gespeicherte Daten exakt verglichen;
nur tatsächlich neu ausgestellte Camp-Angebotskennungen/Scope/Revisionsbindungen
werden separat gegen den neuen aktuellen Kontext geprüft. Anstoß bleibt gesperrt.
Das eigene Vereinsprofil bevorzugt beim Stadionnamen die tatsächlich gelieferte
Angabe des Session-Stadionreads (#23). Das gilt ausschließlich bei gleicher
stabiler Team-ID. Fehlende Stadionzuordnungen fremder Vereine werden weiterhin
als unbekannt dargestellt; es gibt keine Namens-/Reihenfolgeraten aus dem Katalog.
Ein nativer Vorher-/Nachher-Gegenfall mit derselben OBS-Datei und fünf gezielte
Bericht-/Layouttests prüfen die Anzeige.