Render typed bilingual news and preserve historical journal scope (by Codex)
This commit is contained in:
1 parent
1eb5e99847
commit
950d79d529
16 files changed
+6858
-81
No files matched your search
@@ -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.
|
||||
@@ -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
|
||||
|
||||
Reference in new issue
Block a user