From bf3fd81aceb9dc363e772bc60f57af6945844ebe Mon Sep 17 00:00:00 2001 From: Codex Date: Tue, 27 Oct 2026 02:39:21 +0100 Subject: [PATCH] Document the implemented bilingual news event payload registry for engine handoff (by Codex) --- docs/new_ui/desktop/news/EVENTS.md | 140 +++++++++++++++++++++++++++++ docs/new_ui/desktop/news/README.md | 11 +++ docs/new_ui/integration/PRESS.md | 12 +++ 3 files changed, 163 insertions(+) create mode 100644 docs/new_ui/desktop/news/EVENTS.md diff --git a/docs/new_ui/desktop/news/EVENTS.md b/docs/new_ui/desktop/news/EVENTS.md new file mode 100644 index 0000000..cf657ea --- /dev/null +++ b/docs/new_ui/desktop/news/EVENTS.md @@ -0,0 +1,140 @@ + +# Ereignisse für den neuen Nachrichtenrenderer + +Der private HTML-Goldstand enthält 113 eigene DE/EN-Vorlagen. Dies ist deren maschinennahe Payload-Registry, kein Originaltextinventar und keine Zusage bereits gelieferter Engineereignisse. + +Kanonische Katalog-SHA256: `e249142f2635c897803d3016eb05d3f94297a75a013316fd536f82f2ef982339`. + +Die Engine liefert fachliche Ereignisse mit `id`, `type`, `date`, `scope` und `data`. Der Renderer wählt nur Varianten, deren erforderliche Fakten vollständig und widerspruchsfrei vorliegen. `team` stammt aus dem Ereignisbereich. + +| Vorlage | Ereignis / Variante | Bereiche | Benötigte Daten | +| --- | --- | --- | --- | +| match-win | match.result / win | club, national | competition:entity, opponent:entity, score:score, team:entity←scope | +| match-draw | match.result / draw | club, national | competition:entity, opponent:entity, score:score, team:entity←scope | +| match-loss | match.result / loss | club, national | competition:entity, opponent:entity, score:score, team:entity←scope | +| match-narrow-win | match.result / narrow-win | club, national | opponent:entity, score:score, team:entity←scope | +| match-big-win | match.result / big-win | club, national | opponent:entity, score:score, team:entity←scope | +| match-narrow-loss | match.result / narrow-loss | club, national | opponent:entity, score:score, team:entity←scope | +| match-heavy-loss | match.result / heavy-loss | club, national | opponent:entity, score:score, team:entity←scope | +| match-goalless | match.result / goalless | club, national | opponent:entity, score:score, team:entity←scope | +| match-derby-win | match.result / derby-win | club | derby:boolean, opponent:entity, score:score, team:entity←scope | +| match-derby-draw | match.result / derby-draw | club | derby:boolean, opponent:entity, score:score, team:entity←scope | +| match-derby-loss | match.result / derby-loss | club | derby:boolean, opponent:entity, score:score, team:entity←scope | +| match-late-win | match.result / late-win | club, national | minute:minute, opponent:entity, score:score, team:entity←scope | +| match-late-loss | match.result / late-loss | club, national | minute:minute, opponent:entity, score:score, team:entity←scope | +| match-comeback | match.result / comeback | club, national | opponent:entity, score:score, team:entity←scope, trailed:boolean | +| match-clean-win | match.result / clean-win | club, national | opponent:entity, score:score, team:entity←scope | +| match-away-win | match.result / away-win | club, national | opponent:entity, score:score, team:entity←scope, venue:venue | +| match-home-win | match.result / home-win | club, national | opponent:entity, score:score, team:entity←scope, venue:venue | +| match-friendly | match.friendly_scheduled / default | club, national | on:date, opponent:entity, team:entity←scope | +| league-champion | league.champion / default | club | competition:entity, season:season, team:entity←scope | +| league-promoted | league.promoted / default | club | competition:entity, season:season, team:entity←scope | +| league-relegated | league.relegated / default | club | competition:entity, season:season, team:entity←scope | +| league-position | league.position / default | club | competition:entity, position:positive_integer, season:season, team:entity←scope | +| league-leading | league.leading / default | club | competition:entity, team:entity←scope | +| league-safe | league.safe / default | club | competition:entity, team:entity←scope | +| run-wins | run.wins / default | club | matches:matches, team:entity←scope | +| run-unbeaten | run.unbeaten / default | club | matches:matches, team:entity←scope | +| run-winless | run.winless / default | club | matches:matches, team:entity←scope | +| run-losses | run.losses / default | club | matches:matches, team:entity←scope | +| cup-draw-announced | cup.draw_announced / default | club, national, global | competition:entity, on:date | +| cup-draw-opponent | cup.draw / default | club, national | competition:entity, opponent:entity, round:positive_integer, team:entity←scope | +| cup-round-win | cup.round_result / win | club, national | competition:entity, opponent:entity, round:positive_integer, score:score, team:entity←scope | +| cup-round-loss | cup.round_result / loss | club, national | competition:entity, opponent:entity, round:positive_integer, score:score, team:entity←scope | +| cup-final-reached | cup.final_reached / default | club, national | competition:entity, team:entity←scope | +| cup-final-win | cup.final_result / win | club, national | competition:entity, opponent:entity, score:score, team:entity←scope | +| cup-final-loss | cup.final_result / loss | club, national | competition:entity, opponent:entity, score:score, team:entity←scope | +| cup-extra-win | cup.extra_time / win | club, national | competition:entity, opponent:entity, score:score, team:entity←scope | +| cup-shootout-win | cup.penalties / win | club, national | competition:entity, opponent:entity, score:score, shootout:score, team:entity←scope | +| cup-shootout-loss | cup.penalties / loss | club, national | competition:entity, opponent:entity, score:score, shootout:score, team:entity←scope | +| national-called | national.player_called / default | national | player:person, team:entity←scope | +| national-squad | national.squad_announced / default | national | players:players, team:entity←scope | +| national-group | national.group_draw / default | national | opponents:entities, team:entity←scope, tournament:tournament | +| national-qualified | national.qualified / default | national | team:entity←scope, tournament:tournament | +| national-eliminated | national.eliminated / default | national | team:entity←scope, tournament:tournament | +| national-start | national.tournament_start / default | national | team:entity←scope, tournament:tournament | +| national-title | national.tournament_won / default | national | team:entity←scope, tournament:tournament | +| national-final | national.final_reached / default | national | team:entity←scope, tournament:tournament | +| national-camp | national.camp / default | national | on:date, place:entity, team:entity←scope | +| national-return | national.player_released / default | national | player:person, toClub:entity | +| indoor-invitation | indoor.invitation / default | club | competition:entity, on:date, team:entity←scope | +| indoor-group | indoor.group_draw / default | club | competition:entity, opponents:entities, team:entity←scope | +| indoor-win | indoor.result / win | club | competition:entity, opponent:entity, score:score, team:entity←scope | +| indoor-loss | indoor.result / loss | club | competition:entity, opponent:entity, score:score, team:entity←scope | +| indoor-title | indoor.won / default | club | competition:entity, team:entity←scope | +| transfer-signed | transfer.signed / default | club | fee:money, fromClub:entity, player:person, team:entity←scope | +| transfer-free | transfer.free / default | club | player:person, team:entity←scope, until:date | +| transfer-sold | transfer.sold / default | club | fee:money, player:person, team:entity←scope, toClub:entity | +| loan-in | loan.arrival / default | club | fromClub:entity, player:person, team:entity←scope, until:date | +| loan-out | loan.departure / default | club | player:person, team:entity←scope, toClub:entity, until:date | +| loan-return | loan.return / default | club | player:person, team:entity←scope | +| transfer-talks | transfer.talks / default | club | player:person, team:entity←scope | +| transfer-offer | transfer.offer_received / default | club | fee:money, player:person, team:entity←scope, toClub:entity | +| contract-extended | contract.extended / default | club | player:person, team:entity←scope, until:date, wage:money | +| contract-expiring | contract.expiring / default | club | player:person, team:entity←scope, until:date | +| contract-ended | contract.ended / default | club | player:person, team:entity←scope | +| contract-declined | contract.declined / default | club | player:person, team:entity←scope | +| injury-reported | player.injury / default | club, national | player:person, team:entity←scope | +| injury-duration | player.injury_duration / default | club, national | days:days, diagnosis:diagnosis, player:person, team:entity←scope | +| injury-season | player.season_out / default | club, national | player:person, season:season, team:entity←scope | +| injury-recovered | player.recovered / default | club, national | player:person, team:entity←scope | +| suspension-imposed | player.suspended / default | club, national | matches:matches, player:person, team:entity←scope | +| suspension-served | player.suspension_served / default | club, national | player:person, team:entity←scope | +| player-sent-off | player.sent_off / default | club, national | player:person | +| training-focus | training.focus / default | club, national | focus:focus, team:entity←scope | +| camp-start | training.camp_start / default | club, national | place:entity, team:entity←scope, until:date | +| camp-end | training.camp_end / default | club, national | place:entity, team:entity←scope | +| youth-promoted | youth.promoted / default | club | player:person, team:entity←scope | +| youth-prospect | youth.prospect / default | club | player:person, team:entity←scope | +| training-progress | training.progress / default | club, national | focus:focus, player:person, team:entity←scope | +| training-setback | training.setback / default | club, national | focus:focus, player:person, team:entity←scope | +| stadium-expansion-plan | stadium.expansion_planned / default | club | seats:seats, stadium:entity | +| stadium-expansion-done | stadium.expansion_finished / default | club | count:integer, stadium:entity | +| stadium-attendance | stadium.attendance_record / default | club | count:integer, stadium:entity, team:entity←scope | +| stadium-pitch | stadium.pitch_ready / default | club | stadium:entity, team:entity←scope | +| environment-facility | environment.improved / default | club | facility:facility, team:entity←scope | +| environment-support | environment.support / default | club | team:entity←scope | +| finance-profit | finance.profit / default | club | amount:money, team:entity←scope | +| finance-loss | finance.loss / default | club | amount:money, team:entity←scope | +| sponsor-signed | advertising.signed / default | club | amount:money, company:entity, team:entity←scope | +| sponsor-ending | advertising.ending / default | club | company:entity, team:entity←scope, until:date | +| advertising-budget | advertising.budget / default | club | amount:money, team:entity←scope | +| tv-payment | finance.tv_payment / default | club | amount:money, season:season, team:entity←scope | +| loan-approved | finance.loan_approved / default | club | amount:money, bank:entity, team:entity←scope | +| loan-declined | finance.loan_declined / default | club | bank:entity, team:entity←scope | +| loan-repaid | finance.loan_repaid / default | club | amount:money, bank:entity, team:entity←scope | +| debt-warning | finance.debt / default | club | amount:money, team:entity←scope | +| shares-purchased | finance.shares_bought / default | club | amount:money, company:entity, shares:shares, team:entity←scope | +| shares-sold | finance.shares_sold / default | club | amount:money, company:entity, shares:shares, team:entity←scope | +| shares-rise | finance.share_rise / default | club | company:entity, price:money, rate:percent | +| shares-fall | finance.share_fall / default | club | company:entity, price:money, rate:percent | +| insurance-payment | finance.insurance_payment / default | club | amount:money, team:entity←scope | +| toto-win | toto.win / default | club | amount:money, team:entity←scope | +| toto-loss | toto.loss / default | club | amount:money, team:entity←scope | +| manager-joined | career.manager_joined / default | club, national | manager:person, team:entity←scope | +| manager-resigned | career.manager_resigned / default | club, national | manager:person, team:entity←scope | +| season-started | career.season_started / default | club, national | season:season, team:entity←scope | +| season-finished | career.season_finished / default | club, national | season:season, team:entity←scope | +| calendar-new-year | calendar.new_year / default | club, national, global | year:year | +| manager-birthday | career.manager_birthday / default | club, national | age:ordinal, manager:person, team:entity←scope | +| cup-extra-loss | cup.extra_time / loss | club, national | competition:entity, opponent:entity, score:score, team:entity←scope | +| transfer-fee-undisclosed | transfer.signed / fee-undisclosed | club | fromClub:entity, player:person, team:entity←scope | +| sale-fee-undisclosed | transfer.sold / fee-undisclosed | club | player:person, team:entity←scope, toClub:entity | +| contract-basic | contract.extended / basic | club | player:person, team:entity←scope, until:date | +| loan-end-undisclosed | loan.arrival / end-undisclosed | club | fromClub:entity, player:person, team:entity←scope | + +## Transport und Grenzen + +- `entity`/`person` sind strukturierte stabile IDs mit Namen, keine HTML-Fragmente. Optionale DE/EN-Namen werden nur ausdrücklich verwendet. +- `score={for,against}` steht aus Sicht des Bereichsteams. Derby, später Treffer, Rückstand oder Austragungsort werden nicht aus einem Ergebnis geraten. +- Der aktuelle Pressrenderer erwartet `money={minor,currency}` mit sicher darstellbarer ganzzahliger Untereinheit bis 9e14 und den unterstützten zweistelligen Währungen. Der allgemeinere Integrationsentwurf benutzt dagegen Dezimalstrings und `minorUnits`: der Adapter muss gezielt und geprüft übersetzen. Unbekannte Beträge werden ausgelassen und verwenden eine passende faktenarme Variante; ungültige bekannte Werte werden abgewiesen. +- `date` ist ISO `YYYY-MM-DD`; der Produzent stellt ein abgeschlossenes Ereignisdatum bereit. Ein künftiger Termin in einem Planungsartikel ist ein eigenes Datumsfeld. +- Eine Vorkommnis-ID wird je Bereich genau einmal zugestellt. Widersprüchliche Wiederverwendung ist ein Fehler; gelöschte Artikel bleiben im Dedupe-Register. +- DE/EN-Textfassungen sind gespeicherte historische Snapshots. Spätere Teamumbenennung oder Sprachwechsel schreibt keine alten Fakten um. +- Die acht Beispiele pro neuem Demo-Bereich gehören nur zum UI-Test. Eine echte Engineanbindung darf keine fiktiven Meldungen als Ersatz für fehlende Ereignisse einspeisen. + +## Tatsächlicher Umsetzungsstand + +HTML: Registry, typisierte Parameter, DE/EN-Renderer, persistentes Journal und gemeinsam gefilterte Desktop-View sind implementiert. Der getrennte Browserlauf besteht 2.149 begrenzte Prüfungen einschließlich echter Karrierebindung; das ist keine Engine- oder native Presseabnahme. + +Native RmlUI und Engine werden über dieselben semantischen Daten angebunden. Eine erste Anbindung kann mit Matchabschluss, Managerbeitritt/-abgabe und bestätigten Geschäftsereignissen beginnen; sie muss nicht sofort jede Vorlage produzieren. Reads und UI-Timer erzeugen keine Engineergebnisse. diff --git a/docs/new_ui/desktop/news/README.md b/docs/new_ui/desktop/news/README.md index b671279..bfc7048 100644 --- a/docs/new_ui/desktop/news/README.md +++ b/docs/new_ui/desktop/news/README.md @@ -72,3 +72,14 @@ Revisionen sowie Save/Load und atomare Ablehnung fehlerhafter Checkpoints. Visuelle Prüfung und native Eingabereplays erfolgen zusätzlich bei 1280×720 und 1920×1080 in allen drei Themen; konkrete Ergebnisse stehen im zugehörigen QA-Protokoll. Diese Tests ersetzen keine Prüfung einer späteren Engine-Quelle. + + +## Nachtstand 26./27. Oktober 2026: eigene kurze Ereignisartikel + +Die HTML-Referenz verwendet jetzt 113 eigene Kurzvorlagen mit DE/EN-Snapshots, +Typ-/Konsistenzprüfung und persistentem Bereichs-/Lösch-Dedupe. Die +[Ereignisregistry und Payloadfelder](EVENTS.md) dienen der direkten Übergabe +an Claude. Vereins- und Nationalnachrichten bleiben getrennt; das Desktopwidget +liest dieselbe lokalisierte View wie das Tablet. Fehlende Beträge/Scorer werden +nicht erfunden. Dies ist der überprüfte HTML-Stand; die native Presseanbindung +ist davon getrennt und wird hier noch nicht als fertig bezeichnet. diff --git a/docs/new_ui/integration/PRESS.md b/docs/new_ui/integration/PRESS.md index 259e3f4..eaf1249 100644 --- a/docs/new_ui/integration/PRESS.md +++ b/docs/new_ui/integration/PRESS.md @@ -45,3 +45,15 @@ Ablöse, wechselt keinen Verein und ersetzt kein Finanz-/Transferledger. `press-event.json` und `press-article.json` sind synthetische Strukturbeispiele. Sie beweisen weder die geplanten 104 Kurztemplates noch acht Scope-Seeds oder bereits registrierte Engineevents; diese kommen aus dem separaten News-Bericht. + + +## Tatsächlicher Katalogstand der Nacht + +Der eigenständige HTML-Katalog ist inzwischen mit 113 DE/EN-Varianten implementiert. +Die [Payloadregistry](../desktop/news/EVENTS.md) beschreibt die tatsächlich +verwendeten semantischen IDs und Pflichtfelder. Der bisherige Vertragsentwurf +bleibt ein Vorschlag für den Engineadapter; er ist nicht automatisch dieselbe +JavaScript-Transportform. Insbesondere Money-Dezimalstrings/Minor Units müssen +an der Pressrenderer-Grenze explizit in dessen sichere Zahlenform überführt werden. +Der Browserlauf hat 2.149 begrenzte Prüfungen bestanden, ohne eine Engine- oder +Native-Integration vorzutäuschen. Demo-Seeds bleiben ausschließlich im Testpfad.