Инструкция пользователя

Что делает приложение

Приложение собирает опубликованные вакансии из HeadHunter, SuperJob, «Работы России», JobCareer, Яндекса и Сбера. Один запрос может включать несколько источников, до 100 территорий и до 500 должностей.

Результаты сохраняются в истории, проверяются по городу и должности, очищаются от повторов, используются для зарплатной аналитики и выгружаются в Excel. Сбор выполняется в фоне и восстанавливается после перезапуска приложения.

Вход и учётная запись

Главная страница доступна сразу, но запуск поиска, просмотр истории и другие рабочие действия разрешены только после входа. Если пользователь не авторизован, приложение показывает окно входа поверх страницы. Проверка логина и пароля выполняется через сервер приложения, поэтому устройству пользователя не требуется отдельное сетевое соединение с Supabase.

1. Запросите доступ. Если учётной записи ещё нет, нажмите «Запросить доступ», укажите имя, email и при необходимости комментарий. Администратор увидит заявку в панели управления.
2. Получите данные для входа. После одобрения администратор создаёт учётную запись и передаёт адрес приложения, логин и временный пароль из шести символов выбранным способом.
3. Откройте приложение. Введите адрес электронной почты и временный пароль. Дополнительно подтверждать почту не требуется.
4. Смените пароль. После входа нажмите своё имя в правой верхней части страницы. В открывшемся окне укажите новый пароль длиной не менее шести символов.

Если администратор заполнил имя пользователя, в заголовке показывается оно. Если имя не задано, отображается адрес электронной почты. Сам адрес изменить в приложении нельзя.

Как выполнить поиск

1. Выберите источники данных

   Источник — это сайт, с которого загружаются вакансии. Можно оставить вариант «Все источники данных» или отметить только нужные сайты. Недоступный источник выбрать нельзя.

   

2. Укажите территорию

   Нажмите карточку «География поиска». В режиме «Справочник» выберите всю Россию, один или несколько регионов либо отдельные города. Для точного городского поиска оставьте включённым условие «Строгое соответствие города».

   Если у вас есть готовый перечень, переключитесь на «Список городов» и вставьте названия по одному на строке, в том числе столбец из Excel. Одноимённый город лучше сразу записывать вместе с регионом: например, «Киров, Кировская область». Проверьте найденные и неоднозначные строки, выберите нужные варианты и нажмите «Добавить найденные». За один поиск можно выбрать до 100 территорий.

   

   

   

3. Выберите профессию

   Нажмите карточку «Направление поиска». Найдите профессию через строку поиска или раскройте направление и роль в справочнике. Можно выбрать несколько профессий.

   Если нужна узкая должность, которой нет в справочнике, используйте блок «Произвольное описание должности». В режиме «Одна должность» введите, например, «Учитель немецкого языка». В режиме «Список должностей» вставьте названия по одному на строке или скопируйте столбец из Excel.

   Перед добавлением списка нажмите «Проверить список». Приложение покажет очищенную поисковую формулировку, предложенную роль, уверенность сопоставления и перенесённые служебные уточнения. Для отдельной строки можно включить поиск именно по введённому названию без привязки к справочнику.

   

4. Задайте период

   Выберите готовый период — сегодня, 3, 7, 14, 30, 60, 90 или 180 дней — либо укажите даты вручную. Обе даты включаются в поиск. Вариант «Без ограничения» ищет вакансии за весь доступный период источника.

5. Укажите размер выборки

   Это максимальное количество вакансий для каждой комбинации «источник × территория × профессия». Чем больше значение, тем дольше может выполняться сбор.

   

6. При необходимости уточните условия

   В разделе «Оптимизация выборки» можно оставить только вакансии, где заполнены зарплата, работодатель, занятость или график. Параметр «Только вакансии со ссылкой» оставляет записи, для которых можно открыть исходную публикацию. «Без повторяющихся вакансий» сохраняет один вариант при совпадении должности, работодателя и города. Чем больше условий отмечено, тем меньше будет результат.

   Флажок «Заработная плата» проверяет наличие хотя бы одной числовой границы независимо от валюты. В зарплатную аналитику после сбора входят только месячные предложения в рублях.

   

7. Нажмите «Собрать данные»

   Приложение сначала оценит объём работы. Для большого запроса появится окно подтверждения. Проверьте количество поисковых срезов и ориентировочное время, затем подтвердите запуск.

   

Массовая загрузка должностей

Этот режим нужен, когда у вас уже есть собственный перечень названий и выбирать каждую должность в справочнике неудобно. За один поиск можно добавить до 500 должностей.

1. Подготовьте список. Разместите каждую должность на отдельной строке. Также поддерживаются точка с запятой и табуляция. Заголовок столбца лучше не копировать.
2. Скопируйте данные. В Excel выделите только ячейки с должностями и нажмите Ctrl+C. Сохранять или загружать сам файл не требуется.
3. Откройте «Направление поиска». В окне выбора профессии переключитесь с «Одна должность» на «Список должностей».
4. Вставьте перечень. Щёлкните многострочное поле и нажмите Ctrl+V. Под полем появится число распознанных строк, повторов и пропущенных значений.
5. Нажмите «Проверить список». Приложение покажет для каждой строки исходное название, очищенную поисковую формулировку, предполагаемую базовую роль и степень уверенности.
6. Выберите способ поиска. «Использовать профессиональную роль» пытается сопоставить каждую строку со справочником; если роль ненадёжна, приложение сохраняет текстовый поиск. «Искать по введённому названию» не применяет справочные роли и проверяет смысловое соответствие названия каждой полученной вакансии.
7. Разберите строки. В предварительном просмотре видны исходное название, поисковая формулировка, выбранная роль или текстовый поиск и предупреждения. Кнопка «Искать по названию» меняет способ только для этой должности.
8. Нажмите «Добавить подготовленные». Повторы будут удалены автоматически. Проверьте добавленные названия и нажмите «Применить».

После добавления настройте города, источники и лимит вакансий. Помните: число поисковых срезов равно количеству источников × городов × должностей. Списки свыше 100 должностей приложение автоматически обрабатывает внутренними пакетами по 100 в одном общем поиске. Для таких поисков удаление повторов включается автоматически и действует между всеми пакетами.

Как следить за сбором

Сбор выполняется в фоне, поэтому во время ожидания можно пользоваться приложением и создавать новые запросы.

• В очереди — запрос ожидает начала работы.
• Выполняется — вакансии загружаются.
• Ожидает повторной попытки — временно недоступный срез будет автоматически повторён через 1, 5, 15 или 30 минут.
• Завершено — все доступные части запроса обработаны.
• Завершено частично — часть источников или комбинаций вернула ошибку, но остальные результаты сохранены.
• Ошибка — получить результат не удалось.

Активный запрос можно отменить. Уже загруженные данные при этом останутся в истории. Сбор выполняется на сервере и продолжает работать, даже если пользователь закрыл браузер или выключил свой компьютер. После аварийного перезапуска сервера незавершённый срез автоматически возвращается в очередь после истечения защитного интервала — не более пяти минут. Срезы, ожидавшие временного повтора, также сохраняют своё состояние.

Как читать результаты

В блоке «Аналитика выборки» выберите нужный поиск. Таблица сравнивает профессии и города, а расположенная под ней воронка показывает, сколько вакансий осталось после каждого этапа проверки.

Число со знаком «минус» справа от этапа показывает, сколько вакансий было исключено именно на нём. Если значения не изменились, этот этап ничего не исключил. Для старых поисков приложение показывает сокращённую воронку.

Нажмите ячейку таблицы, чтобы увидеть подробное распределение зарплат. Используйте кнопку «Просмотреть вакансии» для перехода к карточкам работодателей.

История и выгрузка

Все выполненные пользователем запросы сохраняются в его личном разделе «История поисков». Нажмите нужную строку, чтобы снова открыть её аналитику. Другие пользователи и администратор не видят этот поиск в своей обычной истории. Для частично завершённого поиска раскройте причину ошибки и нажмите «Повторить ошибочные срезы»: кнопка станет зелёной, а рядом появится состояние фонового повтора. Приложение повторит все неудачные комбинации этого запроса, не затрагивая успешно завершённые. Нажимать основную кнопку «Собрать данные» для этого не требуется.

Кнопка «Excel» в истории или «Выгрузить в Excel» в аналитике сохраняет полный результат выбранного поиска. Главный лист «Вакансии» содержит отсортированный список найденных предложений. Дополнительные листы «Аналитика», «Источники», «Качество и воронка» и «Параметры поиска» помогают оценить зарплаты, вклад площадок, полноту данных и условия сбора.

Обратная связь

Нажмите «Обратная связь» в верхней части приложения, выберите тип обращения и опишите вопрос, ошибку или предложение. Email подставляется из учётной записи автоматически. Ограничения на количество символов в сообщении нет.

Если ошибка возникла при сборе вакансий, раскройте её в истории и нажмите «Сообщить о проблеме». Номер соответствующего поиска будет приложен автоматически. Форма не принимает файлы и не передаёт версию приложения, сведения о браузере, пароль или токен авторизации.

Для администратора

У администратора перед именем пользователя находится кнопка «Управление приложением». Обычным пользователям эта кнопка не показывается.

• Обзор — число пользователей, активные и ожидающие задания, заполнение базы и состояние резервного копирования.
• Пользователи — рассмотрение запросов доступа, создание учётной записи с автоматически перенесёнными данными заявки, изменение роли, приостановка и возобновление доступа, выдача нового временного пароля. После создания или перевыпуска временный пароль один раз показывается администратору вместе с логином и адресом приложения; весь набор можно скопировать и передать пользователю самостоятельно.
• Обращения — просмотр вопросов, ошибок и предложений, перевод обращения в работу или закрытие и сохранение внутреннего комментария.
• Инциденты — автоматически зарегистрированные ошибки источников, авторизации, базы, резервного копирования и фоновых заданий. Повторы объединяются, а восстановление фиксируется автоматически.
• Сбор данных — общая параллельность очереди и состояние подключённых источников.
• Хранение и система — срок хранения подробных результатов и Excel, пороги заполнения 80%, 90% и 100%, каталог резервных копий и состояние приложения.

Автоматическое письмо при создании пользователя не отправляется. Адрес электронной почты подтверждается приложением автоматически, а администратор самостоятельно передаёт пользователю адрес приложения, логин и показанный временный пароль. После закрытия окна прежний пароль повторно не отображается: при необходимости следует выдать новый. При 100% заполнения базы новые задания временно не принимаются; уже созданная очередь сохраняется и возобновляется после освобождения места.

Работа через Telegram-бота

Бот использует то же приложение и личную историю связанного пользователя. Поиск, созданный в Telegram, появится в веб-интерфейсе этой учётной записи, а результаты можно будет открыть и выгрузить любым из двух способов.

Как связать Telegram с учётной записью

1. Войдите в веб-приложение и нажмите «Подключить Telegram» рядом с именем пользователя.
2. В открывшемся окне нажмите «Открыть Telegram и подключить». Код действует 10 минут.
3. Отправьте подготовленную команду боту. Если команда не подставилась автоматически, скопируйте её из окна приложения.
4. Дождитесь подтверждения «Telegram подключён». Кнопка в заголовке также изменит состояние.

Как выполнить поиск в боте

1. Откройте бота по ссылке выше и отправьте команду /start.
2. Нажмите «Новый поиск» и отметьте источники данных.
3. Отправьте города через запятую или каждый с новой строки.
4. Отправьте до 500 должностей. Можно вставить столбец из Excel; бот принимает переносы строк, запятые и точки с запятой. Названия из справочника получают готовые роли источников, а произвольные названия автоматически проходят смысловую проверку заголовков вакансий.
5. Выберите период, лимит и условия: строгий город, обязательные поля и удаление повторов. Отдельный глобальный переключатель точного названия не нужен: способ проверки определяется для каждой должности.
6. Проверьте оценку объёма и подтвердите запуск.
7. Следите за индикатором выполнения. Состояние «Ожидает автоматического повтора» означает временную ошибку источника; бот продолжит сбор самостоятельно. Сбор можно остановить кнопкой или командой /cancel, при этом уже полученные вакансии сохранятся.

Основные команды: /search — новый поиск, /history — история, /funnel — последняя воронка, /status — состояние источников, /cancel — остановка активного сбора либо сброс ещё не запущенной настройки.

Если что-то не получилось