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

78 lines
5.8 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.
<!-- SPDX-License-Identifier: GPL-3.0-only -->
# 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.
Die [konkreten nativen Anschlussstellen](NATIVE_BINDING_MAP.md) unterscheiden
bereits austauschbare Providerreads von noch direkt verwendeten Demohelfern.
## 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 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. |
| 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 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.
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.