iobroker.poolcontrol 1.2.12 → 1.2.14

package/README.md

@@ -189,6 +189,16 @@ New features are added regularly – please refer to the changelog.
 
 ## Changelog
 
+### 1.2.14
+Release: 22.03.2026
+- ### add i18n support for chemistry help texts
+
+### 1.2.13
+Release: 22.03.2026
+- Added multilingual state names and descriptions (DE/EN)
+- Improved consistency of all state texts
+- Minor text and structure refinements
+
 ### 1.2.12
 Release: 21.03.2026
 - Repository cleanup and fixes for ioBroker repository checker

package/admin/i18n/de/translations.json

@@ -153,7 +153,5 @@
   "Voice": "Stimme",
   "Volume (0–100)": "Lautstärke (0–100)",
   "Wednesday": "Mittwoch",
-  "option1": "Option1",
-  "option2": "Option2",
   "poolcontrol adapter settings": "Adaptereinstellungen für Poolcontrol"
 }

package/admin/i18n/es/translations.json

@@ -153,7 +153,5 @@
   "Voice": "Voz",
   "Volume (0–100)": "Volumen (0–100)",
   "Wednesday": "Miércoles",
-  "option1": "Opción1",
-  "option2": "opción 2",
   "poolcontrol adapter settings": "Ajustes del adaptador para poolcontrol"
 }

package/admin/i18n/fr/translations.json

@@ -153,7 +153,5 @@
   "Voice": "Voix",
   "Volume (0–100)": "Volume (0 à 100)",
   "Wednesday": "Mercredi",
-  "option1": "option1",
-  "option2": "Option2",
   "poolcontrol adapter settings": "Paramètres d'adaptateur pour poolcontrol"
 }

package/admin/i18n/it/translations.json

@@ -153,7 +153,5 @@
   "Voice": "Voce",
   "Volume (0–100)": "Volume (0–100)",
   "Wednesday": "Mercoledì",
-  "option1": "opzione1",
-  "option2": "opzione2",
   "poolcontrol adapter settings": "Impostazioni dell'adattatore per poolcontrol"
 }

package/admin/i18n/nl/translations.json

@@ -153,7 +153,5 @@
   "Voice": "Stem",
   "Volume (0–100)": "Volume (0–100)",
   "Wednesday": "Woensdag",
-  "option1": "Option1",
-  "option2": "Optie2",
   "poolcontrol adapter settings": "Adapterinstellingen voor poolcontrol"
 }

package/admin/i18n/pl/translations.json

@@ -153,7 +153,5 @@
   "Voice": "Głos",
   "Volume (0–100)": "Głośność (0–100)",
   "Wednesday": "Środa",
-  "option1": "opcja 1",
-  "option2": "opcja2",
   "poolcontrol adapter settings": "Ustawienia adaptera dla poolcontrol"
 }

package/admin/i18n/pt/translations.json

@@ -153,7 +153,5 @@
   "Voice": "Voz",
   "Volume (0–100)": "Volume (0–100)",
   "Wednesday": "Quarta-feira",
-  "option1": "opção1",
-  "option2": "opção2",
   "poolcontrol adapter settings": "Configurações do adaptador para poolcontrol"
 }

package/admin/i18n/ru/translations.json

@@ -153,7 +153,5 @@
   "Voice": "Голос",
   "Volume (0–100)": "Громкость (0–100)",
   "Wednesday": "Среда",
-  "option1": "вариант1",
-  "option2": "вариант2",
   "poolcontrol adapter settings": "Настройки адаптера для poolcontrol"
 }

package/admin/i18n/uk/translations.json

@@ -153,7 +153,5 @@
   "Voice": "Голос",
   "Volume (0–100)": "Обсяг (0–100)",
   "Wednesday": "Середа",
-  "option1": "Варіант1",
-  "option2": "Варіант2",
   "poolcontrol adapter settings": "Налаштування адаптера для poolcontrol"
 }

package/admin/i18n/zh-cn/translations.json

@@ -153,7 +153,5 @@
   "Voice": "嗓音",
   "Volume (0–100)": "音量 (0–100)",
   "Wednesday": "周三",
-  "option1": "选项1",
-  "option2": "选项2",
   "poolcontrol adapter settings": "poolcontrol的适配器设置"
 }

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.2.12",
+    "version": "1.2.14",
     "news": {
+      "1.2.14": {
+        "en": "Add i18n support for chemistry help (common.states and help texts), fix React issues caused by invalid translations, and improve multilingual user guidance.",
+        "de": "i18n-Unterstützung für Chemie-Hilfe hinzugefügt (common.states und Hilfetexte), React-Fehler durch fehlerhafte Übersetzungen behoben und mehrsprachige Benutzerführung verbessert.",
+        "ru": "Добавьте поддержку i18n для справки по химии (common.states и справочные тексты), исправьте проблемы React, вызванные неверными переводами, и улучшите многоязычное руководство пользователя.",
+        "pt": "Adicione suporte i18n para ajuda química (common.states e textos de ajuda), corrija problemas do React causados ​​por traduções inválidas e melhore a orientação multilíngue do usuário.",
+        "nl": "Voeg i18n-ondersteuning toe voor scheikundige hulp (common.states en helpteksten), repareer React-problemen veroorzaakt door ongeldige vertalingen en verbeter de meertalige gebruikersbegeleiding.",
+        "fr": "Ajoutez la prise en charge d'i18n pour l'aide chimique (common.states et textes d'aide), corrigez les problèmes de React causés par des traductions non valides et améliorez le guidage utilisateur multilingue.",
+        "it": "Aggiungi il supporto i18n per la guida in chimica (common.states e testi di aiuto), risolvi i problemi di React causati da traduzioni non valide e migliora la guida utente multilingue.",
+        "es": "Agregue soporte i18n para ayuda sobre química (estados comunes y textos de ayuda), solucione problemas de React causados ​​por traducciones no válidas y mejore la guía del usuario multilingüe.",
+        "pl": "Dodaj obsługę i18n dla pomocy chemicznej (stany wspólne i teksty pomocy), rozwiąż problemy z React spowodowane nieprawidłowymi tłumaczeniami i ulepsz wielojęzyczne wskazówki dla użytkownika.",
+        "uk": "Додайте підтримку i18n для довідки з хімії (common.states і тексти довідки), виправте проблеми з React, викликані недійсними перекладами, і покращте багатомовні інструкції для користувачів.",
+        "zh-cn": "添加对化学帮助（common.states 和帮助文本）的 i18n 支持，修复无效翻译导致的 React 问题，并改进多语言用户指南。"
+      },
       "1.2.12": {
         "en": "Repository cleanup and fixes for ioBroker repository checker. Restored required native object in io-package.json, removed invalid properties and updated README.",
         "de": "Repository-Bereinigung und Fehlerbehebungen für den ioBroker Repository-Checker. Erforderliches native-Objekt in der io-package.json wiederhergestellt, ungültige Eigenschaften entfernt und README aktualisiert.",
@@ -16,19 +29,6 @@
         "uk": "Очищення сховища та виправлення для засобу перевірки сховища ioBroker. Відновлено необхідний рідний об’єкт у io-package.json, видалено недійсні властивості та оновлено README.",
         "zh-cn": "ioBroker 存储库检查器的存储库清理和修复。恢复了 io-package.json 中所需的本机对象，删除了无效属性并更新了 README。"
       },
-      "1.2.11": {
-        "en": "Repository cleanup and fixes for ioBroker repository checker. Removed invalid properties from io-package.json and updated README.",
-        "de": "Repository-Bereinigung und Fehlerbehebungen für den ioBroker Repository-Checker. Ungültige Eigenschaften aus der io-package.json entfernt und README aktualisiert.",
-        "ru": "Очистка репозитория и исправления для средства проверки репозитория ioBroker. Удалены недопустимые свойства из io-package.json и обновлен README.",
-        "pt": "Limpeza de repositório e correções para verificador de repositório ioBroker. Propriedades inválidas removidas de io-package.json e README atualizado.",
-        "nl": "Opschonen van opslagplaatsen en oplossingen voor ioBroker-repositorycontrole. Ongeldige eigenschappen uit io-package.json verwijderd en README bijgewerkt.",
-        "fr": "Nettoyage du référentiel et correctifs pour le vérificateur de référentiel ioBroker. Suppression des propriétés invalides de io-package.json et mise à jour du README.",
-        "it": "Pulizia del repository e correzioni per il controllo del repository ioBroker. Rimosse proprietà non valide da io-package.json e README aggiornato.",
-        "es": "Limpieza del repositorio y correcciones para el verificador del repositorio de ioBroker. Se eliminaron propiedades no válidas de io-package.json y se actualizó README.",
-        "pl": "Oczyszczenie repozytorium i poprawki dla modułu sprawdzania repozytorium ioBroker. Usunięto nieprawidłowe właściwości z io-package.json i zaktualizowano plik README.",
-        "uk": "Очищення сховища та виправлення для засобу перевірки сховища ioBroker. Видалено недійсні властивості з io-package.json і оновлено README.",
-        "zh-cn": "ioBroker 存储库检查器的存储库清理和修复。从 io-package.json 中删除了无效属性并更新了 README。"
-      },
       "1.2.10": {
         "en": "Improved German translations and terminology in admin UI (jsonConfig). Fixed incorrect or misleading sensor names (e.g. flow vs temperature sensors) and improved overall wording and consistency.",
         "de": "Verbesserte deutsche Übersetzungen und Begrifflichkeiten in der Admin-Oberfläche (jsonConfig). Falsche bzw. missverständliche Sensorbezeichnungen (z. B. Flow vs. Temperatursensoren) korrigiert und allgemeine Formulierungen sowie Konsistenz verbessert.",
@@ -67,19 +67,6 @@
         "pl": "Poprawione definicje ról dla stanów zapisywalnych zgodnie z wytycznymi ioBroker.",
         "uk": "Виправлено визначення ролей для записуваних станів відповідно до вказівок ioBroker.",
         "zh-cn": "根据 ioBroker 指南更正了可写状态的角色定义。"
-      },
-      "1.2.6": {
-        "en": "Fixed adapter checker issues, converted remaining log messages to English, updated release-script plugins and dependabot configuration.",
-        "de": "Adapter-Checker-Probleme behoben, verbleibende Logmeldungen auf Englisch umgestellt, release-script Plugins und Dependabot-Konfiguration aktualisiert.",
-        "ru": "Исправлены проблемы с проверкой адаптера, преобразованы оставшиеся сообщения журнала на английский язык, обновлены плагины сценариев выпуска и конфигурация зависимостей.",
-        "pt": "Corrigidos problemas do verificador do adaptador, convertidas mensagens de log restantes para inglês, plug-ins de script de lançamento atualizados e configuração do dependabot.",
-        "nl": "Problemen met de adaptercontrole opgelost, resterende logberichten naar het Engels geconverteerd, release-scriptplug-ins en dependabot-configuratie bijgewerkt.",
-        "fr": "Correction des problèmes de vérification d'adaptateur, conversion des messages de journal restants en anglais, mise à jour des plugins de script de version et configuration des dépendances.",
-        "it": "Risolti i problemi di controllo dell'adattatore, convertiti i messaggi di registro rimanenti in inglese, aggiornati i plugin degli script di rilascio e la configurazione di dependabot.",
-        "es": "Se solucionaron problemas del verificador de adaptadores, se convirtieron los mensajes de registro restantes al inglés, se actualizaron los complementos del script de lanzamiento y la configuración del dependabot.",
-        "pl": "Naprawiono problemy z modułem sprawdzania adaptera, przekonwertowano pozostałe komunikaty dziennika na język angielski, zaktualizowano wtyczki skryptu wydania i konfigurację zależnego bota.",
-        "uk": "Виправлено проблеми перевірки адаптера, перетворено решту повідомлень журналу на англійську мову, оновлено плагіни сценарію випуску та конфігурацію dependabot.",
-        "zh-cn": "修复了适配器检查器问题，将剩余日志消息转换为英语，更新了发布脚本插件和 dependentabot 配置。"
       }
     },
     "titleLang": {

package/lib/helpers/aiChemistryHelpHelper.js

@@ -1,4 +1,7 @@
 'use strict';
+
+const { I18n } = require('@iobroker/adapter-core');
+
 /* eslint-disable jsdoc/require-param-description */
 /* eslint-disable jsdoc/require-returns-description */
 
@@ -150,40 +153,40 @@ const aiChemistryHelpHelper = {
      */
     _getHelpText(issue) {
         const commonFooter =
-            '\n\nWichtig:\n' +
-            '• Immer schrittweise vorgehen: erst messen → klein korrigieren → umwälzen lassen → erneut messen.\n' +
-            '• Angaben auf dem Produkt beachten (Konzentration/Beckenvolumen unterscheiden sich).\n' +
-            '• Wenn du unsicher bist: lieber langsamer korrigieren als „mit Gewalt“.\n';
+            `\n\n${I18n.t('Important:')}\n` +
+            `• ${I18n.t('Always proceed step by step: measure first → correct in small steps → let the water circulate → measure again.')}\n` +
+            `• ${I18n.t('Always follow the product instructions (concentration and pool volume may differ).')}\n` +
+            `• ${I18n.t('If you are unsure, correct more slowly rather than forcing it.')}\n`;
 
         const map = {
             // ----------------------------------------------------------
             // pH
             // ----------------------------------------------------------
             ph_low:
-                `Problem: pH-Wert ist zu niedrig (Wasser ist „zu sauer“).\n\n` +
-                `Was das bedeutet:\n` +
-                `Ein zu niedriger pH-Wert kann Material (Metalle/Einbauteile) stärker angreifen und Badereizungen begünstigen. Außerdem kann die Wasserbalance insgesamt instabil werden.\n\n` +
-                `Häufige Ursachen:\n` +
-                `• Viel Regen-/Frischwasser (kann das Wasser „ansäuern“)\n` +
-                `• Niedrige Alkalinität (Puffer fehlt → pH fällt schneller)\n` +
-                `• Häufige Korrekturen/Backwash/Wasserwechsel\n\n` +
-                `Übliche Lösungsrichtung:\n` +
-                `• pH mit einem „pH-Plus“/pH-Heber schrittweise anheben.\n` +
-                `• Wenn der pH ständig wieder fällt: Totalalkalinität/„Puffer“ mit prüfen, weil sonst jede pH-Korrektur nur kurz hält.\n${
+                `${I18n.t('Problem: pH value is too low (water is too acidic).')}\n\n` +
+                `${I18n.t('What this means:')}\n` +
+                `${I18n.t('A pH value that is too low can attack materials (metals / built-in parts) more strongly and can increase irritation during bathing. It can also make the overall water balance unstable.')}\n\n` +
+                `${I18n.t('Common causes:')}\n` +
+                `• ${I18n.t('A lot of rainwater / fresh water (can acidify the water)')}\n` +
+                `• ${I18n.t('Low alkalinity (buffer missing → pH drops faster)')}\n` +
+                `• ${I18n.t('Frequent corrections / backwashing / water changes')}\n\n` +
+                `${I18n.t('Typical corrective direction:')}\n` +
+                `• ${I18n.t('Raise the pH gradually with a pH increaser / pH plus product.')}\n` +
+                `• ${I18n.t('If the pH keeps dropping again, also check total alkalinity / the buffer, otherwise every pH correction will only hold for a short time.')}\n${
                     commonFooter
                 }`,
 
             ph_high:
-                `Problem: pH-Wert ist zu hoch (Wasser ist „zu basisch“).\n\n` +
-                `Was das bedeutet:\n` +
-                `Bei zu hohem pH-Wert arbeitet Chlor/Desinfektion oft schlechter, und es kann leichter zu Trübungen/Ausfällungen kommen (z. B. Kalk). Außerdem können Augen/Haut gereizt sein.\n\n` +
-                `Häufige Ursachen:\n` +
-                `• Starkes „Ausgasen“/viel Sprudel (CO₂ entweicht → pH steigt)\n` +
-                `• Hartes Wasser / hohe Alkalinität\n` +
-                `• Manche Becken/Materialien können anfangs pH nach oben ziehen\n\n` +
-                `Übliche Lösungsrichtung:\n` +
-                `• pH mit „pH-Minus“/pH-Senker in kleinen Schritten senken.\n` +
-                `• Bei wiederkehrend hohem pH: Alkalinität/Wasserhärte mit betrachten, weil das die Stabilität stark beeinflusst.\n${
+                `${I18n.t('Problem: pH value is too high (water is too alkaline).')}\n\n` +
+                `${I18n.t('What this means:')}\n` +
+                `${I18n.t('If the pH value is too high, chlorine / disinfection often works less effectively and cloudiness / precipitation (for example lime) can occur more easily. Eyes and skin may also become irritated.')}\n\n` +
+                `${I18n.t('Common causes:')}\n` +
+                `• ${I18n.t('Strong outgassing / a lot of bubbling (CO₂ escapes → pH rises)')}\n` +
+                `• ${I18n.t('Hard water / high alkalinity')}\n` +
+                `• ${I18n.t('Some pools / materials can initially push the pH upward')}\n\n` +
+                `${I18n.t('Typical corrective direction:')}\n` +
+                `• ${I18n.t('Lower the pH in small steps with a pH reducer / pH minus product.')}\n` +
+                `• ${I18n.t('If the pH repeatedly rises again, also consider alkalinity / water hardness, because this strongly affects stability.')}\n${
                     commonFooter
                 }`,
 
@@ -191,118 +194,118 @@ const aiChemistryHelpHelper = {
             // Chlor
             // ----------------------------------------------------------
             chlor_low:
-                `Problem: Chlorwert ist zu niedrig.\n\n` +
-                `Was das bedeutet:\n` +
-                `Zu wenig wirksames Chlor kann dazu führen, dass sich Keime/Algen leichter vermehren. Häufig sieht man dann zuerst „müdes“ Wasser: weniger klar, mehr Geruch, schneller Belag.\n\n` +
-                `Häufige Ursachen:\n` +
-                `• Viel Sonne/UV (Chlor wird schneller abgebaut)\n` +
-                `• Hohe Badebelastung (Schweiß/Organik „verbraucht“ Chlor)\n` +
-                `• pH-Wert ungünstig (Chlor wirkt schlechter)\n\n` +
-                `Übliche Lösungsrichtung:\n` +
-                `• Desinfektion wieder in einen normalen Bereich bringen und parallel pH kontrollieren.\n` +
-                `• Wenn Chlor dauerhaft „wegbricht“: Ursachen wie organische Belastung/Filterzustand/Umwälzung mit prüfen.\n${
+                `${I18n.t('Problem: Chlorine level is too low.')}\n\n` +
+                `${I18n.t('What this means:')}\n` +
+                `${I18n.t('Too little effective chlorine can allow germs and algae to multiply more easily. Often the first signs are tired-looking water: less clarity, more odor, and deposits forming faster.')}\n\n` +
+                `${I18n.t('Common causes:')}\n` +
+                `• ${I18n.t('A lot of sun / UV exposure (chlorine breaks down faster)')}\n` +
+                `• ${I18n.t('High bathing load (sweat / organic matter consumes chlorine)')}\n` +
+                `• ${I18n.t('Unfavorable pH value (chlorine works less effectively)')}\n\n` +
+                `${I18n.t('Typical corrective direction:')}\n` +
+                `• ${I18n.t('Bring disinfection back into a normal range and check the pH in parallel.')}\n` +
+                `• ${I18n.t('If chlorine keeps dropping permanently, also check causes such as organic load, filter condition, and circulation.')}\n${
                     commonFooter
                 }`,
 
             chlor_high:
-                `Problem: Chlorwert ist zu hoch.\n\n` +
-                `Was das bedeutet:\n` +
-                `Zu hoher Chlorwert kann Augen/Haut reizen, starken Geruch verursachen und Material/Abdeckungen stärker belasten. In diesem Zustand ist „mehr Chemie“ fast nie die richtige Richtung.\n\n` +
-                `Häufige Ursachen:\n` +
-                `• Zu viel nachdosiert / Schockbehandlung zu hoch\n` +
-                `• Zu wenig Abbau (Abdeckung drauf + wenig Sonne)\n\n` +
-                `Übliche Lösungsrichtung:\n` +
-                `• Keine weitere Chlorzugabe.\n` +
-                `• Zeit wirken lassen (Sonne/UV baut Chlor ab) und gut umwälzen.\n` +
-                `• Erst wenn Chlor wieder im normalen Bereich ist, weitere Korrekturen (z. B. pH) sinnvoll bewerten.\n${
+                `${I18n.t('Problem: Chlorine level is too high.')}\n\n` +
+                `${I18n.t('What this means:')}\n` +
+                `${I18n.t('A chlorine level that is too high can irritate eyes and skin, cause strong odor, and put more stress on materials and covers. In this situation, adding even more chemicals is almost never the right direction.')}\n\n` +
+                `${I18n.t('Common causes:')}\n` +
+                `• ${I18n.t('Too much chlorine added / shock treatment too high')}\n` +
+                `• ${I18n.t('Too little natural breakdown (cover on + little sun)')}\n\n` +
+                `${I18n.t('Typical corrective direction:')}\n` +
+                `• ${I18n.t('Do not add more chlorine.')}\n` +
+                `• ${I18n.t('Let time do the work (sun / UV reduces chlorine) and keep the water circulating well.')}\n` +
+                `• ${I18n.t('Only evaluate further corrections (for example pH) once chlorine is back in a normal range.')}\n${
                     commonFooter
                 }`,
 
             chlor_no_effect:
-                `Problem: „Chlor steigt trotz Zugabe nicht“.\n\n` +
-                `Was das bedeutet:\n` +
-                `Das passiert häufig, wenn das Wasser eine hohe „Chlornachfrage“ hat: Das zugegebene Chlor wird sofort verbraucht, bevor ein stabiler freier Chlorwert messbar bleibt.\n\n` +
-                `Häufige Ursachen:\n` +
-                `• Hohe organische Belastung (Schmutz, Biofilm, starke Nutzung)\n` +
-                `• Beginnender/unsichtbarer Algenbefall\n` +
-                `• Stark falscher pH-Wert (Wirkung eingeschränkt)\n\n` +
-                `Übliche Lösungsrichtung:\n` +
-                `• Erst Grundwerte prüfen (pH, Filter/Umwälzung, Sichtprüfung auf Beläge).\n` +
-                `• Wasser „sauber bekommen“ (Filter reinigen/rückspülen, Becken bürsten), damit Chlor nicht nur „verbraucht“ wird.\n` +
-                `• Wenn dauerhaft keine Wirkung messbar ist, liegt oft ein „oxidativer Bedarf“ vor (Chlor wird sofort gebunden/abgebaut) – dann hilft nur konsequent Ursachen reduzieren und danach erneut messen.\n${
+                `${I18n.t('Problem: Chlorine level does not rise despite dosing.')}\n\n` +
+                `${I18n.t('What this means:')}\n` +
+                `${I18n.t('This often happens when the water has a high chlorine demand: the added chlorine is consumed immediately before a stable free chlorine level can remain measurable.')}\n\n` +
+                `${I18n.t('Common causes:')}\n` +
+                `• ${I18n.t('High organic load (dirt, biofilm, heavy use)')}\n` +
+                `• ${I18n.t('Early / invisible algae growth')}\n` +
+                `• ${I18n.t('Strongly incorrect pH value (effectiveness reduced)')}\n\n` +
+                `${I18n.t('Typical corrective direction:')}\n` +
+                `• ${I18n.t('First check the basic values (pH, filter / circulation, visual inspection for deposits).')}\n` +
+                `• ${I18n.t('Get the water clean again (clean / backwash the filter, brush the pool), so chlorine is not only being consumed immediately.')}\n` +
+                `• ${I18n.t('If no effect can be measured permanently, there is often an oxidative demand present (chlorine is immediately bound / broken down) – then only consistent reduction of the causes and measuring again will help.')}\n${
                     commonFooter
                 }`,
 
             chlor_smell:
-                `Problem: Starker „Chlorgeruch“ trotz Messwert.\n\n` +
-                `Was das bedeutet:\n` +
-                `Der typische „Hallenbad-Geruch“ kommt oft nicht von „zu viel gutem Chlor“, sondern von gebundenen Chlorverbindungen (Chloramine). Diese entstehen, wenn Chlor sich mit Stickstoff-/Organik aus Schweiß/Urinfrachten verbindet.\n\n` +
-                `Häufige Ursachen:\n` +
-                `• Hohe Badebelastung / organische Einträge\n` +
-                `• Zu wenig Frischwasser/Abbau/Filterpflege\n` +
-                `• Schlechte Lüftung (bei Indoor-Pools) verstärkt die Wahrnehmung\n\n` +
-                `Übliche Lösungsrichtung:\n` +
-                `• Ziel ist, gebundene Belastung zu reduzieren: gute Umwälzung/Filtration, Beckenreinigung, ggf. Frischwasseranteil.\n` +
-                `• Parallel pH prüfen, weil falscher pH die Desinfektion zusätzlich verschlechtert.\n${commonFooter}`,
+                `${I18n.t('Problem: Strong chlorine smell despite the measured value.')}\n\n` +
+                `${I18n.t('What this means:')}\n` +
+                `${I18n.t('The typical indoor pool smell often does not come from too much good chlorine, but from bound chlorine compounds (chloramines). These are formed when chlorine combines with nitrogen / organic matter from sweat and similar contamination.')}\n\n` +
+                `${I18n.t('Common causes:')}\n` +
+                `• ${I18n.t('High bathing load / organic input')}\n` +
+                `• ${I18n.t('Too little fresh water / breakdown / filter care')}\n` +
+                `• ${I18n.t('Poor ventilation (for indoor pools) increases the perceived smell')}\n\n` +
+                `${I18n.t('Typical corrective direction:')}\n` +
+                `• ${I18n.t('The goal is to reduce bound contamination: good circulation / filtration, pool cleaning, and possibly a fresh water share.')}\n` +
+                `• ${I18n.t('Also check the pH in parallel, because an incorrect pH further reduces disinfection performance.')}\n${commonFooter}`,
 
             // ----------------------------------------------------------
             // Wasserbild / Optik
             // ----------------------------------------------------------
             water_green:
-                `Problem: Wasser ist grün.\n\n` +
-                `Was das bedeutet:\n` +
-                `Grünes Wasser ist sehr häufig ein Hinweis auf Algenwachstum (oft ausgelöst durch zu wenig wirksames Chlor und/oder schlechte Umwälzung).\n\n` +
-                `Häufige Ursachen:\n` +
-                `• Freies Chlor zu niedrig oder „verbraucht“\n` +
-                `• pH zu hoch → Chlor wirkt deutlich schlechter\n` +
-                `• Filter/Umwälzung unzureichend oder Filter verschmutzt\n` +
-                `• Hohe Temperatur + Sonne (Algenwachstum wird begünstigt)\n\n` +
-                `Übliche Lösungsrichtung:\n` +
-                `• Wasserwerte prüfen (insb. pH und Chlor) und Umwälzung/Filterzustand verbessern.\n` +
-                `• Becken gründlich bürsten/absaugen, damit Beläge nicht „überleben“.\n` +
-                `• Danach geduldig filtern lassen, bis das Wasser wieder klar wird.\n${commonFooter}`,
+                `${I18n.t('Problem: Water is green.')}\n\n` +
+                `${I18n.t('What this means:')}\n` +
+                `${I18n.t('Green water is very often a sign of algae growth (often caused by too little effective chlorine and / or poor circulation).')}\n\n` +
+                `${I18n.t('Common causes:')}\n` +
+                `• ${I18n.t('Free chlorine too low or already consumed')}\n` +
+                `• ${I18n.t('pH too high → chlorine works much less effectively')}\n` +
+                `• ${I18n.t('Insufficient filter / circulation or dirty filter')}\n` +
+                `• ${I18n.t('High temperature + sun (algae growth is encouraged)')}\n\n` +
+                `${I18n.t('Typical corrective direction:')}\n` +
+                `• ${I18n.t('Check the water values (especially pH and chlorine) and improve circulation / filter condition.')}\n` +
+                `• ${I18n.t('Brush / vacuum the pool thoroughly so deposits do not survive.')}\n` +
+                `• ${I18n.t('Then let the filter run patiently until the water becomes clear again.')}\n${commonFooter}`,
 
             water_cloudy:
-                `Problem: Wasser ist trüb / grau / milchig.\n\n` +
-                `Was das bedeutet:\n` +
-                `Trübes Wasser entsteht oft durch feine Schwebstoffe oder chemische Ungleichgewichte (z. B. pH/Alkalinität/Kalk), die der Filter nicht gut „packt“.\n\n` +
-                `Häufige Ursachen:\n` +
-                `• Filter verschmutzt/zu kurze Filterlaufzeit\n` +
-                `• pH/Alkalinität außerhalb des stabilen Bereichs\n` +
-                `• Hohe Wasserhärte (Kalk) – besonders in Kombination mit hohem pH\n` +
-                `• Zu wenig Desinfektion → biologische Trübung möglich\n\n` +
-                `Übliche Lösungsrichtung:\n` +
-                `• Filterzustand prüfen (Reinigung/Rückspülen) und ausreichend umwälzen.\n` +
-                `• Grundwerte pH/Chlor prüfen und stabilisieren.\n` +
-                `• Wenn die Trübung „mineralisch“ wirkt (milchig/weiß): Wasserhärte/Balance mit betrachten.\n${
+                `${I18n.t('Problem: Water is cloudy / gray / milky.')}\n\n` +
+                `${I18n.t('What this means:')}\n` +
+                `${I18n.t('Cloudy water is often caused by fine suspended particles or chemical imbalances (for example pH / alkalinity / lime) that the filter cannot handle well.')}\n\n` +
+                `${I18n.t('Common causes:')}\n` +
+                `• ${I18n.t('Dirty filter / filter runtime too short')}\n` +
+                `• ${I18n.t('pH / alkalinity outside the stable range')}\n` +
+                `• ${I18n.t('High water hardness (lime) – especially together with high pH')}\n` +
+                `• ${I18n.t('Too little disinfection → biological cloudiness is possible')}\n\n` +
+                `${I18n.t('Typical corrective direction:')}\n` +
+                `• ${I18n.t('Check the filter condition (cleaning / backwashing) and ensure sufficient circulation.')}\n` +
+                `• ${I18n.t('Check the basic values pH / chlorine and stabilize them.')}\n` +
+                `• ${I18n.t('If the cloudiness looks mineral (milky / white), also consider water hardness / balance.')}\n${
                     commonFooter
                 }`,
 
             algae_visible:
-                `Problem: Algen an Wänden oder Boden sichtbar.\n\n` +
-                `Was das bedeutet:\n` +
-                `Sichtbare Algen sind ein klares Zeichen, dass die Desinfektion/Umwälzung nicht ausreichend war oder lokal tote Zonen entstehen (Ecken/Leitungen).\n\n` +
-                `Häufige Ursachen:\n` +
-                `• Chlor zu niedrig oder „verbraucht“\n` +
-                `• pH zu hoch (Chlor wirkt schlechter)\n` +
-                `• Zu wenig Bürsten/Beckenpflege, schlechte Zirkulation\n\n` +
-                `Übliche Lösungsrichtung:\n` +
-                `• Mechanik zuerst: konsequent bürsten/absaugen, Filterpflege.\n` +
-                `• Werte (pH/Chlor) danach stabilisieren und Umwälzung verbessern.\n` +
-                `• Ziel ist, Algen nicht nur „chemisch“, sondern auch mechanisch zu entfernen.\n${commonFooter}`,
+                `${I18n.t('Problem: Algae visible on walls or floor.')}\n\n` +
+                `${I18n.t('What this means:')}\n` +
+                `${I18n.t('Visible algae are a clear sign that disinfection / circulation was not sufficient or that local dead zones are forming (corners / pipes).')}\n\n` +
+                `${I18n.t('Common causes:')}\n` +
+                `• ${I18n.t('Chlorine too low or already consumed')}\n` +
+                `• ${I18n.t('pH too high (chlorine works less effectively)')}\n` +
+                `• ${I18n.t('Too little brushing / pool care, poor circulation')}\n\n` +
+                `${I18n.t('Typical corrective direction:')}\n` +
+                `• ${I18n.t('Mechanics first: brush / vacuum consistently, maintain the filter.')}\n` +
+                `• ${I18n.t('Then stabilize the values (pH / chlorine) and improve circulation.')}\n` +
+                `• ${I18n.t('The goal is to remove algae not only chemically, but also mechanically.')}\n${commonFooter}`,
 
             foam_on_surface:
-                `Problem: Schaumbildung auf der Wasseroberfläche.\n\n` +
-                `Was das bedeutet:\n` +
-                `Schaum entsteht oft durch Tenside/Organik (Sonnencreme, Körperpflege, Reinigungsreste), manche Algenmittel/Polymere oder auch Luft im System. Es ist meist kein „Chlor-Problem“, sondern ein „Stoffe-im-Wasser“-Problem.\n\n` +
-                `Häufige Ursachen:\n` +
-                `• Viele Lotionen/Öle im Wasser, hohe organische Belastung\n` +
-                `• Bestimmte algenhemmende Mittel können Schaum begünstigen\n` +
-                `• Luft zieht ins System (kleine Undichtigkeiten) → Schaum wirkt stärker\n\n` +
-                `Übliche Lösungsrichtung:\n` +
-                `• Oberfläche abschöpfen, Filter sauber halten, organische Einträge reduzieren.\n` +
-                `• pH/Chlor im Blick behalten (stabile Werte helfen, Organik schneller abzubauen).\n` +
-                `• Wenn Schaum dauerhaft bleibt: Quelle (Produkte/Einträge/Technik) systematisch eingrenzen.\n${
+                `${I18n.t('Problem: Foam on the water surface.')}\n\n` +
+                `${I18n.t('What this means:')}\n` +
+                `${I18n.t('Foam is often caused by surfactants / organic matter (sunscreen, body care products, cleaning residues), some algaecides / polymers, or also air in the system. It is usually not a chlorine problem, but rather a substances-in-the-water problem.')}\n\n` +
+                `${I18n.t('Common causes:')}\n` +
+                `• ${I18n.t('A lot of lotions / oils in the water, high organic load')}\n` +
+                `• ${I18n.t('Certain anti-algae products can promote foam')}\n` +
+                `• ${I18n.t('Air entering the system (small leaks) → foam appears stronger')}\n\n` +
+                `${I18n.t('Typical corrective direction:')}\n` +
+                `• ${I18n.t('Skim off the surface, keep the filter clean, and reduce organic input.')}\n` +
+                `• ${I18n.t('Keep an eye on pH / chlorine as well (stable values help break down organic matter faster).')}\n` +
+                `• ${I18n.t('If foam remains permanently, systematically narrow down the source (products / contamination / technology).')}\n${
                     commonFooter
                 }`,
 
@@ -310,40 +313,40 @@ const aiChemistryHelpHelper = {
             // Badegefühl / Stabilität
             // ----------------------------------------------------------
             skin_eye_irritation:
-                `Problem: Haut- oder Augenreizungen beim Baden.\n\n` +
-                `Was das bedeutet:\n` +
-                `Reizungen können verschiedene Ursachen haben: zu hoher oder sehr niedriger pH, zu hohe Desinfektionskonzentration, oder gebundene Chlorverbindungen (Chloramine) bei organischer Belastung.\n\n` +
-                `Häufige Ursachen:\n` +
-                `• pH außerhalb des Wohlfühlbereichs\n` +
-                `• Chlor deutlich zu hoch\n` +
-                `• „Chlorgeruch“/Chloramine durch starke organische Einträge\n\n` +
-                `Übliche Lösungsrichtung:\n` +
-                `• Zuerst messen (pH & Chlor) und Werte wieder in einen normalen Bereich bringen.\n` +
-                `• Becken/Filter sauber halten, damit organische Belastung nicht in „gebundene“ Formen kippt.\n` +
-                `• Bei starken Beschwerden: Baden pausieren, bis Wasserwerte stabil sind.\n${commonFooter}`,
+                `${I18n.t('Problem: Skin or eye irritation while swimming.')}\n\n` +
+                `${I18n.t('What this means:')}\n` +
+                `${I18n.t('Irritation can have several causes: pH that is too high or very low, too high a disinfectant concentration, or bound chlorine compounds (chloramines) caused by organic contamination.')}\n\n` +
+                `${I18n.t('Common causes:')}\n` +
+                `• ${I18n.t('pH outside the comfortable range')}\n` +
+                `• ${I18n.t('Chlorine clearly too high')}\n` +
+                `• ${I18n.t('Chlorine smell / chloramines caused by strong organic input')}\n\n` +
+                `${I18n.t('Typical corrective direction:')}\n` +
+                `• ${I18n.t('Measure first (pH and chlorine) and bring the values back into a normal range.')}\n` +
+                `• ${I18n.t('Keep the pool / filter clean so that organic contamination does not turn into bound compounds.')}\n` +
+                `• ${I18n.t('If irritation is strong, pause swimming until the water values are stable.')}\n${commonFooter}`,
 
             values_unstable:
-                `Problem: Wasserwerte sind häufig instabil (kippen schnell).\n\n` +
-                `Was das bedeutet:\n` +
-                `Wenn pH/Chlor ständig stark schwanken, fehlt oft „Stabilität“ im Wasser: Puffer (Alkalinität) zu niedrig/zu hoch, wechselnde Belastung, oder die Umwälzung/Filtration ist nicht konstant genug.\n\n` +
-                `Häufige Ursachen:\n` +
-                `• Totalalkalinität zu niedrig → pH springt/kippt schnell\n` +
-                `• Viele kleine Korrekturen ohne ausreichende Umwälzzeit\n` +
-                `• Filterzustand schlecht / zu kurze Filterzeiten\n` +
-                `• Starke externe Einflüsse (Regen, Hitze, hohe Nutzung)\n\n` +
-                `Übliche Lösungsrichtung:\n` +
-                `• Einmal „Basis“ stabil bekommen (Puffer/Filter/Regelmäßigkeit), dann erst fein korrigieren.\n` +
-                `• Korrigieren immer in kleinen Schritten und mit Zeit zum Durchmischen.\n${commonFooter}`,
+                `${I18n.t('Problem: Water values are often unstable (change quickly).')}\n\n` +
+                `${I18n.t('What this means:')}\n` +
+                `${I18n.t('If pH / chlorine fluctuate strongly all the time, the water often lacks stability: the buffer (alkalinity) is too low / too high, the load changes frequently, or circulation / filtration is not constant enough.')}\n\n` +
+                `${I18n.t('Common causes:')}\n` +
+                `• ${I18n.t('Total alkalinity too low → pH jumps / tips over quickly')}\n` +
+                `• ${I18n.t('Many small corrections without enough circulation time')}\n` +
+                `• ${I18n.t('Poor filter condition / filter times too short')}\n` +
+                `• ${I18n.t('Strong external influences (rain, heat, heavy use)')}\n\n` +
+                `${I18n.t('Typical corrective direction:')}\n` +
+                `• ${I18n.t('First get the basics stable (buffer / filter / regularity), then only fine-tune.')}\n` +
+                `• ${I18n.t('Always correct in small steps and allow enough time for mixing.')}\n${commonFooter}`,
 
             unknown_problem:
-                `Problem: Unklar, was genau los ist.\n\n` +
-                `Vorgehen (minimal & sinnvoll):\n` +
-                `1) Sichtcheck: Grün? Trüb? Beläge? Schaum?\n` +
-                `2) Zwei Messwerte reichen für den Start: pH + freies Chlor.\n` +
-                `3) Technik prüfen: Läuft die Umwälzung? Filter sauber? Rückspülen nötig?\n\n` +
-                `Typische Faustregel:\n` +
-                `• Optik-Probleme (grün/trüb) sind sehr oft eine Kombination aus Desinfektion + pH + Filterung.\n` +
-                `• „Geruch/Reizung“ ist oft nicht „zu viel Chlor“, sondern „falsch gebunden/organisch belastet“.\n${
+                `${I18n.t('Problem: It is unclear what exactly is wrong.')}\n\n` +
+                `${I18n.t('Procedure (minimal and sensible):')}\n` +
+                `1) ${I18n.t('Visual check: Green? Cloudy? Deposits? Foam?')}\n` +
+                `2) ${I18n.t('Two measured values are enough for the start: pH + free chlorine.')}\n` +
+                `3) ${I18n.t('Check the technology: Is circulation running? Is the filter clean? Is backwashing needed?')}\n\n` +
+                `${I18n.t('Typical rule of thumb:')}\n` +
+                `• ${I18n.t('Visual problems (green / cloudy) are very often a combination of disinfection + pH + filtration.')}\n` +
+                `• ${I18n.t('Odor / irritation is often not too much chlorine, but incorrectly bound / organically loaded water.')}\n${
                     commonFooter
                 }`,
         };
@@ -354,8 +357,8 @@ const aiChemistryHelpHelper = {
 
         // Fallback
         return (
-            `Hinweis: Dieses Problem ist (noch) nicht bekannt.\n\n` +
-            `Bitte wähle einen der vorhandenen Punkte aus oder nutze „Problem unklar / nicht eindeutig“.\n${
+            `${I18n.t('Note: This problem is not known yet.')}\n\n` +
+            `${I18n.t('Please select one of the existing items or use "Issue unclear / not specific".')}\n${
                 commonFooter
             }`
         );