Files
Dreierpack-Manager/docs/new_ui/desktop/transfer/README.md
T

182 lines
9.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Kader und Transfermarkt · native Modern UI
Stand: 25. Oktober 2026. Maßgeblich ist der aktuelle private HTML-Stand
`bmh_4k_ui`, Referenz `23845730`: `desktop/transfer-menu.js`,
`transfer-window.css`, `career-menus.css` und die Einbindung in
`management-menus.js`. Die späteren Regeln in `transfer-window.css`
überschreiben frühere Größen. Die aktuelle Vorlage zeigt vier numerische
Mannschaftsstärken; frühere Zylinderdiagramme werden nicht reaktiviert.
Native Quellen sind
[demo_transfer.hpp](../../../../src/modern/ui/demo_transfer.hpp),
[demo_transfer.cpp](../../../../src/modern/ui/demo_transfer.cpp),
[transfer_screens.inc](../../../../src/modern/ui/transfer_screens.inc),
[transfer_controls.inc](../../../../src/modern/ui/transfer_controls.inc)
und [transfer.rcss](../../../../assets/modern/transfer.rcss).
Private Bilder, Namenstabellen und Weltdateien gehören nicht in öffentliche
Tests oder dieses Dokument.
## Übersicht und Auswahl
Links steht der gesamte eigene Kader mit stabilen Spieler-IDs in der
Katalogreihenfolge. Es gibt keinen Schnitt bei sechzehn Spielern:
20er- und 24er-Kader bleiben vollständig auswählbar und scrollbar.
„Daten A“ zeigt Position, Fuß, Typ, Kondition, Technik, Form und Stärke;
„Daten B“ Alter und die sieben vorhandenen Fähigkeiten. „Komplett“
verbreitert den Kaderbereich und zeigt weitere vorhandene Werte.
Unbekannte Angaben erscheinen als „—“, bekannte Nullen als `0`.
Rechts stehen sechs Marktangebote pro Seite, Namenfeld und Finden,
Preis-/Restkapitalvorschau, Positionsfilter, Mannschaftsstärken und die
Geschäftsaktionen. Die Seitenpfeile und Rechtsklick auf die Angebotsfläche
wechseln die Seite. Maus- und Tastaturfokus auf einer Angebotszeile ändern
nur die Vorschau. Der gewählte Spieler bleibt davon getrennt.
Tippen im Namenfeld verändert zunächst ausschließlich den lokalen
Texteingabeentwurf. Erst Finden oder Enter übernimmt die Suche.
Die Suche unterstützt bis zu vierzig Unicodezeichen und berücksichtigt
Groß-/Kleinschreibung sowie geläufige lateinische Akzente, etwa
Müller/Muller, Öztürk/Ozturk und François/Francois.
Der Suchdialog bietet Positionen, Alters- und Stärkeintervalle,
Kondition/Technik/Form als Vergleichsgrundlage, Spielweise, Spielseite und
maximale Preisvorstellung. Mindestens eine Position und ein Vergleichswert
bleiben ausgewählt. „Vorschlag“ setzt einen bearbeitbaren Entwurf anhand
der aktiven Mannschaft auf. „Aktive“ verwendet ausschließlich die von der
Aufstellung gelieferten aktiven IDs; „Team“ den vollständigen eigenen
Kader. Der Transfermarkt erzeugt keine zweite Startelf.
## Angebote und Vormerkungen
Eigene Spieler lassen sich zum Verkauf oder Verleihen vormerken.
Ein zum Verkauf bereits gelisteter Spieler wird mit „Vom Markt nehmen“
wieder aus der eigenen Transferliste entfernt. Es können höchstens drei
eigene Spieler gleichzeitig gelistet sein. Kaufen und Ausleihen öffnen
Angebote für fremde Marktspieler; Abwerben öffnet Land, Liga, Verein und
dessen vollständigen tatsächlichen Kader.
Der Angebotsdialog enthält Spieler-/Vereinsdaten, fiktiven Marktwert oder
Leihgebühr, Gehaltswunsch beziehungsweise vorhandenes Demomonatsgehalt,
Ablöse/Leihgebühr, Monatsgehalt, Dauer und sieben Prämien. Bei Leihe sind
12/24 Monate, sonst 12/24/36/48 Monate zulässig. Spieler-Info und Team-Info
führen zurück zum unveränderten Angebot. Kader-, Angebots- und
Dialogscrollpositionen werden dabei lokal erhalten.
Geldfelder öffnen die gemeinsame Zahleneingabe mit zweiter Bestätigung.
Ablöse verwendet Vorschläge in 100.000er-Schritten, Monatsgehalt 5.000,
Suchbudget 500.000 und Prämien 1. Die Werte bleiben nach Bestätigung ein
lokaler Entwurf. Erst „Angebot“ speichert den vorläufigen Transferauftrag.
Abbruch verwirft ihn vollständig. Ein alter Welt-/Club-/Revisionsbezug
berechtigt keine spätere Bestätigung auf einem veränderten Stand.
Die Auftragsliste hält höchstens fünfzig Aufträge und erlaubt Rücknahme.
Ein erneutes eigenes Verkaufs-/Verleihangebot ersetzt den Auftrag dieses
Spielers; Kauf und Leihe bleiben wie im HTML getrennte Auftragsarten.
Die Rücknahme des eigenen Auftrags entfernt auch dessen Listierung.
Es gibt keinen zusätzlichen Tauschhandler, weil die aktuelle Vorlage
keinen solchen Ablauf enthält.
**Vormerkungen führen keinen Transfer aus.** Sie verändern weder echte
Kaderzuordnung, Spieler-/Vereinsdaten, Konto, Sparbuch, Schuld,
Spielerverträge noch Mannschaftsaufstellung. Ein Angebot über dem
verfügbaren Kapital bleibt als negative Vorschau und bloßer Auftrag
zulässig; es wird keine neue Zahlungsregel erfunden.
## Zustand und Währung
`state.transfer` besitzt ausschließlich:
```text
club, query, positions, criteria, listed, orders
```
`club` bindet den Zustand an den ersten verwalteten Verein. `listed`
enthält eigene stabile Spieler-IDs. Ein Auftrag enthält
`kind`, `player`, `source_club`, `fee`, `salary`, `months`, `bonuses` und
`poached`. Die Quelle muss zum tatsächlichen Katalogspieler passen.
Fremde Spieler außerhalb des Demo-Markts können nur über das ausdrücklich
markierte Abwerben vorgemerkt werden.
Alle gespeicherten Geldwerte einschließlich Suchbudget und Prämien sind
Minor Units aus `manifest.currency`. Bei null Nachkommastellen gilt
Faktor 1, bei zwei Faktor 100. Editoraktionen übergeben ganze angezeigte
Währungseinheiten; der Provider rechnet genau einmal um. Ablösen liegen
zwischen 0 und 99.999.999, Monatsgehälter zwischen 0 und 200.000,
Prämien zwischen 0 und 100 angezeigten Einheiten. Ein bestätigter Entwurf
schreibt ausschließlich `state.transfer`.
Suche und übernommenes Suchprofil bleiben im UI-Demostand erhalten.
Änderungen von Suche, Profil oder Positionsfilter erhalten vorhandene
Aufträge und Listierungen. Tab, Komplettansicht, Stärkengrundlage,
Seitennummer, Auswahl, Hovervorschau und sämtliche Dialogentwürfe sind
flüchtige App-Daten. Beim Wechsel des ersten verwalteten Vereins setzt
die Datenquelle den Transferzustand für den neuen Verein zurück.
`migrate_demo_transfer()` ergänzt nur ein vollständig fehlendes
Transferfeld. Vorhandene beschädigte Bestände, unbekannte Felder,
fehlerhafte IDs, doppelte Auftragsziele, unzulässige Laufzeiten und
überschrittene Limits werden atomar abgewiesen. Bestehende gültige
Minorwerte werden dabei nicht still gerundet.
## Datenquelle und Referenzgrenzen
Namen, Spieler-/Vereins-IDs, Fotos, Positionen, Nationalitäten,
Geburtsdaten und vorhandene Attribute kommen aus dem unveränderten
Katalog. Alter wird aus `born` zum Demodatum berechnet. Ein im Datensatz
klar fiktiv erzeugtes Geburtsdatum bleibt eine Datensatzangabe, keine
Behauptung einer unabhängig verifizierten Biografie.
**OpenBMH deviates from the original:** Die zwölf erfundenen
HTML-Marktpersonen werden durch einen deterministischen zwölfköpfigen
Ausschnitt tatsächlicher fremder Katalogspieler ersetzt. Kleinere oder
leere Kataloge erzeugen entsprechend weniger Angebote. Eigene
Listierungen kommen zusätzlich hinzu. Abwerben zeigt alle tatsächlichen
Spieler des gewählten Vereins. Fehlende Werte werden nicht aus den
HTML-Formeln für Kondition, Technik, Fähigkeiten oder Saisonstatistik
erfunden. Preise, Gehaltsforderungen und vorläufige Angebote bleiben
hingegen ausdrücklich fiktive UI-Daten.
Die logische Inhaltsfläche beträgt 2612 × 1864. Der Kaderbereich ist
1480,96875 breit; rechts folgt nach 34 Abstand der 1097,03125 breite
Marktbereich. Die sechs Angebote stehen über Vorschau, Filtern und vier
numerischen Stärkewerten. Der Angebotsdialog ist 2200 × 1210,5 groß,
der Suchdialog 2200 × 899. Native Auswahllisten verwenden die bestehenden
RmlUI-Steuerelemente und erhalten den Fokus nach dem Schließen.
## Prüfstand und Enginegrenze
Synthetische Prüfungen in
[modern_transfer_ui_tests.cpp](../../../../tests/modern_transfer_ui_tests.cpp)
sind erfolgreich: 0/2/20/24 eigene Spieler, volle fremde Kader,
beide Währungspräzisionen, drei Listierungen, fünfzig Aufträge,
Ersetzung/Rücknahme, Unicode-/Akzentsuche, korrekte `born`-Verwendung,
unbekannte Werte, ungültige Aktionen, strenge Migration,
Speicher-Roundtrip und unveränderte Welt-/Fremdmodelldaten.
Eine isolierte Syntaxprüfung der integrierten Ansicht ist ebenfalls grün.
Die gemeinsame Integration und alle 26 Regressionstests sind grün. Die
native Linux-Prüfung deckt Midnight, Silver und Matchday jeweils in
1920 × 1080 und 1280 × 720 ab. Geprüft sind Geldentwurf und zweite
Bestätigung, Info/Zurück/Abbruch, Angebot und Auftragsrücknahme, drei
eigene Listierungen mit atomarer Ablehnung der vierten, vollständiges
Abwerben, Suchbudget null, Suche erst bei Enter, Pickerabbruch und
Rechtsklick-Seitenwechsel. Ein echter UI-Checkpoint mit vorgemerktem
Auftrag wurde in einem neuen Prozess mit identischem Modell geladen.
Ein gezielter Nutzerscroll erreicht den zwanzigsten eigenen Spieler.
Auswahl und Scrolloffset bleiben nach Angebot → Spielerinfo → Zurück →
Abbruch erhalten. Die Wiederherstellung läuft genau einmal nach einem
DOM-Neuaufbau; ein flüchtiger interner `restore_scroll`-Schalter verhindert,
dass spätere Frames den Nutzeroffset zurücksetzen. Dieses Feld gehört
ausschließlich zur lokalen Ansicht und wird nicht im Demomodell gespeichert.
Private Bilder, passende Diagnose-Snapshots, echte UI-Checkpoints, JSONL-
Abläufe, Hashmetadaten und ein portabler Replay-Helfer liegen ausschließlich
im privaten Paket `bmh_4k_ui/docs/qa/squad-batch-2026-10-25/transfer/`.
Diagnose-Snapshots sind keine ladbaren Spielstände; die sichtbare flüchtige
Dialogauswahl wird durch den jeweiligen Ablauf reproduziert.
Der spätere Modern-Sessionadapter muss echte Transferregeln, Zustimmung,
Kaderwechsel und Buchungen liefern; dieses Paket ruft keine Engine,
Classic-Initialisierung oder Zufallsquelle auf.