Реестр Агентов

Реестр Агентов

INSP-UC-AGNT-001

Создать Агента💬

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

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

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

Точки входа:

  • Реестр Агентов  

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

Приоритет:

Средний

Роли: 

Агент, Системный администратор - далее Администратор💬

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

  1. Администратор запускает функцию создания Агента
  2. Система отображает форму для ввода данных:
    1. Вид лица 
    2. Наименование 
    3. ИНН 
    4. Телефон 
    5. Эл. почта 
  3. Пользователь вводит данные:
    1. Вид лица INSP-AT-AGNT-003
    2. Наименование INSP-AT-AGNT-004
    3. ИНН INSP-AT-AGNT-005
    4. Телефон INSP-AT-AGNT-006
    5. Эл. почта INSP-AT-AGNT-007
    6. Пользователи → выполняется сценарий INSP-UC-AGNT-008
  4. Система динамически проверяет корректность ввода данных 
  5. Пользователь подтверждает создание Агента
  6. Система сохраняет Агента
  7. Система отображает сообщение об успешном создании
  8. Завершение сценария

Расширение:


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


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


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

Примечание:

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


INSP-UC-AGNT-008

Создать связь пользователя с Агентом💬

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

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

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

Точки входа:

  • Реестр Агентов  

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

  1. Администратор начал выполнение сценария создания связи в момент создания Агента INSP-UC-AGNT-001
  2. Администратор начал выполнение сценария создания связи в момент изменения Агента INSP-UC-AGNT-007

Приоритет:

Средний

Роли: 

Агент, Системный администратор - далее Администратор

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

  1. Администратор активирует функцию создания связи Пользователя(ей) с Агентом)
  2. Система отображает список Пользователей
    1. Роль = Агент
  3. Администратор может выполнить поиск в списке по атрибутам
    1. Фамилия
    2. Имя
    3. Отчество
    4. Логин
  4. Администратор выбирает одного или нескольких пользователей и подтверждает выбор
  5. Система проверяет возможность связи выбранных пользователей с Агентом
  6. Продолжение предыдущего сценария

Расширение:

5a. Пользователь уже связан с другим Агентом
5a.1 Система обнаруживает, что выбранный пользователь уже связан с другим Агентом
5a.2 Система отображает ошибку "Невозможно привязать пользователя <ФИО>, так как для него уже существует связь с другим Агентом"
5a.3 Завершение сценария


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

Примечание:

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


INSP-UC-AGNT-002

Просмотреть список Агентов

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

Релиз: MVP

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

Точки входа:

  • → Реестр Агентов

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

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

Приоритет:

Средний

Роли: 

Исполнитель, Администрация порта, Служба контроля, Системный администратор - далее Пользователь

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

  1. Пользователь запускает функцию просмотра списка Агентов
  2. Система отображает список Агентов и данные в виде реестра:
    1. Вид лица 
    2. Наименование 
    3. ИНН 
    4. Телефон 
    5. Эл. почта 
  3. Пользователь может перейти к одному из сценариев:
    1. Сортировать список → INSP-UC-AGNT-003
    2. Фильтровать список → INSP-UC-AGNT-003
    3. Найти в реестре → 
    4. Просмотреть карточку Агента → 
  4. Завершение сценария

Расширение:

Примечание:


INSP-UC-AGNT-003

Сортировать список Агентов

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

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

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

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

  1. Пользователь открыл список Агентов INSP-UC-AGNT-002

Точки входа:

  • → Реестр Агентов

Приоритет:

Средний (2)

Роли: 

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

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

  1. Пользователь запускает функцию сортировки одного из полей реестра:
    1. Наименование
    2. ??
  2. Если ранее была включена сортировка по другому полю, то Система сбрасывает ее
  3. Система сортирует реестр по указанному полю
    1. по возрастанию при первом вызове
    2. по убыванию при втором вызове
    3. при третьем вызове - сброс сортировки
  4. Завершение сценария

Расширение:

3a. Ошибка запроса
3a.1 Система не смогла выполнить запрос (или не смогла получить ответ по запросу)
3a.2 Система отображает ошибку "Возникла ошибка, попробуйте обновить страницу и повторить запрос"
3a.3 Завершение сценария

Примечание:


INSP-UC-AGNT-004



Фильтровать список Агентов

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

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

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

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

  1. Пользователь открыл список Агентов INSP-UC-AGNT-002

Точки входа:

  • → Реестр Агентов

Приоритет:

Средний (2)

Роли: 

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

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

  1. Пользователь запускает функцию фильтрации (сложной) реестра
  2. Система отображает форму для настроек фильтрации с ключевыми атрибутами фильтрации:
    1. Вид лица 
    2. ...
  3. Пользователь устанавливает фильтры
    1. Вид лица 
    2. ...
  4. Пользователь подтверждает применение фильтров в реестре
  5. Система выполняет фильтрацию реестра по заданным настройкам
  6. Пользователь просматривает реестр
  7. Завершение сценария

Расширение:

6a. Быстрый сброс
6a.1 Пользователь запустил функцию сброса фильтров (или очистил форму с настройками фильтрации)
6a.2 Система сбрасывает результаты фильтрации и отображает такой вид реестра, какой был перед тем как Пользователь начал фильтрацию
6a.2 Завершение сценария


5a. Ошибка запроса
5a.1 Система не смогла выполнить запрос (или не смогла получить ответ по запросу)
5a.2 Система отображает ошибку "Возникла ошибка, попробуйте обновить страницу и повторить запрос"
5a.3 Завершение сценария

Примечание:


INSP-UC-AGNT-005




Найти в реестре Агентов

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

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

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

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

  1. Пользователь открыл список Агентов INSP-UC-AGNT-002

Точки входа:

  • → Реестр Агентов

Приоритет:

Средний (2)

Роли:

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

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

  1. Пользователь вводит в форму для поиска запрос
  2. Система динамически при вводе от 3 символов начинает поиск Агента и отображает результаты по совпадению (без учета регистра):
    1. Наименование 
    2. ИНН 
    3. ???
  3. Система отображает результаты поиска
  4. Пользователь может продолжить вводить символы для поиска, система динамически производит поиск
  5. Завершение сценария

Расширение:

4a. Быстрый сброс
4a.1 Пользователь запустил функцию сброса результатов поиска (или очистил форму поиска)
4a.2 Система сбрасывает результаты поиска и отображает такой вид реестра, какой был перед тем как Пользователь начал поиск
4a.2 Завершение сценария

2a, 4b. Ошибка запроса
.1 Система не смогла выполнить запрос (или не смогла получить ответ по запросу)
.2 Система отображает ошибку "Возникла ошибка, попробуйте обновить страницу и повторить запрос"
.3 Завершение сценария

Примечание:


INSP-UC-AGNT-006





Просмотреть карточку Агента

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

Релиз: MVP

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

Точки входа:

  • → Реестр Агентов
  • Главная → Профиль (для Агента)

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

Приоритет:

Средний (2)

Роли: 

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

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

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

Расширение:

Примечание:


INSP-UC-AGNT-007





Обновить данные Агента

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

Релиз: MVP

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

Агент - юридическое лицо, представляющие Судовладельца. Агенты имеют права подавать заявки от лица Судовладельца.

Под одним юридическим лицом в системе может быть несколько Пользователей - представителей организации Агента.

Точки входа:

  • ??
  • Профиль → Данные агента

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

  1. Роль пользователя = Агент, и он запустил сценарий обновления данных своего профиля 
  2. Системный администратор имеет права на изменения данных любого Агента

Приоритет:

Высокий

Роли: 

Агент, Системный администратор - далее Администратор

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

  1. Администратор активирует функцию изменения данных 
  2. Система отображает форму для ввода данных:
    1. Вид лица 
    2. Наименование 
    3. ИНН 
    4. Телефон 
    5. Эл. почта 
  3. Пользователь вносит изменения:
    1. Вид лица INSP-AT-AGNT-003
    2. Наименование INSP-AT-AGNT-004
    3. ИНН INSP-AT-AGNT-005
    4. Телефон INSP-AT-AGNT-006
    5. Эл. почта INSP-AT-AGNT-007
    6. Пользователи → выполняется сценарий INSP-UC-AGNT-008
  4. Система динамически проверят корректность введенных данных
  5. Пользователь подтверждает изменение данных
  6. Система сохраняет и обновляет данные
  7. Система отображает сообщение об успешной операции
  8. Завершение сценария

Расширение:

2a. Изменение Системным администратором
- Системный администратор может обновить данные любого Агента
- Агент может обновить данные только своего профиля


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


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


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

Примечание:

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

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

claude-code · 2026-09-15 09:15 МСК · решён · к фрагменту · 73074945
«Создать Агента»

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

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

добавила примечание

claude-code · 2026-09-15 13:39 МСК · 73075427

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

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

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

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

добавила примечание

claude-code · 2026-09-15 13:39 МСК · 73075428

[Ревью] Решено, спасибо — в примечании указано, что в MVP связь пользователя с Агентом также заводится напрямую в БД вместе с самим Агентом, роль Агент не остаётся без организации.

Роман Износов · 2026-09-15 10:24 МСК · открыт · к фрагменту · 73075180
«Администратор»

“Администратор” - это администратор порта? Или администратор чуть поменьше системного?

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

Нет, это просто короткое обозначение далее по тексту сценария.

Обычно я пишу либо далее Пользователь, либо далее Администратор

К странице

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

[Ревью] Желательно: В реестре Агентов не описана статусная модель/процесс верификации юридического лица (проверка ИНН/ОГРН через ЕГРЮЛ, блокировка организации при необходимости). Аналогичное замечание относится и к странице «Реестр Исполнителей». Стоит уточнить, нужен ли такой процесс верификации и на каком этапе (MVP/После MVP).

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

В MVP не планируется верификации данных Исполнителей и Агентов

claude-code · 2026-09-15 13:39 МСК · 73075429

[Ревью] Решено, спасибо за подтверждение — зафиксировано, что верификация юрлица в MVP не планируется (осознанное решение, а не пробел).