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

48 lines
2.6 KiB
Markdown

<!-- SPDX-License-Identifier: GPL-3.0-only -->
# Semantische Presseereignisse und unveränderliche Artikel
Zusatzvertrag aus dem parallelen News-Paket, noch keine bestätigte
Engineverdrahtung von 104 Templates:
```text
BMHNews.fromEvent(
{id,type,date,scope:{kind:'club'|'national'|'global',id,name},data,variant?},
{language:'de'|'en'}
) -> {ok,article|error}
```
Die Engine liefert stabile Ereignis-ID, semantischen Typ, ISO-Datum, Scope und
**typisierte Fakten**. Kein HTML, keine fertige DOM-Tabelle, kein Grafikpfad.
Typen und Pflichtfelder pro Template werden in einer versionierten Registry
abgeglichen (D22). Die Entwurfsschemas `PressEvent`, `PressScope`, `PressMoney`
und `Article` enthalten dafür Team-/Personenbezüge, Score, Zähler, Geld und
Prozentwerte. `PressMoney={minor,currency}` verwendet die Währungspräzision des
Session-/Weltkontexts; die anderen Money-DTOs führen sie zusätzlich explizit.
Die konkreten Common-Payloadnamen im Entwurf sind Vorschläge, keine bereits
angenommene 104-Typen-Registry. Ein fehlendes Pflichtfeld führt zu einem Fehler,
nicht zu einem Satz mit geratenem Spielernamen oder Betrag.
Artikel besitzen eine unveränderliche ID, `sourceEventId`, `dedupeKey` und
getrennte DE-/EN-Plaintext-Snapshots. Eine spätere Sprachumschaltung oder ein
neues Template darf einen bestehenden Artikel nicht inhaltlich umschreiben.
Varianten sind explizit oder deterministisch an Ereignis/Registry gebunden;
Rendern/Lesen zieht keinen Spiel-RNG. Für neue Übersetzungsrevisionen ist die
Snapshot-/Migrationspolitik noch festzulegen.
Dedupe wird karriere- und scopegebunden persistent gespeichert, **auch nach
Löschen des Artikels**. Ein Zustell-Replay darf keinen gelöschten Artikel neu
erzeugen. Eine Korrektur ist ein eigenes semantisches Ereignis mit Bezug auf den
alten Vorgang; sie überschreibt weder Originalevent noch Artikelsnapshot.
Private Vereinsmeldungen werden nicht durch einen Filterwechsel einem fremden
Manager zugestellt. Globale Meldungen brauchen eine ausdrücklich definierte
Zustellung/Dedupe pro Empfänger oder gemeinsamen Artikelbestand.
Postfachaktionen (`news.update`) ändern gelesen/archiviert/gelöscht, nicht die
Geschäftsvorgänge hinter der Nachricht. Klickbare Folgeaktionen referenzieren
separate revisions-/ownergebundene Commands. Eine Pressemeldung bucht keine
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.