poolbalance
v6.0.0
Published
Pool cleaning, measurement and chemical balancing app.
Readme
Pool Balance ( Personal Edition )
Pool cleaning, measurement and chemical balancing app using ScalaFx, Scalikejdbc, Ox, HikariCP, H2, jDeploy and Scala 3.
Install
- Select Pool Balance
- Select a platform to download a compressed app installer.
- Decompress app installer.
- Install app by double-clicking app installer.
- Select app icon to launch app.
This install has been tested on macOS.
Features
- dashboard
- cleanings
- measurements
- chemicals
- charts
- database
Use Cases
- clean pool and components
- measure pool chemical content
- add chemicals to pool
Entity
- Pool 1 --> * Cleaning | Measurement | Chemical
Model
- App 1 --> 1 Context | Store | Model | View
- Store 1 --> 1 Context
- Model 1 --> 1 Context | Store
- View 1 --> 1 Context | Model
UI
- Top: dashboard(total chlorine, free chlorine, ph, calcium hardness, total alkalinity, cyanuric acid, total bromine)
- Left: pane(pools)
- Center: tabbedpane(cleanings, measurements, chemicals)
Charts
- cleanings - line chart ( x = cleaned, y = ? )
- measurements - line chart ( x = measured, y = measurement )
- chemicals - bar chart ( x = added, y = amount/typeof )
Measurements
Measured in ppm ( parts per million ).
| Measurement | Range | Good | Ideal | |-----------------------------------|-----------|-------------|-------| | total chlorine (tc = fc + cc) | 0 - 10 | 1 - 5 | 3 | | free chlorine (fc) | 0 - 10 | 1 - 5 | 3 | | combinded chlorine (cc = tc - fc) | 0.0 - 0.5 | 0.0 - 0.2 | 0.0 | | ph | 6.2 - 8.4 | 7.2 - 7.6 | 7.4 | | calcium hardness | 0 - 1000 | 250 - 500 | 375 | | total alkalinity | 0 - 240 | 80 - 120 | 100 | | cyanuric acid | 0 - 300 | 30 - 100 | 50 | | total bromine | 0 - 20 | 2 - 10 | 5 | | salt | 0 - 3600 | 2700 - 3400 | 3200 | | temperature | 50 - 100 | 75 - 85 | 82 |
Chemicals
- Liquids measured in: gallons ( gl ) and liters ( l ).
- Granules measured in: pounds ( lbs ) and kilograms ( kg ).
- LiquidChlorine ( gl/l )
- Trichlor ( tablet )
- Dichlor ( lbs/kg )
- CalciumHypochlorite ( lbs/kg )
- Stabilizer ( lbs/kg )
- Algaecide ( gl/l )
- MuriaticAcid ( gl/l )
- Salt ( lbs/kg )
Products
- Chlorine for pool.
- Chlorine tablets for pool filtration system.
- Pool Shock
Solutions
Suggested solutions to chemical imbalances.
- high ph - Sodium Bisulfate
- low ph - Sodium Carbonate, Soda Ash
- high alkalinity - Muriatic Acid, Sodium Bisulfate
- low alkalinity - Sodium Bicarbonate, Baking Soda
- calcium hardness - Calcium Chloride
- low chlorine - Chlorine Tablets, Granules, Liquid
- algae - Algaecide, Shock
- stains - Stain Identification Kit, Stain Remover
Build
sbt clean compile
Test
sbt clean test
Run
sbt run
Assembly
sbt clean test assembly copyAssemblyJar
Execute
java -jar .assembly/poolbalance-$version.jar
Deploy
- edit build.sbt ( jarVersion + version )
- edit app.conf ( about > alert > contentText )
- edit package.json ( version + jdeploy / jar )
- sbt clean test assembly copyAssemblyJar
- perform github release ( from https://github.com/objektwerks/pool.balance.p )
- npm login
- jdeploy publish ( to https://www.jdeploy.com/~poolbalance )
- check email for npm message
See jDeploy Docs for details.
jDeploy Install
- Setup npm account at npmjs.com
- Install node, which installs npm, which bundles npx.
- Install jdeploy via npm - npm install -g jdeploy
- Add icon.png ( 256x256 or 512x512 ) to project root and resources.
- Edit jDeploy package.json as required.
- Add jdeploy and jdeploy-bundle to .gitignore
See jDeploy Docs for details.
NPM Versioning
The
build.sbtmust contain asemver 3-digitversion number. See: Npmjs Semver
NPM Registry
Pool Balance is deployed to: https://www.npmjs.com/package/poolbalance
Resources
License
Copyright (c) [2022-2025] [Objektwerks]
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
* http://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
