iobroker.poolcontrol 1.3.25 → 1.3.27

package/lib/helpers/chemistryToolsHelper.js

@@ -0,0 +1,413 @@
+'use strict';
+
+const { I18n } = require('@iobroker/adapter-core');
+
+const PH_STEP = 0.1;
+const VOLUME_REFERENCE_L = 10000;
+
+const chemistryToolsHelper = {
+    adapter: null,
+
+    /**
+     * @param {import('iobroker').Adapter} adapter - ioBroker adapter instance
+     */
+    init(adapter) {
+        this.adapter = adapter;
+
+        void this._subscribeStates();
+        void this._prefillCalculatorValues();
+
+        this.adapter.log.debug('[chemistryToolsHelper] Initialized');
+    },
+
+    async _subscribeStates() {
+        const ids = [
+            'general.pool_size',
+            'chemistry.ph.input.current_value',
+
+            'chemistry.tools.ph_plus_calculator.05_calculate',
+            'chemistry.tools.ph_plus_calculator.01_pool_volume_l',
+            'chemistry.tools.ph_plus_calculator.02_current_ph',
+            'chemistry.tools.ph_plus_calculator.03_target_ph',
+            'chemistry.tools.ph_plus_calculator.04_grams_per_10000l_01ph',
+
+            'chemistry.tools.ph_minus_calculator.05_calculate',
+            'chemistry.tools.ph_minus_calculator.01_pool_volume_l',
+            'chemistry.tools.ph_minus_calculator.02_current_ph',
+            'chemistry.tools.ph_minus_calculator.03_target_ph',
+            'chemistry.tools.ph_minus_calculator.04_grams_per_10000l_01ph',
+
+            'chemistry.tools.salt_calculator.04_calculate',
+            'chemistry.tools.salt_calculator.01_pool_volume_l',
+            'chemistry.tools.salt_calculator.02_current_salt_ppm',
+            'chemistry.tools.salt_calculator.03_target_salt_ppm',
+        ];
+
+        for (const id of ids) {
+            await this.adapter.subscribeStatesAsync(id);
+        }
+
+        this.adapter.log.debug('[chemistryToolsHelper] Own states subscribed');
+    },
+
+    /**
+     * @param {string} id - Changed state ID
+     * @param {ioBroker.State | null | undefined} state - Changed state
+     * @returns {Promise<void>}
+     */
+    async handleStateChange(id, state) {
+        if (!state) {
+            return;
+        }
+
+        try {
+            if (id.endsWith('general.pool_size') || id.endsWith('chemistry.ph.input.current_value')) {
+                await this._prefillCalculatorValues();
+                return;
+            }
+
+            if (
+                id.endsWith('chemistry.tools.ph_plus_calculator.05_calculate') &&
+                state.ack === false &&
+                state.val === true
+            ) {
+                await this._calculatePhPlus();
+                await this._setBool('chemistry.tools.ph_plus_calculator.05_calculate', false);
+                return;
+            }
+
+            if (
+                id.endsWith('chemistry.tools.ph_minus_calculator.05_calculate') &&
+                state.ack === false &&
+                state.val === true
+            ) {
+                await this._calculatePhMinus();
+                await this._setBool('chemistry.tools.ph_minus_calculator.05_calculate', false);
+            }
+
+            if (
+                id.endsWith('chemistry.tools.salt_calculator.04_calculate') &&
+                state.ack === false &&
+                state.val === true
+            ) {
+                await this._calculateSalt();
+                await this._setBool('chemistry.tools.salt_calculator.04_calculate', false);
+            }
+        } catch (err) {
+            this.adapter.log.warn(`[chemistryToolsHelper] Error in handleStateChange: ${err.message}`);
+        }
+    },
+
+    async _prefillCalculatorValues() {
+        const poolVolume = await this._readNumber('general.pool_size');
+        const currentPh = await this._readNumber('chemistry.ph.input.current_value');
+
+        await this._prefillNumberIfEmpty('chemistry.tools.ph_plus_calculator.01_pool_volume_l', poolVolume);
+        await this._prefillNumberIfEmpty('chemistry.tools.ph_minus_calculator.01_pool_volume_l', poolVolume);
+        await this._prefillNumberIfEmpty('chemistry.tools.salt_calculator.01_pool_volume_l', poolVolume);
+
+        await this._prefillNumberIfEmpty('chemistry.tools.ph_plus_calculator.02_current_ph', currentPh);
+        await this._prefillNumberIfEmpty('chemistry.tools.ph_minus_calculator.02_current_ph', currentPh);
+    },
+
+    /**
+     * Calculates the pH Plus amount using the manufacturer dosage formula.
+     *
+     * @returns {Promise<void>}
+     */
+    async _calculatePhPlus() {
+        const base = 'chemistry.tools.ph_plus_calculator';
+
+        const poolVolume = await this._readNumber(`${base}.01_pool_volume_l`);
+        const currentPh = await this._readNumber(`${base}.02_current_ph`);
+        const targetPh = await this._readNumber(`${base}.03_target_ph`);
+        const dosageFactor = await this._readNumber(`${base}.04_grams_per_10000l_01ph`);
+
+        const validation = this._validateInputs({
+            type: 'plus',
+            poolVolume,
+            currentPh,
+            targetPh,
+            dosageFactor,
+        });
+
+        if (!validation.valid) {
+            await this._writeInvalidResult(base, validation.error);
+            return;
+        }
+
+        const resultGrams = this._calculateAmountGrams(currentPh, targetPh, poolVolume, dosageFactor);
+        const roundedGrams = Math.round(resultGrams);
+
+        const resultText =
+            `${I18n.translate('Calculated amount')}: ${roundedGrams} g pH Plus. ` +
+            `${I18n.translate('Reference value based on common manufacturer dosage.')} ` +
+            `${I18n.translate('Follow the manufacturer instructions and re-measure afterwards.')}`;
+
+        await this._writeValidResult(base, roundedGrams, resultText);
+    },
+
+    /**
+     * Calculates the pH Minus amount using the manufacturer dosage formula.
+     *
+     * @returns {Promise<void>}
+     */
+    async _calculatePhMinus() {
+        const base = 'chemistry.tools.ph_minus_calculator';
+
+        const poolVolume = await this._readNumber(`${base}.01_pool_volume_l`);
+        const currentPh = await this._readNumber(`${base}.02_current_ph`);
+        const targetPh = await this._readNumber(`${base}.03_target_ph`);
+        const dosageFactor = await this._readNumber(`${base}.04_grams_per_10000l_01ph`);
+
+        const validation = this._validateInputs({
+            type: 'minus',
+            poolVolume,
+            currentPh,
+            targetPh,
+            dosageFactor,
+        });
+
+        if (!validation.valid) {
+            await this._writeInvalidResult(base, validation.error);
+            return;
+        }
+
+        const resultGrams = this._calculateAmountGrams(currentPh, targetPh, poolVolume, dosageFactor);
+        const roundedGrams = Math.round(resultGrams);
+
+        const resultText =
+            `${I18n.translate('Calculated amount')}: ${roundedGrams} g pH Minus. ` +
+            `${I18n.translate('Reference value based on common manufacturer dosage.')} ` +
+            `${I18n.translate('Follow the manufacturer instructions and re-measure afterwards.')}`;
+
+        await this._writeValidResult(base, roundedGrams, resultText);
+    },
+
+    /**
+     * Calculates the salt amount needed to raise the salt concentration.
+     *
+     * @returns {Promise<void>} Resolves when the salt calculation result has been written.
+     */
+    async _calculateSalt() {
+        const base = 'chemistry.tools.salt_calculator';
+
+        const poolVolume = await this._readNumber(`${base}.01_pool_volume_l`);
+        const currentSalt = await this._readNumber(`${base}.02_current_salt_ppm`);
+        const targetSalt = await this._readNumber(`${base}.03_target_salt_ppm`);
+
+        if (!Number.isFinite(poolVolume) || poolVolume <= 0) {
+            await this._writeInvalidSaltResult(base, I18n.translate('Pool volume must be greater than 0 liters.'));
+            return;
+        }
+
+        if (!Number.isFinite(currentSalt) || currentSalt < 0) {
+            await this._writeInvalidSaltResult(
+                base,
+                I18n.translate('Current salt concentration must be 0 ppm or higher.'),
+            );
+            return;
+        }
+
+        if (!Number.isFinite(targetSalt) || targetSalt <= currentSalt) {
+            await this._writeInvalidSaltResult(
+                base,
+                I18n.translate('Target salt concentration must be higher than the current salt concentration.'),
+            );
+            return;
+        }
+
+        const resultKg = ((targetSalt - currentSalt) * poolVolume) / 1000000;
+        const roundedKg = Math.round(resultKg * 10) / 10;
+
+        const resultText =
+            `${I18n.translate('Calculated amount')}: ${roundedKg} kg ${I18n.translate('salt')}. ` +
+            `${I18n.translate('Reference value for raising the salt concentration in pool water.')} ` +
+            `${I18n.translate('Follow the salt system manufacturer instructions and add salt gradually.')}`;
+
+        await this._writeValidSaltResult(base, roundedKg, resultText);
+    },
+
+    /**
+     * @param {object} input - Calculator input values
+     * @param {'plus' | 'minus'} input.type - Calculator type
+     * @param {number} input.poolVolume - Pool volume in liters
+     * @param {number} input.currentPh - Current pH value
+     * @param {number} input.targetPh - Target pH value
+     * @param {number} input.dosageFactor - Dosage factor in grams per 10,000 l and 0.1 pH
+     * @returns {{ valid: boolean, error: string }} Validation result with an optional translated error message.
+     */
+    _validateInputs(input) {
+        if (!Number.isFinite(input.poolVolume) || input.poolVolume <= 0) {
+            return { valid: false, error: I18n.translate('Pool volume must be greater than 0 liters.') };
+        }
+
+        if (!Number.isFinite(input.currentPh) || input.currentPh <= 0 || input.currentPh > 14) {
+            return { valid: false, error: I18n.translate('Current pH value must be between 0 and 14.') };
+        }
+
+        if (!Number.isFinite(input.targetPh) || input.targetPh <= 0 || input.targetPh > 14) {
+            return { valid: false, error: I18n.translate('Target pH value must be between 0 and 14.') };
+        }
+
+        if (!Number.isFinite(input.dosageFactor) || input.dosageFactor <= 0) {
+            return { valid: false, error: I18n.translate('Dosage factor must be greater than 0 grams.') };
+        }
+
+        if (input.type === 'plus' && input.targetPh <= input.currentPh) {
+            return {
+                valid: false,
+                error: I18n.translate('For pH Plus, the target pH value must be higher than the current pH value.'),
+            };
+        }
+
+        if (input.type === 'minus' && input.targetPh >= input.currentPh) {
+            return {
+                valid: false,
+                error: I18n.translate('For pH Minus, the target pH value must be lower than the current pH value.'),
+            };
+        }
+
+        return { valid: true, error: '' };
+    },
+
+    /**
+     * @param {number} currentPh - Current pH value
+     * @param {number} targetPh - Target pH value
+     * @param {number} poolVolume - Pool volume in liters
+     * @param {number} dosageFactor - Dosage factor in grams per 10,000 l and 0.1 pH
+     * @returns {number} Calculated amount in grams.
+     */
+    _calculateAmountGrams(currentPh, targetPh, poolVolume, dosageFactor) {
+        const phDifference = Math.abs(targetPh - currentPh);
+        const phSteps = phDifference / PH_STEP;
+        const volumeFactor = poolVolume / VOLUME_REFERENCE_L;
+
+        return phSteps * volumeFactor * dosageFactor;
+    },
+
+    /**
+     * @param {string} base - Base state path of the calculator
+     * @param {number} grams - Calculated amount in grams
+     * @param {string} resultText - Readable result text
+     * @returns {Promise<void>}
+     */
+    async _writeValidResult(base, grams, resultText) {
+        const now = Date.now();
+
+        await this._setNumber(`${base}.10_result_grams`, grams);
+        await this._setString(`${base}.11_result_text`, resultText);
+        await this._setBool(`${base}.12_valid`, true);
+        await this._setString(`${base}.13_last_error`, '');
+        await this._setNumber(`${base}.14_last_calculated_at`, now);
+    },
+
+    /**
+     * @param {string} base - Base state path of the calculator
+     * @param {string} errorText - Validation error text
+     * @returns {Promise<void>}
+     */
+    async _writeInvalidResult(base, errorText) {
+        const now = Date.now();
+
+        await this._setNumber(`${base}.10_result_grams`, 0);
+        await this._setString(`${base}.11_result_text`, errorText);
+        await this._setBool(`${base}.12_valid`, false);
+        await this._setString(`${base}.13_last_error`, errorText);
+        await this._setNumber(`${base}.14_last_calculated_at`, now);
+    },
+
+    /**
+     * @param {string} base - Base state path of the salt calculator
+     * @param {number} kg - Calculated salt amount in kilograms
+     * @param {string} resultText - Readable result text
+     * @returns {Promise<void>} Resolves when the valid salt result states have been updated.
+     */
+    async _writeValidSaltResult(base, kg, resultText) {
+        const now = Date.now();
+
+        await this._setNumber(`${base}.10_result_kg`, kg);
+        await this._setString(`${base}.11_result_text`, resultText);
+        await this._setBool(`${base}.12_valid`, true);
+        await this._setString(`${base}.13_last_error`, '');
+        await this._setNumber(`${base}.14_last_calculated_at`, now);
+    },
+
+    /**
+     * @param {string} base - Base state path of the salt calculator
+     * @param {string} errorText - Validation error text
+     * @returns {Promise<void>} Resolves when the invalid salt result states have been updated.
+     */
+    async _writeInvalidSaltResult(base, errorText) {
+        const now = Date.now();
+
+        await this._setNumber(`${base}.10_result_kg`, 0);
+        await this._setString(`${base}.11_result_text`, errorText);
+        await this._setBool(`${base}.12_valid`, false);
+        await this._setString(`${base}.13_last_error`, errorText);
+        await this._setNumber(`${base}.14_last_calculated_at`, now);
+    },
+
+    /**
+     * @param {string} id - Target state ID
+     * @param {number} newValue - Value to write if target is empty
+     * @returns {Promise<void>}
+     */
+    async _prefillNumberIfEmpty(id, newValue) {
+        if (!Number.isFinite(newValue) || newValue <= 0) {
+            return;
+        }
+
+        const currentValue = await this._readNumber(id);
+
+        if (currentValue > 0) {
+            return;
+        }
+
+        await this._setNumber(id, newValue);
+    },
+
+    /**
+     * @param {string} id - State ID
+     * @returns {Promise<number>} Numeric state value, or 0 if the state is missing or invalid.
+     */
+    async _readNumber(id) {
+        const state = await this.adapter.getStateAsync(id);
+        const value = Number(state?.val);
+        return Number.isFinite(value) ? value : 0;
+    },
+
+    /**
+     * @param {string} id - State ID
+     * @param {string} value - Value to write
+     * @returns {Promise<void>}
+     */
+    async _setString(id, value) {
+        await this.adapter.setStateChangedAsync(id, { val: String(value ?? ''), ack: true });
+    },
+
+    /**
+     * @param {string} id - State ID
+     * @param {number} value - Value to write
+     * @returns {Promise<void>}
+     */
+    async _setNumber(id, value) {
+        const numberValue = Number(value);
+        await this.adapter.setStateChangedAsync(id, { val: Number.isFinite(numberValue) ? numberValue : 0, ack: true });
+    },
+
+    /**
+     * @param {string} id - State ID
+     * @param {boolean} value - Value to write
+     * @returns {Promise<void>}
+     */
+    async _setBool(id, value) {
+        await this.adapter.setStateChangedAsync(id, { val: !!value, ack: true });
+    },
+
+    cleanup() {
+        this.adapter = null;
+    },
+};
+
+module.exports = chemistryToolsHelper;

package/lib/i18n/de.json

@@ -13,12 +13,10 @@
   "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.",
@@ -29,7 +27,6 @@
   "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)",
@@ -37,7 +34,6 @@
   "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)",
@@ -45,7 +41,6 @@
   "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",
@@ -53,7 +48,21 @@
   "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: Chlorine level does not rise despite dosing.": "Problem: Chlorwert steigt trotz Dosierung nicht.",
+  "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.": "Das passiert häufig, wenn das Wasser einen hohen Chlorbedarf hat: Zugegebenes Chlor wird sofort verbraucht, bevor ein stabiler freier Chlorwert messbar bleibt.",
+  "High organic load (dirt, biofilm, heavy use)": "Hohe organische Belastung (Schmutz, Biofilm, starke Nutzung)",
+  "Early / invisible algae growth": "Beginnender oder noch nicht sichtbarer Algenwuchs",
+  "Strongly incorrect pH value (effectiveness reduced)": "Deutlich falscher pH-Wert (Wirkung reduziert)",
+  "First check the basic values (pH, filter / circulation, visual inspection for deposits).": "Zuerst die Grundwerte prüfen (pH, Filter / Umwälzung, Sichtprüfung auf Beläge).",
+  "Get the water clean again (clean / backwash the filter, brush the pool), so chlorine is not only being consumed immediately.": "Das Wasser wieder sauber bekommen (Filter reinigen / rückspülen, Becken bürsten), damit Chlor nicht sofort wieder verbraucht wird.",
+  "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.": "Wenn dauerhaft keine Wirkung messbar ist, liegt oft ein oxidativer Bedarf vor (Chlor wird sofort gebunden / abgebaut). Dann hilft nur, die Ursachen konsequent zu reduzieren und erneut zu messen.",
+  "Problem: Strong chlorine smell despite the measured value.": "Problem: Starker Chlorgeruch trotz Messwert.",
+  "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.": "Der typische Schwimmbadgeruch kommt oft nicht von zu viel wirksamem Chlor, sondern von gebundenen Chlorverbindungen (Chloraminen). Diese entstehen, wenn Chlor mit Stickstoff / organischen Stoffen aus Schweiß und ähnlichen Verunreinigungen reagiert.",
+  "High bathing load / organic input": "Hohe Badebelastung / organischer Eintrag",
+  "Too little fresh water / breakdown / filter care": "Zu wenig Frischwasser / Abbau / Filterpflege",
+  "Poor ventilation (for indoor pools) increases the perceived smell": "Schlechte Lüftung (bei Innenpools) verstärkt den wahrgenommenen Geruch",
+  "The goal is to reduce bound contamination: good circulation / filtration, pool cleaning, and possibly a fresh water share.": "Ziel ist, gebundene Verunreinigungen zu reduzieren: gute Umwälzung / Filtration, Beckenreinigung und gegebenenfalls ein Frischwasseranteil.",
+  "Also check the pH in parallel, because an incorrect pH further reduces disinfection performance.": "Parallel auch den pH-Wert prüfen, weil ein falscher pH-Wert die Desinfektionsleistung weiter reduziert.",
   "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",
@@ -63,10 +72,57 @@
   "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.",
-
+  "Problem: Water is cloudy / gray / milky.": "Problem: Wasser ist trüb / grau / milchig.",
+  "Cloudy water is often caused by fine suspended particles or chemical imbalances (for example pH / alkalinity / lime) that the filter cannot handle well.": "Trübes Wasser entsteht oft durch feine Schwebstoffe oder chemische Ungleichgewichte (zum Beispiel pH / Alkalinität / Kalk), die der Filter nicht gut erfassen kann.",
+  "Dirty filter / filter runtime too short": "Verschmutzter Filter / zu kurze Filterlaufzeit",
+  "pH / alkalinity outside the stable range": "pH / Alkalinität außerhalb des stabilen Bereichs",
+  "High water hardness (lime) – especially together with high pH": "Hohe Wasserhärte (Kalk), besonders zusammen mit hohem pH-Wert",
+  "Too little disinfection → biological cloudiness is possible": "Zu wenig Desinfektion → biologische Trübung ist möglich",
+  "Check the filter condition (cleaning / backwashing) and ensure sufficient circulation.": "Filterzustand prüfen (Reinigung / Rückspülen) und ausreichende Umwälzung sicherstellen.",
+  "Check the basic values pH / chlorine and stabilize them.": "Grundwerte pH / Chlor prüfen und stabilisieren.",
+  "If the cloudiness looks mineral (milky / white), also consider water hardness / balance.": "Wenn die Trübung mineralisch wirkt (milchig / weiß), auch Wasserhärte und Wasserbalance berücksichtigen.",
+  "Problem: Algae visible on walls or floor.": "Problem: Algen sichtbar an Wänden oder Boden.",
+  "Visible algae are a clear sign that disinfection / circulation was not sufficient or that local dead zones are forming (corners / pipes).": "Sichtbare Algen sind ein klares Zeichen, dass Desinfektion / Umwälzung nicht ausgereicht haben oder lokale Totzonen entstehen (Ecken / Leitungen).",
+  "Chlorine too low or already consumed": "Chlor zu niedrig oder bereits verbraucht",
+  "pH too high (chlorine works less effectively)": "pH zu hoch (Chlor wirkt schlechter)",
+  "Too little brushing / pool care, poor circulation": "Zu wenig Bürsten / Beckenpflege, schlechte Umwälzung",
+  "Mechanics first: brush / vacuum consistently, maintain the filter.": "Zuerst mechanisch arbeiten: konsequent bürsten / absaugen und den Filter pflegen.",
+  "Then stabilize the values (pH / chlorine) and improve circulation.": "Danach die Werte stabilisieren (pH / Chlor) und die Umwälzung verbessern.",
+  "The goal is to remove algae not only chemically, but also mechanically.": "Ziel ist, Algen nicht nur chemisch, sondern auch mechanisch zu entfernen.",
+  "Problem: Foam on the water surface.": "Problem: Schaum auf der Wasseroberfläche.",
+  "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.": "Schaum entsteht oft durch Tenside / organische Stoffe (Sonnencreme, Körperpflegeprodukte, Reinigungsreste), manche Algizide / Polymere oder auch Luft im System. Es ist meist kein Chlorproblem, sondern eher ein Problem durch Stoffe im Wasser.",
+  "A lot of lotions / oils in the water, high organic load": "Viele Lotionen / Öle im Wasser, hohe organische Belastung",
+  "Certain anti-algae products can promote foam": "Bestimmte Anti-Algen-Produkte können Schaum begünstigen",
+  "Air entering the system (small leaks) → foam appears stronger": "Lufteintrag im System (kleine Undichtigkeiten) → Schaum wirkt stärker",
+  "Skim off the surface, keep the filter clean, and reduce organic input.": "Oberfläche abschöpfen, Filter sauber halten und organischen Eintrag reduzieren.",
+  "Keep an eye on pH / chlorine as well (stable values help break down organic matter faster).": "Auch pH / Chlor im Blick behalten (stabile Werte helfen, organische Stoffe schneller abzubauen).",
+  "If foam remains permanently, systematically narrow down the source (products / contamination / technology).": "Wenn Schaum dauerhaft bleibt, die Ursache systematisch eingrenzen (Produkte / Verunreinigung / Technik).",
+  "Problem: Skin or eye irritation while swimming.": "Problem: Haut- oder Augenreizungen beim Schwimmen.",
+  "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.": "Reizungen können mehrere Ursachen haben: einen zu hohen oder sehr niedrigen pH-Wert, eine zu hohe Desinfektionsmittelkonzentration oder gebundene Chlorverbindungen (Chloramine) durch organische Belastung.",
+  "pH outside the comfortable range": "pH außerhalb des angenehmen Bereichs",
+  "Chlorine clearly too high": "Chlor deutlich zu hoch",
+  "Chlorine smell / chloramines caused by strong organic input": "Chlorgeruch / Chloramine durch starken organischen Eintrag",
+  "Measure first (pH and chlorine) and bring the values back into a normal range.": "Zuerst messen (pH und Chlor) und die Werte wieder in einen normalen Bereich bringen.",
+  "Keep the pool / filter clean so that organic contamination does not turn into bound compounds.": "Becken / Filter sauber halten, damit organische Verunreinigungen nicht zu gebundenen Verbindungen werden.",
+  "If irritation is strong, pause swimming until the water values are stable.": "Bei starken Reizungen das Baden pausieren, bis die Wasserwerte stabil sind.",
+  "Problem: Water values are often unstable (change quickly).": "Problem: Wasserwerte sind häufig instabil (ändern sich schnell).",
+  "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.": "Wenn pH / Chlor ständig stark schwanken, fehlt dem Wasser oft Stabilität: Der Puffer (Alkalinität) ist zu niedrig / zu hoch, die Belastung ändert sich häufig oder Umwälzung / Filtration sind nicht konstant genug.",
+  "Total alkalinity too low → pH jumps / tips over quickly": "Gesamtalkalinität zu niedrig → pH springt / kippt schnell",
+  "Many small corrections without enough circulation time": "Viele kleine Korrekturen ohne ausreichende Umwälzzeit",
+  "Poor filter condition / filter times too short": "Schlechter Filterzustand / zu kurze Filterzeiten",
+  "Strong external influences (rain, heat, heavy use)": "Starke äußere Einflüsse (Regen, Hitze, intensive Nutzung)",
+  "First get the basics stable (buffer / filter / regularity), then only fine-tune.": "Zuerst die Grundlagen stabil bekommen (Puffer / Filter / Regelmäßigkeit), danach nur noch fein nachjustieren.",
+  "Always correct in small steps and allow enough time for mixing.": "Immer in kleinen Schritten korrigieren und genug Zeit zum Durchmischen lassen.",
+  "Problem: It is unclear what exactly is wrong.": "Problem: Es ist unklar, was genau nicht stimmt.",
+  "Procedure (minimal and sensible):": "Vorgehen (minimal und sinnvoll):",
+  "Visual check: Green? Cloudy? Deposits? Foam?": "Sichtprüfung: Grün? Trüb? Beläge? Schaum?",
+  "Two measured values are enough for the start: pH + free chlorine.": "Für den Anfang reichen zwei Messwerte: pH + freies Chlor.",
+  "Check the technology: Is circulation running? Is the filter clean? Is backwashing needed?": "Technik prüfen: Läuft die Umwälzung? Ist der Filter sauber? Ist Rückspülen nötig?",
+  "Typical rule of thumb:": "Typische Faustregel:",
+  "Visual problems (green / cloudy) are very often a combination of disinfection + pH + filtration.": "Sichtbare Probleme (grün / trüb) sind sehr oft eine Kombination aus Desinfektion + pH + Filtration.",
+  "Odor / irritation is often not too much chlorine, but incorrectly bound / organically loaded water.": "Geruch / Reizungen bedeuten oft nicht zu viel Chlor, sondern falsch gebundenes oder organisch belastetes Wasser.",
   "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.",
-
   "Extended solar configuration invalid": "Konfiguration der erweiterten Solarsteuerung ungültig",
   "Solar Extended configuration invalid": "Konfiguration von Solar Extended ungültig",
   "Priority blocked by controlHelper": "Durch controlHelper blockiert",
@@ -102,7 +158,6 @@
   "extended blocked by actor write error": "Extended durch Aktor-Schreibfehler blockiert",
   "extended active": "Extended aktiv",
   "extended inactive": "Extended inaktiv",
-
   "solar_insights_summary_note_block_7": "Block 7 schreibt direkte Referenzwerte, geschätzte thermische Leistung, geschätzten Tagesertrag, geschätztes Effizienzverhältnis, die Nutzung des Rücklaufsensors sowie wetterbasierte Bewertungskennzeichen.",
   "solar_insights_label_mode": "Modus",
   "solar_insights_label_solar_ran_today": "Solar lief heute",
@@ -141,7 +196,6 @@
   "solar_insights_debug_block_7_updated": "Solar-Insights Block 7 aktualisiert. Verwendete Sensoren:",
   "solar_insights_debug_block_7_error": "Solar-Insights Block 7 Fehler:",
   "solar_insights_html_note_block_7": "Geschätzter Tagesertrag, geschätztes Effizienzverhältnis, Nutzung des Rücklaufsensors und wetterbasierte Bewertungskennzeichen sind aktiv.",
-
   "solar_log_value_unknown": "unbekannt",
   "solar_log_confidence_text": "Die aktuelle Vertrauensstufe dieser Bewertung liegt bei etwa %s Prozent.",
   "solar_log_text_no_runtime_today": "Solar ist heute nicht gelaufen, daher kann kein sinnvoller Solarertrag für den Tag angegeben werden.",
@@ -169,7 +223,6 @@
   "solar_log_text_weather_supported": "Für diese Bewertung ist eine wetterbasierte Plausibilisierung aktiv.",
   "solar_log_text_small_gain_detail": "Der aktuell geschätzte Tagesertrag liegt bei etwa %s Wh, das entspricht etwa %s kWh.",
   "solar_log_text_quality_level": "Die aktuelle Qualitätsstufe der Bewertung ist %s.",
-
   "photovoltaic_insights_calculation_mode_daily": "Tägliche PV-Überschussanalyse",
   "photovoltaic_insights_price_source_adapter_config": "Adapter-Konfiguration",
   "photovoltaic_insights_calculation_note_block_2": "Der Berechnungsblock bereitet die Quelleninformationen für die Photovoltaik-Insights-Analyse vor.",
@@ -188,7 +241,6 @@
   "photovoltaic_insights_debug_text_no_pv_runtime": "Aktuell wird keine PV-Laufzeit gezählt, weil entweder kein PV-Überschuss aktiv ist oder der Photovoltaik-Helper die Pumpe nicht besitzt.",
   "photovoltaic_insights_debug_reason_daily_reset": "Täglicher Reset",
   "photovoltaic_insights_debug_text_daily_reset": "Die täglichen Photovoltaik-Insights-Werte wurden zurückgesetzt.",
-
   "pH source state configured.": "pH-Quell-Datenpunkt konfiguriert.",
   "pH source state could not be subscribed.": "pH-Quell-Datenpunkt konnte nicht abonniert werden.",
   "No pH source state configured.": "Kein pH-Quell-Datenpunkt konfiguriert.",
@@ -219,12 +271,10 @@
   "pH mixing run finished. Pump was already running and was not switched off by the pH helper.": "pH-Mischlauf beendet. Die Pumpe lief bereits und wurde vom pH-Helper nicht ausgeschaltet.",
   "pH trend": "pH-Trend",
   "Overall pH status": "Gesamtstatus pH",
-
   "pH is rising very quickly. Check dosing, alkalinity and water balance.": "Der pH-Wert steigt sehr schnell an. Prüfe Dosierung, Alkalinität und Wasserbalance.",
   "pH is rising noticeably. Observe the trend and check alkalinity and water balance.": "Der pH-Wert steigt merklich an. Beobachte den Trend und prüfe Alkalinität und Wasserbalance.",
   "pH is slowly rising. Continue observing the trend.": "Der pH-Wert steigt langsam an. Beobachte den Trend weiter.",
   "pH is falling. This can be plausible after pH correction or fresh water.": "Der pH-Wert fällt. Das kann nach einer pH-Korrektur oder Frischwasserzugabe plausibel sein.",
-
   "Not enough pH history is available yet. Collect more valid measurements.": "Es sind noch nicht genügend pH-Historienwerte vorhanden. Sammle weitere gültige Messwerte.",
   "No TDS source state configured.": "Kein TDS-Quell-Datenpunkt konfiguriert.",
   "TDS source state configured.": "TDS-Quell-Datenpunkt konfiguriert.",
@@ -247,7 +297,7 @@
   "Not enough TDS history is available yet. Collect more valid measurements.": "Es sind noch nicht genügend TDS-Verlaufsdaten vorhanden. Weitere gültige Messwerte sammeln.",
   "TDS is falling. This can be plausible after fresh water or a partial water change.": "TDS sinkt. Das kann nach Frischwasser oder einem Teilwasserwechsel plausibel sein.",
   "Current TDS value": "Aktueller TDS-Wert",
-  "not enough data": "nicht genug Daten",
+  "not enough data": "nicht genügend Daten",
   "Initial reference": "Initialer Referenzwert",
   "not set": "nicht gesetzt",
   "Delta since reference": "Differenz seit Referenzwert",
@@ -255,7 +305,6 @@
   "Trend status": "Trendstatus",
   "Overall status": "Gesamtstatus",
   "Recommendation": "Empfehlung",
-
   "No ORP source state configured.": "Kein ORP-Quelldatenpunkt konfiguriert.",
   "ORP source state configured.": "ORP-Quelldatenpunkt konfiguriert.",
   "ORP source state could not be subscribed.": "ORP-Quelldatenpunkt konnte nicht abonniert werden.",
@@ -275,10 +324,23 @@
   "ORP value is high. Check whether the measurement is plausible and evaluate the water values together.": "ORP-Wert hoch. Bitte prüfen, ob die Messung plausibel ist und die Wasserwerte gemeinsam bewerten.",
   "ORP value is within the configured reference range.": "ORP-Wert befindet sich im konfigurierten Referenzbereich.",
   "unknown": "unbekannt",
-  "not enough data": "nicht genügend Daten",
   "Current ORP value": "Aktueller ORP-Wert",
   "pH reference": "pH-Referenz",
   "Status": "Status",
-  "Recommendation": "Empfehlung",
-  "ORP evaluation is disabled.": "ORP-Auswertung ist deaktiviert."
-}
+  "ORP evaluation is disabled.": "ORP-Auswertung ist deaktiviert.",
+
+  "Calculated amount": "Berechnete Menge",
+  "Reference value based on common manufacturer dosage.": "Orientierungswert nach üblicher Herstellerdosierung.",
+  "Follow the manufacturer instructions and re-measure afterwards.": "Bitte Herstellerangaben beachten und anschließend erneut messen.",
+  "Pool volume must be greater than 0 liters.": "Das Poolvolumen muss größer als 0 Liter sein.",
+  "Current pH value must be between 0 and 14.": "Der aktuelle pH-Wert muss zwischen 0 und 14 liegen.",
+  "Target pH value must be between 0 and 14.": "Der Ziel-pH-Wert muss zwischen 0 und 14 liegen.",
+  "Dosage factor must be greater than 0 grams.": "Der Dosierfaktor muss größer als 0 Gramm sein.",
+  "For pH Plus, the target pH value must be higher than the current pH value.": "Für pH Plus muss der Ziel-pH-Wert höher als der aktuelle pH-Wert sein.",
+  "For pH Minus, the target pH value must be lower than the current pH value.": "Für pH Minus muss der Ziel-pH-Wert niedriger als der aktuelle pH-Wert sein.",
+  "Current salt concentration must be 0 ppm or higher.": "Die aktuelle Salzkonzentration muss 0 ppm oder höher sein.",
+  "Target salt concentration must be higher than the current salt concentration.": "Die Ziel-Salzkonzentration muss höher als die aktuelle Salzkonzentration sein.",
+  "Reference value for raising the salt concentration in pool water.": "Referenzwert für die Erhöhung der Salzkonzentration im Poolwasser.",
+  "Follow the salt system manufacturer instructions and add salt gradually.": "Bitte die Anweisungen des Salzsystem-Herstellers befolgen und das Salz allmählich hinzufügen.",
+  "salt": "Salz"
+}

package/lib/i18n/en.json

@@ -351,5 +351,23 @@
   "pH reference": "pH reference",
   "Status": "Status",
   "Recommendation": "Recommendation",
-  "ORP evaluation is disabled.": "ORP evaluation is disabled."
+  "ORP evaluation is disabled.": "ORP evaluation is disabled.",
+  
+  "Calculated amount": "Calculated amount",
+  "Reference value based on common manufacturer dosage.": "Reference value based on common manufacturer dosage.",
+  "Follow the manufacturer instructions and re-measure afterwards.": "Follow the manufacturer instructions and re-measure afterwards.",
+
+  "Pool volume must be greater than 0 liters.": "Pool volume must be greater than 0 liters.",
+  "Current pH value must be between 0 and 14.": "Current pH value must be between 0 and 14.",
+  "Target pH value must be between 0 and 14.": "Target pH value must be between 0 and 14.",
+  "Dosage factor must be greater than 0 grams.": "Dosage factor must be greater than 0 grams.",
+
+  "For pH Plus, the target pH value must be higher than the current pH value.": "For pH Plus, the target pH value must be higher than the current pH value.",
+  "For pH Minus, the target pH value must be lower than the current pH value.": "For pH Minus, the target pH value must be lower than the current pH value.",
+  "Current salt concentration must be 0 ppm or higher.": "Current salt concentration must be 0 ppm or higher.",
+
+  "Target salt concentration must be higher than the current salt concentration.": "Target salt concentration must be higher than the current salt concentration.",
+  "Reference value for raising the salt concentration in pool water.": "Reference value for raising the salt concentration in pool water.",
+  "Follow the salt system manufacturer instructions and add salt gradually.": "Follow the salt system manufacturer instructions and add salt gradually.",
+  "salt": "salt"
 }