Draft Modern UI JSON contracts and almanac requirements (by Codex)
This commit is contained in:
1 parent
a207b0129e
commit
c2fb772c04
67 files changed
+27796
No files matched your search
@@ -0,0 +1,47 @@
|
||||
<!-- 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.
|
||||
Reference in new issue
Block a user