🇧🇬 Bulgarian user guide: Прочетете инструкциите на български
1. What this calculator does
Enter your diving activity and sales figures for any date. The calculator estimates the commission allocated to that day, automatically spreads Open Water and Advanced Open Water course pay over multiple calendar days, and shows your monthly earnings.
The V5 edition is a Progressive Web App (PWA). Publish the provided files on an HTTPS website (such as GitHub Pages), then open the website in Safari on iPhone or Chrome on Android. After the first successful online visit and offline cache installation, the app can be used offline. Records remain local to the installed app/browser.
Important: This is an earnings-planning tool, not an employer payroll system. Earnings allocated to a day are not necessarily paid on that date.
2. Commission rates
| Activity | Commission | What to enter |
|---|---|---|
| Double Tank (2 dives) | ฿400 per client | Number of clients on two-dive trip |
| Afternoon Dive | ฿200 per client | Number of afternoon-dive clients |
| Refresher / ReActivate | Rate pending | Number of clients; commission excluded until configured |
| Night Dive | Rate pending | Number of clients; commission excluded until configured |
| Open Water Diver (digital) | ฿3,200 per student | Number of NEW students on course start date (3 days) |
| Advanced Open Water | ≈฿2,650 per student | Number of NEW students on course start date (2 days) |
| DSD standard (2 dives) | ฿1,000 per participant | Number of participants |
| DSD 3rd dive (extra) | ฿500 per participant (assumed) | Participants with optional 3rd dive |
| Personal sales | 5% of sales value (assumed additional) | Total personal sales in THB |
*The extra ฿500 is treated as an instructor commission, and the 5% sales commission is treated as additional to dive/course earnings. Confirm both details with the dive centre.
3. How to enter and save a day's work
- Open the published calculator website in Safari, Chrome, or a compatible browser. Look for the “Calculator active” message.
- Choose a date under Work date.
- Type your quantities directly or tap the + / − buttons beside each activity. For personal sales, the buttons change the sales value by ฿100; you can type any exact amount.
- Check Estimated earnings allocated to this day. This updates as you adjust the values, including any course commission continuing from an earlier date.
- Tap Save this day to store your entry and update the monthly totals.
The daily estimate changes as you type. The Monthly overview reflects saved entries, so remember to save.
Example: recreational divers
Two certified divers each complete two dives. Enter 4 recreational tanks, not 2 customers. Commission: 4 × ฿200 = ฿800.
4. Multi-day courses: enter students only once
Open Water Diver (OWD) — 3 calendar days
OWD pays ฿3,200 per student. When two students start on November 18, enter 2 OWD students on November 18 only. The total course commission is ฿6,400, allocated equally over November 18, 19 and 20.
| Date | Daily allocated OWD commission |
|---|---|
| November 18 | ≈฿2,133.33 |
| November 19 | ≈฿2,133.33 |
| November 20 | ≈฿2,133.33 |
| Total (unrounded) | ฿6,400.00 |
Do not enter these same two students again on the 19th or 20th. Their continuing earnings appear automatically, even if you do not save a separate entry for those dates.
Advanced Open Water (AOWD) — 2 calendar days
One AOWD student pays approximately ฿2,650 in instructor commission. If the student starts on November 18, the calculator allocates ฿1,325 on November 18 and ฿1,325 on November 19.
Courses spanning two months
A course starting on November 30 can allocate part of its commission to December automatically. Use View month to see the correct amount in each month.
Scheduling assumption: Course pay is spread across consecutive calendar days, including rest days if they fall in the middle. The calculator does not currently allow skipping a rest day or separately scheduling individual course sessions.
5. DSD and extra third dives
The standard DSD activity is two dives. Enter the number of participants in DSD – standard, 2 dives. If any of those participants also choose a third dive, enter that number in DSD – additional 3rd dive.
Example: Two DSD participants complete two dives and one of them completes a third. Enter DSD = 2 and 3rd dive = 1. The estimated instructor commission is ฿2,500 (฿2,000 + ฿500).
The app warns if the third-dive count exceeds the standard DSD participant count, but may allow you to save after confirmation.
6. Personal sales commission
Enter the monetary sales value, not the count of items or customers. For example, sales of ฿10,000 produce a ฿500 commission at 5%.
If you sell a course you also teach, include that course's selling price in personal sales only if the dive centre confirms the 5% is payable in addition to your teaching commission. The calculator does not automatically detect or remove duplicate sales credit.
7. Monthly overview and history
- View month: Select any month.
- Total monthly commission: Sum of commissions allocated within the selected month.
- Days with allocated earnings: Number of days with a positive calculated commission. This is not necessarily the number of days physically worked.
- Average per worked day: Monthly commission divided by days with allocated earnings; it uses the label “worked day” for allocated days.
- Allocated daily earnings chart: View daily totals; tap a bar to open the corresponding day.
- Activity totals this month: See allocated amounts by activity. Course student counts can be fractional here because course earnings are spread across days.
- Saved entries / course start dates: Find your saved dates and carry-over days. Choose Edit or View to inspect a day.
8. Editing, clearing and deleting
- Edit a saved day: Select its date, change the figures and tap Save this day again. The app recalculates the linked course days.
- Clear inputs: Resets only the visible input fields. It does not remove saved data until you save the cleared entry.
- Delete saved day: Permanently deletes that date's entry after confirmation. Courses started on that day stop contributing to later dates.
9. Export, backups and changing phones
- Export month (CSV): Download a monthly breakdown for Excel or other spreadsheet apps. It is a report, not a restore file.
- Backup all data (JSON): Download all saved entries, across months. Keep this file somewhere safe.
- Restore JSON backup: Import a previous JSON backup. Warning: restoring replaces all entries currently saved in that browser.
Data is stored locally in the specific browser/device where you used the calculator. It is not synchronized between iPhone and Android. To transfer it, export a JSON backup from the first phone and restore it on the other.
iPhone Files preview does not reliably run this HTML. Do not open index.html from Files: visit the published HTTPS link in Safari instead. If the buttons do nothing, or you see “JavaScript is not running”, verify you are on the hosted web page. Test one dummy entry and verify it remains after reopening. Keep JSON backups: clearing browser data or changing how you open the file may make earlier records inaccessible.
10. Quick worked example
On one date, you take 2 clients on Double Tank, 1 on Afternoon Dive, start 2 new OWD students, guide 1 standard DSD participant and make ฿4,000 in personal sales. The dive commissions are ฿800 + ฿200, the OWD accrual for that first day is ฿2,133.33, DSD earns ฿1,000 and personal sales are ฿200 (assuming the extra 5% applies): total approximately ฿4,333.33 for that day.
| Component | Commission allocated today |
|---|---|
| 2 Double Tank clients | ฿800.00 |
| 2 new OWD students — first of 3 days | ≈฿2,133.33 |
| 1 standard DSD | ฿1,000.00 |
| 5% of ฿4,000 personal sales | ฿200.00 |
| Estimated daily allocation | ≈฿4,333.33 |
The two OWD students also generate approximately ฿2,133.33 on each of the next two calendar days without being entered again. The course's full commission is still ฿6,400.
11. Publish updates using GitHub Pages
- Sign in to GitHub and create a new repository, for example
koh-lipe-earnings. For standard GitHub Pages on a Free account, choose Public. - Extract
koh_lipe_pwa_v5.zipon a computer. Upload all files from inside the extracted folder into the root of the repository:index.html,manifest.webmanifest,sw.js, the PNG icons,user-guide.html, and.nojekyll. Do not upload the ZIP alone. - Open the repository Settings → Pages. Under Build and deployment, choose Deploy from a branch, select main and /(root), then Save.
- Visit the URL GitHub Pages provides, normally
https://YOUR-USERNAME.github.io/koh-lipe-earnings/. Wait for deployment to complete if the site is not available yet. - Confirm the message Calculator active and test the + button before installing it.
Privacy: The source code is public when published in a public repository. Do not place real client names or other private information in GitHub. Calculator records are only held in local device storage and are not uploaded to GitHub by this app.
12. Install on iPhone and Android
iPhone / iPad
- Open the GitHub Pages URL in Safari.
- Tap Share (square with upward arrow).
- Choose Add to Home Screen; turn on Open as Web App if shown.
- Tap Add. Open Lipe Earnings from your Home Screen.
Android
- Open the published URL in Chrome.
- Open the menu (three dots) and choose Install app or Add to Home screen.
- Confirm, then open the new app icon.
Offline use and updates
Open the published page while connected to the internet once to allow the app resources to be cached. Test in airplane mode after the page has loaded. For future updates, replace the GitHub files, then reopen the app with an internet connection to fetch the new version. Because installed apps can use separate storage from browser tabs, make a JSON backup before changing installation methods or removing/reinstalling the app.
On some devices, storage restrictions, low storage, browser data clearing, or app removal can erase saved records. There is no cloud sync. Export JSON backups regularly.
13. Version notes and future updates
Prior versions V1–V5 were informal milestones. The V5 PWA is the 1.0.0 SemVer baseline; the current updated release is 1.2.0. Use MAJOR.MINOR.PATCH for future releases.
This guide is designed to be revised together with future calculator releases. When an activity, rate, calculation rule or feature changes, update the corresponding instructions and the version notes rather than relying on an older guide.
What’s new in version 1.2.0
Use the language selector at the top of the calculator to choose English, Spanish, French, Portuguese, German or Bulgarian. No additional calculator HTML files are required: text is translated in the browser while records remain unchanged.
Daily dive categories
- Double Tank: Enter the number of clients completing the two-dive trip. Each client pays ฿400 instructor commission.
- Afternoon Dive: Enter the number of clients completing one afternoon dive. Each client pays ฿200 instructor commission.
- Refresher / ReActivate: Enter participating clients. The instructor rate is not confirmed and will show “Rate pending”.
- Night Dive: Enter participating clients. The instructor rate is not confirmed and will show “Rate pending”.
To configure a pending rate later, open app.js and change refresher: null or night: null to the confirmed THB amount per participant. Commit the changes and increment the app version/cache version.
Previously saved recreational tanks
Older entries containing the original “Recreational dive tanks” field are kept as Legacy recreational tanks at ฿200 per tank. They remain in historical totals and backups; when editing an old saved day, the legacy value is preserved. Enter new Double Tank and Afternoon Dive clients in the new separate fields.
Dates and course allocations
OWD (digital only) pays ฿3,200 per student, split equally across 3 consecutive calendar days. AOWD pays approximately ฿2,650 per student, split across 2 days. Enter new students only on their course start date. DSD standard two dives pays ฿1,000 per participant; a third DSD dive is assumed to add ฿500 instructor commission per participant, subject to confirmation. Personal sales earn an additional 5% if the centre confirms this applies alongside teaching commission.
Saved data and backups
Save This Day writes to local storage on the current device. The app does not synchronize between Android and iPhone. Use Backup all data (JSON) before changing devices or reinstalling the app. The upgrade maintains the previous local storage key to preserve existing entries.
GitHub Pages update steps
- In VS Code replace
index.htmlanduser-guide.html; addapp.js; replacesw.jsandREADME.md. Keep the icon and manifest files. - Commit with a message such as
feat: split dive activities and add five-language UI (v1.2.0). - Push to the
mainbranch, then open the published GitHub Pages URL and reload the installed app once online.
Version history
Historical V1–V5 labels were informal milestones, not SemVer releases. From this release onward, use MAJOR.MINOR.PATCH. Version 1.2.0 introduces new activity categories and localization without changing the old saved-data format. Version 1.0.0 represents the existing installable V5 app baseline. Older revisions: V1 original calculator; V2/V3 mobile controls and fixes; V4 OWD/AOWD multi-day allocation; V5 installable PWA with offline support.
Version 1.2.0 — Bulgarian language
The calculator now includes Bulgarian (Български) as a sixth interface language. The Instructions link automatically opens the Bulgarian guide when Bulgarian is selected, and the English guide for other interface languages. Existing records, rates and course allocation logic are unchanged. Update app.js, index.html, both guides and sw.js together.
The PWA continues to store data locally; keep regular JSON backups. Version 1.1.1 was a clean-up release; version 1.2.0 adds localization.