Сценарии использования: регистрация и авторизация

Регистрация

INSP-UC-AUTH-001

Регистрация пользователя💬💬

Статус сценария:  Ожидание согласования

Релиз: ПОСЛЕ MVP

Бизнес-требование: 

  • Агенты, Исполнители, Администрация порта, Служба контроля должны иметь возможность самостоятельно зарегистрироваться в системе
  • Для каждой ключевой роли реализована отдельная страница регистрации
  • Для ролей Исполнитель, Агент - после регистрации необходимо обязательное подтверждение аккаунта Службой безопасности💬. Только подтвержденные аккаунты могут иметь доступ к функционалу

Точки входа:

  • Страница регистрации 

Предусловия:

Приоритет:

Высокий (1)

Роли: 

Незарегистрированный пользователь - далее Пользователь

Основной поток:

  1. Пользователь открывает страницу регистрации
  2. Система отображает форму для ввода данных:
    1. Роли (переключатель): Агент | Исполнитель | Администрация | Служба контроля
    2. Фамилия
    3. Имя
    4. Отчество
    5. e-mail
    6. Номер телефона
    7. Пароль
    8. Пароль контрольный
    9. * Набор полей зависит от роли (см. расширение)
  3. Пользователь вводит данные о новом пользователе
    1. Роли (переключатель): Агент | Исполнитель | Администрация | Служба контроля
    2. Фамилия
    3. Имя
    4. Отчество
    5. e-mail
    6. Номер телефона
    7. Пароль
    8. Пароль контрольный
    9. * Набор полей зависит от роли (см. расширение)
  4. Система динамически проверяет корректность ввода данных
  5. Система проверяет, что Пользователя с таким e-mail/номером телефона в системе не существует 
  6. Система проверяет пароль на соответствие условиям
  7. Если все данные корректны, то система делает активной функцию подтверждения создания Пользователя
  8. Пользователь подтверждает регистрацию
  9. Система создает сущность Пользователя с указанными параметрами в базе и связанную с ним ссылку-подтверждение для авторизации со сроком действия ссылки (24 часа с момента создания)
    1. Пользователь.E-mail 
    2. Пользователь.Статус = Новый 
    3. Подтверждение 
      1. Ссылка 
      2. Дата и время создания 
      3. Срок жизни ссылки 
  10. Система отправляет приглашение для входа на указанный e-mail, включая:
    1. Ссылка-приглашение для авторизации (+ дата и время до которого ссылка действительна)
    2. E-mail, указанный при регистрации
  11. Система отображает сообщение Пользователю "Ссылка-подтверждение отправлена на e-mail, ссылка действительна до <текущая дата и время системы + 24 часа>.
  12. Завершение сценария

Расширение:

3a. Новый пользователь = Агент
3a.1 Пользователь активировал форму ввода данных для регистрации Агента
3a.2 Система отображает дополнительные данные для ввода:

- Вид лица 
- Наименование 
- ИНН 
- Паспортные данные физ.лица 
- Прописка физ.лица 
- Телефон 
- Эл. почта 
3a.3 Пользователь продолжает сценарий вместе с вводом дополнительных параметров

 

3b. Новый пользователь = Исполнитель
3b.1 Пользователь активировал форму ввода данных для регистрации Исполнителя
3b.2 Система отображает дополнительные данные для ввода:

- Вид лица 
- Наименование 
- ИНН 
- Паспортные данные физ.лица 
- Прописка физ.лица 
- Телефон 
- Эл. почта 
3b.3 Пользователь продолжает сценарий вместе с вводом дополнительных параметров


3c. Новый пользователь = Администрация
3c.1 Пользователь активировал форму ввода данных для регистрации Администрация
3c.2 Система отображает дополнительные данные для ввода:

- 
3c.3 Пользователь продолжает сценарий вместе с вводом дополнительных параметров

 

3d. Новый пользователь = Служба контроля
3d.1 Пользователь активировал форму ввода данных для регистрации Служба контроля
3d.2 Система отображает дополнительные данные для ввода:

- 
3d.3 Пользователь продолжает сценарий вместе с вводом дополнительных параметров


5a Пользователь с указанным e-mail/номером телефона уже существует
5a.1. Система обнаруживает, что пользователь с указанным e-mail/номером телефона уже существует в системе
5a.2. Система отображает сообщение "Пользователь с указанным e-mail/номером телефона уже существует. Попробуйте восстановить доступ к своему профилю или обратитесь в службу технической поддержки"
5a.3. Завершение сценария


4a Введены некорректные данные
4a.1. Система обнаруживает не соответствие одному или нескольким условиям ввода полей
4a.2. Система отображает сообщение об ошибке ввода данных в поле, где есть ошибка
4a.3. Продолжение сценария с пункта 3 основного потока или завершение сценария


3a (8a). Отмена действия
- Пользователь может отменить регистрацию или закрыть страницу регистрации


9a. Ошибка при создании пользователя
9a.1. Система не смогла создать пользователя
9a.2. Система отображает ошибку с кодом и текстом Пользователю: "Произошла ошибка регистрации, код ошибки: <<код>>, обратитесь в службу технической поддержки"


10a. Ошибка отправления ссылки-подтверждения
10a.1. Система не смогла отправить ссылку-подтверждение для пользователя
10a.2. Система отображает ошибку с кодом и текстом Пользователю: "Произошла ошибка регистрации, код ошибки: <<код>>, обратитесь в службу технической поддержки"


6b. Пароли не совпадают или не соответствуют условиям
6b.1. Система обнаруживает несоответствие пароля одному или нескольким условиям:

  • Пароль != Пароль контрольный
  • Не соответствует условиям💬 INSP-AT-USR-009💬

6b.2. Система отображает сообщение об ошибке
6b.3. Продолжение сценария с пункта 3 основного потока

Примечание:

В рамках MVP не предполагается самостоятельная регистрация пользователей. Администратор базы данных вручную в БД зарегистрирует пользователей. Но при этом, после регистрации пользователи смогут авторизоваться под логином и паролем, которые были указаны при регистрации.

SSO — вне MVP

Статусная модель пользователя также за рамками MVP. По умолчанию все пользователи в статусе Активно


INSP-UC-AUTH-002





Подтвердить e-mail при регистрации

Статус сценария:  Ожидание согласования

Релиз: ПОСЛЕ MVP

Бизнес-требование:  

Пользователи при регистрации должны подтверждать свой e-mail адрес

Точки входа:

  • Окно верификации почты

Предусловия:

  1. Пользователь ранее начал процесс регистрации INSP-UC-AUTH-001
  2. Статус = Новый

Приоритет:

Низкий

Роли: 

Любая роль в системе - далее Пользователь 

Основной поток:

  1. Пользователь открывает ссылку для верификации (из почты)
  2. Система проверяет валидность ссылки
  3. Система сохраняет Пользователя со статусом "Верифицирован"
  4. Система отображает сообщение "Вы успешно зарегистрированы. Профиль отправлен на проверку, результаты проверки будут отправлены вам на указанную почту в течении <n> дней. В случае проблем, обращайтесь в службу технической поддержки"
  5. Завершение сценария

Расширение:

2a. Срок действия ссылки истек или ссылка некорректная
2a.1. Система обнаруживает, что ссылка не валидна:
- истек срок действия с момента создания (24 часа)
- ссылка некорректна 
2a.2. Система отображает сообщение об ошибке: "Ссылка недействительна, проверьте ее еще раз или обратитесь к Администратору" 
2a.3. Завершение сценария


3a. Ошибка при сохранении изменений
3a.1. Система не смогла сохранить изменения сущности Пользователя
3a.2. Система отображает ошибку с кодом и текстом Гостю: "Произошла ошибка регистрации, код ошибки: <<код>>, обратитесь в службу технической поддержки"
3a.3 Завершение сценария

Примечание:

За рамками MVP



Авторизация

INSP-UC-AUTH-004




Авторизоваться💬

Статус сценария:  Согласовано

Релиз: MVP

Бизнес-требование:  

Пользователь системы должен иметь возможность авторизоваться и получить права в системе, соответствующие своей роли

Точки входа:

  • Окно авторизации

Предусловие:

  1. Пользователь был зарегистрирован в системе
  2. Статус = Активный

Приоритет:

Высокий

Роли: 

Неавторизованный пользователь

Основной поток:

  1. Система отображает форму для ввода авторизационных данных
    1. Логин
    2. Пароль
  2. Неавторизованный пользователь вводит авторизационные данные
    1. Логин (e-mail)
    2. Пароль
  3. Неавторизованный пользователь подтверждает ввод данных
  4. Система динамически проверяет корректность ввода данных
  5. Система проверяет наличие пользователя с указанным логином и паролем (аутентификация), его статус
  6. В случае успешной аутентификации система выполняет вход и предоставляет права пользователю, в соответствии с его ролью в системе
  7. Система логирует данные сессии Пользователя
  8. Система отображает главную страницу согласно роли пользователя
  9. Завершение сценария 

Расширение:

2a (3a). Восстановить пароль (пользователь забыл пароль) (вне рамках MVP)💬
2(3)a.1. Пользователь запустил функцию восстановления пароля
2(3)a.2. Выполняется сценарий  INSP-UC-USR-003


2с. Автозаполнение
2с.1 Система поддерживает автозаполнение авторизационных данных


4a. Некорректный ввод данных
4a.1. Система обнаруживает, что пользователь не ввел обязательные данные:
- e-mail
- пароль
4a.2. Система отображает сообщение об ошибке и подсвечивает незаполненные поля
4a.3. Продолжение сценария с пункта 2 основного потока


5a. Неверный логин/пароль:
5a.1. Система не обнаруживает зарегистрированного пользователя в системе с указанными гостем логином и паролем
5a.2. Система отображает сообщение об ошибке: "Пользователя с таким логином и/или паролем не существует. Попробуйте еще раз, сбросьте пароль или обратитесь к Администратору", и отображает соответствующие кнопки для запуска функций:
- Сбросить пароль INSP-UC-USR-003
5a.3. Возвращение во 2 пункт основного потока или переход в соответствующий сценарий


6a. Ошибка при авторизации
6a.1. Система не смогла произвести авторизацию
6a.2. Система отображает ошибку пользователю
6a.3. Завершение сценария

Примечание:

Лимит неудачных попыток входа и блокировка аккаунта/IP после N попыток, время жизни сессии (таймаут), функция «Запомнить меня», параллельные сессии одного пользователя с разных устройств - за рамками MVP


INSP-UC-AUTH-005


Двухфакторная авторизация 

Статус сценария:  Ожидание согласования

Релиз: ПОСЛЕ MVP

Бизнес-требование:  

Точки входа:

  • Окно авторизации

Предусловия:

  1. Пользователь был зарегистрирован в системе и прошел проверку СБ UC-AUTH-003, статус = Активный
  2. В профиле пользователя указан личный номер телефона или e-mail

Приоритет:

Средний

Роли: 

Неавторизованный пользователь

Основной поток:

  1. Система отображает форму для ввода авторизационных данных
    1. Логин
    2. Пароль
  2. Неавторизованный пользователь вводит авторизационные данные
    1. Логин (e-mail)
    2. Пароль
  3. Неавторизованный пользователь подтверждает ввод данных
  4. Система динамически проверяет корректность ввода данных
  5. Система проверяет наличие пользователя с указанным логином и паролем (аутентификация)
  6. Система генерирует уникальный одноразовый код подтверждения личности и отправляет его на определенный способ доставки (e-mail или SMS по номеру телефона)

  7. Система отображает экран для ввода одноразового кода.

  8. Пользователь вводит полученный код, подтверждает ввод.

  9. Система проверяет корректность и срок действия кода.

  10. В случае успешной проверки система выполняет вход и предоставляет права пользователю, в соответствии с его ролью в системе
  11. Система логирует данные сессии Пользователя
  12. Система отображает главную страницу согласно роли пользователя
  13. Завершение сценария 

Расширение:

2a (3a). Восстановить пароль (пользователь забыл пароль)
2(3)a.1. Пользователь запустил функцию восстановления пароля
2(3)a.2. Выполняется сценарий  UC-USR-003


2с. Автозаполнение
2с.1 Система поддерживает автозаполнение авторизационных данных


4a. Некорректный ввод данных
4a.1. Система обнаруживает, что пользователь не ввел обязательные данные:
- e-mail
- пароль
4a.2. Система отображает сообщение об ошибке и подсвечивает незаполненные поля
4a.3. Продолжение сценария с пункта 2 основного потока


5a. Неверный логин/пароль:
5a.1. Система не обнаруживает зарегистрированного пользователя в системе с указанными гостем логином и паролем
5a.2. Система отображает сообщение об ошибке: "Пользователя с таким логином и/или паролем не существует. Попробуйте еще раз, сбросьте пароль или обратитесь к Администратору", и отображает соответствующие кнопки для запуска функций:
- Сбросить пароль UC-USR-003
5a.3. Возвращение во 2 пункт основного потока или переход в соответствующий сценарий


8a. Пользователь не получил код:
8a.1 Пользователь нажимает кнопку "Отправить код повторно".
8a.2 Система инвалидирует предыдущий код и генерирует новый, отправляя его пользователю.
8a.3 Возврат к шагу 8


9a. Неверный или устаревший код:
9a.1 Система обнаруживает, что введен неверный код или истек срок его действия.
9a.2 Система отображает сообщение об ошибке: "Неверный код. Попробуйте еще раз."
9a.3 Возврат к шагу 8. После 3-й неудачной попытки система может заблокировать возможность ввода на короткое время.


6a. Ошибка при авторизации
6a.1. Система не смогла произвести авторизацию
6a.2. Система отображает ошибку пользователю
6a.3. Завершение сценария

Примечание:

Дополнительный опциональный сценарий за рамками MVP


INSP-UC-AUTH-006

Выйти из системы

Статус сценария:  Согласовано

Релиз: MVP

Бизнес-требование: 

Точки входа:

  • Профиль → Выйти

Предусловия:

  1. Пользователь авторизован в системе

Приоритет:

Высокий

Роли: 

Любая роль в системе - далее Пользователь

Основной поток:
  1. Пользователь запускает функцию выхода из профиля
  2. Система отображает окно с необходимостью подтвердить действие и с сообщением "Вы уверены, что хотите выйти из системы?"
  3. Пользователь подтверждает выход из системы
  4. Система завершает текущую сессию пользователя.
  5. Система очищает сессионные данные.
  6. Система отображает главную страницу авторизации

Расширение:

3a. Отмена действия
3a.1. Пользователь не подтверждает выход (закрывает окно)
3a.2. Система возвращает пользователя к последней открытой странице
3a.3. Завершение сценария

Примечание:

Комментарии (28) · по состоянию на 2026-09-18

К фрагментам текста

Вершинин Максим · 2026-09-09 16:00 МСК · открыт · к фрагменту · 73074681
«Регистрация пользователя»

Регистрация пользователя стоит в релизе “После MVP”, при этом авторизация входит в “MVP”, это не ошибка?

Софья Герасимова · 2026-09-16 05:33 МСК · 73075630

Не ошибка, в MVP всех пользователей заведем в БД

claude-code · 2026-09-16 08:46 МСК · 73075682

[Ревью] Раунд 3. Подтверждено и формализовано — решение полностью согласуется со страницей «Список допущений/решений…» (id 73075569): «в MVP пользователей заводит администратор вручную в БД», самостоятельная регистрация/подтверждение почты/2FA/проверка СБ — После MVP. Вопрос закрыт.

claude-code · 2026-09-16 10:18 МСК · 73075817

[Ревью] РЕШЕНО — можно удалить. Формализовано на странице решений: пользователей в MVP заводит администратор вручную в БД.

claude-code · 2026-09-15 09:17 МСК · решён · к фрагменту · 73075080
«Регистрация пользователя»

[Ревью] Критично, конфликт MVP. Сценарий «Регистрация пользователя» (INSP-UC-AUTH-001) имеет Приоритет «Высокий», но Релиз «После MVP». При этом в MVP заявлены только «Авторизоваться» и «Выйти из системы». Неясно, как пользователи (Агенты, Исполнители, Администрация порта, Служба контроля) вообще появляются в системе на этапе MVP — требуется либо предусмотреть альтернативный способ создания пользователей (например, вручную Системным администратором), либо пересмотреть релиз этого сценария.

claude-code · 2026-09-15 13:40 МСК · 73075434

[Ревью] Решено, спасибо — добавлено примечание: «В рамках MVP не предполагается самостоятельная регистрация пользователей. Администратор базы данных вручную в БД зарегистрирует пользователей…». Это согласуется со страницей «Список функций Портала» («Регистрация пользователя через БД» — MVP, согласовано; самостоятельная регистрация — После MVP).

claude-code · 2026-09-16 10:18 МСК · 73075818

[Ревью] РЕШЕНО — можно удалить. Примечание про ручную регистрацию администратором БД добавлено, конфликт релиза снят.

claude-code · 2026-09-15 09:17 МСК · решён · к фрагменту · 73075083
«обязательное подтверждение аккаунта Службой безопасности»

[Ревью] Критично, После MVP, но важно для понимания. Бизнес-требование упоминает обязательное подтверждение аккаунта Службой безопасности для ролей Исполнитель и Агент, однако сам сценарий подтверждения (кто именно выполняет проверку, какие критерии принятия/отказа, куда уходит ветка отказа, что видит пользователь при отказе) в разделе отсутствует — есть только косвенная ссылка «UC-AUTH-003», которой нет на странице.

Софья Герасимова · 2026-09-15 11:09 МСК · 73075250

Процесс подтверждения и проверки пользователей выходит за рамками MVP

claude-code · 2026-09-15 13:40 МСК · 73075436

[Ревью] Решено, спасибо за пояснение — процесс подтверждения СБ целиком вне рамок MVP, что согласуется со статусом «После MVP» для «Проверка СБ заявки на регистрацию» на странице «Список функций Портала». Детализацию сценария имеет смысл проработать при планировании после-MVP этапа.

claude-code · 2026-09-16 10:18 МСК · 73075819

[Ревью] РЕШЕНО — можно удалить. Подтверждено, что процесс подтверждения СБ целиком вне рамок MVP.

claude-code · 2026-09-15 09:17 МСК · решён · к фрагменту · 73075086
«Не соответствует условиям <условия>»

[Ревью] Критично, После MVP. Условия сложности пароля обозначены плейсхолдером «<условия>» и нигде в документации не раскрыты (минимальная длина, требования к составу символов, запрет на простые пароли и т.д.). Без утверждённой политики паролей невозможно реализовать валидацию поля «Пароль» ни на фронте, ни на бэкенде.

Софья Герасимова · 2026-09-15 11:09 МСК · 73075251

добавила

claude-code · 2026-09-15 13:40 МСК · 73075437

[Ревью] Решено, спасибо — плейсхолдер заменён на ссылку на атрибут LinkLINKINSP-AT-USR-009, где должны быть зафиксированы условия пароля.

claude-code · 2026-09-16 10:18 МСК · 73075820

[Ревью] РЕШЕНО — можно удалить. Плейсхолдер условий пароля заменён ссылкой на атрибут с условиями.

claude-code · 2026-09-15 09:17 МСК · решён · к фрагменту · 73075089
«Авторизоваться»

[Ревью] Критично, MVP. В сценарии авторизации не описаны важные для безопасности и UX параметры: лимит неудачных попыток входа и блокировка аккаунта/IP после N попыток, время жизни сессии (таймаут), функция «Запомнить меня», а также разрешены ли параллельные сессии одного пользователя с разных устройств. Это MVP-функционал, требующий уточнения перед разработкой.

claude-code · 2026-09-15 13:40 МСК · 73075440

[Ревью] Решено, спасибо — добавлено примечание, что лимит попыток входа/блокировка, тайм-аут сессии, «Запомнить меня» и параллельные сессии — за рамками MVP. Осознанное решение зафиксировано, вопросов нет.

claude-code · 2026-09-16 10:18 МСК · 73075821

[Ревью] РЕШЕНО — можно удалить. Добавлено примечание, что лимиты попыток входа/тайм-аут сессии/«запомнить меня»/параллельные сессии — за рамками MVP.

claude-code · 2026-09-15 09:17 МСК · решён · к фрагменту · 73075100
«Восстановить пароль (пользователь забыл пароль)»

[Ревью] Критично, MVP. Сценарий «Восстановить пароль» ссылается на INSP-UC-USR-003, которого нет ни на этой странице, ни, судя по всему, в изученном разделе про пользователей. Так как восстановление пароля — обязательная часть MVP-потока логина (сценарий «Авторизоваться» в MVP), нужно либо добавить сам сценарий UC-USR-003 в соответствующий раздел, либо проверить корректность ссылки.

Софья Герасимова · 2026-09-15 11:12 МСК · 73075254

Тут все правильно, не обязательно сценарий, на который указана ссылка должен быть описан в этом же разделе

claude-code · 2026-09-15 13:40 МСК · 73075443

[Ревью] Решено, спасибо за пояснение — согласны, что сценарий INSP-UC-USR-003 может быть описан в разделе «Пользователи» (3.4), это не ошибка данной страницы. Снимаем вопрос, повторно поднимать не будем в рамках раздела 3.1-3.2.

claude-code · 2026-09-16 10:18 МСК · 73075822

[Ревью] РЕШЕНО — можно удалить. Подтверждено, что ссылка на UC-USR-003 корректна, сценарий описан в другом разделе — не ошибка данной страницы.

К странице

claude-code · 2026-09-15 09:17 МСК · открыт · 73075096

[Ревью] Дополнительные уточнения по разделу «Регистрация и авторизация» (без точной привязки к фрагменту): 1. [Желательно, MVP] Способ аутентификации — только логин/пароль. Не зафиксировано явно, что интеграция с ЕСИА/SSO не предусмотрена для MVP — стоит явно задокументировать это как осознанное решение, а не умолчание. 2. [Критично, MVP] Полная статусная модель пользователя (Новый → Верифицирован → Активный и т.д.) нигде на странице не представлена как диаграмма или таблица с описанием переходов. Без неё нельзя спроектировать проверку статуса в предусловии сценария «Авторизоваться» (упоминается только «Статус = Активный» без объяснения, как пользователь туда попадает).

claude-code · 2026-09-15 13:40 МСК · 73075441

[Ревью] Пока актуально: 1) не зафиксировано явно, что интеграция с ЕСИА/SSO не предусмотрена для MVP (только логин/пароль) — стоит добавить как осознанное решение. 2) Полная статусная модель пользователя (Новый → Верифицирован → Активный и далее) по-прежнему не представлена ни диаграммой, ни таблицей на странице — без неё неясно, как пользователь получает статус «Активный», используемый в предусловии сценария «Авторизоваться».

claude-code · 2026-09-16 08:46 МСК · 73075685

[Ревью] Раунд 3. Пока актуально — новая страница решений (id 73075569) не затрагивает ни вопрос об ЕСИА/SSO (только логин/пароль, что и так фактически MVP-реализация, но явной оговорки «SSO — вне MVP» в тексте по-прежнему нет), ни полную статусную модель пользователя (Новый → Верифицирован → Активный и т.д.) — она по-прежнему не представлена диаграммой/таблицей. Остаётся открытым техническим уточнением.

Софья Герасимова · 2026-09-16 09:32 МСК · 73075751

SSO — вне MVP

Статусная модель пользователя также за рамками MVP. По умолчанию все пользователи в статусе Активно

claude-code · 2026-09-16 10:18 МСК · 73075836

[Ревью] Уточнение внесено частично: спасибо за ответ в комментарии — SSO вне MVP, статусная модель пользователя за рамками MVP (все пользователи по умолчанию Активны). Само решение принято, но в тексте страницы это пока не отражено явно (нет фразы про исключение ЕСИА/SSO и статусную модель). Рекомендуется перенести эти формулировки в текст страницы для полноты документации.

Софья Герасимова · 2026-09-16 10:25 МСК · 73075892

Добавила