Merge dev into main for v2026-02-11.19 release

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Dennis Braun

CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to this project will be documented in this file.
 
 Versioning: `YYYY-MM-DD.N` (date + sequential build number per day)
 
+## [2026-02-11.19]
+
+### Added
+- **Incident Report Export**: Two-step flow — editable ISP complaint letter with customer data fields + downloadable technical PDF report with channel tables, worst values, and DIN threshold references
+- **Report i18n**: Full PDF report localization in 4 languages (EN/DE/FR/ES) with locale-appropriate regulatory authorities (Bundesnetzagentur, ARCEP, etc.)
+- **Language selector in topbar**: Country flag dropdown (🇬🇧🇩🇪🇫🇷🇪🇸) for quick language switching
+- **BQM setup guide**: Sidebar link always visible; when not configured, opens modal with benefits and step-by-step setup instructions (DynDNS, WAN ping, ThinkBroadband registration)
+- **Bundled DejaVu fonts**: PDF generation works in Docker without host font dependencies
+
+### Changed
+- **Settings moved to sidebar bottom**: Following common UI convention
+- **Report modal redesign**: Split into complaint letter (copyable text) + technical report (PDF attachment) for easier ISP communication
+
+### Fixed
+- **BQM modal HTML rendering**: i18n strings with HTML tags now render correctly via Jinja2 safe filter
+
 ## [2026-02-09.18]
 
 ### Added

README.md

@@ -167,7 +167,7 @@ DOCSight can optionally publish all channel data to Home Assistant via MQTT Auto
 - [ ] **Ingress/Return Path Scoring**: Composite score based on upstream power levels, modulation quality, and channel count to detect return path interference before total failure
 
 ### Diagnosis & Reporting
-- [ ] **Incident Report Export**: One-click PDF/report with worst modulation values, max power levels, error sums, and auto-generated ISP complaint text referencing DIN thresholds — ready to email to your ISP's tech support
+- [x] **Incident Report Export**: Two-step flow — editable ISP complaint letter with customer data fields + downloadable technical PDF with channel tables, worst values, and DIN threshold references (EN/DE/FR/ES)
 - [ ] **Ping Correlation**: Built-in latency monitor (ping to configurable targets) overlaid on error graphs to prove causality between physical layer issues and packet loss — replaces manual PingPlotter usage
 - [ ] **Before/After Comparison**: Side-by-side overlay of two time periods (e.g. week before vs. after technician visit) to quantify improvements
 - [ ] **FritzBox Event Log Parser**: Extract and display T3/T4 Timeout events, Ranging Request failures, and other DOCSIS error codes from the modem's event log

app/fonts/DejaVuSans-Bold.ttf

@@ -6,6 +6,7 @@
 _DIR = os.path.dirname(__file__)
 _TRANSLATIONS = {}
 LANGUAGES = {}
+LANG_FLAGS = {}
 
 # Load all *.json files in this directory
 for _fname in sorted(os.listdir(_DIR)):
@@ -17,6 +18,7 @@
     _meta = _data.pop("_meta", {})
     _TRANSLATIONS[_code] = _data
     LANGUAGES[_code] = _meta.get("language_name", _code)
+    LANG_FLAGS[_code] = _meta.get("flag", "")
 
 
 def get_translations(lang="en"):

app/fonts/DejaVuSans-Oblique.ttf

@@ -1,17 +1,17 @@
 {
-  "_meta": { "language_name": "Deutsch" },
-
+  "_meta": {
+    "language_name": "Deutsch",
+    "flag": "🇩🇪"
+  },
   "nav": "Navigation",
   "live_dashboard": "Live Dashboard",
   "day_trend": "Tagesverlauf",
   "week_trend": "Wochentrend",
   "month_trend": "Monatstrend",
   "settings": "Einstellungen",
   "reference_values": "Richtwerte",
-
   "open_calendar": "Kalender oeffnen",
   "last_update": "Letztes Update",
-
   "health_good": "Gut",
   "health_marginal": "Grenzwertig",
   "health_poor": "Schlecht",
@@ -22,7 +22,6 @@
   "health_poor_msg": "Ein oder mehrere Werte sind kritisch. Du koenntest Verbindungsprobleme wie langsame Geschwindigkeiten, Abbrueche oder hohe Latenz bemerken.",
   "all_ok": "Alle Kanaele arbeiten normal.",
   "issues_found": "Probleme erkannt",
-
   "issue_ds_power_critical": "Downstream-Pegel ausserhalb der Spezifikation",
   "issue_ds_power_critical_desc": "Signalpegel ueberschreitet +/-10 dBmV. Das deutet meist auf ein Kabel- oder Verstaerkerproblem hin. Kontaktiere deinen Anbieter, wenn das Problem bestehen bleibt.",
   "issue_us_power_critical": "Upstream-Sendeleistung kritisch hoch",
@@ -35,19 +34,16 @@
   "issue_snr_warn_desc": "SNR zwischen 25-30 dB (ideal: ueber 30 dB). Verbindung funktioniert, hat aber weniger Fehlertoleranz. Pruefe die Kabelqualitaet.",
   "issue_uncorr_errors_high": "Hohe Anzahl unkorrigierbarer Fehler",
   "issue_uncorr_errors_high_desc": "Ueber 10.000 unkorrigierbare Fehler erkannt. Diese koennen nicht repariert werden und verursachen Datenverlust. Wenn diese Zahl schnell waechst, kontaktiere deinen Anbieter.",
-
   "ch_power_critical": "Pegel kritisch ausserhalb des Bereichs",
   "ch_power_warning": "Pegel leicht erhoeht",
   "ch_snr_critical": "SNR kritisch niedrig",
   "ch_snr_warning": "SNR unter Idealwert",
-
   "ds_channels": "Downstream Kanaele",
   "us_channels": "Upstream Kanaele",
   "ds_power_range": "DS Power (Min / Avg / Max)",
   "ds_snr_range": "DS SNR (Min / Avg)",
   "ds_errors_label": "DS Fehler (korr. / unkorr.)",
   "us_power_range": "US Power (Min / Avg / Max)",
-
   "status": "Status",
   "channel": "Kanal",
   "frequency": "Frequenz",
@@ -60,18 +56,15 @@
   "channels": "Kanaele",
   "downstream": "Downstream",
   "upstream": "Upstream",
-
   "metric": "Metrik",
   "good": "Gut",
   "marginal": "Grenz.",
   "poor": "Schlecht",
   "low": "niedrig",
-
   "historical_view": "Historische Ansicht",
   "back_to_live": "Zurueck zu Live",
   "error_label": "Fehler",
   "waiting_msg": "Warte auf erste DOCSIS-Abfrage...",
-
   "no_data": "Keine Daten fuer diesen Zeitraum vorhanden.",
   "trend_error": "Fehler beim Laden der Trenddaten.",
   "correctable": "Korrigierbar",
@@ -80,14 +73,24 @@
   "ds_power_avg": "DS Power Avg (dBmV)",
   "ds_snr_avg": "DS SNR Avg (dB)",
   "us_power_avg": "US Power Avg (dBmV)",
-
   "live": "Live",
   "day": "Tag",
   "week": "Woche",
   "month": "Monat",
-  "months": ["Januar", "Februar", "Maerz", "April", "Mai", "Juni",
-             "Juli", "August", "September", "Oktober", "November", "Dezember"],
-
+  "months": [
+    "Januar",
+    "Februar",
+    "Maerz",
+    "April",
+    "Mai",
+    "Juni",
+    "Juli",
+    "August",
+    "September",
+    "Oktober",
+    "November",
+    "Dezember"
+  ],
   "initial_setup": "Ersteinrichtung",
   "modem_connection": "Modem-Verbindung",
   "modem_user_hint": "Tipp: Lege einen eigenen Benutzer fuer DOCSight an, anstatt deinen Haupt-Admin zu verwenden.",
@@ -118,7 +121,6 @@
   "unknown_error": "Unbekannt",
   "error_prefix": "Fehler",
   "default": "Standard",
-
   "back_dashboard": "Zurueck zum Dashboard",
   "light_mode": "Light Mode",
   "dark_mode": "Dark Mode",
@@ -127,41 +129,45 @@
   "settings_saved": "Einstellungen gespeichert",
   "save_failed": "Speichern fehlgeschlagen",
   "saved_ph": "Gespeichert",
-
   "language": "Sprache",
-
   "isp_name": "Internetanbieter",
   "isp_hint": "Wird im LLM-Export angezeigt",
   "isp_other": "Andere",
   "isp_other_placeholder": "Anbietername eingeben",
   "isp_select": "Anbieter waehlen",
-  "isp_options": ["Vodafone", "PYUR", "eazy", "O2", "1&1", "Telekom", "NetCologne", "M-net", "Wilhelm.tel"],
+  "isp_options": [
+    "Vodafone",
+    "PYUR",
+    "eazy",
+    "O2",
+    "1&1",
+    "Telekom",
+    "NetCologne",
+    "M-net",
+    "Wilhelm.tel"
+  ],
   "tariff": "Tarif",
   "max_downstream": "Max Downstream",
   "max_upstream": "Max Upstream",
-
   "export_llm": "Export fuer LLM",
   "export_title": "LLM-Analyse Export",
   "export_hint": "Kopiere diesen Text und fuege ihn in dein bevorzugtes LLM (ChatGPT, Claude, Gemini, ...) ein, um Insights zu deiner Verbindung zu erhalten.",
   "copy_clipboard": "In Zwischenablage kopieren",
   "copied": "Kopiert!",
   "close": "Schliessen",
   "export_no_data": "Noch keine Daten vorhanden. Warte auf die erste Abfrage.",
-
   "login_title": "Anmeldung",
   "login_hint": "Gib das Admin-Passwort ein, um auf DOCSight zuzugreifen.",
   "login_failed": "Falsches Passwort",
   "login_button": "Anmelden",
   "logout": "Abmelden",
   "admin_password": "Admin-Passwort",
   "admin_password_hint": "Leer lassen um Authentifizierung zu deaktivieren",
-
   "bqm_title": "BQM-Graphen",
   "bqm_optional": "optional",
   "bqm_share_url": "BQM Share-URL",
   "bqm_url_hint": "ThinkBroadband BQM Share-Link einfuegen (.png)",
   "bqm_no_data": "Kein BQM-Graph fuer dieses Datum.",
-
   "card_signal_quality": "Downstream",
   "card_upstream": "Upstream",
   "card_errors": "Fehler",
@@ -176,5 +182,29 @@
   "card_uncorr_exact": "Unkorrigierbar (exakt)",
   "card_corr_exact": "Korrigierbar (exakt)",
   "card_errors_note": "Unkorrigierbare Fehler koennen nicht wiederhergestellt werden. Hohe und steigende Werte deuten auf ein Kabelproblem hin.",
-  "card_uptime": "Modem-Laufzeit"
-}
+  "card_uptime": "Modem-Laufzeit",
+  "incident_report": "Störungsbericht",
+  "generate_report": "Bericht erstellen",
+  "report_days": "Berichtszeitraum (Tage)",
+  "report_description": "PDF-Bericht mit Signaldaten, Extremwerten und einem vorformulierten Beschwerdebrief an den Provider.",
+  "bqm_setup_title": "Broadband Quality Monitor (BQM)",
+  "bqm_setup_intro": "BQM von ThinkBroadband überwacht deine Verbindungsqualität, indem es deine öffentliche IP von externen Servern aus anpingt. DOCSight kann BQM-Graphen neben deinen Modemdaten anzeigen.",
+  "bqm_setup_benefits_title": "Warum BQM nutzen?",
+  "bqm_setup_benefit_1": "Unabhängiger Nachweis von Verbindungsproblemen (nicht nur modemseitig)",
+  "bqm_setup_benefit_2": "Überwacht Latenz, Paketverlust und Durchsatz rund um die Uhr",
+  "bqm_setup_benefit_3": "Stärkt ISP-Beschwerden mit Drittanbieter-Belegen",
+  "bqm_setup_howto_title": "So richtest du es ein",
+  "bqm_setup_step_1": "Richte <b>DynDNS</b> auf deinem Router ein (z.B. MyFRITZ! auf der Fritz!Box), damit BQM deine IP findet",
+  "bqm_setup_step_2": "Aktiviere <b>WAN-Ping/ICMP</b> auf deinem Router, damit er auf externe Pings antwortet (Fritz!Box: Internet → Freigaben → \"Auf Ping reagieren\" aktivieren)",
+  "bqm_setup_step_3": "Gehe zu <b>thinkbroadband.com/broadband/monitoring</b>, erstelle ein kostenloses Konto und registriere deine DynDNS-Adresse",
+  "bqm_setup_step_4": "Sobald das Monitoring aktiv ist, kopiere deine <b>Share-URL</b> (endet auf .png) und füge sie in DOCSight unter <b>Einstellungen → BQM Share URL</b> ein",
+  "report_language": "Berichtssprache",
+  "report_customer_hint": "Optional: Deine Daten für das Beschwerdeschreiben",
+  "report_name": "Dein Name",
+  "report_customer_number": "Kunden-/Vertragsnummer",
+  "report_address": "Deine Adresse",
+  "report_edit_hint": "Prüfe und bearbeite das Beschwerdeschreiben. Kopiere es zum Versand per E-Mail oder lade den technischen Bericht als PDF-Anhang herunter.",
+  "report_generate_letter": "Schreiben erstellen",
+  "report_copy_letter": "Schreiben kopieren",
+  "report_download_pdf": "Technischen Bericht (PDF) laden"
+}