Redesign health status with translated issues and actionable guidance

Health banner now shows status icon, translated explanation, and
per-issue descriptions with recommendations. Analyzer uses English
keys (good/marginal/poor) translated in UI. Channel groups collapsed
by default.

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

Author: itsDNNS

CHANGELOG.md

@@ -4,6 +4,13 @@ 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-09.10]
+
+### Changed
+- **Health status redesigned**: Informative banner with translated status, explanation, and per-issue descriptions with actionable recommendations
+- **Analyzer outputs English keys**: Health uses `good/marginal/poor`, issues are machine-readable keys translated in the UI
+- **Channel groups collapsed by default**: Less visual clutter, expand to inspect
+
 ## [2026-02-09.9]
 
 ### Added

app/analyzer.py

@@ -38,20 +38,10 @@ def _channel_health(issues):
 
 
 def _health_detail(issues):
-    """Build a human-readable detail string from issue list."""
+    """Build a machine-readable detail string from issue list."""
     if not issues:
         return ""
-    labels = []
-    for i in issues:
-        if "power" in i and "critical" in i:
-            labels.append("Power kritisch")
-        elif "power" in i:
-            labels.append("Power erhoeht")
-        if "snr" in i and "critical" in i:
-            labels.append("SNR kritisch")
-        elif "snr" in i:
-            labels.append("SNR niedrig")
-    return " + ".join(labels) if labels else ""
+    return " + ".join(issues)
 
 
 def _assess_ds_channel(ch, docsis_ver):
@@ -201,25 +191,25 @@ def analyze(data: dict) -> dict:
     # --- Overall health ---
     issues = []
     if ds_powers and (min(ds_powers) < -DS_POWER_CRIT or max(ds_powers) > DS_POWER_CRIT):
-        issues.append("DS Power ausserhalb Norm")
+        issues.append("ds_power_critical")
     if us_powers and max(us_powers) > US_POWER_CRIT:
-        issues.append("US Power kritisch hoch")
+        issues.append("us_power_critical")
     elif us_powers and max(us_powers) > US_POWER_WARN:
-        issues.append("US Power erhoeht")
+        issues.append("us_power_warn")
     if ds_snrs and min(ds_snrs) < SNR_CRIT:
-        issues.append("SNR zu niedrig")
+        issues.append("snr_critical")
     elif ds_snrs and min(ds_snrs) < SNR_WARN:
-        issues.append("SNR grenzwertig")
+        issues.append("snr_warn")
     if total_uncorr > UNCORR_ERRORS_CRIT:
-        issues.append("Viele uncorrectable Errors")
+        issues.append("uncorr_errors_high")
 
     if not issues:
-        summary["health"] = "Gut"
-    elif any("kritisch" in i for i in issues):
-        summary["health"] = "Schlecht"
+        summary["health"] = "good"
+    elif any("critical" in i for i in issues):
+        summary["health"] = "poor"
     else:
-        summary["health"] = "Grenzwertig"
-    summary["health_details"] = "; ".join(issues) if issues else "Alles OK"
+        summary["health"] = "marginal"
+    summary["health_issues"] = issues
 
     log.info(
         "Analysis: DS=%d US=%d Health=%s",

app/i18n.py

@@ -16,12 +16,37 @@
     "open_calendar": "Open calendar",
     "last_update": "Last Update",
 
-    # Health (display labels for analyzer values Gut/Grenzwertig/Schlecht)
+    # Health status
     "health_good": "Good",
     "health_marginal": "Marginal",
     "health_poor": "Poor",
     "health_warning": "Warning",
     "health_critical": "Critical",
+    "health_good_msg": "Your connection looks healthy. All values are within normal range.",
+    "health_marginal_msg": "Some values are outside the ideal range. This may not affect your internet experience yet, but is worth monitoring.",
+    "health_poor_msg": "One or more values are critically out of range. You may experience connection issues such as slow speeds, dropouts, or high latency.",
+    "all_ok": "All channels operating normally.",
+    "issues_found": "Issues detected",
+
+    # Health issue descriptions
+    "issue_ds_power_critical": "Downstream power out of spec",
+    "issue_ds_power_critical_desc": "Signal level exceeds +/-10 dBmV. This usually indicates a cabling or amplifier problem. Contact your ISP if the issue persists.",
+    "issue_us_power_critical": "Upstream power critically high",
+    "issue_us_power_critical_desc": "Transmit power exceeds 54 dBmV. Your modem is working too hard to reach the provider. Check cable connections or request a signal check from your ISP.",
+    "issue_us_power_warn": "Upstream power elevated",
+    "issue_us_power_warn_desc": "Transmit power is between 50-54 dBmV (ideal: 35-49). May indicate signal loss on the line. Monitor this value over time.",
+    "issue_snr_critical": "Signal-to-noise ratio critically low",
+    "issue_snr_critical_desc": "SNR below 25 dB causes packet loss and connection instability. Common causes: damaged coax cable, loose connectors, or interference from splitters.",
+    "issue_snr_warn": "Signal-to-noise ratio below ideal",
+    "issue_snr_warn_desc": "SNR between 25-30 dB (ideal: above 30 dB). Connection works but has reduced margin for error. Consider checking cable quality.",
+    "issue_uncorr_errors_high": "High uncorrectable error count",
+    "issue_uncorr_errors_high_desc": "Over 10,000 uncorrectable errors detected. These cannot be recovered and cause data loss. If this number grows rapidly, contact your ISP.",
+
+    # Channel health tooltips
+    "ch_power_critical": "Power critically out of range",
+    "ch_power_warning": "Power slightly elevated",
+    "ch_snr_critical": "SNR critically low",
+    "ch_snr_warning": "SNR below ideal",
 
     # Summary cards
     "ds_channels": "Downstream Channels",
@@ -157,6 +182,29 @@
     "health_poor": "Schlecht",
     "health_warning": "Warnung",
     "health_critical": "Kritisch",
+    "health_good_msg": "Deine Verbindung sieht gut aus. Alle Werte sind im Normalbereich.",
+    "health_marginal_msg": "Einige Werte liegen ausserhalb des Idealbereichs. Das beeintraechtigt dein Internet moeglicherweise noch nicht, sollte aber beobachtet werden.",
+    "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",
+    "issue_us_power_critical_desc": "Sendeleistung ueberschreitet 54 dBmV. Dein Modem arbeitet zu hart, um den Anbieter zu erreichen. Pruefe Kabelverbindungen oder fordere eine Signalmessung an.",
+    "issue_us_power_warn": "Upstream-Sendeleistung erhoeht",
+    "issue_us_power_warn_desc": "Sendeleistung zwischen 50-54 dBmV (ideal: 35-49). Kann auf Signalverlust hindeuten. Beobachte diesen Wert ueber Zeit.",
+    "issue_snr_critical": "Signal-Rausch-Verhaeltnis kritisch niedrig",
+    "issue_snr_critical_desc": "SNR unter 25 dB verursacht Paketverluste und Verbindungsinstabilitaet. Haeufige Ursachen: beschaedigtes Koax-Kabel, lose Stecker oder Stoerungen durch Splitter.",
+    "issue_snr_warn": "Signal-Rausch-Verhaeltnis unter Idealwert",
+    "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",

app/templates/index.html

@@ -173,12 +173,28 @@
         }
         .history-banner a { color: var(--info); font-size: 0.85em; }
         .health-banner {
-            padding: 12px 20px; border-radius: 8px;
-            font-size: 1.1em; font-weight: bold; margin-bottom: 16px;
-        }
-        .health-good { background: rgba(76,175,80,0.2); border: 1px solid var(--good); color: var(--good); }
-        .health-warn { background: rgba(255,152,0,0.2); border: 1px solid var(--warn); color: var(--warn); }
-        .health-crit { background: rgba(244,67,54,0.2); border: 1px solid var(--crit); color: var(--crit); }
+            padding: 16px 20px; border-radius: 8px; margin-bottom: 16px;
+        }
+        .health-good { background: rgba(76,175,80,0.1); border: 1px solid var(--good); }
+        .health-warn { background: rgba(255,152,0,0.1); border: 1px solid var(--warn); }
+        .health-crit { background: rgba(244,67,54,0.1); border: 1px solid var(--crit); }
+        .health-status { display: flex; align-items: center; gap: 10px; margin-bottom: 6px; }
+        .health-icon { font-size: 1.4em; }
+        .health-good .health-icon { color: var(--good); }
+        .health-warn .health-icon { color: var(--warn); }
+        .health-crit .health-icon { color: var(--crit); }
+        .health-title { font-size: 1.15em; font-weight: bold; }
+        .health-good .health-title { color: var(--good); }
+        .health-warn .health-title { color: var(--warn); }
+        .health-crit .health-title { color: var(--crit); }
+        .health-msg { font-size: 0.9em; color: var(--text); opacity: 0.85; margin-bottom: 4px; }
+        .health-issues { margin-top: 10px; display: flex; flex-direction: column; gap: 8px; }
+        .health-issue {
+            padding: 8px 12px; border-radius: 6px;
+            background: rgba(0,0,0,0.15);
+        }
+        .health-issue-name { font-weight: bold; font-size: 0.9em; display: block; }
+        .health-issue-desc { font-size: 0.82em; color: var(--muted); margin-top: 2px; display: block; }
         h2.section-title { font-size: 1.1em; margin: 16px 0 8px; color: var(--accent); }
         .summary-grid {
             display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
@@ -414,16 +430,43 @@
     {% set ds = analysis.ds_channels %}
     {% set us = analysis.us_channels %}
 
-    {% set health_labels = {"Gut": t.health_good, "Grenzwertig": t.health_marginal, "Schlecht": t.health_poor} %}
-    {% set health_label = health_labels.get(s.health, s.health) %}
-
-    {% if s.health == "Gut" %}
-    <div class="health-banner health-good">{{ health_label }} &mdash; {{ s.health_details }}</div>
-    {% elif s.health == "Schlecht" %}
-    <div class="health-banner health-crit">{{ health_label }} &mdash; {{ s.health_details }}</div>
-    {% else %}
-    <div class="health-banner health-warn">{{ health_label }} &mdash; {{ s.health_details }}</div>
-    {% endif %}
+    {% set health_map = {"good": t.health_good, "marginal": t.health_marginal, "poor": t.health_poor} %}
+    {% set health_label = health_map.get(s.health, s.health) %}
+    {% set health_msgs = {"good": t.health_good_msg, "marginal": t.health_marginal_msg, "poor": t.health_poor_msg} %}
+    {% set issue_labels = {
+        "ds_power_critical": t.issue_ds_power_critical,
+        "us_power_critical": t.issue_us_power_critical,
+        "us_power_warn": t.issue_us_power_warn,
+        "snr_critical": t.issue_snr_critical,
+        "snr_warn": t.issue_snr_warn,
+        "uncorr_errors_high": t.issue_uncorr_errors_high,
+    } %}
+    {% set issue_descs = {
+        "ds_power_critical": t.issue_ds_power_critical_desc,
+        "us_power_critical": t.issue_us_power_critical_desc,
+        "us_power_warn": t.issue_us_power_warn_desc,
+        "snr_critical": t.issue_snr_critical_desc,
+        "snr_warn": t.issue_snr_warn_desc,
+        "uncorr_errors_high": t.issue_uncorr_errors_high_desc,
+    } %}
+
+    <div class="health-banner health-{{ 'good' if s.health == 'good' else ('crit' if s.health == 'poor' else 'warn') }}">
+        <div class="health-status">
+            <span class="health-icon">{% if s.health == 'good' %}&#10004;{% elif s.health == 'poor' %}&#10006;{% else %}&#9888;{% endif %}</span>
+            <span class="health-title">{{ health_label }}</span>
+        </div>
+        <div class="health-msg">{{ health_msgs.get(s.health, '') }}</div>
+        {% if s.health_issues %}
+        <div class="health-issues">
+            {% for issue in s.health_issues %}
+            <div class="health-issue">
+                <span class="health-issue-name">{{ issue_labels.get(issue, issue) }}</span>
+                <span class="health-issue-desc">{{ issue_descs.get(issue, '') }}</span>
+            </div>
+            {% endfor %}
+        </div>
+        {% endif %}
+    </div>
 
     <div class="summary-grid">
         {% if isp_name or connection_info %}
@@ -460,7 +503,7 @@
 
     <h2 class="section-title">{{ t.downstream }} ({{ ds|length }} {{ t.channels }})</h2>
     {% for group in ds|sort(attribute='docsis_version', reverse=true)|groupby('docsis_version') %}
-    <details class="channel-group" open>
+    <details class="channel-group">
         <summary>DOCSIS {{ group.grouper }} ({{ group.list|length }} {{ t.channels }})</summary>
         <table class="sortable">
             <thead><tr>
@@ -470,10 +513,13 @@ <h2 class="section-title">{{ t.downstream }} ({{ ds|length }} {{ t.channels }})<
             <tbody>
             {% for ch in group.list %}
             <tr>
+                {% set ch_tips = {"power critical": t.ch_power_critical, "power warning": t.ch_power_warning, "snr critical": t.ch_snr_critical, "snr warning": t.ch_snr_warning} %}
+                {% set ch_tip_parts = [] %}
+                {% for key, label in ch_tips.items() %}{% if key in ch.health_detail %}{% if ch_tip_parts.append(label) %}{% endif %}{% endif %}{% endfor %}
                 <td data-sort="{{ 0 if ch.health == 'good' else (2 if ch.health == 'critical' else 1) }}">
                     {% if ch.health == "good" %}<span class="badge badge-good">{{ t.health_good }}</span>
-                    {% elif ch.health == "critical" %}<span class="badge badge-crit" title="{{ ch.health_detail }}">{{ t.health_critical }}</span>
-                    {% else %}<span class="badge badge-warn" title="{{ ch.health_detail }}">{{ t.health_warning }}</span>{% endif %}
+                    {% elif ch.health == "critical" %}<span class="badge badge-crit" title="{{ ch_tip_parts|join(', ') }}">{{ t.health_critical }}</span>
+                    {% else %}<span class="badge badge-warn" title="{{ ch_tip_parts|join(', ') }}">{{ t.health_warning }}</span>{% endif %}
                 </td>
                 <td data-sort="{{ ch.channel_id }}">{{ ch.channel_id }}</td>
                 <td>{{ ch.frequency }}</td>
@@ -491,7 +537,7 @@ <h2 class="section-title">{{ t.downstream }} ({{ ds|length }} {{ t.channels }})<
 
     <h2 class="section-title">{{ t.upstream }} ({{ us|length }} {{ t.channels }})</h2>
     {% for group in us|sort(attribute='docsis_version', reverse=true)|groupby('docsis_version') %}
-    <details class="channel-group" open>
+    <details class="channel-group">
         <summary>DOCSIS {{ group.grouper }} ({{ group.list|length }} {{ t.channels }})</summary>
         <table class="sortable">
             <thead><tr>
@@ -500,11 +546,12 @@ <h2 class="section-title">{{ t.upstream }} ({{ us|length }} {{ t.channels }})</h
             </tr></thead>
             <tbody>
             {% for ch in group.list %}
+            {% set ch_tip = t.ch_power_critical if 'power critical' in ch.health_detail else (t.ch_power_warning if 'power warning' in ch.health_detail else '') %}
             <tr>
                 <td data-sort="{{ 0 if ch.health == 'good' else (2 if ch.health == 'critical' else 1) }}">
                     {% if ch.health == "good" %}<span class="badge badge-good">{{ t.health_good }}</span>
-                    {% elif ch.health == "critical" %}<span class="badge badge-crit" title="{{ ch.health_detail }}">{{ t.health_critical }}</span>
-                    {% else %}<span class="badge badge-warn" title="{{ ch.health_detail }}">{{ t.health_warning }}</span>{% endif %}
+                    {% elif ch.health == "critical" %}<span class="badge badge-crit" title="{{ ch_tip }}">{{ t.health_critical }}</span>
+                    {% else %}<span class="badge badge-warn" title="{{ ch_tip }}">{{ t.health_warning }}</span>{% endif %}
                 </td>
                 <td data-sort="{{ ch.channel_id }}">{{ ch.channel_id }}</td>
                 <td>{{ ch.frequency }}</td>

app/web.py

@@ -291,7 +291,7 @@ def api_export():
         f"- **ISP**: {isp}" if isp else None,
         f"- **Tariff**: {ds_mbps}/{us_mbps} Mbit/s (Down/Up)" if ds_mbps else None,
         f"- **Health**: {s.get('health', 'Unknown')}",
-        f"- **Details**: {s.get('health_details', '')}",
+        f"- **Issues**: {', '.join(s.get('health_issues', []))}" if s.get('health_issues') else None,
         f"- **Timestamp**: {ts}",
         "",
         "## Summary",