Skip to content

Latest commit

 

History

History
148 lines (112 loc) · 12.8 KB

README.md

File metadata and controls

148 lines (112 loc) · 12.8 KB

Приложение "Агрегатор вакансий"

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

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

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

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

Общие требования

  • Приложение должно поддерживать устройства, начиная с 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 на этот адрес.
  • При нажатии на указанный номер телефона приложение открывает приложение для звонка, в котором уже отображен номер телефона.
  • Отображение списка похожих вакансий происходит аналогично отображению списка вакансий на экране поиска.
  • Экраны деталей вакансии отображаются поверх нижней навигации.

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

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

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

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

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

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

Основной стек

kotlin, sharedpreferences, recyclerview, mvvm, intent, fragment, glide, retrofit2, bottomnavigationview, constraint-layout, androidsdk, livedata, koin, room-database, singleactivity, jetpack-navigation-component, corutine-flow.