Files
Dreierpack-Manager/docs/new_ui/integration/MVP_FOR_CLAUDE.md
T

5.5 KiB
Raw Blame History

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.

  • 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 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; sie sind keine bereits implementierte Engine-API.