iobroker.poolcontrol 1.2.13 → 1.2.14

package/README.md

@@ -189,6 +189,10 @@ 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)

package/io-package.json

@@ -1,20 +1,20 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.2.13",
+    "version": "1.2.14",
     "news": {
-      "1.2.13": {
-        "en": "Added multilingual state names and descriptions (DE/EN). Improved consistency of all state texts. Internal cleanup and stability improvements.",
-        "de": "Mehrsprachige State-Namen und Beschreibungen (DE/EN) ergänzt. Einheitliche Benennung aller Datenpunkte. Interne Verbesserungen und Stabilität optimiert.",
-        "ru": "Добавлены многоязычные названия и описания штатов (DE/EN). Улучшена согласованность всех текстов состояний. Внутренняя очистка и улучшения стабильности.",
-        "pt": "Adicionados nomes e descrições de estados multilíngues (DE/EN). Melhor consistência de todos os textos estaduais. Limpeza interna e melhorias de estabilidade.",
-        "nl": "Meertalige namen en beschrijvingen van staten toegevoegd (DE/EN). Verbeterde consistentie van alle staatsteksten. Interne opschoning en stabiliteitsverbeteringen.",
-        "fr": "Ajout de noms et de descriptions d'état multilingues (DE/EN). Amélioration de la cohérence de tous les textes étatiques. Améliorations du nettoyage interne et de la stabilité.",
-        "it": "Aggiunti nomi e descrizioni degli stati multilingue (DE/EN). Maggiore coerenza di tutti i testi statali. Miglioramenti della pulizia interna e della stabilità.",
-        "es": "Se agregaron nombres y descripciones de estados multilingües (DE/EN). Coherencia mejorada de todos los textos estatales. Mejoras en la limpieza interna y la estabilidad.",
-        "pl": "Dodano wielojęzyczne nazwy i opisy stanów (DE/EN). Poprawiona spójność wszystkich tekstów stanowych. Wewnętrzne porządki i ulepszenia stabilności.",
-        "uk": "Додано багатомовні назви та описи штатів (DE/EN). Покращена узгодженість усіх державних текстів. Внутрішнє очищення та покращення стабільності.",
-        "zh-cn": "添加了多语言状态名称和描述（德语/英语）。提高了所有国家文本的一致性。内部清理和稳定性改进。"
+      "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.",
@@ -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": {
@@ -146,8 +133,7 @@
       {
         "admin": ">=7.6.20"
       }
-    ],
-    "installedFrom": "file:///opt/iobroker/ioBroker.poolcontrol"
+    ]
   },
   "native": {},
   "objects": [],

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
             }`
         );

package/lib/i18n/de.json

@@ -0,0 +1,69 @@
+{
+  "No issue selected": "Kein Problem ausgewählt",
+  "pH is too low": "pH-Wert zu niedrig",
+  "pH is too high": "pH-Wert zu hoch",
+  "Chlorine is too low": "Chlorwert zu niedrig",
+  "Chlorine is too high": "Chlorwert zu hoch",
+  "Chlorine does not rise despite dosing": "Chlorwert steigt trotz Dosierung nicht",
+  "Strong chlorine smell despite reading": "Starker Chlorgeruch trotz Messwert",
+  "Water is green": "Wasser ist grün",
+  "Water is cloudy / gray / milky": "Wasser ist trüb / grau / milchig",
+  "Algae visible on walls or floor": "Algen sichtbar an Wänden oder Boden",
+  "Foam on the water surface": "Schaum auf der Wasseroberfläche",
+  "Skin or eye irritation when swimming": "Haut- oder Augenreizungen beim Schwimmen",
+  "Water values are often unstable": "Wasserwerte sind häufig instabil",
+  "Issue unclear / not specific": "Problem unklar / nicht eindeutig",
+
+  "Important:": "Wichtig:",
+  "Always proceed step by step: measure first → correct in small steps → let the water circulate → measure again.": "Immer schrittweise vorgehen: erst messen → klein korrigieren → umwälzen lassen → erneut messen.",
+  "Always follow the product instructions (concentration and pool volume may differ).": "Immer die Angaben auf dem Produkt beachten (Konzentration und Beckenvolumen können abweichen).",
+  "If you are unsure, correct more slowly rather than forcing it.": "Wenn du unsicher bist: lieber langsamer korrigieren als mit Gewalt.",
+
+  "Problem: pH value is too low (water is too acidic).": "Problem: pH-Wert ist zu niedrig (Wasser ist zu sauer).",
+  "What this means:": "Was das bedeutet:",
+  "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.": "Ein zu niedriger pH-Wert kann Materialien (Metalle / Einbauteile) stärker angreifen und Reizungen beim Baden begünstigen. Außerdem kann die Wasserbalance instabil werden.",
+  "Common causes:": "Häufige Ursachen:",
+  "A lot of rainwater / fresh water (can acidify the water)": "Viel Regen- oder Frischwasser (kann das Wasser ansäuern)",
+  "Low alkalinity (buffer missing → pH drops faster)": "Niedrige Alkalinität (Puffer fehlt → pH fällt schneller)",
+  "Frequent corrections / backwashing / water changes": "Häufige Korrekturen / Rückspülen / Wasserwechsel",
+  "Typical corrective direction:": "Übliche Lösungsrichtung:",
+  "Raise the pH gradually with a pH increaser / pH plus product.": "pH-Wert schrittweise mit pH-Plus anheben.",
+  "If the pH keeps dropping again, also check total alkalinity / the buffer, otherwise every pH correction will only hold for a short time.": "Wenn der pH-Wert immer wieder fällt, auch die Alkalinität prüfen, sonst hält die Korrektur nicht lange.",
+
+  "Problem: pH value is too high (water is too alkaline).": "Problem: pH-Wert ist zu hoch (Wasser ist zu basisch).",
+  "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.": "Bei zu hohem pH-Wert wirkt Chlor schlechter und es kann zu Trübungen oder Ausfällungen (z. B. Kalk) kommen. Auch Augen und Haut können gereizt werden.",
+  "Strong outgassing / a lot of bubbling (CO₂ escapes → pH rises)": "Starkes Ausgasen / viel Sprudel (CO₂ entweicht → pH steigt)",
+  "Hard water / high alkalinity": "Hartes Wasser / hohe Alkalinität",
+  "Some pools / materials can initially push the pH upward": "Einige Becken oder Materialien können den pH-Wert anfangs erhöhen",
+  "Lower the pH in small steps with a pH reducer / pH minus product.": "pH-Wert in kleinen Schritten mit pH-Minus senken.",
+  "If the pH repeatedly rises again, also consider alkalinity / water hardness, because this strongly affects stability.": "Wenn der pH-Wert immer wieder steigt, auch Alkalinität und Wasserhärte prüfen.",
+
+  "Problem: Chlorine level is too low.": "Problem: Chlorwert ist zu niedrig.",
+  "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.": "Zu wenig wirksames Chlor lässt Keime und Algen leichter wachsen. Erste Anzeichen sind oft trübes Wasser, Geruch und schnellerer Belag.",
+  "A lot of sun / UV exposure (chlorine breaks down faster)": "Viel Sonne / UV (Chlor baut sich schneller ab)",
+  "High bathing load (sweat / organic matter consumes chlorine)": "Hohe Badebelastung (Schweiß / organische Stoffe verbrauchen Chlor)",
+  "Unfavorable pH value (chlorine works less effectively)": "Ungünstiger pH-Wert (Chlor wirkt schlechter)",
+  "Bring disinfection back into a normal range and check the pH in parallel.": "Desinfektion wieder in den Normalbereich bringen und pH prüfen.",
+  "If chlorine keeps dropping permanently, also check causes such as organic load, filter condition, and circulation.": "Wenn Chlor dauerhaft sinkt, Ursachen wie Belastung, Filterzustand und Umwälzung prüfen.",
+
+  "Problem: Chlorine level is too high.": "Problem: Chlorwert ist zu hoch.",
+  "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.": "Zu viel Chlor kann Augen und Haut reizen, starken Geruch verursachen und Materialien belasten. Mehr Chemie ist hier fast nie sinnvoll.",
+  "Too much chlorine added / shock treatment too high": "Zu viel Chlor zugegeben / Schockbehandlung zu hoch",
+  "Too little natural breakdown (cover on + little sun)": "Zu wenig Abbau (Abdeckung drauf + wenig Sonne)",
+  "Do not add more chlorine.": "Kein weiteres Chlor zugeben.",
+  "Let time do the work (sun / UV reduces chlorine) and keep the water circulating well.": "Zeit wirken lassen (Sonne / UV baut Chlor ab) und gut umwälzen.",
+  "Only evaluate further corrections (for example pH) once chlorine is back in a normal range.": "Weitere Korrekturen erst vornehmen, wenn Chlor wieder im Normalbereich ist.",
+
+  "Problem: Water is green.": "Problem: Wasser ist grün.",
+  "Green water is very often a sign of algae growth (often caused by too little effective chlorine and / or poor circulation).": "Grünes Wasser ist meist ein Zeichen für Algenwachstum (oft durch zu wenig Chlor oder schlechte Umwälzung).",
+  "Free chlorine too low or already consumed": "Freies Chlor zu niedrig oder bereits verbraucht",
+  "pH too high → chlorine works much less effectively": "pH zu hoch → Chlor wirkt schlechter",
+  "Insufficient filter / circulation or dirty filter": "Zu wenig Umwälzung oder verschmutzter Filter",
+  "High temperature + sun (algae growth is encouraged)": "Hohe Temperatur + Sonne fördern Algenwachstum",
+  "Check the water values (especially pH and chlorine) and improve circulation / filter condition.": "Wasserwerte prüfen (pH und Chlor) und Umwälzung / Filter verbessern.",
+  "Brush / vacuum the pool thoroughly so deposits do not survive.": "Becken gründlich bürsten / absaugen.",
+  "Then let the filter run patiently until the water becomes clear again.": "Dann geduldig filtern lassen, bis das Wasser wieder klar ist.",
+
+  "Note: This problem is not known yet.": "Hinweis: Dieses Problem ist noch nicht bekannt.",
+  "Please select one of the existing items or use \"Issue unclear / not specific\".": "Bitte einen vorhandenen Punkt auswählen oder \"Problem unklar\" nutzen."
+}