Files
Dreierpack-Manager/docs/new_ui/desktop/news/NATIVE_CATALOG.md
T

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.