БЫСТРЫЙ СТАРТ
=============

1. Установи Google Chrome: https://www.google.com/chrome/
2. Дважды нажми INSTALL.command.
3. После установки откроется рабочая папка ~/VisaMonitor_Client.
4. В рабочей папке дважды нажми Visa Monitor Panel.app.
5. Во вкладке Первый запуск нажми Открыть настройки.
6. Выбери страну/консульство AIS и язык. Login URL заполнится автоматически.
7. Введи license key, AIS email/password и выбери интервалы дат через календарь.
8. Нажми Проверить настройки.
9. Нажми Сохранить и запустить.
10. После успешной проверки включи автозапись во вкладке Автозапись и режим.

ЛОКАЛЬНАЯ ПАНЕЛЬ
================

Visa Monitor Panel.app - основной дружелюбный интерфейс управления ботом.
CONTROL_PANEL.command - запасной запуск панели, если macOS по какой-то причине не открывает app.

Важно: запускай панель из рабочей папки ~/VisaMonitor_Client.
Не запускай ее из Downloads, Documents или Desktop: macOS может блокировать доступ приложения к файлам бота.

Когда бот запущен через Visa Monitor Panel.app, включается caffeinate -dimsu.
Это не дает Mac заснуть из-за простоя, пока процесс бота работает.
Не выключай Mac вручную и не закрывай крышку MacBook, если это переводит его в сон.

В панели есть:
- мастер первого запуска;
- license key;
- AIS email;
- AIS password;
- выбор страны/консульства AIS и языка;
- автоматическое заполнение ссылки входа AIS;
- выбор часового пояса консульства;
- ссылку appointment/reschedule, если она известна;
- минимум дней на сборы;
- целевые интервалы дат через календарь;
- запуск и остановка бота;
- статус, последние даты и ошибки;
- автозапись и интенсивность;
- проверка обновления;
- отправка отчета об ошибке;
- просмотр логов.

Telegram теперь необязателен. Бот может полностью работать локально через панель.
Telegram нужен только если хочется удаленно получать уведомления и управлять ботом с телефона.

Часовой пояс нужен не по месту проживания клиента, а по месту консульства.
По нему бот включает активное окно консульства, когда проверки идут чаще.
По умолчанию активное окно: 07:00-23:00 по времени консульства.
В это окно бот проверяет appointment каждый цикл, вне окна - мягче, чтобы снизить риск блокировок.

Интенсивность проверки можно менять в панели или в Telegram, если Telegram подключен:
- Осторожный: меньше запросов, ниже риск временной блокировки.
- Сбалансированный: рекомендуемый режим по умолчанию.
- Быстрый: чаще проверяет даты, выше риск ERR_EMPTY_RESPONSE.
- Максимальный: самый агрессивный режим, включать только осознанно.

Быстрый и Максимальный требуют повторного нажатия для подтверждения.

Обновления:
Бот раз в сутки проверяет сервер лицензий. Если там опубликована новая сборка,
бот скачает zip, заменит только программные файлы и перезапустится.
Файлы клиента `.env`, `session.json`, `chrome_profile`, логи и состояние не удаляются.

Отчет об ошибке:
Если что-то пошло не так, открой Visa Monitor Panel.app -> Сервис и логи -> Отправить отчет об ошибке.
Если Telegram подключен, можно также нажать `Сервис` -> `Отправить отчет`.
Бот отправит на сервер технический статус и последние строки лога.
Логин/пароль AIS в отчет не добавляются.

Интервалы дат задаются в панели в формате начала и конца: YYYY-MM-DD.
Можно добавить до 4 интервалов.

Пример:
2026-12-01 -> 2027-01-31
2027-03-01 -> 2027-03-15

ВАЖНО ПРО GOOGLE CHROME
=======================

Google Chrome настоятельно рекомендуется установить заранее.

Бот может использовать резервный Playwright Chromium, но Google Chrome лучше для:
- ручного входа в AIS;
- сохранения сессии;
- автовхода;
- удаленного доступа через Chrome Remote Desktop.

Если Chrome не установлен, бот попробует работать через резервный Chromium.
Это запасной вариант, а не рекомендуемый основной режим.

КАК ОСТАНОВИТЬ
==============

Самый простой способ: дважды нажми STOP_BOT.command.
Бот остановится, сохранит состояние, а окно Terminal закроется автоматически.

Если открыта панель управления: нажми Остановить.

Если открыто окно запуска: нажми Control + C в окне терминала.
Окно запуска тоже должно закрыться само.

Если Telegram подключен и ты далеко от Mac:
Telegram -> Управление -> Остановить бота.
Потом нажми Остановить бота еще раз для подтверждения.

Важно: Остановить бота = полностью выключить процесс.
Чтобы запустить снова без окна Terminal, открой Visa Monitor Panel.app и нажми Запустить.
После полной остановки нажимать Enter или закрывать окно крестиком обычно не нужно.
Для временной паузы используй Telegram -> Управление -> Пауза 30 мин.

ПРОВЕРКА ПОСЛЕ ЗАПУСКА
======================

После каждого запуска бот сам проверяет:
- лицензию;
- вход в AIS;
- текущую дату записи;
- страницу выбора даты;
- получение списка дат.

Если все пункты OK, включи автозапись в панели или в Telegram.
Если есть пункт НУЖНО ВНИМАНИЕ, сначала исправь его.

Как включить автозапись в панели:
Visa Monitor Panel.app -> Автозапись и режим -> Включить постоянно сейчас.

Как включить автозапись через Telegram, если он подключен:
Telegram -> Автозапись -> Включить постоянно
или Telegram -> Автозапись -> Включить на 180 мин.
Нажми выбранную кнопку второй раз для подтверждения.

Если бот пишет, что лицензия не подтверждена:
проверь license key и интернет на Mac.

Если Mac не дает открыть INSTALL.command:
правый клик по INSTALL.command -> Open -> Open.

Если бот просит ручной вход:
войди в AIS в открытом Chrome, дойди до страницы выбора даты и нажми в панели `Я вошел`.
Если Telegram подключен, можно отправить /loggedin.
