Provide a concise staged engine-to-UI handoff for the first text-only build (by Codex)
This commit is contained in:
1 parent
adf1af4ef6
commit
a779db7f73
3 files changed
+82
-4
No files matched your search
@@ -0,0 +1,75 @@
|
|||||||
|
<!-- 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.
|
||||||
|
|
||||||
|
## 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.
|
||||||
@@ -2,8 +2,9 @@
|
|||||||
# Entscheidungen vor dem Engineadapter
|
# Entscheidungen vor dem Engineadapter
|
||||||
|
|
||||||
Diese Liste ist bewusst offen. Vorschläge im Schema sind keine Enginezusagen.
|
Diese Liste ist bewusst offen. Vorschläge im Schema sind keine Enginezusagen.
|
||||||
P0 blockiert eine korrekte Datenanbindung; P1 kann zunächst mit explizitem
|
P0 betrifft die korrekte Anbindung der jeweils genannten Funktion; nicht jeder Punkt
|
||||||
Unavailable beantwortet werden. Maßgebliche neue Nutzeranforderungen sind bei
|
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.
|
D12 bereits festgelegt, ihre technische Umsetzung ist noch nicht bestätigt.
|
||||||
|
|
||||||
| ID | Prio | Entscheidung / belegter Konflikt | Bis zur Antwort |
|
| ID | Prio | Entscheidung / belegter Konflikt | Bis zur Antwort |
|
||||||
|
|||||||
@@ -10,6 +10,7 @@ als HTML-Referenzwerte oder als Regression gegen Originaldaten ausgegeben werden
|
|||||||
|
|
||||||
| Einstieg | Inhalt |
|
| 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 |
|
| [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 |
|
| [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 |
|
| [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.
|
bleiben getrennt. Historische Spieltage werden über `almanac_date()` übertragen.
|
||||||
Dateizeitstempel benutzen UTC-`date-time`. Livezeit führt Periode, Minute und,
|
Dateizeitstempel benutzen UTC-`date-time`. Livezeit führt Periode, Minute und,
|
||||||
nur wenn belegt, Sekunden/Nachspielzeit. Indoor- und Verlängerungsperioden dürfen
|
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;
|
nicht auf eine feste 0–90-Prozentachse gequetscht werden. Unklare historische Indoor-Perioden bleiben im Archivbeispiel ausdrücklich unbekannt.
|
||||||
maßgeblich sind die Periodenwerte der tatsächlichen Engine. Abwesenheiten
|
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
|
führen Wert **und** Einheit: vorhandene Wochenzähler dürfen nicht still in
|
||||||
exakte Verletzungstage oder Sperrspiele umgedeutet werden.
|
exakte Verletzungstage oder Sperrspiele umgedeutet werden.
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user