Files
SHiNE-server/docs/registration-v2/REGISTRATION_UI_3_STEPS_2026-11-04.md
T

5.3 KiB

Новый UI регистрации «Сияние» — 3 шага (04.11.2026)

Назначение

Новый клиентский мастер использует существующий протокол регистрации v2 и существующие серверные операции. Формат сертификата и PDA не меняется.

Порядок экранов

  1. /register/welcome: полноэкранный стартовый экран с иллюстрацией img/registration-sunrise-space.png, логотипом над ней и названием «Сияние».
  2. /register/choose: выбор полноценного (Solana) или бесплатного (server-authorized) аккаунта. Этот экран не входит в индикатор шагов.
  3. /register: шаг 1/3 — логин + проверка свободного имени через CheckRegistrationLogin; шаг 2/3 — пароль + генерация ключей только на устройстве.
  4. Шаг 3/3: /register/payment для Solana либо /register/email для бесплатного аккаунта. Email-письмо отправляется существующим StartFreeRegistration, проверяется через ConfirmFreeRegistration. Серверный код на 6 цифр, TTL один час, максимум пять неверных попыток, повторная отправка через 60 секунд.
  5. /register/success: поздравление после реальной авторизации; для бесплатного и платного аккаунтов разные технически корректные гарантии.

Принципы

  • UI не обещает, что Arweave и Solana — одно и то же: публичный контент хранится в Arweave, независимая учётная запись — в Solana.
  • Платёж — разовый. Стоимость namespace берётся из API, рекомендуемый баланс учитывает сетевые расходы.
  • Максимальная длина пароля в текущем коде — 256 символов. Для регистрации допускается любой непустой пароль, хотя пользователю рекомендуется выбрать длинную фразу или случайный код.
  • Изменение логина/пароля после пополнения кошелька приводит к новому кошельку. Добавлены предупреждения, чтобы не потерять доступ к уже переведённым средствам.
  • Email-коды реально отправляются сервером через Resend. Не добавлять на клиенте тестовые коды. Исходный email во время challenge временно находится в RAM сервера; SHA-256 остаётся в сертификате/базе, поэтому не обещать анонимность адреса.
  • Список почтовых провайдеров носит информационный характер: сервер пока не ограничивает регистрацию строгим whitelist доменов. Если понадобится такой whitelist, согласовать отдельное изменение серверной логики и API-документации.
  • Финальное поздравление показывается только после успешной авторизации. При сбое публикации HEADER сохранена прежняя повторная отправка перед первым блоком.

Изменённые файлы

  • shine-UI/js/pages/start-view.js
  • shine-UI/js/pages/registration-intro-view.js (новый)
  • shine-UI/js/pages/registration-choice-view.js (новый)
  • shine-UI/js/pages/register-view.js
  • shine-UI/js/pages/registration-email-view.js
  • shine-UI/js/pages/registration-payment-view.js
  • shine-UI/js/pages/registration-success-view.js (новый)
  • shine-UI/js/components/registration-stepper.js (новый)
  • shine-UI/js/router.js, shine-UI/js/app.js, shine-UI/js/state.js
  • shine-UI/styles/features/preauth.css
  • shine-UI/img/registration-sunrise.webp (новый)
  • shine-UI/img/registration-sunrise-space.png (новый, пользовательская иллюстрация стартового экрана)
  • shine-UI/index.html (cache busting build hash)
  • shine-UI/tests/registration-api-v2-contract.test.mjs, shine-UI/tests/registration-header-bootstrap.test.mjs (адаптированы к новым текстам/маршруту)

Проверка

  • cd shine-UI && node --test tests/*.test.mjs — 59 из 59 тестов проходят.
  • Автоматические браузерные и полноценные сетевые integration/e2e-тесты не выполнены; перед выкладкой на production проверить регистрацию на тестовом сервере с реальным email, оплату на devnet и возврат назад по шагам.