Where in the app
System → Settings → Chemistry (/settings/chemistry). Requires settings view/edit permission.
⚗️ Chemistry settings
Define which catalog product the calculator uses for each correction type (raise pH, chlorine shock, algaecide…) and water targets.
What this screen controls
| Block | Purpose |
|---|---|
| Targets | pH, free chlorine, alkalinity, salt, CYA, hardness, shock chlorine |
| Dosing mode | Standard or conservative (affects quantities) |
| Product by role | Which catalog item is suggested per need |
| Product profile | Concentration, dose unit, per-visit cap |
| Coefficients | Fine-tune formulas (advanced users) |
| Preview | Sample suggestions with current setup |
Same configuration powers:
- Phone/office consultation (
Operations → Chemical consultation) - Technician work order (Step 2 — dosing)
- Chemical PDF for the client
Starter catalog on signup
New accounts may get a demo chemical catalog (13 products at price 0 with SKUs like QR-001, QD-005…).
Next steps
- Review names and set real prices under Warehouse → Products.
- Open Settings → Chemistry and confirm each role points to the product you actually use.
- When changing brands, do not delete the old product if it has history: create a new one and reassign the role.
How to change products (brand switch)
Step 1 — Add the new product
- Warehouse → Products → New product
- Name, sales unit (kg, L…), purchase price (for consultation costs)
- Optional: your own SKU (not required if you map by role manually)
Step 2 — Chemical profile on the product
On the product page, Chemistry tab:
| Field | Example | Effect |
|---|---|---|
| Chemical role | PH_INCREASE | One primary role per product |
| Active % | 100 | Scales dose (e.g. 10% acid) |
| Dose unit | g, ml, kg | What the technician sees |
| Per-visit cap | 2000 g | Part of the dose may stay pending for the next visit |
| Sanitation types | Chlorine, Salt, Bromine… | Skipped if pool type does not match |
Step 3 — Assign in Settings → Chemistry
Under Product by role, pick the new item for each correction.
Immediate effect: consultation and technician order suggest the new product on the next measurement. No app restart needed.
Step 4 — Van stock
Technician sees In van / Out of stock from the mobile warehouse. Restock the new product after the switch.
Chemical roles (reference)
| Role | When used |
|---|---|
| PH_DECREASE / PH_INCREASE | High / low pH |
| CHLORINE_LIQUID_MAINT | Low free chlorine (maintenance) |
| CHLORINE_LIQUID_SHOCK / CHLORINE_GRANULAR_SHOCK | Shock or high combined chlorine |
| ALKALINITY_INCREASE | Low TA |
| CALCIUM_INCREASE | Low hardness (secondary) |
| STABILIZER | Low CYA (chlorine pools only) |
| SALT | Low salt (electrolysis) |
| ALGAECIDE / FLOCULANT | Water condition (algae / cloudy) |
If a role has no product
The calculator skips that correction without a loud error. Check chemistry settings if an expected suggestion is missing.
Coefficients and conservative mode
- Conservative mode: slightly lower doses (safety margin).
- Coefficients: multipliers per product type; use only if you know your supplier formulation or after field calibration.
Restore defaults resets standard engine coefficients.
Prices and costs
| Data | Where | Effect |
|---|---|---|
| Purchase price | Product page | Estimated cost in consultation and visit |
| Price 0 (demo) | Starter catalog | Costs show €0 until you update |
| Sales unit vs dose | Chemical profile | Auto conversion (g→kg, ml→L) in consumption cart |
Checklist after changing products
- [ ] Each used role has assigned product and active profile
- [ ] Purchase prices updated
- [ ] Stock in technician van
- [ ] Test in Chemical consultation with real readings
- [ ] Test on technician work order (same doses with
visitCapPolicy=apply)
Detailed test guide: E2E calculator test.