9.3 KiB
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.
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.