Основная идея: сначала настраивается судно, экипаж и расписания. Потом месяц заполняется автоматически по расписанию, а операции добавляются через Event, импорт timelapse или ручным рисованием. PDF и MLC формы берут одну общую timeline-таблицу.
1. Нижнее меню
Dashboard - быстрый месячный вид, рисование операций, PDF/XLSX.
Schedule - расписания SEA/PORT для каждого члена экипажа.
Log - журнал событий и отчет.
MLC - официальные MLC формы: working arrangements и hours of rest.
Violat. - нарушения MLC и ITF inspector view.
Crew - данные судна, экипаж, контракты, база, импорт/экспорт.
2. Данные судна и экипажа
В Crew → Vessel заполняются Ship name, Flag, IMO. Эти поля сохраняются в базу и используются в PDF/MLC.
В карточках экипажа задаются rank, group, work type, weekly regular hours и fixed monthly overtime.
Regular: Mon-Fri максимум 8h/day, Saturday максимум 4h/day, Sunday/holiday = 0. Weekly regular hours остаются данными контракта и не увеличивают эти дневные пределы.
Fixed monthly overtime - индивидуальный лимит обычного overtime конкретного моряка. Все сверх него идет в Extra Pay. Если Fixed OT = 0, весь OT candidate сразу Extra Pay.
3. Расписание SEA / PORT
В Schedule для каждого моряка есть два режима: SEA и PORT. Программа выбирает нужное расписание по текущему mode log: AT SEA / AT PORT.
Расписание является базовым слоем: автоматически в Work/Rest переносится только WATCH. SUB-WATCH остается только справочной строкой расписания и никогда автоматически не считается.
Для OS в специальных операциях используется AT PORT schedule там, где это указано правилами.
4. Ручное заполнение месяца
В Dashboard выбираешь моряка и тип операции. Левая кнопка мыши/drag добавляет время, правая кнопка или Erase стирает слот.
Ручной слот имеет приоритет над расписанием. Если слот стер вручную, расписание не дорисует его обратно.
Кнопка SCHED заполняет видимый месяц расписанием. CLR очищает месяц выбранного моряка.
5. Event и правила операций
Standby - всем разрешенным, кроме исключенных настроек crew.
Mooring - deck/engine/master согласно разрешениям.
Anchor - Master всегда, deck watch по AT PORT.
Pilot - Master и Bosun всегда, watchkeepers по AT SEA, OS по AT PORT.
Channel Pilotage - Master и Bosun всегда, watchkeepers по AT SEA, OS по AT PORT.
SUB-WATCH является только плановой подсказкой в расписании. Если эти часы реально отработаны, внеси их вручную как обычную работу.
6. Import timelapse
Импорт принимает .xlsx, .xls, .csv, ручную таблицу или pasted text.
Обязательные колонки: date, start, end. Дополнительно: type, crew, note.
Удобные форматы: date 02-07-26 или 2026-07-02; time 0500, 0530, 16:30.
Поддерживаемые типы: watch, moor/mooring, anchor, pilot, channel pilotage, drill, standby, provision, inspection, rest, at sea, at port.
Перед импортом показывается preview: дата, start/end, raw values, тип и кому назначит программа.
Важно: импорт заменяет только затронутые даты. Другие даты месяца остаются как были. Если импортируешь дату, ручные слоты этой даты будут пересобраны из расписания и импортированных операций.
7. Save, Load, Export
Кнопка SAVE вверху сохраняет все в браузерную базу localStorage.
Crew → Data → Save database скачивает полный JSON backup: vessel, crew, schedules, entries, timelapse, ручные слоты, holidays, mode log.
Load database полностью заменяет текущую браузерную базу данными из JSON.
Dashboard PDF создает Extra Overtime Payroll working hours PDF по выбранному моряку и месяцу.
XLSX экспортирует текущий timesheet. Если XLSX-библиотека недоступна, будет CSV fallback.
8. Payroll: Regular / Overtime / Extra
Regular: Mon-Fri max 8h/day; Saturday max 4h/day; Sunday/holiday 0.
Overtime: работа сверх Regular, но только до 10h total work/day и только пока не исчерпан индивидуальный Fixed Monthly OT.
Extra Pay: всё сверх 10h/day плюс OT candidate сверх индивидуального Fixed Monthly OT. Fixed OT = 0 → весь OT candidate = Extra Pay.
Если fixed OT поставить 168, цифры изменятся только когда месячный overtime-кандидат больше старого лимита. Extra по правилу more than 10h/day остается Extra.
9. MLC forms
Table of Shipboard Working Arrangements печатает расписание SEA/PORT.
Record of Hours of Rest печатает rest form по одному или всем морякам.
MLC rest form учитывает расписание, импорт и то, что нарисовано вручную. Расчет идет по 15 минутам.
Полная rest-клетка отмечается ✗. Если rest ровно 30 минут внутри часа, клетка закрашивается по диагонали наполовину.
10. Что делать при странных цифрах
Обнови главную страницу и открой PDF заново: старое окно about:blank не обновляется само.
Проверь mode SEA/PORT на нужную дату: от него зависит расписание.
Проверь Crew contract: weekly regular hours и fixed monthly overtime.
Если импорт дал лишние операции, re-import той же даты заменит затронутый день. Если ошибка была нарисована вручную, стирай ее вручную или очищай день/месяц.