From a779db7f73caada2ad13edbe538ca84f48045285 Mon Sep 17 00:00:00 2001 From: Codex Date: Tue, 27 Oct 2026 01:16:11 +0100 Subject: [PATCH 1/2] Provide a concise staged engine-to-UI handoff for the first text-only build (by Codex) --- docs/new_ui/integration/MVP_FOR_CLAUDE.md | 75 +++++++++++++++++++++++ docs/new_ui/integration/OPEN_DECISIONS.md | 5 +- docs/new_ui/integration/README.md | 6 +- 3 files changed, 82 insertions(+), 4 deletions(-) create mode 100644 docs/new_ui/integration/MVP_FOR_CLAUDE.md diff --git a/docs/new_ui/integration/MVP_FOR_CLAUDE.md b/docs/new_ui/integration/MVP_FOR_CLAUDE.md new file mode 100644 index 0000000..261fbe7 --- /dev/null +++ b/docs/new_ui/integration/MVP_FOR_CLAUDE.md @@ -0,0 +1,75 @@ + +# Kurzübernahme für Claude: erste echte UI-Anbindung + +Ziel ist eine spielbare erste Modern-UI mit **Live-Ticker als einziger Matchansicht**. +JSON bleibt die Austauschform. Die ausführlichen Schemas sind ein Arbeitsentwurf; +wir müssen nicht vor dem ersten Menü alle 75 Definitionen implementieren oder +Engine-Interna auf ein neues Protokoll umschreiben. Ein schlanker Adapter um die +vorhandenen C++-Dienste und `ModernSession::read()` genügt als erster Schritt. + +## Zuerst fest vereinbaren + +1. **Maßgeblicher Engine-Ref:** Öffentlich geprüft sind `0.3` mit Modern-Code + und `main` ohne `src/modern`. Bitte den tatsächlichen Integrationszweig benennen. +2. **Gemeinsamer Kontext:** Welt/Karriere, stabile Manager- und Team-ID, aktive + Rolle Verein/National, Spielphase, Zustandsrevision und verfügbare Aktionen. + Ein Anzeigename, Porträtindex oder Tabellenplatz darf keine fachliche ID sein. +3. **Einheiten explizit:** Aktuelle Engine-Reads und HTML-Beispielwerte sind teils + ganze Euro, native Demo-Werte teils Cent. Zunächst bestehende Enginewerte samt + Einheit liefern; der Adapter rechnet genau einmal am passenden Formatter. + Der Decimalstring-/Minor-Unit-Vorschlag im großen Schema ist keine Voraussetzung + dafür, bereits korrekte vorhandene Daten anzubinden. +4. **Reads und Aktionen trennen:** Menülesen, Sortieren und Manager-Vorschau + verändern keinen Spiel-RNG oder Spielstand. Geld-/Vertragsaktionen verwenden + bestehende bindende Angebote und eine geprüfte Revision. Die UI sperrt weitere + Bestätigungen während eines laufenden Aufrufs. + +## Lieferreihenfolge + +| Lieferung | Benötigte autoritative Daten | +| --- | --- | +| A · Karriere/Schreibtisch | Mod/Welt, Datum/Saison/Spieltag, 1–4 aktive Menschen, aktuelles Team, Bankstand mit Einheit, verfügbare Menüs/Widgets und Warnungen. Neuer Spielstart setzt Modus3. Club/Nationalauswahl: mindestens eines aktiv, bestehende Originalgrenzen beibehalten. | +| B · Vorbereitung | Kader mit stabilen Spieler-IDs, Positionen, Werten und Status; Aufstellung/Taktik/Training, Nominierungen, verfügbare Termine und Trainingslager. National- und Indoor-Aufgebot ausdrücklich deklarieren. | +| C · Geschäft/Planung | Bestehende Bank-, Stadion-, Transfer-, Vertrags-, Werbe-, Freundschafts- und Verlegungsprojektionen. Jede verfügbare Mutation mit ihren tatsächlichen Grenzen, Kosten und Angeboten. Noch fehlende Dienste als unavailable kennzeichnen. | +| D · Live-Ticker | Ein gemeinsamer Live-Snapshot: einzigartige Paarungen, beide Seiten/Logos, zuständige menschliche Manager, Zeit/Periode, Ergebnis, sequenzierte Text-/Ereignismeldungen, Aufstellungen/Bank, Statistik und Live-Tabelle. Auswahl rechts ist eine unabhängige Informationsansicht. | +| E · Eingriff/Nachspiel | Eingriff für genau den geprüften Manager/Matchkontext, gemeinsame Pausen-/Fortsetzungsregeln, bestätigte Änderungen, abgeschlossene Ergebnisse und zulässige Nachspielschritte. Ein Rückblick darf keine Saison fortsetzen. | +| F · Manager/Nachrichten | Aufgeben mit Vorschau/Bestätigung: KI-Übernahme bei verbleibenden Menschen, sonst GameEnd; stabile historische Identität behalten. Join über vorhandenen Mechanismus. Presseereignisse mit stabiler Vorkommnis-ID und fachlichem Payload. | + +Eine Lieferung muss nicht bis F warten. Root kann A/B direkt in die native UI +binden und die übrigen Bereiche im ausdrücklich getrennten Demo-Modus prüfen. +Die UI darf fehlende reale Daten nicht still durch ihre Dummyformeln ersetzen. + +## Almanach für Statistiken + +Benötigt werden Saison/Wettbewerb/Runde, stabile Team-/Spieler-/Manager-/Match-IDs, +Ergebnisse getrennt nach regulärer Zeit, Verlängerung und Elfmeterschießen, +Aufstellungen und Bank, Einsätze, Ereignisreihenfolge und die belegten Tor-/Vorlagen-/ +Karten-/Verletzungs-/Wechselinformationen. Auch Nichtteilnahme und unvollständige +Nationalkader müssen unterscheidbar bleiben. Details: [ALMANAC.md](ALMANAC.md). + +- **Fairplay:** Rohkategorien plus Punkte nach der vorhandenen Engine-Regel + liefern; die Oberfläche erfindet keine Gewichtung für Gelb-Rot. +- **Spielerstatistik:** Tore, belegte Vorlagen, Gelb und Rot sowie Einsatzbasis. + Aktuell sind Indoor-/Rotationskader gegenüber einer pauschalen ersten Elf zu prüfen. +- **Erfolge/Sieger/Serien:** Endtabellen, Wettbewerbsteilnahme und erreichte Runde. +- **Highscore:** Vorhandenen Enginewert und Regelkontext liefern; nicht aus Titeln + in der UI nachbauen. Finanzen, Transfers und Amtszeiten brauchen zusätzliche + Historien, sofern sie nicht bereits an anderer Stelle gespeichert werden. + +Historische Unsicherheiten bleiben `null`/unavailable mit Grund. Eine nachträgliche +Archivkorrektur-API oder neue Administrationsoberfläche ist für die erste +schreibgeschützte Almanachansicht nicht erforderlich. + +## Kontextgrenzen + +Ausländische Clubs sind zunächst nur anschaubar, nicht als Managerteam wählbar. +National-Desktop und Liveansicht erhalten ihre eigenen Capabilities. Hallenfußball +hat sechs gleichzeitige Spieler und elf Plätze im Aufgebot; `driver.cpp` belegt +zwei20-Minuten-Abschnitte. Wechselpaare und Einsatzstatistik kommen aus den +bestehenden Regeln, nicht aus einer neuen UI-Regel. Grafikmodi bleiben außerhalb +der ersten Modern-Version. + +Die offenen Fragen in [OPEN_DECISIONS.md](OPEN_DECISIONS.md) gelten vor der jeweiligen +Funktion. Sie bilden keine zusätzliche Freigaberunde und blockieren nicht pauschal +bereits vorhandene Menüs. Beispiele und ausführlicher Entwurf stehen im +[Integrationsindex](README.md); sie sind keine bereits implementierte Engine-API. diff --git a/docs/new_ui/integration/OPEN_DECISIONS.md b/docs/new_ui/integration/OPEN_DECISIONS.md index 5f6c399..13812ef 100644 --- a/docs/new_ui/integration/OPEN_DECISIONS.md +++ b/docs/new_ui/integration/OPEN_DECISIONS.md @@ -2,8 +2,9 @@ # Entscheidungen vor dem Engineadapter Diese Liste ist bewusst offen. Vorschläge im Schema sind keine Enginezusagen. -P0 blockiert eine korrekte Datenanbindung; P1 kann zunächst mit explizitem -Unavailable beantwortet werden. Maßgebliche neue Nutzeranforderungen sind bei +P0 betrifft die korrekte Anbindung der jeweils genannten Funktion; nicht jeder Punkt +blockiert den Start bereits vorhandener Menüs. Nicht benötigte Erweiterungen bleiben +ausdrücklich unavailable. Die schlanke erste Lieferfolge steht in [MVP_FOR_CLAUDE.md](MVP_FOR_CLAUDE.md). Maßgebliche neue Nutzeranforderungen sind bei D12 bereits festgelegt, ihre technische Umsetzung ist noch nicht bestätigt. | ID | Prio | Entscheidung / belegter Konflikt | Bis zur Antwort | diff --git a/docs/new_ui/integration/README.md b/docs/new_ui/integration/README.md index d0de4ee..afe886f 100644 --- a/docs/new_ui/integration/README.md +++ b/docs/new_ui/integration/README.md @@ -10,6 +10,7 @@ als HTML-Referenzwerte oder als Regression gegen Originaldaten ausgegeben werden | Einstieg | Inhalt | | --- | --- | +| [Kurzübergabe für Claude](MVP_FOR_CLAUDE.md) | Schlanker Einstieg und Lieferreihenfolge für die erste echte Anbindung | | [Schemas](schemas/ui-contract.schema.json) | JSON Schema 2020-12; gemeinsame Typen, Readmodels, Kommandos, Fehler und Ergebnisse | | [Index](schemas/contract-index.json) | Namen der vorgeschlagenen Reads und Commands | | [Menüvertrag](menu-contracts.json) | 47 Menü-/Auswertungsbereiche mit sichtbaren Daten und Code-/HTML-Quellen | @@ -140,8 +141,9 @@ Kalendertage sind ISO `YYYY-MM-DD`; Saison-ID, Saisonlabel und Kalenderjahr bleiben getrennt. Historische Spieltage werden über `almanac_date()` übertragen. Dateizeitstempel benutzen UTC-`date-time`. Livezeit führt Periode, Minute und, nur wenn belegt, Sekunden/Nachspielzeit. Indoor- und Verlängerungsperioden dürfen -nicht auf eine feste 0–90-Prozentachse gequetscht werden. Die Indoor-Periodenlängen bleiben im Beispiel ausdrücklich unbekannt; -maßgeblich sind die Periodenwerte der tatsächlichen Engine. Abwesenheiten +nicht auf eine feste 0–90-Prozentachse gequetscht werden. Unklare historische Indoor-Perioden bleiben im Archivbeispiel ausdrücklich unbekannt. +Für neue Live-Hallenspiele belegt `src/modern/game/driver.cpp` zwei20-Minuten-Abschnitte; +maßgeblich bleiben die gelieferten Periodenwerte der tatsächlichen Engine. Abwesenheiten führen Wert **und** Einheit: vorhandene Wochenzähler dürfen nicht still in exakte Verletzungstage oder Sperrspiele umgedeutet werden. From be7d6bd43e11d70fc0fb9acf90c53bff51f0cb47 Mon Sep 17 00:00:00 2001 From: Codex Date: Tue, 27 Oct 2026 01:52:45 +0100 Subject: [PATCH 2/2] Clarify indoor rotation rows without inventing a squad eligibility limit (by Codex) --- docs/new_ui/integration/MVP_FOR_CLAUDE.md | 6 +++--- docs/new_ui/integration/README.md | 9 ++++----- 2 files changed, 7 insertions(+), 8 deletions(-) diff --git a/docs/new_ui/integration/MVP_FOR_CLAUDE.md b/docs/new_ui/integration/MVP_FOR_CLAUDE.md index 261fbe7..e2f36fe 100644 --- a/docs/new_ui/integration/MVP_FOR_CLAUDE.md +++ b/docs/new_ui/integration/MVP_FOR_CLAUDE.md @@ -28,7 +28,7 @@ vorhandenen C++-Dienste und `ModernSession::read()` genügt als erster Schritt. | Lieferung | Benötigte autoritative Daten | | --- | --- | -| A · Karriere/Schreibtisch | Mod/Welt, Datum/Saison/Spieltag, 1–4 aktive Menschen, aktuelles Team, Bankstand mit Einheit, verfügbare Menüs/Widgets und Warnungen. Neuer Spielstart setzt Modus3. Club/Nationalauswahl: mindestens eines aktiv, bestehende Originalgrenzen beibehalten. | +| A · Karriere/Schreibtisch | Mod/Welt, Datum/Saison/Spieltag, 1–4 aktive Menschen, aktuelles Team, Bankstand mit Einheit, verfügbare Menüs/Widgets und Warnungen. Neuer Spielstart setzt Modus 3. Club/Nationalauswahl: mindestens eines aktiv, bestehende Originalgrenzen beibehalten. | | B · Vorbereitung | Kader mit stabilen Spieler-IDs, Positionen, Werten und Status; Aufstellung/Taktik/Training, Nominierungen, verfügbare Termine und Trainingslager. National- und Indoor-Aufgebot ausdrücklich deklarieren. | | C · Geschäft/Planung | Bestehende Bank-, Stadion-, Transfer-, Vertrags-, Werbe-, Freundschafts- und Verlegungsprojektionen. Jede verfügbare Mutation mit ihren tatsächlichen Grenzen, Kosten und Angeboten. Noch fehlende Dienste als unavailable kennzeichnen. | | D · Live-Ticker | Ein gemeinsamer Live-Snapshot: einzigartige Paarungen, beide Seiten/Logos, zuständige menschliche Manager, Zeit/Periode, Ergebnis, sequenzierte Text-/Ereignismeldungen, Aufstellungen/Bank, Statistik und Live-Tabelle. Auswahl rechts ist eine unabhängige Informationsansicht. | @@ -64,8 +64,8 @@ schreibgeschützte Almanachansicht nicht erforderlich. Ausländische Clubs sind zunächst nur anschaubar, nicht als Managerteam wählbar. National-Desktop und Liveansicht erhalten ihre eigenen Capabilities. Hallenfußball -hat sechs gleichzeitige Spieler und elf Plätze im Aufgebot; `driver.cpp` belegt -zwei20-Minuten-Abschnitte. Wechselpaare und Einsatzstatistik kommen aus den +hat sechs gleichzeitige Positionen; die ersten elf Aufstellungszeilen bilden den Rotationsplan, weitere tatsächliche Reserven bleiben davon getrennt; `driver.cpp` belegt +zwei 20-Minuten-Abschnitte. Wechselpaare und Einsatzstatistik kommen aus den bestehenden Regeln, nicht aus einer neuen UI-Regel. Grafikmodi bleiben außerhalb der ersten Modern-Version. diff --git a/docs/new_ui/integration/README.md b/docs/new_ui/integration/README.md index afe886f..044ef1f 100644 --- a/docs/new_ui/integration/README.md +++ b/docs/new_ui/integration/README.md @@ -142,7 +142,7 @@ bleiben getrennt. Historische Spieltage werden über `almanac_date()` übertrage Dateizeitstempel benutzen UTC-`date-time`. Livezeit führt Periode, Minute und, nur wenn belegt, Sekunden/Nachspielzeit. Indoor- und Verlängerungsperioden dürfen nicht auf eine feste 0–90-Prozentachse gequetscht werden. Unklare historische Indoor-Perioden bleiben im Archivbeispiel ausdrücklich unbekannt. -Für neue Live-Hallenspiele belegt `src/modern/game/driver.cpp` zwei20-Minuten-Abschnitte; +Für neue Live-Hallenspiele belegt `src/modern/game/driver.cpp` zwei 20-Minuten-Abschnitte; maßgeblich bleiben die gelieferten Periodenwerte der tatsächlichen Engine. Abwesenheiten führen Wert **und** Einheit: vorhandene Wochenzähler dürfen nicht still in exakte Verletzungstage oder Sperrspiele umgedeutet werden. @@ -184,10 +184,9 @@ Managerfall steht für diese Deutschland-kompatible Rolle; andere Nationalteams bleiben als Gegner darstellbar. Indoor unterscheidet `rosterSize`, `rosterLimit`, `onFieldCount`, -`onFieldLimit` und `benchLimit`. Belegt sind sechs Personen auf dem Feld und elf -Kaderplätze (`game/lineup.cpp`); eine 11er-Feldregel aus der Outdooransicht darf -nicht übernommen werden. `benchLimit=5` im Fixture ist die restliche -Kapazitätsaufteilung des synthetischen 11/6-Beispiels, keine Aussage über einen +`onFieldLimit` und `benchLimit`. Belegt sind sechs gleichzeitige Feldpositionen und elf +Zeilen im Rotationsplan (`game/lineup.cpp`); eine 11er-Feldregel aus der Outdooransicht darf +nicht übernommen werden. `benchLimit=5` im Fixture ist die Partneraufteilung des synthetischen 11/6-Beispiels; sie erklärt keine allgemeine Kaderobergrenze, keine Aussage über einen neuen Wechselmodus. Wechselanzahl und Wiedereinwechselbarkeit bleiben D11. ## Pagination, Live und Nachspiel