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

Просмотр

INSP-UC-VSS-001

Просмотреть список судов

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

Релиз: MVP

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

Точки входа:

  • Справочники → Судна

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

Приоритет:

Высокий

Роли: 

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

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

  1. Пользователь запускает функцию просмотра списка судов
  2. Система отображает текущий список судов в виде реестра:
    1. Наименование
    2. Vessel name
    3. ИМО | IMO
    4. Класс судна | Type
    5. Длина, м | Lenght Overal (LOA), m
    6. Ширина, м | Breadth, m
    7. Осадка, м | Draft, m
    8. Флаг | Flag
    9. Капитан судна (Ф.И.О.) | Name of vessel Capitan
    10. Собственник и (или) владелец судна | The owner and (or) master of vessel
    11. Описание | Descriprion
  3. Пользователь с соответствующими правами может перейти к одному из сценариев:
    1. Создать новое судно → INSP-UC-VSS-003
    2. Просмотреть карточку судна → INSP-UC-VSS-002
    3. Изменить характеристики → INSP-UC-VSS-004
  4. Завершение сценария

Расширение:

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

Примечание:


INSP-UC-VSS-002

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

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

Релиз: MVP

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

Точки входа:

  • Справочники → Судна → Судно

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

Приоритет:

Средний

Роли: 

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

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

  1. Пользователь запускает функцию просмотра карточки Судна
  2. Система отображает карточку судна, в том числе данные:
    1. Наименование
    2. Vessel name
    3. ИМО | IMO
    4. Класс судна | Type
    5. Длина, м | Lenght Overal (LOA), m
    6. Ширина, м | Breadth, m
    7. Осадка, м | Draft, m
    8. Флаг | Flag
    9. Капитан судна (Ф.И.О.) | Name of vessel Capitan
    10. Собственник и (или) владелец судна | The owner and (or) master of vessel
    11. Описание | Descriprion
  3. Пользователь с соответствующими правами может перейти к одному из сценариев:
    1. Изменить характеристики → INSP-UC-VSS-004
  4. Завершение сценария

Расширение:

Примечание:


INSP-UC-VSS-005



Фильтровать список судов

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

Релиз: MVP

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

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

Точки входа:

  • Справочники → Судна

Приоритет:

Средний (2)

Роли: 

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

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

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

Расширение:

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


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

Примечание:


INSP-UC-VSS-006




Найти судно в справочнике

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

Релиз: MVP

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

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

Точки входа:

  • Справочники → Судна

Приоритет:

Средний (2)

Роли:

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

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

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

Расширение:

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

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

Примечание:


Создание и изменение

INSP-UC-VSS-003


Создать новое судно

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

Релиз: MVP

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

Точки входа:

  • Справочники → Флот

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

Приоритет:

Низкий (3)

Роли:

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

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

  1. Пользователь запускает функцию создания нового Судна
  2. Система отображает форму для ввода данных:
    1. Наименование
    2. Vessel name
    3. ИМО | IMO
    4. Класс судна | Type
    5. Длина, м | Lenght Overal (LOA), m
    6. Ширина, м | Breadth, m
    7. Осадка, м | Draft, m
    8. Флаг | Flag
    9. Капитан судна (Ф.И.О.) | Name of vessel Capitan
    10. Собственник и (или) владелец судна | The owner and (or) master of vessel
    11. Описание | Descriprion
  3. Пользователь вводит данные:
    1. Наименование INSP-AT-VSS-002
    2. Vessel name INSP-AT-VSS-016
    3. ИМО | IMO INSP-AT-VSS-003
    4. Класс судна | TypeINSP-AT-VSS-006
    5. Длина, м | Lenght Overal (LOA), mINSP-AT-VSS-007
    6. Ширина, м | Breadth, mINSP-AT-VSS-008
    7. Осадка, м | Draft, mINSP-AT-VSS-009
    8. Флаг | Flag INSP-AT-VSS-010
    9. Капитан судна (Ф.И.О.) | Name of vessel CapitanINSP-AT-VSS-013
    10. Собственник и (или) владелец судна | The owner and (or) master of vessel INSP-AT-VSS-012
    11. Описание | DescriprionINSP-AT-VSS-004
  4. Система динамически проверяет корректность ввода данных 
  5. Пользователь подтверждает создание Судна
  6. Система создает и сохраняет новое Судно
  7. Завершение сценария

Расширение:


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


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

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


4b. Нарушение уникальности
4b.1 Система обнаруживает, что судно с указанными характеристиками уже существует в системе💬
- ИМО | IMO INSP-AT-VSS-003
4b.2 Система отображает сообщение об ошибке и подсвечивает поле, в котором обнаружена ошибка
4b.3 Продолжение сценария с пункта 3


3a. Отображение подсказок
3a.1. Пользователь может запустить функцию отображения подсказки по заполнению какого-либо поля
3a.2. Система отображает подсказку, о правилах заполнения поля

Примечание:


INSP-UC-VSS-004





Изменить характеристики судна

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

Релиз: MVP

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

Точки входа:

  • ..... → Судно

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

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

Приоритет:

Низкий (3)

Роли: 

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

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

  1. Пользователь запускает функцию изменения характеристик Судна
  2. Система отображает форму для ввода данных:
    1. Наименование
    2. Vessel name 
    3. ИМО | IMO
    4. Класс судна | Type
    5. Длина, м | Lenght Overal (LOA), m
    6. Ширина, м | Breadth, m
    7. Осадка, м | Draft, m
    8. Флаг | Flag
    9. Капитан судна (Ф.И.О.) | Name of vessel Capitan
    10. Собственник и (или) владелец судна | The owner and (or) master of vessel
    11. Описание | Descriprion
  3. Пользователь вводит данные:
    1. Наименование INSP-AT-VSS-002
    2. Vessel name INSP-AT-VSS-016
    3. ИМО | IMO INSP-AT-VSS-003
    4. Класс судна | TypeINSP-AT-VSS-006
    5. Длина, м | Lenght Overal (LOA), mINSP-AT-VSS-007
    6. Ширина, м | Breadth, mINSP-AT-VSS-008
    7. Осадка, м | Draft, mINSP-AT-VSS-009
    8. Флаг | Flag INSP-AT-VSS-010
    9. Капитан судна (Ф.И.О.) | Name of vessel CapitanINSP-AT-VSS-013
    10. Собственник и (или) владелец судна | The owner and (or) master of vessel INSP-AT-VSS-012
    11. Описание | DescriprionINSP-AT-VSS-004
  4. Система динамически проверяет корректность ввода данных 
  5. Пользователь подтверждает сохранение Судна
  6. Система сохраняет изменения Судна
  7. Система отображает сообщение об успешной операции
  8. Завершение сценария

Расширение:

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


3a. Отображение подсказок
3a.1. Пользователь может запустить функцию отображения подсказки по заполнению какого-либо поля
3a.2. Система отображает подсказку, о правилах заполнения поля


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


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

Примечание:




INSP-UC-VSS-007



Архивировать судно💬

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

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

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

Точки входа:

  • ..... → Судно

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

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

Приоритет:

Низкий (3)

Роли: 

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

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

  1. Пользователь запускает функцию изменения статуса Судна на "Не активно"
  2. Система проверяет наличие незавершенных заявок (статус != "Исполнено"), где участвует данное судно
  3. Система обнаруживает незавершенную(ые) заявку(и), в котором участвует судно - отображает сообщение "Данное судно участвует в Заявке: <информация о заявках>, для того чтобы сменить статус Судна необходимо отменить данные Заявки или изменить судно в этих Заявках
  4. Пользователь может сразу из сообщения перейти к карточкам найденных Заявок, для того чтобы отменить их или изменить судно либо завершить сценарий без обновления статуса судна
  5. После того как пользователь отменил/изменил все связанные с судном Заявки пользователь возвращается к подтверждению архивации судна
  6. Пользователь подтверждает действие
  7. Система сохраняет изменения
  8. Система отображает сообщение об успешной операции
  9. Завершение сценария

Расширение:

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


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

Примечание:

В MVP не будет статусов Судна, процессов архивации/распаковки. Все судна по умолчанию в статусе Активно



INSP-UC-VSS-008



Активировать судно

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

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

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

Точки входа:

  • ..... → Судно

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

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

Приоритет:

Низкий (3)

Роли: 

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

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

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

Расширение:

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

Примечание:

В MVP не будет статусов Судна, процессов архивации/распаковки. Все судна по умолчанию в статусе Активно


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

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

Кирилл Левчук · 2026-09-09 16:40 МСК · решён · к фрагменту · 73074688
«Супер-оператор - далее Пользователь»

Кто такой супер-оператор?

Роман Износов · 2026-09-15 01:26 МСК · открыт · к фрагменту · 73074825
«6a. Ошибка при создании и сохранении»

При дублировании справочника будут отображаться ошибки во избежании нескольких одинаковых портов/суден и т.п.?

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

Да, надо бы, добавлю

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

Добавила расширение + в словаре данных уточнила уникальность

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

Но что касаемо портов - подозреваю, что они не уникальные. Пока не стала добавлять

claude-code · 2026-09-15 09:16 МСК · решён · к фрагменту · 73075034
«Система обнаруживает, что судно с указанными характеристиками уже существует в системе»

[Ревью] Критично, MVP. Уникальность судна проверяется одновременно по полям Наименование, Vessel name и ИМО. Однако название судна не является уникальным глобально (суда разных судовладельцев могут называться одинаково), а вот ИМО — уникальный номер, присваиваемый судну на весь срок службы. Совместная проверка уникальности по названию+ИМО выглядит спорным бизнес-правилом: возможно, уникальным ключом должен быть только ИМО.

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

[Ревью] Пока актуально: проверка уникальности судна всё ещё выполняется одновременно по Наименованию, Vessel name и ИМО (п. 4b сценария INSP-UC-VSS-003) — бизнес-обоснование совместной проверки по названию+ИМО не пояснено.

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

[Ревью] Раунд 3. Пока актуально — проверка уникальности судна по-прежнему выполняется одновременно по Наименованию, Vessel name и ИМО (п. 4b сценария INSP-UC-VSS-003); формат/чек-сумма ИМО также не описаны. Новое решение (стр. 73075569) этот вопрос не затрагивает — остаётся открытым как отдельное уточнение бизнес-правила, не связанное с принятыми MVP-допущениями.

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

[Ревью] Пока актуально: проверка уникальности судна всё ещё выполняется одновременно по Наименованию, Vessel name и ИМО (п. 4b сценария INSP-UC-VSS-003); формат/чек-сумма ИМО также не описаны. Изменений с прошлого раунда нет.

claude-code · 2026-09-15 09:16 МСК · решён · к фрагменту · 73075038
«ключевыми атрибутами фильтрации»

[Ревью] Критично, MVP. Поля «Класс судна | Type» и «Флаг | Flag» используются как атрибуты фильтрации в реестре судов, но нигде не указано, являются ли они справочниками (enum/список значений) или полями свободного текста. Если свободный текст — фильтрация по ним будет ненадёжной (опечатки, разный регистр/написание).

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

Это поля списков значений

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

[Ревью] Решено, спасибо за уточнение — «Класс судна» и «Флаг» являются полями списка значений (не свободный текст), что обеспечивает надёжную фильтрацию.

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

[Ревью] РЕШЕНО — можно удалить. Подтверждено, что «Класс судна» и «Флаг» — поля списка значений, вопрос закрыт.

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

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

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

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

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

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

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

[Ревью] РЕШЕНО — можно удалить. Расхождение ролей (Порты: Агент+Исполнитель; Суда: только Агент) закреплено как осознанное решение на странице решений.

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

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

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

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

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

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

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

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

К странице

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

[Ревью] Критично, MVP. Для поля «ИМО | IMO» (сценарии «Создать новое судно» INSP-UC-VSS-003 и «Изменить характеристики судна» INSP-UC-VSS-004) не указан формат/длина значения — номер ИМО должен состоять из 7 цифр — и алгоритм проверки контрольной цифры (checksum). Без этого нельзя реализовать корректную валидацию поля.

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

[Ревью] Пока актуально: формат/длина поля «ИМО | IMO» (7 цифр) и алгоритм проверки контрольной цифры в сценариях INSP-UC-VSS-003/004 по-прежнему не описаны.