154 lines
9.0 KiB
Markdown
154 lines
9.0 KiB
Markdown
<!-- SPDX-License-Identifier: GPL-3.0-only -->
|
||
# Speichern, Laden und Desktopansichten
|
||
|
||
Die native RmlUI-Fassung überträgt den privaten HTML-Goldstand der Dateien
|
||
`desktop/save-load-menu.js`, `desktop/save-load-window.css`,
|
||
`desktop/modern-dialogs.js` und `desktop/desktop-views.js`. Referenzrevision:
|
||
`4b1c3b61ccd7b19351cd0b2dfac1006918103c97`. Die Referenz bleibt privat und
|
||
unverändert; diese öffentliche Implementierung enthält keine Originalgrafiken
|
||
oder Originalspielstände. Ausgangsstand der nativen Umsetzung ist `db89d88`.
|
||
|
||
## Sichtbare Ansichten
|
||
|
||
Spielstände verwenden den gemeinsamen Untermenürahmen mit 2720 × 2040
|
||
Entwurfseinheiten. Die Desktopansichten verwenden das eigenständige
|
||
Desktopdialogfenster mit 2560 × 1840 Einheiten. Beide haben eine unbegrenzt
|
||
scrollbare Liste, eine getrennte Detailansicht und bestätigte Aktionen für
|
||
Überschreiben, Umbenennen und Löschen. „Neuer Speicherstand“ beziehungsweise
|
||
„Neue Ansicht“ erscheint nur beim Speichern. Fehlende oder beschädigte Dateien
|
||
bleiben mit einer Fehlermeldung erkennbar.
|
||
|
||
Die Karriereübersicht zeigt Saison, Spieltag, Spieldatum, Manager und Vereine
|
||
aus dem ausgewählten Dokument. Nur ein neuer Eintrag zeigt die aktuelle
|
||
Karriere. Die Demo befindet sich ohne gesonderte gespeicherte
|
||
`game_info.matchday`-Angabe in der Vorbereitung; hier wird kein zukünftiger
|
||
Engine-Spieltag erfunden. Die Saison folgt dem gespeicherten Spieldatum und
|
||
beginnt im Juli. Speicherdatum, Dateigröße und Änderungsdatum stammen aus dem
|
||
Dateianbieter. Namen werden vor der Anzeige als RmlUI-Text maskiert.
|
||
|
||
Die Ansicht „Standard“ ist eine unveränderliche, immer verfügbare Vorlage.
|
||
Sie verwendet beim Laden den aktuellen Look. Ihre Vorschau wird unmittelbar
|
||
aus der Standardgeometrie gezeichnet; sie ist kein Screenshot einer heimlich
|
||
auf die aktive Karriere angewendeten Ansicht. Eigene Ansichten enthalten den
|
||
tatsächlichen Desktop-Screenshot zum Speicherzeitpunkt sowie Anordnung,
|
||
Widgetgrößen, Sichtbarkeit, Fixierungen und Look. Der Screenshot entsteht ohne
|
||
Dateidialog und ohne das darüberliegende Verwaltungsfenster.
|
||
|
||
## Lokale Dateitransaktionen
|
||
|
||
`DemoFiles` speichert ausschließlich UI-Demostände; es liest und schreibt keine
|
||
OBS-/Engine-Karriere. Die Ablage liegt unter dem weltbezogenen
|
||
`userdata/ui-demo/<world-hash>/saves` beziehungsweise `layouts`. Der explizite
|
||
Parameter `--ui-userdata` erlaubt eine vollständig isolierte QA-Ablage.
|
||
Globale Anzeige-, Sound- und Themenpräferenzen bleiben in ihrer eigenen Datei.
|
||
|
||
Ein Datensatz ist ein Dokument mit Schema `openbmh-ui-file@1`. Es enthält
|
||
Bezeichnung, Art, Zeitstempel, Payload, Welt-ID, Hash der Weltmanifestrevision,
|
||
PNG-Vorschau und separate Inhaltsprüfsummen. Die PNG-Bytes werden verlustfrei
|
||
hexadezimal eingebettet. Deshalb werden Layout und Screenshot mit **einem**
|
||
atomaren Dateiaustausch veröffentlicht. Die Dateinamen sind opake IDs und
|
||
werden nicht aus Benutzernamen zusammengesetzt. Eine umbenannte Ansicht
|
||
behält Identität, ursprünglichen Speicherzeitpunkt und Vorschau.
|
||
|
||
Vor der Veröffentlichung werden Karriere und Desktop in isolierten Objekten
|
||
validiert. Karriereprüfungen nutzen die bestehenden `DemoSource`-Regeln. Die
|
||
aktive Quelle wird erst nach erfolgreicher Validierung ersetzt. Entwürfe
|
||
binden sich an Welt, Source-Objekt und Source-Revision. Bestätigungen tragen
|
||
zusätzlich den SHA-256-Token der ausgewählten Dateiversion. Ein inzwischen
|
||
geänderter, gelöschter oder fremder Datensatz wird zurückgewiesen.
|
||
|
||
Ein kurzlebiges Transaktionsverzeichnis serialisiert Anbieteroperationen.
|
||
Fehlgeschlagene Schreibvorgänge behalten den bisherigen Datensatz. Löschen
|
||
verwendet eine atomare Umbenennung; bei einem unterbrochenen Aufräumen bleibt
|
||
die Datei als versteckter, wiederherstellbarer Rest erhalten. Ein nach einem
|
||
Prozessabsturz verbliebenes Transaktionsverzeichnis wird nicht ungeprüft
|
||
entfernt: Nach Beenden aller beteiligten Prozesse muss es geprüft werden.
|
||
Symlinks und Pfadwechsel aus der Ablage werden zurückgewiesen. Abgeleitete
|
||
PNG-Vorschaudateien unter `.previews` sind nur ein durch Hash identifizierter
|
||
Cache; sie sind nie die autoritative gespeicherte Vorschau.
|
||
|
||
Namen besitzen 1 bis 64 Unicode-Zeichen und keine Steuerzeichen. Der
|
||
plattformunabhängige Vergleich berücksichtigt Groß-/Kleinschreibung,
|
||
deutsches ß, Ö/ö und komponierte/dekomponierte lateinische Tastaturakzente.
|
||
Ansichten berücksichtigen zusätzlich vollbreite ASCII-Kompatibilitätszeichen;
|
||
„Standard“ bleibt dabei reserviert. Speichernamen verwenden diesen
|
||
Kompatibilitätsschritt nicht. Die kleine portable Hilfe ist kein vollständiger
|
||
Unicode-NFC-/NFKC-Normalisierer: Seltene kombinierte Schriftzeichen außerhalb
|
||
der dokumentierten lateinischen Akzente bleiben bytegenau unterscheidbar.
|
||
Diese Grenze betrifft die Namen, nicht die Dateiinhalte oder Spielvalidierung.
|
||
|
||
Ältere rohe Demo-JSON-Spielstände und Layoutdateien werden gelesen, aber beim
|
||
Navigieren nicht umgeschrieben. Vorhandene PNG-Seitendateien können in ein
|
||
neues konsistentes Dokument übernommen werden. Alte Ansichten ohne Vorschau
|
||
zeigen einen ausdrücklichen Hinweis; vor der Veröffentlichung einer neuen
|
||
Ansichtsdatei ist eine gültige Vorschau erforderlich.
|
||
|
||
## Aktionen und Zustandsgrenzen
|
||
|
||
Import und Export sind ausdrückliche Buttonaktionen. Erst dann öffnet NFD
|
||
einen Betriebssystemdialog. QA kann mit `--ui-file-import` und
|
||
`--ui-file-export` konkrete Pfade bereitstellen; die Parameter lösen allein
|
||
keine Dateiaktion aus. Import validiert das Dokument vollständig und legt
|
||
einen neuen, bei Namenskonflikten umbenannten Eintrag an. Es wird kein
|
||
bestehender lokaler Stand überschrieben und keine Karriere automatisch
|
||
geladen. Export enthält Payload und Vorschau gemeinsam; ein vorhandenes
|
||
Ziel benötigt eine separate Überschreibbestätigung.
|
||
|
||
Karriere-Save setzt Source und Karriere-Desktop erst nach erfolgreicher
|
||
Veröffentlichung auf „gespeichert“. Karriere-Load setzt den ausgewählten
|
||
validierten Stand samt Layout auf „gespeichert“. Ansichts-Save verändert diese
|
||
Karrieremarkierungen nicht. Ansichts-Load erzeugt einen Desktop-Undo-Schritt,
|
||
speichert die globale Themenpräferenz zuerst und übernimmt anschließend
|
||
Layout und Look. Andere Anzeige- oder Soundwerte werden dabei nicht aus dem
|
||
Spielstand übernommen.
|
||
|
||
Die Root-Glue-Hooks `files_saved_success(bool)` und `files_loaded_success()`
|
||
verantworten den Rücksprung ins Hauptmenü, die Fortsetzung eines bestätigten
|
||
Beenden-Ablaufs und das Zurücksetzen sourceabhängiger Presenter. Abbrechen
|
||
und Escape verwerfen nur lokale Dateifensterentwürfe und die ausstehende
|
||
Beenden-nach-Speichern-Absicht. Navigation, Auswahl und Vorschau verändern die
|
||
aktive Karriere nicht.
|
||
|
||
## Prüfung und offene Enginefragen
|
||
|
||
`tests/modern_files_ui_tests.cpp` verwendet nur eine synthetische Welt und
|
||
temporäre QA-Dateien. Es prüft Namenskonflikte, atomare Payload-/PNG-Rundläufe,
|
||
veraltete Tokens, beschädigte Importe, fehlgeschlagene Überschreibungen,
|
||
Transaktionskonflikte, ausgewählte Dateimetadaten, Exportkollisionen, getrennte
|
||
UI-Präferenzen und den Rollback fehlgeschlagener Karrierevalidierung.
|
||
Ein Build und native Screenshot-/Interaktionsprüfungen müssen separat
|
||
ausgeführt werden; die Testquelle allein belegt kein Plattformverhalten.
|
||
|
||
Die spätere Engineanbindung muss den gemeinsamen Karriere-/Sessionanbieter
|
||
verwenden. OBS-Migration, Managerbesitz, Engine-Revisionen, RNG-Zustände,
|
||
Autosaves und echte Saisonfortschritte werden hier ausdrücklich nicht als
|
||
implementiert behauptet. Sie gehören nicht in diesen UI-Demodateianbieter.
|
||
|
||
## Bewusste Abgrenzungen zum Browser-POC
|
||
|
||
Ansichten und Arbeitsanordnung liegen in dieser nativen Demo im weltbezogenen
|
||
UI-Verzeichnis; vorhandene ältere native Layouts bleiben so erreichbar. Der
|
||
Browser-POC speichert diese Bibliothek browserglobal. Anzeige und Sound bleiben
|
||
nativ unabhängig von der Welt gespeichert. Das Laden einer Karriere setzt
|
||
diese globalen Präferenzen nicht zurück; eine benannte Ansicht darf dagegen
|
||
ihre ausdrücklich gespeicherte Gestaltung wiederherstellen.
|
||
|
||
Erfolgreiches Speichern und Laden einer Karriere lässt das Dateifenster mit
|
||
Auswahl und Rückmeldung offen. Ansichts-Speichern und -Laden kehren zum Desktop
|
||
zurück. Arbeitsanordnungen lösen keinen Spielstand-Speicherbedarf aus.
|
||
|
||
## Gespeicherte Person und Nationalrolle
|
||
|
||
Savekopf und Mitspieler-Untertext beziehen sich auf den tatsächlich ausgewählten
|
||
Slot. `career.role` und `career.active_portrait` stammen aus dessen Payload, nicht
|
||
aus dem aktuellen Betrachter und nicht pauschal aus Person0. Ein gespeicherter
|
||
Nationalcoach zeigt Deutschland samt GUI-Flagge; die intern kompatible
|
||
Vereinsreferenz wird nicht als dessen Mannschaft ausgegeben. Bei kombinierten
|
||
Karrieren behalten die anderen gespeicherten Personen ihre Vereinsbeschriftung.
|
||
|
||
Der gezielte native Test speichert tatsächlich eine Nationalansicht von Robin
|
||
und betrachtet sie anschließend mit einer anderen laufenden Vereinsrolle/Person0.
|
||
Der rechte Kopf und Robins Zeile zeigen weiter Deutschland; der laufende
|
||
Viewer-Source bleibt unverändert. Es werden ausschließlich Metadaten gelesen,
|
||
kein Karrierepayload oder Enginezustand umgebaut.
|