Document the implemented bilingual news event payload registry for engine handoff (by Codex)

This commit is contained in:
Codex committed 2026-10-27 02:39:21 +01:00
1 parent be7d6bd43e
commit bf3fd81ace
3 files changed
+163

No files matched your search

+140
View File
@@ -0,0 +1,140 @@
<!-- SPDX-License-Identifier: GPL-3.0-only -->
# 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.
+11
View File
@@ -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.
+12
View File
@@ -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.