Render typed bilingual news and preserve historical journal scope (by Codex)

This commit is contained in:
Codex authored and Codex committed 2026-10-27 05:46:07 +01:00
1 parent 1eb5e99847
commit 950d79d529
16 files changed
+6858 -81

No files matched your search

+160
View File
@@ -0,0 +1,160 @@
<!-- SPDX-License-Identifier: GPL-3.0-only -->
# Nativer Presse-Renderer und historisches Journal v2 (by Codex)
`assets/modern/news-catalog.json` enthält die 113 selbst verfassten deutschen und
englischen Vorlagen aus dem HTML-Katalog. Das ist eigener UI-Text, keine
Zeitungsdatenbank und kein Originalspielinhalt. Die neue C++-Komponente rendert
explizit übergebene semantische Ereignisse; sie erzeugt weder Presseereignisse
noch GameState-, Kalender-, Geld- oder Zufallsregeln.
## Reine Schnittstelle
`NewsCatalog::load(path)` oder der JSON-Konstruktor prüfen den Katalog.
`registry()` liefert Vorlagen-ID, Ereignistyp, Variante, erlaubte Bereiche,
Parameterschemata und Konsistenzregeln. Eine doppelte ID, unbekannte Parametertypen,
Regeln oder nicht deklarierte Platzhalter werden abgewiesen.
```cpp
NewsCatalog catalogue = NewsCatalog::load(resource_path);
NewsEvent event;
event.id = "career:example:transfer:42"; // Vorkommnis-ID, keine UI-Revision
event.type = "transfer.signed";
event.date = "2032-07-01";
event.scope = {NewsScopeKind::club, {"club:example", "FC Beispiel", {}}};
event.data = {{"player", {{"id", "player:42"}, {"name", "Alex Beispiel"}}},
{"fromClub", {{"id", "club:other"}, {"name", "SV Beispiel"}}}};
auto rendered = catalogue.from_event(event);
// {ok:true,article} oder {ok:false,error:{code,fields}}
```
Zusätzlich gibt es `from_event(Json, context)` für Adapter, `from_almanac` für
das vorhandene flache Almanachrecordformat und `example(template_id, options)`
als **ausdrücklichen UI-Testpfad**. Beispiele sind immer als `demo:true`
markiert. Ein fehlendes reales Ereignis, eine fehlende Pflichtangabe oder ein
unbekannter Enginepfad führt niemals automatisch zu einem Beispielartikel.
Kein UI-Timer publiziert Nachrichten.
`NewsScopeKind` trennt Club, National und Global. `NewsLanguage` trennt Deutsch
und Englisch. Die Registry validiert jedes Feld in `NewsEvent::data`: Entitäten,
Personen, Listen, Ergebnispaare, Datum, Saison, Geld, Booleanwerte, fachliche
Ganzzahlgrenzen und bekannte Enumerationen. Teamnamen stammen ausschließlich
aus dem Ereignisbereich; ein Manager kann ausdrücklich im Ereignis oder Kontext
gegeben sein. Es werden keine fehlenden Torschützen, Gehälter, Ablösen,
Leihenden oder Spielminuten erfunden. Sparsame Varianten besitzen eigene
Verträge für tatsächlich unbekannte Werte.
Die Ergebnisse enthalten dieselben Artikel- und Ereignisschemata wie der eigene
JS-Katalog: `schema:bmh-news-article@1`, `catalogueVersion`, stabile `id`,
`eventId`, `eventType`, `templateId`, `date`, `kind`, `tone`, `scope`,
`dedupeKey`, `fingerprint`, normalisierte `event`-Fakten und beide fertigen
`translations.de/en`. Die Schlüsselidentität ist das kanonische Tupel
`[scope.kind,scope.id,event.id]`; FNV64 und kanonische Fakten entsprechen dem
HTML-Vertrag. Sprache und Überschriftenfassung ändern die Identität nicht.
`validate_article` prüft Faktenidentität und erhält gespeicherte Prosa; ein
später bearbeiteter Katalog überschreibt keine alten Sprachsnapshots.
## Datum, Geld und Unicode
Datumswerte sind echte ISO-Daten; Texte werden zentral als de-DE/en-GB-Datum,
Zahlen, Einheiten, Listen, Ordinalzahlen und Währung formatiert. Datum hängt nicht
von der lokalen Zeitzone ab. UTF-8 wird auf gültige Skalare, Steuerzeichen und
Längengrenzen geprüft. World-/Adapternamen kommen aus dem bereits normalisierten
Datensatz und bleiben in dessen kanonischer Schreibweise erhalten. Der Renderer
führt keine zusätzliche NFC-Laufzeitbibliothek ein. Ein Adapter für andere
Namensquellen ist selbst für deren vereinbarte kanonische Normalisierung
verantwortlich; eine allgemeine Unicode-Normalisierungsparität für beliebige
unkanonisierte Fremdeingaben wird nicht behauptet.
`NewsMinorMoney` ist ausdrücklich ein Betrag mit **zwei Dezimalstellen**. Er
konvertiert nicht implizit aus einem nativen Integer oder allgemeinen Money-DTO.
Das vorhandene allgemeine DTO ist `{minor:string,currency,minorUnits:0..4}`.
`news_money_from_dto` prüft diese Felder und skaliert ausschließlich exakt:
| DTO | News-Minorwert |
|---|---|
| `minor:"12", minorUnits:0` | `1200` |
| `minor:"12", minorUnits:1` | `120` |
| `minor:"12", minorUnits:2` | `12` |
| `minor:"120", minorUnits:3` | `12` |
| `minor:"1200", minorUnits:4` | `12` |
Inexacte Teilcentwerte, negative Beträge, fehlende Einheiten, ungültige
Währungen oder Überläufe werden abgewiesen, niemals gerundet oder als Majorwert
erraten. Ein direkter allgemeiner DTO ist kein gültiger News-Moneywert; der
Adapter muss die explizite Konvertierung benutzen. Die Vorlagen verwenden
nichtnegative semantische Betragsgrößen; ob ein Enginewert eine Zahlung,
Forderung oder negative Buchung bedeutet, entscheidet der Ereignisadapter.
Auch Zeitbezüge wie das in einer Vorlage ausdrücklich genannte Monatsgehalt
müssen vor Übergabe belegt sein; bei unbekanntem Gehalt gibt es die sparsame
Vertragsvariante. Unterstützte Währungscodes sind EUR, GBP, USD, CHF und DEM.
Alle Ausgaben sind **Textdaten**, kein Rml-/HTML-Markup. Der bestehende native
Presenter escaped sie einmal. Ersatzwerte werden nicht erneut als Template
interpretiert, auch wenn ein Name `{{club}}` oder `<img>` enthält.
## Journal und Scope
`news_journal.*` bietet einen reinen v2-Store mit `items`, dauerhaftem `seen`-
Ledger und getrenntem `unbound`-Altbestand. `publish_news_article` nimmt nur einen
vom Katalog validierten Artikel entgegen. Gleiches Vorkommnis und gleiche
Fakten liefern `deduped:true` ohne Änderung am Store; widersprüchliche Fakten
liefern `news_event_id_conflict`. Löschen verschiebt in den Papierkorb und
behält das Ledger, sodass Replay nichts dupliziert oder wiederherstellt.
Grenzen sind 500 aktuelle Datensätze, 100 ungebundene Altzeilen und 2.000 Ledger-
Einträge; volle Kapazität wird ausdrücklich gemeldet und nicht still verworfen.
Der Aufrufer besitzt die äußere Revisionsprüfung und atomare Sourcepublikation.
Die bestehenden `demo_news_view`, `demo_news_unread` und `edit_demo_news`
verwenden dieselben Scopeguards. Clubartikel erscheinen nur beim passenden
Club, Nationalartikel nur beim passenden Nationalteam; ausdrücklich globale
Kalenderartikel sind gemeinsam. Finanz-/Transfer-/Stadion-/Hallenartikel können
nicht als globale oder nationale Clubberichte importiert werden. Tablet,
Detailansicht, Archiv, Sammellesen und Desktop-Widget verwenden diese Projektion.
Backendaktionen auf fremde oder ungebundene IDs werden abgewiesen; ein anderer
Owner kann nicht durch eine Sammelaktion unsichtbare Clubzeilen ändern.
Bekannte neu erstellte Demoartikel frieren die historische Person, den Club und
fertigen Text sofort im **bekannten Erstellkontext** ein. Danach werden keine
`{{club}}`-/`{{manager}}`-Platzhalter mehr gegen den aktuellen Menschen ersetzt.
Ein Rollen-/Managerwechsel verändert Ansichten, keine alten Fakten. Die optionale
Sprachprojektion liest nur fertige `translations`; sie schreibt keine Texte um.
Die aktuelle allgemeine native UI bietet weiterhin Deutsch, der reine Renderer
und die Journalprojektion sind für beide Sprachsnapshots vorbereitet.
Die bisherige v1 speicherte nur rohe Templates, Datum und Statusflags, aber
keinen beweisbaren historischen Owner. Solche vorhandenen v1-Zeilen werden
**unverändert nach `unbound` übernommen**, ohne den heutigen Menschen als alten
Besitzer zu erfinden. Sie erscheinen weder als Club- noch Nationalartikel; die
UI nennt die erhaltene Altbestandszahl. Ein bloßer Read migriert nichts und
ändert weder Revision noch Dirty. Die normale Ladegrenze migriert einmalig im
staged Zustand, bevor die saubere Baseline gesetzt wird. Der Altbestand bleibt
über Save/Load erhalten und kann später über einen gesonderten belegbaren
Altarchivpfad erschlossen werden.
Ein tatsächlicher neuer `start` erzeugt die Demo-Defaults erst **nach** Annahme
von Person, Club, Rolle und Datum. Join, Umbenennung, Rollenwechsel und alte
Migration tun dies nicht. Ein National-only-Start erhält keine Clubdefaults.
Das verhindern die tatsächlichen Source.start-Regressionsfälle mit FreshCoach
und einem anderen als dem Default-Erstclub.
## Anbindungsstand und Prüfung
Die Resource, reiner Renderer und Journal-API sind nutzbare UI-Teilkomponenten.
Die bestehenden nativen Journalaktionen und Save/Load bleiben erhalten. Ein
Presse-Engineadapter oder automatischer Engineevent-Abonnent gehört nicht zu
diesem Paket. Die Demo-Fixturefactory in `modern_news_ui_tests --write-fixtures
<directory> <catalogue.json>` publiziert ausdrücklich drei eigene Testereignisse
für Club 0, einen anderen Club und Deutschland; das ist kein Ersatz für fehlende
reale Engineinformationen.
`modern_news_catalog_tests` vergleicht 370 vollständige eigene JS-/C++-Snapshots,
einschließlich beider Sprachen, aller 113 Vorlagen, aller Bereiche sowie Geld-
und Prozentgrenzen. IDs, Fingerprints, beide Texte und normalisierte Fakten
werden vollständig verglichen. Weitere Fälle prüfen Pflichtangaben, falsche
Typen, unbekannte Daten, Money-DTOMapping, literale UTF-8-/Markupdaten,
Archivtextänderungen, Locale-Replay und dauerhafte Löschdedupe.
`modern_news_ui_tests` prüft historische Besitzer, fremde/nationale Scopeguards,
unveränderte Reads, konservative Migration, Aktionen, Revisions-/Undo-Schutz,
Save/Load und die tatsächliche Startidentität. Native Linux-/RmlUI-Scopes werden
zusätzlich über echte Menüeingaben geprüft; konkrete Schlussbelege bleiben
privat. Windows und macOS werden damit nicht als interaktiv geprüft ausgegeben.
+11 -9
View File
@@ -9,14 +9,15 @@ Repositorys. Die Implementierung verwendet die gemeinsame 3840×2160-Fläche:
Das Tablet ist 2720×2040 groß; Schrift, Kamera, Rahmen und Homebar sind native
UI-Elemente. Midnight, Silver und Matchday verwenden dieselben Themenvariablen.
Das Vereinsjournal zeigt Vereinswappen, aktuellen Vereinsnamen und Spieldatum,
Das nach aktuellem Team gefilterte Spieljournal zeigt Vereinswappen, aktuellen Vereinsnamen und Spieldatum,
die kicker-Wortmarke, Postfach und Archiv mit Gesamtzahlen, Suche, „Alle gelesen“
und die Zahl der angezeigten ungelesenen Meldungen. Zwölf ausdrücklich fiktive
Meldungen beginnen mit neun Postfach- und drei Archivmeldungen, davon fünf
und die Zahl der angezeigten ungelesenen Meldungen. Im bekannten Club-Erstellkontext beginnen zwölf ausdrücklich fiktive
Demomeldungen mit neun Postfach- und drei Archivmeldungen, davon fünf
ungelesen. Die Anfangsdaten entstehen relativ zum aktuellen Spieldatum, auch
über Monats-, Jahres- und Schaltjahresgrenzen hinweg. Gespeicherte Vorlagen
lösen `{{club}}` und `{{manager}}` erst in der Projektion gegen den aktuellen
ersten Manager auf. Ein Managerwechsel behält deshalb keine alten Namen.
über Monats-, Jahres- und Schaltjahresgrenzen hinweg. Neue Meldungen binden Person, Team und Text einmalig bei ihrer Erstellung.
Manager-/Rollenwechsel benennen alte Fakten nicht um; vorhandene rohe v1-Vorlagen
ohne historischen Besitzernachweis bleiben separat und unverändert erhalten.
Die [native Katalog-/v2-Schnittstelle](NATIVE_CATALOG.md) beschreibt den Vertrag.
Die sechs Kategorien verwenden vorhandene GUI-Bilder für Spielbetrieb,
Verträge, Bargeld, Training und Stadion sowie das Vereinswappen aus dem OBW.
Feste Kategorieillustrationen gehören zur externen GUI-Ressourcensammlung.
@@ -57,8 +58,9 @@ erneuten Öffnen derselben Welt in der laufenden UI-Sitzung erhalten. Anders als
im HTML-Prototyp gelangen diese reinen Ansichtsparameter nicht in einen
Spielcheckpoint; Laden einer Welt beginnt mit dem Postfach ohne Suche.
Die Grenze zur Quelle liegt in `DataSource`/`DemoSource`: `news` enthält nur
`version` und maximal 100 strikt validierte Meldungen. Ältere Demo-Checkpoints
Die Grenze zur Quelle liegt in `DataSource`/`DemoSource`: `news` verwendet v2 mit gebundenen Fakten, Statusflags,
Dedupeledger und getrenntem ungebundenem Altbestand. Reads filtern gegen den
aktuellen Team-/Nationalbereich und verändern keine Daten. Ältere Demo-Checkpoints
ohne `news` werden beim Laden ergänzt; vorhandene fehlerhafte Postfächer werden
atomar abgewiesen. Aktionen schreiben ausschließlich diesen Präsentationsblock.
Es gibt weder `GameState`-Zugriffe noch Änderungen an Geld, Kader, Kalender,
@@ -66,7 +68,7 @@ Weltkatalog oder Zufallsströmen. Eine spätere Session-Quelle muss echte Meldun
und deren Zuständigkeit liefern; Ereigniserzeugung und Gameplay bleiben offen.
`modern_news_ui_tests` verwendet ausschließlich synthetische Kataloge und prüft
Migration, dynamische Identität und Daten, Suche, Zähler, Lesen, Sammellesen,
Migration, historische Identität und Scope, Suche, Zähler, Lesen, Sammellesen,
Archiv/Zurückholen/Löschen, kleine Undo-Patches, Konflikte, strikte Validierung,
Revisionen sowie Save/Load und atomare Ablehnung fehlerhafter Checkpoints.
Visuelle Prüfung und native Eingabereplays erfolgen zusätzlich bei 1280×720