Fix speedtest card color: compute health from booked speed ratio

The speedtest card always showed green (health-good). Now computes
health class based on download speed vs. booked speed from settings:
>=80% = green, 50-80% = yellow/warning, <50% = red/critical.
Upload values are colored independently. Falls back to green when
no booked speed is configured.

Adds booked_download / booked_upload settings (Mbps) with i18n
support for EN, DE, FR, ES.

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

Author: Dennis Braun

app/config.py

@@ -37,6 +37,8 @@
     "bqm_url": "",
     "speedtest_tracker_url": "",
     "speedtest_tracker_token": "",
+    "booked_download": 0,
+    "booked_upload": 0,
 }
 
 ENV_MAP = {
@@ -72,7 +74,7 @@
     "fritz_password": "modem_password",
 }
 
-INT_KEYS = {"mqtt_port", "poll_interval", "web_port", "history_days"}
+INT_KEYS = {"mqtt_port", "poll_interval", "web_port", "history_days", "booked_download", "booked_upload"}
 
 
 class ConfigManager:

app/i18n/de.json

@@ -214,6 +214,10 @@
   "speedtest_url_hint": "Basis-URL deiner Speedtest Tracker Instanz",
   "speedtest_token": "API-Token",
   "speedtest_token_hint": "Bearer-Token aus den Speedtest Tracker Einstellungen",
+  "booked_download": "Gebuchter Download (Mbps)",
+  "booked_download_hint": "Vertraglich gebuchte Download-Geschwindigkeit in Mbps fuer die Bewertung",
+  "booked_upload": "Gebuchter Upload (Mbps)",
+  "booked_upload_hint": "Vertraglich gebuchte Upload-Geschwindigkeit in Mbps fuer die Bewertung",
   "speedtest_setup_title": "Speedtest Tracker Integration",
   "speedtest_setup_intro": "Speedtest Tracker ist eine selbst gehostete App, die regelmaessig Ookla-Speedtests durchfuehrt. DOCSight kann deine Speedtest-Ergebnisse neben den Modemsignaldaten anzeigen.",
   "speedtest_setup_benefits_title": "Warum Speedtest Tracker nutzen?",

app/i18n/en.json

@@ -214,6 +214,10 @@
   "speedtest_url_hint": "Base URL of your Speedtest Tracker instance",
   "speedtest_token": "API Token",
   "speedtest_token_hint": "Bearer token from Speedtest Tracker settings",
+  "booked_download": "Booked Download (Mbps)",
+  "booked_download_hint": "Contracted download speed in Mbps for health calculation",
+  "booked_upload": "Booked Upload (Mbps)",
+  "booked_upload_hint": "Contracted upload speed in Mbps for health calculation",
   "speedtest_setup_title": "Speedtest Tracker Integration",
   "speedtest_setup_intro": "Speedtest Tracker is a self-hosted app that runs periodic Ookla speed tests. DOCSight can display your speed test results alongside modem signal data for a complete picture of your connection.",
   "speedtest_setup_benefits_title": "Why use Speedtest Tracker?",

app/i18n/es.json

@@ -209,6 +209,10 @@
   "speedtest_url_hint": "URL base de tu instancia de Speedtest Tracker",
   "speedtest_token": "Token API",
   "speedtest_token_hint": "Token Bearer de la configuración de Speedtest Tracker",
+  "booked_download": "Descarga contratada (Mbps)",
+  "booked_download_hint": "Velocidad de descarga contratada en Mbps para el calculo de estado",
+  "booked_upload": "Subida contratada (Mbps)",
+  "booked_upload_hint": "Velocidad de subida contratada en Mbps para el calculo de estado",
   "speedtest_setup_title": "Integración con Speedtest Tracker",
   "speedtest_setup_intro": "Speedtest Tracker es una aplicación autoalojada que ejecuta pruebas de velocidad Ookla periódicas. DOCSight puede mostrar tus resultados de speedtest junto a los datos de señal del módem.",
   "speedtest_setup_benefits_title": "¿Por qué usar Speedtest Tracker?",

app/i18n/fr.json

@@ -206,6 +206,10 @@
   "speedtest_url_hint": "URL de base de votre instance Speedtest Tracker",
   "speedtest_token": "Jeton API",
   "speedtest_token_hint": "Jeton Bearer depuis les paramètres de Speedtest Tracker",
+  "booked_download": "Debit descendant souscrit (Mbps)",
+  "booked_download_hint": "Debit descendant contractuel en Mbps pour le calcul de sante",
+  "booked_upload": "Debit montant souscrit (Mbps)",
+  "booked_upload_hint": "Debit montant contractuel en Mbps pour le calcul de sante",
   "speedtest_setup_title": "Intégration Speedtest Tracker",
   "speedtest_setup_intro": "Speedtest Tracker est une application auto-hébergée qui effectue des tests de vitesse Ookla périodiques. DOCSight peut afficher vos résultats de speedtest à côté des données du signal modem.",
   "speedtest_setup_benefits_title": "Pourquoi utiliser Speedtest Tracker ?",

app/templates/index.html

@@ -1009,7 +1009,36 @@
 
         {# ── Card 4: Speed (Speedtest Tracker) ── #}
         {% if speedtest_configured and speedtest_latest %}
-        <div class="metric-card health-good">
+        {# Compute speed health based on booked speed: >=80% good, 50-80% warn, <50% crit #}
+        {% if booked_download and booked_download > 0 %}
+            {% set dl_ratio = speedtest_latest.download_mbps / booked_download %}
+            {% if dl_ratio >= 0.8 %}
+                {% set speed_health = 'health-good' %}
+                {% set dl_val_class = 'val-good' %}
+            {% elif dl_ratio >= 0.5 %}
+                {% set speed_health = 'health-warn' %}
+                {% set dl_val_class = 'val-warn' %}
+            {% else %}
+                {% set speed_health = 'health-crit' %}
+                {% set dl_val_class = 'val-bad' %}
+            {% endif %}
+        {% else %}
+            {% set speed_health = 'health-good' %}
+            {% set dl_val_class = 'val-good' %}
+        {% endif %}
+        {% if booked_upload and booked_upload > 0 %}
+            {% set ul_ratio = speedtest_latest.upload_mbps / booked_upload %}
+            {% if ul_ratio >= 0.8 %}
+                {% set ul_val_class = 'val-good' %}
+            {% elif ul_ratio >= 0.5 %}
+                {% set ul_val_class = 'val-warn' %}
+            {% else %}
+                {% set ul_val_class = 'val-bad' %}
+            {% endif %}
+        {% else %}
+            {% set ul_val_class = 'val-good' %}
+        {% endif %}
+        <div class="metric-card {{ speed_health }}">
             <div class="metric-card-header" onclick="toggleCard(this.parentNode)">
                 <span class="status-dot"></span>
                 <span class="card-title">&#9889; {{ t.speed }}</span>
@@ -1018,11 +1047,11 @@
             <div class="metric-card-body">
                 <div class="metric-row">
                     <div class="metric-item">
-                        <div class="metric-value val-good">{{ speedtest_latest.download_human or (speedtest_latest.download_mbps ~ ' Mbps') }}</div>
+                        <div class="metric-value {{ dl_val_class }}">{{ speedtest_latest.download_human or (speedtest_latest.download_mbps ~ ' Mbps') }}</div>
                         <div class="metric-label">{{ t.download }}</div>
                     </div>
                     <div class="metric-item">
-                        <div class="metric-value val-good">{{ speedtest_latest.upload_human or (speedtest_latest.upload_mbps ~ ' Mbps') }}</div>
+                        <div class="metric-value {{ ul_val_class }}">{{ speedtest_latest.upload_human or (speedtest_latest.upload_mbps ~ ' Mbps') }}</div>
                         <div class="metric-label">{{ t.upload }}</div>
                     </div>
                 </div>

app/templates/settings.html

@@ -245,6 +245,16 @@ <h2>{{ t.general }}</h2>
                 <input type="password" id="speedtest_tracker_token" name="speedtest_tracker_token" value="" placeholder="{% if config.speedtest_tracker_token %}{{ t.saved_ph }}{% endif %}">
                 <span class="hint">{{ t.speedtest_token_hint }}</span>
             </div>
+            <div class="form-row">
+                <label for="booked_download">{{ t.booked_download }}</label>
+                <input type="number" id="booked_download" name="booked_download" value="{{ config.booked_download or '' }}" min="0" step="1" placeholder="e.g. 1000">
+                <span class="hint">{{ t.booked_download_hint }}</span>
+            </div>
+            <div class="form-row">
+                <label for="booked_upload">{{ t.booked_upload }}</label>
+                <input type="number" id="booked_upload" name="booked_upload" value="{{ config.booked_upload or '' }}" min="0" step="1" placeholder="e.g. 50">
+                <span class="hint">{{ t.booked_upload_hint }}</span>
+            </div>
         </div>
     </details>
 

app/web.py

@@ -231,6 +231,8 @@ def index():
     bqm_configured = _config_manager.is_bqm_configured() if _config_manager else False
     speedtest_configured = _config_manager.is_speedtest_configured() if _config_manager else False
     speedtest_latest = _state.get("speedtest_latest")
+    booked_download = _config_manager.get("booked_download", 0) if _config_manager else 0
+    booked_upload = _config_manager.get("booked_upload", 0) if _config_manager else 0
     conn_info = _state.get("connection_info") or {}
     dev_info = _state.get("device_info") or {}
 
@@ -269,6 +271,8 @@ def _has_us_ofdma(analysis):
                 bqm_configured=bqm_configured,
                 speedtest_configured=speedtest_configured,
                 speedtest_latest=speedtest_latest,
+                booked_download=booked_download,
+                booked_upload=booked_upload,
                 uncorr_pct=_compute_uncorr_pct(snapshot),
                 has_us_ofdma=_has_us_ofdma(snapshot),
                 device_info=dev_info,
@@ -288,6 +292,8 @@ def _has_us_ofdma(analysis):
         bqm_configured=bqm_configured,
         speedtest_configured=speedtest_configured,
         speedtest_latest=speedtest_latest,
+        booked_download=booked_download,
+        booked_upload=booked_upload,
         uncorr_pct=_compute_uncorr_pct(_state["analysis"]),
         has_us_ofdma=_has_us_ofdma(_state["analysis"]),
         device_info=dev_info,