AACSearch / руководство
Аккаунты, вход и организации
Регистрация, подтверждение email, сброс пароля, приглашения и создание или смена организации.
Вход
У корня консоли (/) нет собственного экрана — он сразу перенаправляет на
/dashboard.
/login принимает email и пароль. Конфигурация better-auth в API
поддерживает только вход по email и паролю — нет ни magic link, ни одноразового
кода, ни беспарольного входа. На странице также есть ссылки Create account,
Forgot password и mailto-ссылка на поддержку.
Если в развёртывании настроены OAuth или OIDC, соответствующие кнопки появляются
автоматически на основе публичной процедуры security.authProviders:
кнопка Continue with {name} для обобщённого OIDC-провайдера, а также
Google и GitHub, если заданы GOOGLE_CLIENT_ID / GITHUB_CLIENT_ID.
Развёртывание без них показывает только форму ввода пароля.
Параметр ?next= учитывается после успешного входа, но только для пути того же
источника (same-origin) — абсолютный URL на другой хост отбрасывается.
Регистрация
/register запрашивает имя, email, пароль и его подтверждение. Пароль должен
содержать не менее 15 символов (под полем выводится «At least 15 characters.»), а
подтверждение должно совпадать; проверка выполняется и при потере фокуса, и в
виде фокусируемой сводки ошибок при отправке формы. Обязательный флажок ссылается
на страницы Terms и Privacy на маркетинговом сайте. Те же условные кнопки
OIDC / Google / GitHub, что и на странице входа, появляются, если они есть в
развёртывании, а ?next= того же источника учитывается после регистрации.
Регистрация сразу выполняет вход и переводит пользователя на цель ?next — по
умолчанию на Overview. /verify-email не участвует в этом перенаправлении: это
адрес, на который указывает письмо подтверждения от API, а подтверждение email
не обязательно для работы с аккаунтом.
Подтверждение email
У /verify-email три возможных исхода:
- Email confirmed — токен принят. Далее следует кнопка Continue to dashboard.
- This link no longer works — токен отсутствует, уже использован или истёк.
- Something went wrong — любой другой сбой, с возможностью войти.
Участники с неподтверждённым email могут запросить новое письмо в разделе Профиль — баннер там предлагает Resend verification email.
Сброс пароля
/forgot-password принимает адрес email и всегда показывает одно и то же
подтверждение, независимо от того, существует ли аккаунт, — это намеренная
защита от перебора аккаунтов. Ошибками отображаются только эксплуатационные сбои
(лимит запросов, отключённая функция, сеть). В подтверждении есть кнопка Try
again для возврата к форме, ссылка на вход передаёт дальше ?next=, а письмо
содержит ссылку на /reset-password?token=…. Ссылка действует один час.
/reset-password считывает токен и код ошибки (если есть) из строки запроса,
заданной перенаправлением API. Истёкший токен описывается иначе, чем
недействительный или уже использованный. Новый пароль должен содержать 15–128
символов и совпадать с подтверждением. При успехе выводится «Password updated» с
кнопкой Continue to sign in; для непригодной ссылки предлагается Request a
new link, которая возвращает к форме восстановления пароля.
Принятие приглашения
Владелец или администратор организации приглашает коллегу в разделе
Команда. Письмо с приглашением ведёт на
/invitation/{id}, где показаны название организации, кто вас пригласил,
предлагаемая роль и срок действия, а также кнопки Accept и Decline.
Посетителя, не выполнившего вход, сначала отправляют на вход, а затем возвращают к приглашению. Страница различает четыре исхода загрузки:
| Случай | Что вы увидите |
|---|---|
| Приглашение адресовано другому email | «This invitation is for a different account» с действием Sign in with another account. |
| API сначала требует подтверждённый email | «Verify your email first» со ссылкой на ваш профиль. |
| Истекло, уже использовано или отозвано | «Invitation expired or no longer valid» с кнопкой Go to dashboard. |
| Любой другой сбой | «Invitation error» с кнопкой Go to dashboard. Действие Try again появляется, только если не удалось само принятие или отклонение. |
Принятие добавляет вас в организацию и делает её активной. Отклонение помечает приглашение как отклонённое, а приглашение, отозванное отправителем, отображается как отменённое; все три состояния финальные и показываются вместо карточки.
Создание организации
Организации принадлежат движок, её коллекции, API-ключи и команда. Консоль
отправляет анонимного посетителя на вход перед /create-organization и
предлагает форму с полями:
- Name — произвольный текст.
- Slug — формируется автоматически из названия, пока вы не измените его
вручную. Должен соответствовать
^[a-z0-9]+(?:-[a-z0-9]+)*$, проверяется на доступность запросом с задержкой (debounce) и используется в URL и ответах API.
Кнопка создания остаётся неактивной, пока не указано название и slug не свободен. Организация становится активной, и консоль открывается на Overview. Пользователь, выполнивший вход и уже состоящий в организации, также видит ссылку «Changed your mind? Back to the dashboard».
Переключение организаций
Переключатель вверху боковой панели перечисляет все организации, в которых вы состоите, и показывает активную. Выбор другой организации меняет то, что читает и записывает каждый экран; консоль обновляется на месте. В том же меню есть ссылки на Settings организации и New organization.
Без активной организации экраны, которым она нужна, либо показывают пустое состояние со ссылкой на Overview, либо отклоняют действие — и вызовы уровня управления (control plane), и вызовы тенанта определяют организацию по сессии.
Быстрый старт
/dashboard/quick-start — чек-лист для новой организации. Он подробно описан в
обзоре консоли; его шаги:
Создайте API-ключ
Полный для сервера, поисковый для браузера.
Чек-лист считывает актуальное состояние при получении фокуса, поэтому шаги отмечаются сами, когда работа выполняется в другом месте; необязательные шаги вы подтверждаете сами, и они запоминаются в браузере.
Время жизни сессии
Консоль использует сессионную cookie better-auth из API. Макет дашборда
перенаправляет анонимного посетителя на /login?next=…, а прокси-слой применяет
ту же проверку к /dashboard/** и /create-organization до отрисовки страницы.
Сессии можно просмотреть и отозвать в разделе
Profile → Security; организация также
может ограничить максимальный возраст сессии и доступ к консоли по IP в разделе
Settings → Security.
Помощь, статус и обслуживание
Блок поддержки в боковой панели содержит ссылки на эту документацию, справочник
API и email поддержки. /maintenance — статическая страница «we'll be back
shortly» со ссылками на страницу статуса и поддержку; автоматически на неё ничего
не перенаправляет, поэтому она отдаётся только тогда, когда развёртывание
направляет туда трафик. На неизвестный URL консоли возвращается собственная
страница 404 консоли со ссылкой на дашборд и адресом поддержки.