Сценарии использования: управление справочником портов, причалов, стоянок

Описание справочника:

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

INSP-UC-PRT-001

Просмотреть справочник портов, причалов, стоянок

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

Релиз: MVP

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

Точки входа:

  • ... → Справочник Порты, причалы и стоянки

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

Приоритет:

Высокий

Роли: 

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

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

  1. Пользователь запускает функцию просмотра справочника портов, причалов, стоянок
  2. Система отображает текущий список портов, причалов, стоянок в виде реестра:
    1. Порты:
      1. Наименование
      2. Статус
      3. Страна
      4. Координаты
    2. Причалы:
      1. Порт
      2. Наименование
      3. Координаты
    3. Стоянки
      1. Порт
      2. Наименование
      3. Координаты
  3. Пользователь с соответствующими правами может перейти к одному из сценариев:
    1. Выполнить поиск в справочнике → INSP-UC-PRT-006
    2. Создать новый порт, причал, стоянку →  INSP-UC-PRT-002
    3. Изменить характеристики порта, причала, стоянки → INSP-UC-PRT-005
  4. Завершение сценария

Расширение:

2a. Нет портов
2a.1 Система обнаруживает, что нет созданных портов
2a.2 Система отображает пустой список с сообщением "Нет созданных портов"

Примечание:


INSP-UC-PRT-006

Найти порт, причал, стоянку в справочнике

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

Релиз: MVP

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

Точки входа:

  • ... → Справочник Порты, причалы и стоянки

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

Приоритет:

Высокий

Роли: 

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

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

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

Расширение:

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

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

Примечание:


INSP-UC-PRT-002



Создать порт

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

Релиз: MVP

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

Точки входа:

  • ... → Справочник Порты, причалы и стоянки

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

  1. Пользователь открыл справочник портов INSP-UC-PRT-001

Приоритет:

Средний

Роли: 

Агент, Исполнитель, Системный администратор💬 - далее Пользователь💬

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

  1. Пользователь запускает функцию создания порта
  2. Система отображает поля для ввода:
    1. Порты:
      1. Наименование
      2. Страна
      3. Координаты
    2. Причалы:
      1. Порт
      2. Наименование
      3. Координаты
    3. Стоянки
      1. Порт
      2. Наименование
      3. Координаты
  3. Пользователь вводит данные
    1. Порты:
      1. Наименование INSP-AT-PRT-002
      2. Страна INSP-AT-PRT-013
      3. Координаты INSP-AT-PRT-004
    2. Причалы:
      1. Порт INSP-AT-PRT-006
      2. Наименование INSP-AT-PRT-007
      3. Координаты INSP-AT-PRT-008
    3. Стоянки
      1. Порт INSP-AT-PRT-010
      2. Наименование INSP-AT-PRT-011
      3. Координаты INSP-AT-PRT-012
  4. Пользователь подтверждает ввод данных
  5. Система проверяет корректность ввода данных
  6. Система создает и сохраняет новый порт/причал/стоянку💬
    1. Статус = Активно
  7. Завершение сценария

Расширение:

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


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

Примечание:

В MVP принимаем риск, что Агенты/Исполнители могут создать некорректные данные


INSP-UC-PRT-003


Архивировать порт💬

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

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

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

Точки входа:

  • ... → Справочник Портов

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

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

Приоритет:

Низкий (3)

Роли: 

Системный администратор - далее Пользователь

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

  1. Пользователь запускает функцию изменения статуса Порта на "Не активно"
  2. Система проверяет связь порта с незавершенными заявками

  3. В случае, если система не обнаружила связанных Заявок система отображает окно для подтверждения действия

  4. Пользователь подтверждает смену статуса порта
  5. Система сохраняет изменения статуса = Не активно💬
  6. Завершение сценария

Расширение:

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


4a (2b.3a). Отмена
.1. Пользователь отменяет изменение
.3. Система пользователя на предыдущее окно

Примечание:

В рамках MVP статус Порта не меняется, всегда Активный


INSP-UC-PRT-004

Активировать порт

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

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

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

Точки входа:

  • ... → Справочник Портов

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

  1. Пользователь выбрал порт, который хочет активировать
  2. Статус порта = Не активно

Приоритет:

Низкий (3)

Роли: 

Системный администратор - далее Пользователь

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

  1. Пользователь запускает функцию изменения статуса Порта на "Активно"
  2. Система отображает окно для подтверждения действия
  3. Пользователь подтверждает смену статуса порта
  4. Система сохраняет изменения статуса = Активно
  5. Завершение сценария

Расширение:

3a. Отмена
3a.1. Пользователь отменяет изменение
3a.3. Система пользователя на предыдущее окно

Примечание:

В рамках MVP статус Порта не меняется, всегда Активный


INSP-UC-PRT-005

Изменить характеристики порта

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

Релиз: MVP

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

Точки входа:

  • ... → Справочник Портов

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

  1. Пользователь выбрал порт, который хочет изменить

Приоритет:

Низкий (3)

Роли: 

Агент, Исполнитель, Системный администратор - далее Пользователь

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

  1. Пользователь запускает функцию изменения характеристик порта
  2. Система отображает поля для изменения данных:
    1. Порты:
      1. Наименование
      2. Страна
      3. Координаты
    2. Причалы:
      1. Порт
      2. Наименование
      3. Координаты
    3. Стоянки
      1. Порт
      2. Наименование
      3. Координаты
  3. Пользователь меняет данные
    1. Порты:
      1. Наименование INSP-AT-PRT-002
      2. Страна INSP-AT-PRT-013
      3. Координаты INSP-AT-PRT-004
    2. Причалы:
      1. Порт INSP-AT-PRT-006
      2. Наименование INSP-AT-PRT-007
      3. Координаты INSP-AT-PRT-008
    3. Стоянки
      1. Порт INSP-AT-PRT-010
      2. Наименование INSP-AT-PRT-011
      3. Координаты INSP-AT-PRT-012
  4. Пользователь подтверждает ввод данных
  5. Система проверяет корректность ввода данных
  6. Система сохраняет изменения
  7. Завершение сценария

Расширение:

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


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

Примечание:

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

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

Вершинин Максим · 2026-09-09 16:22 МСК · решён · к фрагменту · 73074683
«Агент, Исполнитель, Системный администратор - далее Пользователь»

Корректно ли что пользователь может создать свой порт, без проверки сис. админа? И порт будет сразу в состоянии “Активно”?

Вершинин Максим · 2026-09-09 16:24 МСК · 73074685

Агент может создать порт, но при какой-либо ошибке никак не сможет его удалить либо отредактировать

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

Пока да, заводят порты Агенты. В будущем. скорее всего это будет делать Админ.

В изменение добавила Агента

Роман Износов · 2026-09-15 01:13 МСК · открыт · к фрагменту · 73074823
«Не активно»

Справочники с таким статусов отображаются у всех пользователей или только у админа?

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

Архивацию и в, целом, статусы портов решили оставить после MVP, поэтому пока ответить не могу

claude-code · 2026-09-15 09:15 МСК · решён · к фрагменту · 73074996
«Архивировать порт»

[Ревью] Критично, конфликт MVP. Сценарии «Архивировать порт» (INSP-UC-PRT-003) и «Активировать порт» (INSP-UC-PRT-004) помечены релизом «После MVP», хотя в описании справочника (родительская страница) архивирование заявлено как единственный механизм управления жизненным циклом записи взамен удаления. Получается, что в MVP не будет способа деактивировать ошибочно созданный или выведенный из использования порт. Нужно либо перенести эти сценарии в MVP, либо явно зафиксировать, что в MVP статус портов не меняется.

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

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

В рамках MVP статус Порта не меняется, всегда Активный

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

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

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

[Ревью] РЕШЕНО — можно удалить. Примечание «В рамках MVP статус Порта не меняется, всегда Активный» добавлено, конфликт с родительской страницей снят.

claude-code · 2026-09-15 09:15 МСК · решён · к фрагменту · 73075001
«Система создает и сохраняет новый порт/причал/стоянку»

[Ревью] Критично, MVP. В сценарии создания порта/причала/стоянки (INSP-UC-PRT-002) нет проверки уникальности вводимых данных (в отличие от сценария создания Судна INSP-UC-VSS-003, где есть явное расширение «Нарушение уникальности»). Не определены уникальные ключи справочника (например, комбинация Наименование+Координаты для порта, Порт+Наименование для причала/стоянки) — есть риск дублей в НСИ.

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

Принимаем такой риск в рамках MVP

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

[Ревью] Решено, спасибо за явное решение — риск отсутствия проверки уникальности в MVP осознанно принят, зафиксировано в комментарии. Возражений нет.

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

[Ревью] РЕШЕНО — можно удалить. Риск отсутствия проверки уникальности в MVP осознанно принят и зафиксирован.

claude-code · 2026-09-15 09:15 МСК · решён · к фрагменту · 73075028
«Агент, Исполнитель, Системный администратор»

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

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

Принимаем такой риск

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

[Ревью] Решено, спасибо за явное решение — риск создания записей справочника ролями Агент/Исполнитель осознанно принят. Возражений нет.

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

[Ревью] Раунд 3. Дополнительно подтверждено — решение теперь формализовано на странице «Список допущений/решений…» (id 73075569): «в MVP в справочник “Порты, причалы и стоянки” Агенты/Исполнители МОГУТ вносить новые данные через UI (риск некорректных данных принят)». Полностью согласуется с текстом данной страницы. Вопросов нет.

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

[Ревью] РЕШЕНО — можно удалить. Решение по ролям (Агенты/Исполнители вносят данные в справочник портов) формализовано на странице решений, вопросов нет.

К странице

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

[Ревью] Уточнения по атрибутам сценариев «Создать порт» (INSP-UC-PRT-002) / «Изменить характеристики порта» (INSP-UC-PRT-005): 1. [Критично, MVP] Для поля «Координаты» порта не указан формат значения: градусы/минуты/секунды или десятичные градусы, система координат (рекомендуется WGS84), разделитель широты/долготы. Без этого нельзя однозначно спроектировать валидацию поля и карту. 2. [Желательно, MVP] Для поля «Страна» не уточнено, является ли оно справочником (например, по ISO 3166) с выбором из списка, или полем свободного текста. Это важно для фильтрации/поиска и единообразия данных.

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

[Ревью] Пока актуально: формат поля «Координаты» (градусы/минуты/секунды vs десятичные градусы, система координат, разделитель широты/долготы) и природа поля «Страна» (справочник ISO 3166 vs свободный текст) в тексте сценариев INSP-UC-PRT-002/005 по-прежнему не уточнены.