← Обратно към калкулатора English guide
1. За какво служи калкулаторът?
Въведете броя клиенти по дейности за определена дата, за да видите прогнозните си комисиони в тайландски батове (THB, ฿). Приходите от OWD и AOWD се разпределят автоматично по дни. Месечният преглед сумира начисленията за избрания месец.
Това е уеб приложение (PWA), което може да се добави на началния екран на iPhone или Android. Данните се съхраняват локално на устройството, а не в GitHub или обща база данни.
2. Комисиони и категории
| Дейност | Комисиона | Какво се въвежда |
|---|---|---|
| Двойно гмуркане (Double Tank) | ฿400/клиент | Брой клиенти за две гмуркания |
| Следобедно гмуркане | ฿200/клиент | Брой клиенти |
| Open Water Diver, дигитален курс | ฿3 200/курсист | Нови курсисти в деня на започване; 3 дни |
| Advanced Open Water | ≈฿2 650/курсист | Нови курсисти в деня на започване; 2 дни |
| DSD — 2 гмуркания | ฿1 000/участник | Брой участници |
| DSD — трето гмуркане | +฿500/участник* | Брой участници с допълнително гмуркане |
| Опреснителен курс / ReActivate | Неизвестна | Брой участници |
| Нощно гмуркане | Неизвестна | Брой участници |
| Лични продажби | 5%* | Стойност на продажбите в ฿ |
*Необходимо е потвърждение, че ฿500 за третото DSD гмуркане са допълнителна инструкторска комисиона и че 5% от личните продажби се добавят към възнаграждението за водене на същия курс.
Докато комисионите за опреснителен курс и нощно гмуркане не бъдат уточнени, въведените участници се отчитат, но тези дейности не се добавят към приходите. За да зададете тарифите, променете refresher: null и night: null в обекта RATES в app.js на потвърдените суми в THB.
3. Записване на работен ден
- Отворете публикуваната страница в Safari или Chrome. Трябва да се появи съобщение, че калкулаторът работи.
- Изберете Дата на работа.
- Въведете броя участници за всяка дейност чрез полето или бутоните + и −. За продажби бутоните променят сумата със ฿100; можете да въведете точна стойност.
- Проверете Прогнозни приходи за деня. Те се преизчисляват при промяна.
- Натиснете Запази деня, за да съхраните въведените данни.
Без натискане на бутона за запазване промените са само предварителен преглед. При повторно отваряне на датата се зарежда последният запазен запис.
4. Многодневни курсове: въведете курсистите само веднъж
Open Water Diver — 3 последователни календарни дни
Двама курсисти започват на 18 ноември. Въведете 2 OWD само на 18 ноември. Пълната комисиона е ฿6 400 и се разпределя по ฿2 133,33 приблизително за 18, 19 и 20 ноември. Не въвеждайте същите курсисти отново на следващите дни.
Advanced Open Water — 2 последователни календарни дни
Двама курсисти носят общо приблизително ฿5 300 — по ฿2 650 за всеки от двата дни. Въведете курсистите само в началния ден.
Разпределението е счетоводно: реалното плащане от центъра може да е на друга дата. Калкулаторът брои последователни календарни дни, включително евентуални почивни дни.
5. DSD и допълнително трето гмуркане
Стандартната DSD програма включва две гмуркания за ฿1 000 на участник. За участници, които правят трето гмуркане, въведете отделно броя им в полето за допълнително трето DSD гмуркане. Пример: 2 стандартни DSD участници и 1 допълнително трето гмуркане = ฿2 500 прогнозна комисиона (฿2 000 + ฿500).
Ако броят на третите гмуркания надвишава броя на стандартните участници, приложението показва предупреждение.
6. Комисиона от продажби
Въвеждайте стойността на продажбите, не броя артикули. При продажби за ฿10 000 комисионата от 5% е ฿500. Ако лично продавате и провеждате курс, потвърдете с центъра дали получавате и двете комисиони, преди да включите продажната стойност.
7. Месечен преглед и история
- Изберете месец: сменя периода на отчета.
- Обща месечна комисиона: сбор от сумите, начислени за този месец, включително продължаващи курсове.
- Дни с начислени приходи: броят на дните с положителна сума. Това не винаги е броят на реално отработените дни.
- Средно на ден: месечният приход, разделен на дните с начислени приходи.
- Графика: докоснете колонка, за да отворите датата.
- Суми по дейности и дневни записи: преглед на категориите и редактиране на запазени дати.
8. Редактиране и изтриване
Редактиране: изберете запазена дата, променете стойностите и натиснете отново Запази деня. Начисленията за свързаните дни от курса се преизчисляват.
Изчисти полетата: премахва видимите стойности, но не изтрива запазения запис, докато не го запазите изрично.
Изтрий запазения ден: изтрива записа след потвърждение. Ако на тази дата е започнал курс, неговите начисления за следващите дни също изчезват.
9. CSV, JSON архиви и смяна на телефон
Експорт на месеца (CSV): отчет за Excel; не служи за възстановяване.
Архивирай всички данни (JSON): запазва записите от всички месеци. Съхранявайте копието на сигурно място.
Възстанови JSON архив: импортира архив, като заменя всички текущи записи на устройството.
Няма автоматична синхронизация между iPhone и Android. За прехвърляне направете JSON архив на старото устройство и го възстановете на новото. Не отваряйте HTML файла чрез визуализацията в приложението Files на iPhone, защото JavaScript може да бъде блокиран; използвайте публикуваната HTTPS страница.
10. Пример за дневни приходи
На един ден имате 2 клиента за Double Tank, 1 следобеден клиент, започвате OWD с 2 курсисти, провеждате DSD с 1 участник и продавате услуги за ฿4 000.
| Дейност | Начислено за деня |
|---|---|
| 2 Double Tank клиента | ฿800,00 |
| 1 Afternoon Dive | ฿200,00 |
| 2 нови OWD курсисти (ден 1 от 3) | ≈฿2 133,33 |
| 1 стандартно DSD | ฿1 000,00 |
| 5% от ฿4 000 продажби | ฿200,00 |
| Общо за деня | ≈฿4 333,33 |
Останалата част от OWD комисионата се начислява автоматично през следващите два дни.
11. Публикуване на актуализации в GitHub Pages
- Направете JSON архив преди обновяване.
- Отворете локалното Git хранилище
Dive-calculatorвъв VS Code. - Заменете файловете в корена на проекта с тези от новата версия:
index.html,app.js,user-guide.html,user-guide-bg.html,sw.js,README.md, както и останалите конфигурационни файлове, когато са включени. Не поставяйте цялата папка като подпапка. - Проверете
git statusи се уверете, че няма незавършен merge/rebase или конфликтни маркери. - Направете commit и push към
main. При отказ „non-fast-forward“ първо синхронизирайте промените внимателно, без--force. - Отворете публикувания адрес с интернет, за да се обнови кешът на PWA.
12. Инсталиране на iPhone и Android
iPhone
- Отворете публикувания адрес в Safari.
- Докоснете бутона за споделяне.
- Изберете Add to Home Screen („Добавяне към началния екран“), при възможност активирайте отваряне като приложение.
- Потвърдете с Add.
Android
- Отворете публикувания адрес в Chrome.
- В менюто с трите точки изберете Install app или Add to Home screen.
- Потвърдете инсталирането.
Отворете приложението веднъж с интернет, за да се кешират файловете; после може да го ползвате офлайн. При обновяване го отворете отново с интернет. Изтриването на приложението или локалните данни може да премахне записите.
13. Версии и промени
Използваме Semantic Versioning (MAJOR.MINOR.PATCH). Старите V1–V5 са неформални етапи: V4 добави разпределението по дни, V5 — инсталиране като PWA. 1.0.0 е базата на PWA; 1.1.0 въвежда новите категории и петте езика; 1.1.1 поправя смесените файлове; 1.2.0 добавя български интерфейс и това пълно ръководство на български.
При бъдещи промени обновявайте едновременно калкулатора, ръководствата, историята на версиите и версията на PWA кеша.