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


INSP-UC-MAIN-001




Главная для Агента

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

Релиз: MVP

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

Для каждой роли должна быть реализована отдельная Главная страница, где должна храниться максимально-необходимая информация и функционал

Точки входа:

  1. Главная

Предусловия

  1. Пользователь открыл Главную
  2. Роль пользователя = Агент

Приоритет:

Высокий (1)

Роли: 

Агент - далее Пользователь

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

  1. Пользователь открывает Главную
  2. Система💬 отображает главную страницу с функциональными разделами:
    1. Мои заявки💬 → (реестр заявок) INSP-UC-APP-001 (по умолчанию сортировка от новых к старым, пагинация по 10)
      1. Статусы - все
      2. Отображение по вкладкам + счетчик кол-ва заявок во вкладке
      3. Автор заявки = Пользователь
    2. Реестр Исполнителей → INSP-UC-CNTR-001
    3. Уведомления (колокольчик)💬 → INSP-UC-NTF-004
      1. Изменения в Заявке, где Пользователь является создателем
  3. Завершение сценария

Расширение:

2a. Отображение реестра Заявок
Реестр заявок отображается по вкладкам:

  • Ожидает назначение: статусы - Черновик, Возвращено💬 
  • Ожидает подтверждение: статусы - Ожидается подтверждение, 
  • Ожидает начала работ: статусы - Запланировано
  • В работе: статусы - Выполнение работ
  • Завершенные: статусы - Исполнено, Отменено

В каждой вкладке отображается счетчик кол-ва заявок во вкладке

  

2b. Перейти в Заявку
- Пользователь может открыть карточку Заявки INSP-UC-APP-007


2c. Фильтры, сортировка, поиск в реестре Заявок

  • Пользователь может настроить фильтрацию реестра заявок INSP-UC-APP-003
  • Пользователь может выполнить поиск заявки в реестре INSP-UC-APP-004
  • Пользователь может сортировать реестр Заявок INSP-UC-APP-002


2d. Не данных
- Если нет данных для отображения в виджете, то отображается сообщение "Нет данных"


2e. Ошибка загрузки
- При возникновении ошибки загрузки данных отображается сообщение "Произошла ошибка, попробуйте обновить страницу"


Примечание:

Цель Агента - видеть все свои заявки и их статус


INSP-UC-MAIN-002


Главная для Исполнителя

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

Релиз: MVP

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

Для каждой роли должна быть реализована отдельная Главная страница, где должна храниться максимально-необходимая информация и функционал

Точки входа:

  1. Главная

Предусловия

  1. Пользователь открыл Главную
  2. Роль пользователя = Исполнитель

Приоритет:

Высокий (1)

Роли: 

Исполнитель - далее Пользователь

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

  1. Пользователь открывает Главную
  2. Система отображает главную страницу с функциональными разделами:
    1. Мои заявки → INSP-UC-APP-001:
      1. Статусы: Ожидается подтверждение, Запланировано, Выполнение работ, Исполнено, Отменено
      2. Отображение по вкладкам + счетчик кол-ва заявок во вкладке
      3. Исполнитель Заявки = Пользователь
    2. Уведомления (колокольчик) → INSP-UC-NTF-004
      1. Изменения в Заявке, где Пользователь является Исполнителем
  3. Завершение сценария

Расширение:

2a. Отображение реестра Заявок
Реестр заявок отображается по вкладкам:

  • Ожидает подтверждение: статусы - Ожидается подтверждение, 
  • Ожидает начала работ: статусы - Запланировано
  • В работе: статусы - Выполнение работ
  • Завершенные: статусы - Исполнено, Отменено
  • Отклонены: статусы - Возвращено

В каждой вкладке отображается счетчик кол-ва заявок во вкладке


2b. Перейти в Заявку
- Пользователь может открыть карточку Заявки INSP-UC-APP-007


2c. Фильтры, сортировка, поиск в реестре Заявок

  • Пользователь может настроить фильтрацию реестра заявок INSP-UC-APP-003
  • Пользователь может выполнить поиск заявки в реестре INSP-UC-APP-004
  • Пользователь может сортировать реестр Заявок INSP-UC-APP-002


2d. Не данных
- Если нет данных для отображения в виджете, то отображается сообщение "Нет данных"


2e. Ошибка загрузки
- При возникновении ошибки загрузки данных отображается сообщение "Произошла ошибка, попробуйте обновить страницу"

Примечание:

Цель Исполнителя - получить и выполнить заявку


INSP-UC-MAIN-004


Главная для Администрации порта

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

Релиз: MVP

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

Для каждой роли должна быть реализована отдельная Главная страница, где должна храниться максимально-необходимая информация и функционал

Точки входа:

  1. Главная

Предусловия

  1. Пользователь открыл Главную
  2. Роль пользователя = Администрация порта

Приоритет:

Высокий (1)

Роли: 

Администрация порта - далее Пользователь

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

  1. Пользователь открывает Главную
  2. Система отображает главную страницу с функциональными разделами:
    1. Заявки на осмотр→ INSP-UC-APP-001:
      1. Статусы - Ожидается подтверждение, Запланировано, Выполнение работ, Исполнено, Отменено
      2. Отображение по вкладкам + счетчик кол-ва заявок во вкладке
      3. Исполнитель Заявки - все
      4. Автор Заявки - все
    2. Реестр Исполнителей → INSP-UC-CNTR-001
    3. Реестр Агентов → INSP-UC-AGNT-002
    4. Уведомления (колокольчик)💬 → INSP-UC-NTF-004
      1. Заявки, перешедшие в статус "Исполнено"
    5. Статистика за периоды: за день, календарную неделю, текущий календарный месяц <название месяца>, прошлый календарный месяц <название месяца>
      1. По всем заявкам  
        1. Кол-во выполненных заявок - общее кол-во всех заявок, в разрезе периода, в статусах in [Исполнено]
        2. Кол-во отмененных заявок - общее кол-во всех заявок, в разрезе периода, в статусах in [Отменено]
        3. Кол-во невыполненных заявок - общее кол-во всех заявок, в разрезе периода, в статусах in [Ожидается подтверждение, Запланировано, Выполнение работ]
      2. По заявкам в разрезе Агентов (Наименование Агента - строка)💬
        1. Кол-во выполненных заявок - общее кол-во всех заявок, в разрезе периода и Агента, в статусах in [Исполнено]
        2. Кол-во отмененных заявок - общее кол-во всех заявок, в разрезе периода и Агента, в статусах in [Отменено]
        3. Кол-во невыполненных заявок - общее кол-во всех заявок, в разрезе периода и Агента, в статусах in [Ожидается подтверждение, Запланировано, Выполнение работ]
      3. По заявкам в разрезе Исполнителей (Наименование Исполнителя - строка)
        1. Кол-во выполненных заявок - общее кол-во всех заявок, в разрезе периода и Исполнителя, в статусах in [Исполнено]
        2. Кол-во отмененных заявок - общее кол-во всех заявок, в разрезе периода и Исполнителя, в статусах in [Отменено]
        3. Кол-во невыполненных заявок - общее кол-во всех заявок, в разрезе периода и Исполнителя, в статусах in [Ожидается подтверждение, Запланировано, Выполнение работ]
  3. Завершение сценария

Расширение:

2a. Отображение реестра Заявок
Реестр заявок отображается по вкладкам:

  • Ожидает подтверждения: статусы - Ожидается подтверждение, 
  • Ожидает начала работ: статусы - Запланировано
  • В работе: статусы - Выполнение работ
  • Завершенные: статусы - Исполнено, Отменено
  • Отклонены: статусы - Возвращено

В каждой вкладке отображается счетчик кол-ва заявок во вкладке


2b. Перейти в Заявку
- Пользователь может открыть карточку Заявки INSP-UC-APP-007


2c. Фильтры, сортировка, поиск в реестре Заявок

  • Пользователь может настроить фильтрацию реестра заявок INSP-UC-APP-003
  • Пользователь может выполнить поиск заявки в реестре INSP-UC-APP-004
  • Пользователь может сортировать реестр Заявок INSP-UC-APP-002


2d. Не данных
- Если нет данных для отображения в виджете, то отображается сообщение "Нет данных"


2e. Ошибка загрузки
- При возникновении ошибки загрузки данных отображается сообщение "Произошла ошибка, попробуйте обновить страницу"

Примечание:

Цель Администрации порта - видеть и контролировать все заявки на осмотр, получать статистику по осмотрам


  

INSP-UC-MAIN-003


Главная для Службы контроля

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

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

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

Точки входа:

  1. Главная

Предусловия

  1. Пользователь открыл Главную
  2. Роль пользователя = Служба контроля

Приоритет:

Высокий (1)

Роли: 

Служба контроля - далее Пользователь💬

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

  1. Пользователь открывает Главную
  2. Система отображает главную страницу с функциональными разделами:
    1. Заявки на осмотр
    2. Заявки на регистрацию Исполнителя в Системе
    3. Уведомления
    4. Статистика
  3. Завершение сценария

Расширение:

2a. Перейти в Заявку
- Пользователь может открыть карточку Заявки UC-APP-007


2c. Настроить отображаемые данные статистики
2c.1 Пользователь может настроить детали дашбордов
2c.2 Система сохраняет настройки для текущего пользователя до следующих изменений


2d. Фильтры, сортировка, поиск в реестре Заявок

  • Пользователь может настроить фильтрацию реестра заявок UC-APP-003
  • Пользователь может выполнить поиск заявки в реестре UC-APP-004
  • Пользователь может сортировать реестр Заявок UC-APP-002

Примечание:

Дашборды и уведомления могут добавляться в будущих доработках системы

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

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

Софья Герасимова · 2026-09-04 12:07 МСК · фрагмент удалён · к фрагменту · 73074427
«2d. Фильтры, сортировка, поиск в реестре Исполнителей»

в MVP не будет

Софья Герасимова · 2026-09-04 12:12 МСК · фрагмент удалён · к фрагменту · 73074429
«Кол-во невыполненных заявок - общее кол-во всех заявок, в разрезе периода и Агента, в статусах in [Ожидает планирования, Запланировано, Выполнение работ]»

За прошлый месяц - должен быть слепок

Софья Герасимова · 2026-09-04 12:14 МСК · решён · к фрагменту · 73074431
«Система»

Добавить минимальную статистику по МОИМ заявкам

Софья Герасимова · 2026-09-04 12:16 МСК · фрагмент удалён · к фрагменту · 73074433
«все»

кроме черновика

Софья Герасимова · 2026-09-04 12:17 МСК · решён · к фрагменту · 73074435
«Уведомления (колокольчик)»

Только о завершении осмотров по заявке

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

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

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

[Ревью] Решено, спасибо — роль в сценарии «Главная для Службы контроля» исправлена на «Служба контроля».

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

[Ревью] РЕШЕНО — можно удалить. Роль в сценарии «Главная для Службы контроля» исправлена на «Служба контроля».

claude-code · 2026-09-15 09:18 МСК · фрагмент удалён · к фрагменту · 73075108
«Поиск исполнителя»

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

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

[Ревью] Решено, спасибо — упоминание статуса «Поиск исполнителя» убрано из раздела Службы контроля, расхождение снято.

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

[Ревью] РЕШЕНО — можно удалить. Упоминание статуса «Поиск исполнителя» убрано, расхождение статусов снято.

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

[Ревью] Желательно, MVP. Во вкладке «Ожидает назначение» для Агента объединены статусы «Черновик» (заявка ещё не отправлена, редактируется автором) и «Возвращено» (заявка была отклонена/возвращена после рассмотрения) — это концептуально разные состояния жизненного цикла заявки. Нужно подтвердить, что объединение в одну вкладку — осознанное UX-решение, а не недосмотр, и что пользователю будет понятно, почему заявки с разным смыслом статуса показаны вместе.

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

осознанное решение

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

[Ревью] Решено, спасибо за подтверждение — объединение «Черновик»+«Возвращено» во вкладке «Ожидает назначение» осознанное решение, вопросов нет.

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

[Ревью] РЕШЕНО — можно удалить. Подтверждено, что объединение статусов «Черновик»+«Возвращено» во вкладке — осознанное UX-решение.

claude-code · 2026-09-15 09:18 МСК · фрагмент удалён · к фрагменту · 73075112
«???»

[Ревью] Желательно, После MVP. Пункт «Статистика → 1. ???» — незаполненный плейсхолдер вместо содержимого. Нужно раскрыть, какие именно метрики/дашборды должна видеть Служба контроля.

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

[Ревью] Решено, спасибо — плейсхолдер «???» убран из пункта «Статистика».

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

[Ревью] РЕШЕНО — можно удалить. Плейсхолдер «???» в пункте «Статистика» убран.

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

[Ревью] Желательно, MVP. Для виджета «Мои заявки» не указан лимит отображаемых записей на странице/во вкладке, наличие пагинации (или бесконечная подгрузка) и сортировка по умолчанию (например, по дате создания/обновления). Это нужно для проектирования UI и производительности запроса.

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

добавила

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

[Ревью] Решено, спасибо — добавлено «по умолчанию сортировка от новых к старым, пагинация по 10» для виджета «Мои заявки».

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

[Ревью] РЕШЕНО — можно удалить. Пагинация (по 10) и сортировка по умолчанию для виджета «Мои заявки» добавлены.

claude-code · 2026-09-15 09:18 МСК · решён · к фрагменту · 73075116
«Уведомления (колокольчик)»

[Ревью] Критично, MVP. Для виджета «Уведомления» (колокольчик) не описано: как визуально/логически различаются прочитанные и непрочитанные уведомления, как считается счётчик непрочитанных, и обновляются ли уведомления в реальном времени (push/WebSocket) или только при обновлении страницы/по интервалу опроса (polling). Это существенно влияет на архитектуру (нужен ли WebSocket-канал) и должно быть решено до разработки MVP.

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

Визуально - если пользователь нажал на кнопку “прочитано” - то данное уведомление больше не отображается в колокольчике. Это описано в сценарии INSP-UC-NTF-006

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

[Ревью] Уточнение внесено, но остался вопрос: спасибо за пояснение визуального поведения (уведомление пропадает из колокольчика после «прочитано», см. INSP-UC-NTF-006). Однако механизм обновления в реальном времени (push/WebSocket) vs. опрос/обновление страницы по-прежнему не указан — важно для архитектурного решения перед разработкой MVP.

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

[Ревью] Раунд 3. Пока актуально — механизм обновления уведомлений в реальном времени (push/WebSocket) vs. опрос/обновление страницы (polling) по-прежнему не указан. Новое решение (стр. 73075569) этот вопрос не затрагивает — требуется отдельное архитектурное решение перед разработкой MVP.

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

[Ревью] Пока актуально: механизм обновления уведомлений в реальном времени (push/WebSocket) vs. опрос/обновление страницы (polling) по-прежнему не указан на странице. Требуется отдельное архитектурное решение перед разработкой MVP.

claude-code · 2026-09-15 09:18 МСК · решён · к фрагменту · 73075118
«По заявкам от конкретного Агента (Наименование Агента - строка)»

[Ревью] Желательно, После MVP. Для статистического среза «по конкретному Агенту/Исполнителю» не указано, как именно пользователь выбирает конкретного Агента/Исполнителя (поиск по строке, выпадающий список, автокомплит), и обновляются ли цифры статистики в реальном времени при изменении данных или пересчитываются по расписанию/при обновлении страницы.

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

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

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

[Ревью] Уточнение внесено, но остался вопрос: спасибо, периодичность обновления статистики (раз в 10 минут) и формат (таблица) зафиксированы. Способ выбора конкретного Агента/Исполнителя (поиск/выпадающий список/автокомплит) пока не описан.

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

[Ревью] Уточнение внесено частично: периодичность обновления статистики (раз в 10 минут) и формат (таблица) зафиксированы — спасибо. Способ выбора конкретного Агента/Исполнителя в срезе статистики (поиск/выпадающий список/автокомплит) пока не описан.

К странице

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

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

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

добавила

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

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