Проект Job-Seeker

Проект представляет собой небольшое приложение для поиска работы, использующее API сервиса HeadHunter.

Предварительная настройка проекта

Добавление секретного токена для API HeadHunter

Сначала необходимо получить API токен Хедхантера. Как это сделать описано в их документации.

Для проброса секретного токена, полученного после регистрации приложения для использования API HeadHunter, создайте в корне проекта файл develop.properties и добавьте туда одно свойство:

hhAccessToken=my_access_token

Вместо my_access_token вставьте полученный после регистрации токен доступа к API HeadHunter. После изменения значения синхронизируйте проект.

Файл develop.properties игнорируется при коммитах в Git, поэтому можно не бояться, что значение токена попадёт в открытый доступ. Значения, записанные в файл develop.properties, будут добавлены в приложение на стадии сборки и попадут в специальный объект, который называется BuildConfig. Подробнее про этот объект можно почитать в документации.

Возможноости приложения

Приложение предоставляет следующую функциональность:

• Поиск вакансий;
• Указание фильтров для поиска;
• Просмотр деталей отдельной вакансии;
• И добавление вакансий в список "Избранного".

Общяя информация

• Приложение поддерживает устройства, начиная с Android 8.0 (minSdkVersion = 26).
• Приложение поддерживает только портретную ориентацию (portrait), при перевороте экрана ориентация не меняется.

Главный экран -- экран поиска вакансий

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

Особенности экрана

• По умолчанию, поиск происходит по всей доступной базе вакансий без учёта региона, отрасли компании и уровня зарплаты и валюты.
• Приложение не хранит историю поиска, поэтому между перезапусками приложения текст в поле ввода не обязан сохраняться.
• При вводе нового текста в поле ввода мы осуществляем новый поиск с debounce в 2000 миллисекунд.
• В отдельном элементе списка может быть картинка логотипа компании, которая загружается отдельно. В процессе загрузки картинки и в случае ошибки загрузки этой картинки показывается плейсхолдер. Также плейсхолдер отображается, если информации о картинке нет.
• В зависимости от пришедших с сервера данных информация о вакансии может отображаться несколькими способами:
  • "От XX";
  • "До XX";
  • "От XX до XX";
  • "Зарплата не указана".
• Если в вакансии указана зарплата, то числа отображаются с разбиением на разряды (то есть 1 000 000, 12 345 678).
• Зарплата в вакансии может быть указана в разной валюте, не только в рублях. Вот полный список возможных валют:
  • Российский рубль (RUR / RUB)
  • Белорусский рубль (BYR)
  • Доллар (USD)
  • Евро (EUR)
  • Казахстанский тенге (KZT)
  • Украинская гривна (UAH)
  • Азербайджанский манат (AZN)
  • Узбекский сум (UZS)
  • Грузинский лари (GEL)
  • Киргизский сом (KGT)
• В целях экономии трафика пользователей загрузка результатов поиска происходит постранично (paging) по 20 элементов за раз. Запрос на следующую страницу происходит, когда пользователь доскроллил до последнего доступного элемента списка.

Фильтрация -- набор экранов фильтров поиска

Используя настройки фильтра, пользователь может уточнить некоторые параметры поиска, который осуществляется на экране "Поиск". Фильтр позволяет указать:

• Место работы - регион, населённый пункт, указанный в вакансии как рабочая локация.
• Отрасль - сфера деятельности организации, разместившей вакансию.
• Уровень зарплаты - уровень ЗП, соответствующий указанному в вакансии.
• Возможность скрывать вакансии, для которых не указана ЗП.

Особенности экранов

• Параметры фильтра не являются обязательными - пользователь может уточнить любой параметр из предложенных, а может не указывать ничего. В случае, если указан хотя бы один из параметров, он учитыватся при последующих поисковых запросах на экране "Поиск". Параметры фильтра, которые пользователь не уточнял, в поисковом запросе не учавствуют.
• Настройки параметров фильтра сохраняются даже после закрытия приложения.
• Поиск по отраслям компании ведётся сразу по всем элементам дерева отраслей, без разделения на категории по уровням вложенности.
• Экраны фильтрации отображаются поверх нижней навигации.
• Если у пользователя выбрана страна поиска вакансий, то список регионов на экране выбора региона поиска ограничивается регионами указанной страны.
• Если пользователь выбрал город до выбора страны, то страна подставляется автоматически.
• Кнопка "Сбросить" появляется, если пользователь указал хотя бы одно значение фильтров.
• Кнопка "Применить" появляется, если пользователь указал фильтр, отличающийся от предыдущего. Нажатие на кнопку "Применить" приводит к сохранению выбранных настроек фильтра и применению фильтра для всех последующих запросов на поиск вакансий до изменения фильтра.
• Все настройки фильтра сохраняются автоматически сразу после изменения.

Экран просмотра деталей вакансии

Нажав на элемент списка найденных вакансий (а так же в списке закладок и похожих вакансий), пользователь попадает на экран с подробным описанием вакансии. Помимо уровня ЗП, требуемого опыта и графика работы пользователь может на этом экране увидеть:

• Информацию о работодателе
• Подробное описание вакансии
• Перечень требуемых ключевых навыков
• Контактную информацию

Также пользователь может ознакомиться со списком похожих вакансий, поделиться ссылкой на данную вакансию, а также связаться с работодателем через указанные контакты.

Особенности экрана

• Любая часть описания деталей вакансии опциональна, то есть из сети может не прийти какое-то из ожидаемых полей.
• Подробное описание вакансии приходит в HTML-формате.
• При нажатии на элемент списка похожих вакансий открывается новый экран деталей вакансий, который связан с предыдущим (на предыдущий экран можно вернуться, нажав кнопку Back).
• Отображение указанной зарплаты и валюты происходит аналогично выдаче поиска вакансий.
• При нажатии на указанный адрес электронной почты открывается диалог с предложением написать email на этот адрес.
• При нажатии на указанный номер телефона открывается приложение для звонка, в котором уже отображён номер телефона.
• Отображение списка похожих вакансий происходит аналогично отображению списка вакансий на экране поиска.
• Экраны деталей вакансии отображаются поверх нижней навигации.

Экран избранных вакансий

Пользователь может добавлять вакансии в "Избранное", чтобы иметь возможность быстро вернуться к заинтересовавшему его предложению. Добавить вакансию в "избранное" (или удалить из "избранного") можно на экране "Вакансия". На экране списка избранных вакансий пользователь может удалить вакансию из закладок. Все вакансии, добавленные в закладки, можно увидеть на отдельном экране в приложении.

Особенности экрана

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

Экран информации о команде разработчиков

На экране отображается статический список людей, участвовавших в разработке приложения.