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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Поведение при нажатии на уведомление зависит от его типа:

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

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

---