Complete Modern desktop widgets and file libraries (by Codex)
This commit is contained in:
1 parent
db89d889f7
commit
31bcf93205
43 files changed
+3134
-484
No files matched your search
@@ -80,3 +80,10 @@ Privates Repository `bmh_4k_ui`, Commit `19969d430e38eadae7ff7a9d1fb381ab02c395d
|
||||
[Transfers: Ablöse-Kasten und Abstand der Positionsfilter](transfers/README.md).
|
||||
|
||||
[Eintrittspreis: kompakter Schieberegler mit Bestätigung](entry-price/README.md).
|
||||
|
||||
## Native Umsetzung
|
||||
|
||||
Die [Widgetdokumentation](widgets/README.md) beschreibt den nativen Katalog,
|
||||
Raster und Arbeitsanordnung; die [Dateiverwaltung](save-load/README.md) die
|
||||
getrennten Karriere- und Ansichtsdateien. Beide lesen weiterhin Demodaten und
|
||||
bestätigen keine Engine-Spielbarkeit.
|
||||
@@ -0,0 +1,138 @@
|
||||
<!-- 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.
|
||||
@@ -0,0 +1,54 @@
|
||||
# Desktop und Widgets · native Umsetzung
|
||||
|
||||
Stand: 26. Oktober 2026. Referenz ist der unveränderte private HTML-Goldstand
|
||||
`4b1c3b61`, insbesondere modern-layout.js, modern-desktop.js/.css und
|
||||
modern-dialogs.js. Die bisherige HD-Oberfläche bleibt erhalten.
|
||||
|
||||
Der Desktop enthält 32 Appbuttons und 17 Widgettypen mit insgesamt 48
|
||||
Größenvarianten. Die Standardansicht zeigt acht Widgets; sämtliche Elemente
|
||||
sind zunächst fixiert. Das Raster verwendet 224-Punkte-Zellen, 24 Punkte
|
||||
Abstand und einen Ursprung bei 64/224 im logischen 3840×2160-Raum.
|
||||
Alle drei Themes und der proportional skalierte Desktop bleiben erhalten.
|
||||
|
||||
Kalender, Konto/Eintritt, nächste Begegnung, Managerporträt und Vereinswappen
|
||||
übernehmen die Referenzgeometrie. Warnlampen zeigen zehn Zustände; die breite
|
||||
4×1-Variante fasst Sondertraining/Erschöpfung und Startelf/Ersatzspieler zu
|
||||
acht Lampen zusammen. Sie lassen sich für einen erklärenden Hinweis anklicken.
|
||||
Konto, Werbeverträge, Aktien und Trainings-/Kaderdaten stammen aus dem gemeinsamen
|
||||
UI-Demostand. Fan-Stimmung, Saisonkurven, Form, Platz/Stärke und direkte Duelle
|
||||
bleiben klar benannte Pseudodaten. Diagramme verwenden die Pfade und Werte der
|
||||
HTML-Referenz; sie berechnen keine Ergebnisse oder Tabellenregeln.
|
||||
|
||||
Die Widgetgalerie bietet Vorschauen, Suche und jede freigegebene Größe. Ein
|
||||
hinzugefügtes Widget wird als vorhanden markiert; die Galerie bleibt offen.
|
||||
Im Raster führt Platzmangel zu vollständigem Rollback. Frei platzierte Widgets
|
||||
können sich überlagern. Eine gemeinsame Größenbasis lässt 4×1 und 3×3 exakt an
|
||||
Appbutton-Zellen anschließen. Hintergründe haben einen eigenen Auswahldialog;
|
||||
bisher ist ausschließlich das vorhandene Nachtstadion freigegeben.
|
||||
|
||||
Das Rechtsklickmenü folgt dem Goldlayout und bleibt unabhängig von der
|
||||
Desktopskalierung 270 physische Pixel breit. Es unterscheidet Desktop- und
|
||||
Objektaktionen. Fixierte Elemente lassen sich weder verschieben, verkleinern
|
||||
noch entfernen. Rasterumschalten und Anordnen erhalten fixierte Positionen;
|
||||
fehlender Platz übernimmt keine Teilanordnung. Rückgängig hält bis zu 40 Stände.
|
||||
Bewegliche Widgets können auf den Papierkorb gezogen werden; Appbuttons bleiben
|
||||
erhalten. Escape verwirft eine laufende Bewegung. Pfeiltasten bewegen im Raster
|
||||
um eine Zelle, frei um 24 Punkte beziehungsweise mit Umschalt um 96 Punkte.
|
||||
|
||||
Die Arbeitsanordnung wird atomar als `working-desktop.json` im weltbezogenen
|
||||
UI-Demoverzeichnis gespeichert. Sie verändert weder Quellenrevision noch
|
||||
Spiel-Dirty. Ein ausdrücklich angegebener `--ui-state` hat Vorrang; kaputte
|
||||
Arbeitsanordnungen werden gemeldet und bis zur bewussten Änderung erhalten.
|
||||
Benannte Ansichten sind davon unabhängig und werden mit Theme und tatsächlicher
|
||||
PNG-Vorschau in der [Dateiverwaltung](../save-load/README.md) gespeichert.
|
||||
|
||||
Spiel beenden bietet eine eigene Rückfrage. Nur geänderte Spielwerte erzeugen
|
||||
Speicherbedarf; Änderungen an Layout oder globalen UI-Präferenzen zählen nicht
|
||||
dazu. Nach Speichern/Verwerfen geht es zum Hauptmenü, beim OS-Schließen endet
|
||||
die Anwendung. Abbrechen lässt die laufende Partie offen. Anstoß bleibt ohne
|
||||
Aktion; Match-Engine, Audiosystem und Stadionperipherie gehören nicht zum Paket.
|
||||
|
||||
Native Bildnachweise, Eingabeskripte und passende UI-Democheckpoints liegen privat
|
||||
unter `bmh_4k_ui/docs/qa/desktop-files-batch-2026-10-25/`. Öffentliche Tests verwenden
|
||||
synthetische Kataloge. Build-/Control-CI ist von einer tatsächlichen nativen
|
||||
Windows-/macOS-Spielabnahme zu unterscheiden.
|
||||
Reference in new issue
Block a user