# Lokalisierung der Clientoberfläche

`src/translations.json` enthält **166 deutsche Quellschlüssel mit jeweils fünf Übersetzungen**: Englisch (`en`), Französisch (`fr`), Spanisch (`es`), Portugiesisch (`pt`) und Arabisch (`ar`). Insgesamt sind das **830 Übersetzungswerte**. Deutsch bleibt die Quellsprache. `HORST Secret Chat` und `rabbi1384` bleiben unverändert.

Die Formulierungen verwenden eine direkte, einfache Ansprache: englisches „you“, französisches „tu“, spanisches „tú“ und europäisches Portugiesisch mit „tu“. Arabisch ist modernes Hocharabisch. Der Koffer-voll-Geld-Witz und die humorvolle Bezeichnung des Projekteigentümers sind sinngemäß erhalten. Einschränkungen zur Wiederherstellung, zu extern gespeicherten Kopien, zur Löschung bei der nächsten Verbindung, zum Hintergrundbetrieb und zur ausstehenden externen Sicherheitsprüfung sind mitübersetzt.

## Umfang und Prüfung

Grundlagen sind `docs/ui-strings.json` sowie die UI-Literale aus `src/app.js` einschließlich der aktuellen Melde-, Kontolösch-, Datenschutz- und Quellcode-Einträge. Von 176 Einträgen der Extraktionsdatei werden 155 direkt durch identische Schlüssel abgedeckt. Die 21 übrigen Einträge sind unten erklärt. Die elf zusätzlichen Schlüssel decken in der Extraktion fehlende Literale, Zeitfragmente, Statusanzeigen und die geplante Sprachauswahl ab.

Geprüft wurden gültiges UTF-8-JSON, eindeutige Schlüssel, exakt fünf Sprachfelder pro Eintrag und Zeichenkettenwerte für alle Sprachen. Alle identifizierten statischen deutschen UI-Texte dieses Quellstands sind enthalten. Es gab keine externen Übersetzungsdienste oder Uploads. Diese Prüfung ersetzt keine Prüfung der gerenderten Oberflächen durch Muttersprachler.

Bewusst ausgelassen sind:

- Methoden und technische Werte: `POST`, `GET`, `DELETE`, `Content-Type`, `Bearer `, `noopener noreferrer`, `Enter` und der Locale-Bezeichner `de-DE`.
- CSS-Klassen: `side-head row spread`, `row spread`, `chat-head row`, `icon back`, `primary send`, `key wide`, `key space`, `member row`.
- Tastaturbelegungen bzw. Umschalttasten: `qwertzuiopü`, `asdfghjklöä`, `ABC`.
- Der technische Downloadpräfix `SMChat-Notfallschluessel-`. Eine Umbenennung auf die aktuelle Marke ist eine separate Codeänderung.
- Die Extraktionsdatei gibt das Schlüsseldatei-Literal mit sichtbaren Escapezeichen wieder. Das Wörterbuch enthält stattdessen den tatsächlichen JavaScript-Wert mit Zeilenumbrüchen: `\nWiederherstellungsschlüssel – geheim halten\n\n`.

## Einbindung

1. **Nur die Anzeige übersetzen.** Nachrichtentexte, Benutzernamen, Gruppennamen, Dateinamen, URLs, Zertifikate, Signaturen, Protokollwerte und gespeicherte Identifikatoren sind Nutzdaten oder Maschinenwerte. Insbesondere werden `gesendet`, `zugestellt`, `nicht gesendet`, `wird gesendet`, `nur du` und `Zustellung unbestätigt` im Code als Statuswerte gespeichert bzw. verglichen. Diese Werte müssen intern stabil bleiben; ihre Übersetzung gehört an die Renderstelle. Sonst können Sprachwechsel und Zustellprüfungen scheitern.
2. **Leerraum in Quellschlüsseln nicht trimmen.** Fragmente wie `Angemeldet als `, `Blockieren: `, ` Teilnehmer · `, ` ab Versand · `, ` bis ` und ` · bis ` enthalten absichtlich Leerzeichen. Auch die echten Zeilenumbrüche der exportierten Schlüsseldatei müssen erhalten bleiben.
3. **Leere Übersetzungen sind gültig.** Der Schlüssel ` gültig` hat in allen fünf Zielsprachen absichtlich den Wert `""`. Der vorausgehende Headertext nennt bereits „Message validity: “ bzw. die entsprechende Übersetzung. Das vermeidet unnatürliche deutsche Satzstellung in den Zielsprachen. Für den Fallback `dictionary[key]?.[language] ?? key` verwenden, nicht `|| key`. Die Fragmente der Zustimmung zu Bedingungen/Datenschutz sind ebenfalls aufeinander abgestimmt; ` gelesen.` wird zum abschließenden Punkt, weil das Verb zuvor steht.
4. **Sprache beim Rendern anwenden.** Übersetzte Standardnamen wie `Meine Gruppe` sollten nicht die Grundlage für signierte Daten oder dauerhafte sprachabhängige Statuswerte werden. Ein Sprachwechsel muss vorhandene UI-Elemente neu rendern; gespeicherte Nutzernachrichten werden dabei nicht verändert.
5. **Zeiten und Plurale lokal formatieren.** `fmt` ist im gelesenen Quellstand noch an `de-DE` gebunden. Für `Intl.DateTimeFormat` die gewählte Oberflächensprache verwenden. Die Schlüssel ` Min.`, ` Std.` und ` Tage` decken die bisherigen Templatefragmente ab, ersetzen aber keine vollständige Pluralbehandlung. Die angebotenen festen Ablaufzeiten `1 Minute`, `1 Stunde`, `24 Stunden` und `7 Tage` haben vollständige Übersetzungen. Für die Anzeige dieser konkreten Werte vorzugsweise diese vollständigen Bezeichnungen wiederverwenden; das liefert insbesondere die korrekten arabischen Formen.
6. **Serverantworten und Systemdialoge separat behandeln.** Rohe Fehlertexte aus `data.error`, Betriebssystemdialoge und native Plugintexte sind durch dieses Wörterbuch nicht automatisch lokalisiert. Meldegründe werden auf dem Server als `spam`, `harassment`, `illegal` und `other` gespeichert; die Projektmeldungsansicht sollte sie beim Rendern den übersetzten UI-Bezeichnungen zuordnen, statt die Enumwerte direkt auszugeben.

## Arabisch und Eingabe

Für `ar` am Dokument `lang="ar"` und `dir="rtl"` setzen; für die anderen Sprachen `dir="ltr"`. CSS sollte logische Eigenschaften (`margin-inline`, `padding-inline`, `text-align: start`) verwenden. Keine Zeichenketten oder DOM-Reihenfolgen manuell umkehren.

Benutzernamen, Schlüssel, URLs und Dateipfade mit `bdi` bzw. eigener LTR-Richtung isolieren. Nachrichtentexte und frei gewählte Gruppennamen brauchen eine eigene automatische Richtung (`dir="auto"`), da ihre Sprache unabhängig von der Oberfläche sein kann. Namen oder Benutzereingaben dürfen dafür nicht verändert werden. Gemischte Zeilen mit `HORST Secret Chat`, `rabbi1384`, Ziffern und arabischem Text visuell prüfen.

Die vorhandene App-Tastatur enthält weiterhin deutsche QWERTZ-Zeilen. Übersetzte Tastenbeschriftungen erzeugen keine arabischen Buchstaben oder französischen/portugiesischen/spanischen Zusatzzeichen. Für eine vollständig nutzbare mehrsprachige Eingabe braucht es passende Tastaturbelegungen oder eine klar erreichbare Gerätetastatur. Dies ist keine Änderung dieses Übersetzungsauftrags. Auch die derzeitige Benutzernamenprüfung bleibt auf `a-z`, Ziffern, Punkt, Bindestrich und Unterstrich beschränkt; die übersetzten Hinweise versprechen keine Unterstützung arabischer Benutzernamen.

## Noch offene Oberflächenprüfung

Nach der Einbindung die sechs Sprachansichten auf Mobilgerät und PC prüfen: Begrüßung und Pflichtzustimmung, Wiederherstellung und Schlüsselexport, Gruppenkopf und Ablaufzeiten, Nachrichtenstatus, Anhänge, Einladungen, Einstellungen, Melden/Blockieren, Kontolöschung und Rechte-Dialog. Besonders auf lange französische/portugiesische Schaltflächen, arabische Dialogausrichtung sowie Username- und Zeitdarstellung achten. Die Übersetzungsdatei ist vollständig für den beschriebenen Quellstand; native Sprachpakete, Rechtsdokumente und Storetexte liegen außerhalb dieses Auftrags.
