Начало работы

Создание аккаунта

Новые пользователи регистрируются на странице /register. Экран разделён на две части: слева — маркетинговая панель (анимированный заголовок «Добро пожаловать в Apps Kit SDK», краткое описание продукта и три анимированные карточки показателей — «Рост дохода», «Доля заполненных запросов», «Сбои и ANR». Это рекламные элементы, а не данные вашего аккаунта), справа — форма регистрации.

Форма регистрации содержит следующие поля:

• Полное имя — обязательное поле.
• Email — обязательное поле; адрес электронной почты должен быть корректным.
• Пароль — обязательное поле; не менее 8 символов, включая хотя бы одну прописную букву, одну строчную букву и один специальный символ (например, !@#$%^&*).

При нажатии Создать аккаунт в Firebase создаётся аккаунт с авторизацией по email и паролю, сразу отправляется письмо Firebase для подтверждения email, а затем пользователь регистрируется на сервере Apps Kit SDK (POST /oauth/login с oauthProvider: "email"). После этого вы перенаправляетесь на /login: регистрация не выполняет автоматический вход, а войти можно только после подтверждения email (см. раздел «Вход» ниже).

Также можно выбрать Зарегистрироваться через Google: откроется всплывающее окно Firebase для входа через Google (signInWithPopup), а аккаунт будет зарегистрирован с oauthProvider: "gmail". При регистрации через Google отдельно подтверждать email не нужно: вы сразу попадёте на / («Мои приложения») или /users в зависимости от типа аккаунта.

Ссылка «Уже есть аккаунт? ВОЙТИ» возвращает на /login.

Вход

Экран входа (/login) использует ту же двухпанельную компоновку, что и экран регистрации: маркетинговая панель слева и форма входа справа.

LOGIN_SCREEN_IMAGE

Форма входа содержит:

• Email — обязательное поле; адрес должен иметь корректный формат.
• Пароль — обязательное поле.
• Переключатель видимости пароля (значок глаза) в поле пароля.
• Продолжить — кнопка отправки формы; недоступна, пока форма не заполнена корректно.
• Запомнить меня — флажок, при установке которого ваш email (но не пароль) сохраняется в браузере и автоматически подставляется при следующем посещении.
• Забыли пароль? — ссылка на /forget-password.
• Кнопку «Войти через Google» — используется тот же сценарий со всплывающим окном Firebase, что и при регистрации через Google, но для существующих аккаунтов.
• «Новый пользователь? ЗАРЕГИСТРИРОВАТЬСЯ» — ссылка на /register.

При входе по email и паролю дополнительно проверяется, подтверждён ли email вашего аккаунта Firebase. Если нет, появится сообщение «Сначала подтвердите email.», и вход не будет выполнен. После успешного входа любым из способов вы попадёте на / («Мои приложения»), если у вас обычный пользовательский аккаунт, или на /users, если у вас внутренний аккаунт или аккаунт администратора.

Восстановление пароля

На странице /forget-password находится форма с одним полем — адресом электронной почты. При отправке формы вызывается метод Firebase sendPasswordResetEmail. Сброс пароля выполняется не на портале: вы получаете ссылку для сброса по электронной почте. Всплывающее сообщение подтверждает: «Письмо для сброса пароля отправлено. Проверьте входящие», после чего вы возвращаетесь на /login. На странице также есть ссылка «Вернуться ко входу?».

Верхняя панель навигации

После входа на каждой странице, кроме экранов авторизации, отображается верхняя панель навигации с меню аккаунта справа. Только на странице «Мои приложения» рядом с ним также отображается колокольчик уведомлений.

Меню аккаунта. Нажатие на аватар, имя или email в правом верхнем углу открывает выпадающее меню, содержащее:

• Строку «Мой аккаунт», соответствующую вашему собственному аккаунту (когда он выбран, синяя точка отмечает его как активный).
• Раздел «Мне предоставлен доступ» — появляется, только если вы приняли хотя бы одно приглашение к совместному доступу от другой команды. Для каждого пригласившего пользователя отображаются имя, email и аватар. Нажатие на одного из них переключает весь портал на соответствующий аккаунт (технически — отправляет действие switchAccount()). После этого все разделы — «Мои приложения», «Бренды», «Кампании» и т. д. — показывают его ресурсы с учётом предоставленных вам разрешений.
• Нижнюю часть меню, которая меняется в зависимости от контекста: если вы просматриваете собственный аккаунт, здесь отображается ссылка «Профиль». Если вы переключились на аккаунт с совместным доступом, вместо неё отображается красная кнопка «Выйти → Мне предоставлен доступ». Она возвращает вас в собственный аккаунт и открывает страницу «Мне предоставлен доступ».

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

Колокольчик уведомлений. Отображается только по маршрутам / и /apps (то есть на панели «Мои приложения»); в других разделах портала его нет. Счётчик на значке показывает общее количество уведомлений во всех группах. Нажатие открывает выпадающий список с заголовком «Уведомления»: записи сгруппированы по типу, каждая содержит краткое сообщение.

Результат нажатия на отдельное уведомление зависит от его типа:

• Если тип уведомления — upatedSdkVersion (оповещение «Версия SDK обновлена»), нажатие сразу открывает страницу сведений об этом приложении (/app/:id) и не отмечает уведомление как прочитанное.
• Для всех остальных типов нажатие открывает страницу загрузки SDK и отмечает уведомление как прочитанное (вызывается эндпоинт отметки о прочтении и появляется всплывающее сообщение «Уведомление успешно отмечено как прочитанное»).

Колокольчик открывает только выпадающий список для быстрого просмотра. Это отдельный, более простой интерфейс, чем страница «Мои уведомления», описанная далее в этом руководстве. При этом оба интерфейса не связаны со списком приглашений «Мне предоставлен доступ». Таким образом, на портале действительно есть три разных интерфейса для приглашений и уведомлений; их различия описаны в разделе «Аккаунт».

---