Files
Dreierpack-Manager/docs/new_engine/phasen.md
T

114 lines
12 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.
# Phasen · Modern-Engine 0.3
Jede Phase hält das Spiel lauffähig. **Classic-Prüfung nach jeder Phase:**
`ctest -C Release -E repo_hygiene` und die Classic-Regression identisch zur
Referenz aus M0.
## M0 · Grundlage
- Classic-Referenz festhalten: Regressionsausgaben, Langläufe, Tag auf `0.3`.
- Modern-Datensatz lokal bereitstellen (privat, nicht in dieses Repository).
**Abnahme:** Referenzen liegen vor; spätere Phasen vergleichen dagegen.
## M1 · `WorldLayout` und Abzweig
- `WorldLayout` in `src/game/state.hpp`: Ligagrößen, ID-Bereiche (Liga, Amateure, Pokal-Ausländer, Nationalteams, `kNoTeam`), Kaderplätze pro Team, Pool-Offsets, Gesamtzahl der Plätze, Spieler- und Vereinsanzahl. `classic_layout()` liefert die heutigen Werte; `squad_range` liest das Layout.
- Gemeinsame Teile lesen Teambereiche aus dem Layout (`match_engine`, `rating`, `match`).
- Saisonlogik nach `src/modern/game/` kopieren (Bibliothek `bmh_season_modern`, Namespace `bmh::modern`); dort alle festen Größen aus dem [Befund](befund.md) durch Layoutwerte ersetzen.
- Vereinsbezogene Speicherblöcke werden in Modern zu Vektoren, die nach der Vereinsanzahl bemessen sind; Classic behält seine Blöcke.
**Abnahme:** Classic identisch; Modern-Kern baut und läuft mit Classic-Layout identisch zu Classic (Gegenprobe, dass der Abzweig nichts verändert hat).
## M2 · Ligen, Spielpläne, Kalender
- Spielplangenerator je Liga aus den Daten: `round-robin` (Kreismethode, jede Größe, Heim/Auswärts ausgeglichen) für die internationalen Ligen, `legacy:<n>` für die deutschen Ligen aus den Classic-Tabellen des Datensatzes.
- Kalender: Der Tagesplan der Saison wird beim Start aus dem Classic-Plan erzeugt und für die internationalen Ligen auf 38 Runden ergänzt. Ligen mit weniger Runden setzen danach aus. Tabellen, Prognose und Saisonende rechnen je Liga mit `2 × (Vereine − 1)` Spieltagen.
- Europapokal-Teilnehmer aus den internationalen Ligen werden wie bisher bestimmt, mit den neuen Teambereichen.
**Abnahme:** Synthetische Welt mit Ligen von 20, 20, 20 und 18 Vereinen spielt eine Saison vollständig durch; jede Paarung genau einmal pro Hin- und Rückrunde.
## M3 · Modern-Weltlader
- Ein Paket ist Modern, wenn `requires` `runtime:modern-v1` enthält; der Mod-Ordner darf zusätzlich `mod.json` mit `type: modern` tragen (Ansatz aus dem Modern-POC).
- Ablauf (`src/modern/content/world_loader.*`): Archiv lesen → Classic-Startzustand aus den Classic-Datenbereichen des Pakets aufbauen → Welttabellen darüberlegen (Vereine, Ligen, Kader und Reihenfolge, Spielerwerte `bmh-classic@1`, Verträge) → `WorldLayout` aus den Daten ableiten.
- Namen: `GameState` erhält UTF-8-Felder für Vor- und Nachname sowie Vereinsname und Kurzname. Texte der Engine (Post, Meldungen, Ranglisten, Konsole) verwenden in Modern einen gemeinsamen Namenszugriff.
- Asset-Schlüssel (Wappen, Porträts, Trophäen) werden unverändert an die UI weitergegeben.
- Gegenseitiger Ausschluss: Modern lehnt Classic-Pakete ab und umgekehrt.
**Abnahme:** Der Modern-Datensatz startet eine Karriere mit einem deutschen Verein; Kader, Namen und Ligen stimmen mit den Welttabellen überein.
**Umsetzung (Stand 24. Oktober 2026):**
- `src/modern/content/world.*`: typisierte Sicht auf die Welttabellen (Ligen, Vereine, Spieler, Nationen, Ligatermine).
- `src/modern/content/world_package.*`: liest aus dem Paket nur, was die Engine braucht (Manifest, Welttabellen, Classic-Nutzdaten, Classic-Grafiken); HD-Wappen und -Porträts bleiben im Archiv. Der Classic-Startzustand entsteht aus den unveränderten `x-classic`/`x-legacy`-Daten.
- `src/modern/content/world_expand.*`: bringt den Classic-Start auf die Welt. Vereins-IDs folgen den Ligamitgliedern (die vergrößerten internationalen Ligen verschieben alle IDs dahinter um 30); Tabellen pro Verein werden umgerechnet, neue Vereine übernehmen die Startwerte eines Originalvereins derselben Liga; neue Spieler erhalten ihre Werte aus den `bmh-classic@1`-Attributen; jeder Ligaverein hat 24 Kaderplätze; die Pools hinter den Kadern (Transferliste, vereinslos, Ausland, Nationalteam, 54 Reservespieler) behalten Inhalt und Reihenfolge.
- Namen und OBW-IDs für die UI liegen in `ModernState` (`world_club_name`, `player_first`, `player_last`, …); die Engine-Texte nutzen weiter die Einzelbyte-Namenspools, in die neue Namen angehängt werden.
- Probelauf: `modern_season_sim <Welt.obw> [Spielzüge] [Verein] [Startwert]`; `MODERN_DEBUG=1` zeigt die Ladeschritte, `MODERN_WATCH=<Sekunden>` meldet regelmäßig den Engine-Schritt (Endlosschleifen finden).
- Ergebnis mit dem Modern-Datensatz 1.3: zwei Saisons, rund 5.300 Spiele; alle Ligen spielen ihre Runden vollständig (deutsche Ligen 34, LaLiga/Premier League/Serie A 38, Ligue 1 34).
- Dabei gefunden und behoben: der Schiedsrichterpool (49) reicht nicht für Tage mit deutschen und vergrößerten internationalen Ligen (Modern-Abweichung), die Fairplay-Tabelle pro Ligaverein ist mitgewachsen, Kaderzuordnung über das Layout statt fester 24/16-Arithmetik.
- Offen für M6: Modern-Spielstände; die Session nutzt übergangsweise die Classic-UI-Projektionen, die dafür auf das Layout umgestellt sind.
## M4 · Trainingslager
Siehe [Trainingslager](trainingslager.md): Katalog aus den Daten, drei Regionen, Qualitätswerte 0–6, unveränderte Preisformel und Aufenthaltsgrenzen, begrenzte 6-Sterne-Wirkung.
**Abnahme:** Tests für Preis, Grenzen und Wirkung mit festen Seeds; Simulation: drei Aufenthalte in 6-Sterne-Lagern bringen einem Spitzenteam im Schnitt höchstens etwa einen Tabellenplatz.
## M5 · Datenrevision 1.4 (privat)
- Neue, nummerierte Migration des Modern-Datensatzes nach dem bestehenden Migrationsvertrag (Eingangs-Hash, Bericht, unabhängige Prüfung, Editor-Roundtrip): `runtime:modern-v1`, spielbar, Trainingslager-Katalog, Kalenderangaben für 38 Spieltage, Finanzangaben auch für die 30 neuen Vereine, ein größerer Schiedsrichter-Pool (mindestens 100, [Datenformat F9](datenformat.md#f9--schiedsrichter)) samt Engine-Anbindung.
- Werkzeug: C++ (`openbmh_world_migrate`) oder das bestehende Migrationswerkzeug der Datenpflege; vor Beginn abstimmen.
**Abnahme:** Prüfbericht ohne Fehler; Editor öffnet und speichert verlustfrei.
**Abnahme Revision 1.4 (25.10.2026):** `runtime:modern-v1` im Manifest; 18 Lager auf 3 Karten aus den Daten (`resorts`), das 6-Sterne-Lager buchbar; 100 Schiedsrichter (50 neue mit Strenge und Wahrnehmung), noch etwa 7 Doppeleinsätze pro Saison statt an fast jedem Ligatag; Geburtsdaten für alle 3.414 Spieler. Zwei Saisons ohne Abbruch, Spielstand-Rundreise identisch, zehn Saisons ohne Abbruch. Engine-Anpassungen dabei: Geburtsdaten gelten jetzt auch für die Originalspieler (`WorldPlayer::born`); das Alter stoppt bei 47, dem Maximum seines Feldes (ein 40-jähriger Torwart würde sonst nach einigen Jahren überlaufen). Offen für die Daten nur `playable: true` im Manifest (liest die Engine nicht).
**Stand Engine (erledigt):** Die Engine liest alles, was 1.4 liefern soll: `runtime:modern-v1` (F1), Ligatermine für 38 Spieltage (F3; Revision 1.3 spielt schon 38/38), den Lager-Katalog mit Karten (F4), den Schiedsrichter-Pool aus `staff` (F9). Für Finanzen (F7) braucht 0.3 nichts.
**Stand Datenpflege (25.10.2026):** Revision 1.4 ist gebaut und unabhängig geprüft (101 Prüfungen, null Fehler), zweimal bytegleich erzeugt und im ergänzten Editor verlustfrei geöffnet/gespeichert. Die Welt nennt beide Laufzeit-/Editoranforderungen, ist spielbar markiert und liefert 3 Karten, 18 Lager sowie 100 Schiedsrichter. Alle 3.414 Spieler haben `born`: bei den Originalen 2.345 aus Quellen ergänzt und 229 ausdrücklich als Simulation generiert; die 840 Ergänzungen bleiben unverändert. Original-IDs, Namen, Werte und Ressourcen bleiben erhalten. Ein Engine-Zug mit der neuen Welt ist geprüft; der unten genannte Mehrsaisontest bleibt beim Engine-Team. Der Editor-Supportfix liegt ebenfalls auf `0.3`, kein neuer Editor-Release.
**Aufgabenpaket Datenmigration 1.4 (Codex, Python-Migrationswerkzeug, privates Repo):**
1. Manifest: `requires` um `runtime:modern-v1` ergänzen, `playable: true`. `editor:world-v1` darf bleiben.
2. Trainingslager: Regel `rule:training-camps` mit `maps` (Deutschland, Europa, Naher Osten) und den 18 Lagern aus `docs/new_ui/desktop/trainingcamp` nach [F4](datenformat.md#f4--trainingslager); `x`/`y` bleiben `null`. Vorlage für Werte und IDs (`resort:0..17`): `default_camp_catalogue()` in `src/modern/game/training_camps.cpp`.
3. Schiedsrichter: mindestens 50 neue `staff`-Zeilen (`role: referee`, ohne `x-legacy`) nach [F9](datenformat.md#f9--schiedsrichter), fiktive Namen, `attributes.strictness` und `attributes.perception` je 0–3 ähnlich verteilt wie bei den 49 Originalen (`x-legacy.property`: Bits 3–4 bzw. 0–1).
4. Stabile IDs: Vereins-, Spieler- und Schiedsrichter-IDs aus 1.3 unverändert lassen (der Almanach und die Spielstände beziehen sich darauf).
4a. Geburtsdaten auch für die 2.574 Originalspieler (heute Platzhalter-Alter 16). Die Engine übernimmt das Alter dann beim Karrierestart, statt es zu würfeln ([Balance](balance.md)).
5. Bericht, Prüfung und Editor-Roundtrip wie bei 1.3; Eintrag in `DIAMOND_MIGRATIONS.md`.
Danach: `modern_season_sim` mit der neuen Welt (zwei Saisons, `SIM_CONTRACTS=1`) muss ohne Doppeleinsätze von Schiedsrichtern und mit den 18 Lagern laufen; das prüfe ich.
## M6 · Spielstände und UI-Projektionen
- Spielstände `.obs` mit `save_profile: modern-career-v1`: gleiche Hülle wie Classic, aber Modern-Zustand mit Layout und Namen; Dimensionen aus der Welt.
- Projektionen und Aktionen der `ModernSession` gemäß [UI-Schnittstelle](ui-schnittstelle.md).
**Abnahme:** Speichern und Laden mitten in der Saison setzt identisch fort; UI-Projektionen haben Tests mit synthetischen Welten.
**Umsetzung Spielstände (erledigt):**
- `src/modern/content/world_save.*`: `save_world_career` / `load_world_career`. Der Spielstand nennt seine Welt (ID und Datenrevision) und enthält nur die Karriere (Format siehe [Datenformat F8](datenformat.md)).
- Laden: `ModernSession` setzt zuerst das Classic-Layout zurück, liest den Spielstand und ruft dann `install_world_dimensions(world)` auf (aus `expand_to_world` herausgelöst), damit Layout, Ligagrößen und Kalender wieder zur Welt passen.
- Autosave und `save_game` schreiben über `save_world_career`, sobald eine Welt geladen ist (`current_world()`).
- Fehler behoben: Beim Auf- und Abstieg (`ClubsChangePlaces`) wurden die Modern-Namen (`world_club_id/name/short`) nicht mitgetauscht.
- Prüfung: `MODERN_SAVE_CHECK=N modern_season_sim …` speichert nach Zug N, lädt in eine zweite Session und vergleicht Zustand, Namen und Layout. Nach Zug 30 und 58 identisch; zwei Saisons mit `SIM_CONTRACTS=1`: 0 von 168 Vereinsnamen falsch.
## M7 · Balance
- Konsolen-Langläufe mit dem Modern-Datensatz (mehrere Startkonstellationen, je zehn Saisons): Tore pro Spiel, Punkteverteilung je Liga, Ermüdung und Verletzungen bei 38 statt 22 Spieltagen, Marktwerte und Gehälter, Finanzen des menschlichen Vereins, Wirkung der Trainingslager.
- Korrekturen zuerst in den Daten (etwa Werte der neu ergänzten Spieler, Preise), dann in Regeln; jede Regeländerung in [DIFFERENCES](../DIFFERENCES.md).
**Abnahme:** Bericht mit Kennzahlen und begründeten Anpassungen.
## M8 · Almanach: Anschluss und Schussserien
Die native Oberfläche liest Kalender, Tagespaarungen, Spielberichte und Ereignisse
über die revisionsgebundene Modern-Sessionprojektion; die getrennte Demo bleibt
eine eigene Quelle. Details stehen im [Almanach-Menü](../new_ui/desktop/almanac/README.md).
Nachbesserung vom 28. Oktober 2026 (#18): Der Recorder erfasst Elfmeterschüsse aus
dem Matchprotokoll einmalig und getrennt von Spieltoren. Die Leseprojektion
berichtigt eindeutig belegte ältere Doppelprotokolle in Kopien. Spielstandbytes,
Spielentscheidungen und RNG bleiben unverändert. Hallen- und unklare
Verlängerungs-Teilstände werden ausdrücklich behandelt. Format und Editor
benötigen keine Anpassung; [Nachweise und Grenzen](almanach.md).