---

[I128-2777] Единый модуль обращений VirtualRef вместо IrbHelp

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.3 >> [I128-2777] Единый модуль обращений VirtualRef вместо IrbHelp📄 Скачать в DOCX

---

Тип	Версия	Статус	Приоритет	Исполнитель
⚙️ Новые возможности	2026.3	🔘 Завершено	Средний	Ilya Mikhaylenko

Компоненты: ИРБИС 128. Модуль VirtualRef - Виртуальная справка

Завершено: 24.08.2026 15:19

Ценность Пользователь и сотрудник библиографической справки работают с единым сервисом на базе VirtualRef без выбора между IrbHelp и VirtualRef. Вопросы обрабатываются по логике, близкой к Jira: у каждого вопроса есть проект, человекочитаемый ключ, статус, ответственный, наблюдатели и история изменений. С точки зрения ИРБИС 128 проект VirtualRef является профилем обслуживания: он задает ключ, права доступа, workflow, нумерацию и рабочие списки. Все пользовательские и рабочие сценарии IrbHelp сводятся в VirtualRef; IrbHelp не остается отдельным модулем или совместимым слоем.

Сценарий

• администратор настраивает проекты/профили обслуживания VirtualRef: у каждого проекта есть уникальный мнемонический ключ по аналогии с Jira, название, права доступа и рабочая статусная модель;
• статусная модель/workflow определяет начальный статус, рабочие и финальные статусы, разрешенные переходы, права на переходы и связанные уведомления;
• пользователь задает вопрос через VirtualRef; если ему доступен ровно один активный проект/профиль, он выбирается автоматически и отдельный выбор пользователю не показывается;
• если пользователю доступно несколько проектов/профилей, при создании вопроса он выбирает, к какому проекту относится вопрос;
• вопросы нумеруются внутри проекта по порядку и адресуются по ключу проекта и номеру, например BIB1, BIB2;
• сотрудник видит вопросы в рабочих списках VirtualRef с фильтрами по проекту/профилю, статусу, ответственному, наблюдателям и другим рабочим признакам;
• действие "Взять в работу" назначает текущего сотрудника ответственным, но не скрывает вопрос от других сотрудников и не удаляет его из общих списков;
• ответственный сотрудник может быть изменен другим разрешенным действием workflow;
• у вопроса есть список наблюдателей, которые могут отслеживать вопрос и получать связанные уведомления без назначения ответственными;
• сотрудник выполняет разрешенные переходы workflow: отвечает, возвращает в работу, завершает, отклоняет или переводит вопрос в другой предусмотренный статус;
• пользователь видит свои вопросы, ответы, переписку, вложения, проект/профиль, ключ вопроса, статус, ответственного сотрудника, наблюдателей и историю значимых изменений;
• административная точка входа библиографической справки ведет в VirtualRef;
• отдельные страницы, actions, ссылки и записи IrbHelp заменяются сценариями VirtualRef.

Терминология Внутренняя сущность называется проектом VirtualRef, потому что она дает Jira-like ключ и нумерацию вопросов. В пользовательском интерфейсе ее можно называть профилем, направлением или службой, если это лучше соответствует конкретной установке ИРБИС 128. Независимо от отображаемого названия эта сущность должна сохранять проектный ключ, права доступа, workflow и счетчик вопросов.

Совместимость Старые ссылки IrbHelp/*, совместимые обертки и редиректы не поддерживаются. Обратная совместимость IrbHelp не требуется.

Записи SUPPORT/MESSAGES сейчас нигде не используются, поэтому миграция, совместимое чтение и сохранение этих записей не входят в обязательный scope задачи.

Существующие сценарии VirtualRef для виртуальной справки не должны ломаться без явного решения в этой задаче. Если для проектов/профилей или workflow потребуются отдельные конфигурационные сущности или модули, они должны быть связаны с VirtualRef и не должны создавать второй пользовательский сервис вместо VirtualRef. Настройки, права, системные страницы и Help-документация для библиографической справки должны быть переведены на VirtualRef.

-

Задача I1282759 расширяет DP*Irbis64Native контрактами конкурентной записи, пакетной обработки и объявления возможностей провайдера. PR предназначен для develop, содержит доставленную зависимость I1282746 и только изменения DP*Irbis64Native.

Куда смотреть:

• В интерфейсе изменений не видно. Техническая точка: API провайдера DP_Irbis64Native, методы GetCapabilities, DeleteRecIfVersion, ReorganizeExcludeDeleted, импорт, сортировка и пакетное обновление записей. Эффект: вызывающий модуль может определить возможности провайдера, выполнять условную запись/удаление и безопасно обрабатывать конкурентные изменения БД. Chrome: не подтверждено, потому что изменение относится к внутреннему провайдеру данных.
• Настройки для сценария: новые настройки не требуются; используются существующие PAR-файлы и параметры нативной БД.
• Help: Help не применим: пользовательский и административный интерфейс не меняются.
• Для PRволны: ветка уже содержит текущий develop и mergedзависимость I1282746; можно переключаться прямо на PRветку.

Изменения по файлам:

modules/DP_Irbis64Native/Tests/Contracts/DatabaseWriteAtomicityContract.php

• Проверяет атомарность записи и откат при ошибках.

modules/DP_Irbis64Native/Tests/Contracts/DatabaseWriteConcurrencyContract.php

• Проверяет конкурентную запись и контроль версий.

modules/DP_Irbis64Native/Tests/Contracts/MstAutoExtendContract.php

• Новый файл. Проверяет автоматическое расширение MST при записи за текущей границей файла.

modules/DP_Irbis64Native/Tests/NativeTestSupport.php

• Добавляет вспомогательные операции для новых контрактных сценариев.

modules/DP*Irbis64Native/*_call/DeleteRecIfVersion.inc

• Новый файл. Удаляет запись только при совпадении ожидаемой версии.

modules/DP*Irbis64Native/*_call/GetCapabilities.inc

• Новый файл. Возвращает поддерживаемые провайдером операции и контракты.

modules/DP*Irbis64Native/*_call/GetTermList.inc

• Усиливает обработку границ и ошибок чтения терминов.

modules/DP*Irbis64Native/*_call/ImportFromFile.inc

• Согласует импорт с блокировками и жизненным циклом БД.

modules/DP*Irbis64Native/*_call/RecIfUpdateAll.inc

• Поддерживает контролируемое пакетное обновление записей.

modules/DP*Irbis64Native/*_call/ReorganizeExcludeDeleted.inc

• Новый файл. Выполняет нативную реорганизацию без физически удалённых записей.

modules/DP*Irbis64Native/*_call/SortMfnByPref.inc

• Делает сортировку MFN устойчивой к граничным данным.

modules/DP*Irbis64Native/*_call/prvGetDbCtx.inc

• Формирует согласованный контекст нативной БД для операций провайдера.

modules/DP_Irbis64Native/api.php

• Публикует новые capability и version-aware контракты.

modules/DP_Irbis64Native/include/IrbisDatabaseLock.php

• Расширяет управление блокировкой БД для конкурентных операций.

modules/DP_Irbis64Native/include/IrbisDbLifecycle.php

• Координирует открытие, запись, реорганизацию и закрытие БД.

modules/DP_Irbis64Native/include/IrbisSpaceNative.php

• Поддерживает новые операции нативного пространства данных.

modules/DP_Irbis64Native/include/MstFile.php

• Добавляет безопасное расширение и контроль границ MST.

modules/DP_Irbis64Native/include/MstSpace.php

• Согласует размещение записей с обновлённым MST-контрактом.

modules/DP_Irbis64Native/include/N01File.php

• Усиливает проверки структуры и границ N01.

modules/DP_Irbis64Native/include/XrfFile.php

• Согласует XRF-ссылки и версии записей при конкурентной записи.

-

1. Что сделано

• Переведен сценарий библиографической справки на единый модуль обращений VirtualRef.

• Добавлены проекты, статусы и переходы workflow как управляемые записи с правами.

• Вопросы получили ключ, тему, статус, ответственного, наблюдателей и историю изменений.

• Действия над вопросом перенесены на страницу просмотра вопроса; ответ редактируется отдельной формой с ссылками, библиографией, связями с ЭК и файлами.

• Списки вопросов приведены к компактному dashboard/table-виду; карточка просмотра вопроса приведена к единому плотному layout.

  1. Проверка

• php ~~l по измененным PHP~~like файлам modules/VirtualRef.

• git diff --check.

• Проверены страницы ?id=VirtualRef/Ask, ?id=VirtualRef/ShowWorker, ?id=VirtualRef/ShowUser, ?id=VirtualRef/ShowFAQ, ?id=VirtualRef/ShowQuestion.

• Проверены workflow-confirm, форма VirtualRef/EditAnswer, обзор workflow и порядок блоков в карточке вопроса.

-

I1282777 для release/2026.2: восстанавливает рабочий процесс заявок IrbHelp, который используется downstreamзадачей [IBK-470](https://jira.irbis128.ru/browse/IBK-470) для сервиса "Библиографическая справка". PR возвращает уведомления, рабочие кнопки обработки и прямой вход сотрудников в обработку заявок.

Куда смотреть:

• Сценарий в системе: пользователь создает заявку через ?id=IrbHelp/Ask, сотрудник с ролью SITESPEC/IRWORKER открывает ?id=IrbHelp/ShowWorker, принимает или поручает заявку, затем отклоняет или завершает ее. Пользователь видит заявку в ?id=IrbHelp/ShowUser и может отменить активную заявку или оценить завершенную.
• Было: заявка сохранялась без уведомлений, кнопки списков вызывали отсутствующие JS-функции, часть действий могла падать на пустой записи или некорректном условии supCreatorEmail != '', модуль был скрыт из admin panel.
• Стало: уведомления отправляются при создании, назначении, изменении статуса и новом сообщении; добавлен irbHelpBtnActions.js; server actions проверяют запись и права; IrbHelp/ShowWorker регистрируется как системная страница для IRWORKER; модуль виден в admin panel.
• Настройки для сценария: для уведомления сотрудников должен быть заполнен общий параметр SupportMail; для обработки нужна роль SITESPEC/IRWORKER.
• Chrome/email: полный UI/email сценарий локально не подтвержден, потому что нет гарантированно настроенной почты и тестовых данных SUPPORT; выполнены статические и синтаксические проверки.
• Help: обновлен modules/IrbHelp/Help/Workflow.md, добавлено описание уведомлений и SupportMail.
• Downstream: PR блокирует [IBK-470](https://jira.irbis128.ru/browse/IBK-470). После merge source branch может быть удалена; для возврата в IBK нужно брать final commit/diff из target branch release/2026.2.

Изменения по файлам:

modules/IrbHelp/api.php

• Модуль больше не скрывается из admin panel.
• Добавлены helpers для заголовка заявки, ссылок на пользовательскую/рабочую карточку, e-mail пользователя и отправки уведомлений.
• Добавлены уведомления о создании, назначении и изменении статуса заявки.

modules/IrbHelp/Pages/Ask.page

• Удален диагностический вывод перед header().
• Приветственный текст выводится только при показе формы, а не при submit.
• После сохранения заявки отправляются уведомления.
• Абсолютный redirect заменен на относительный ?id=IrbHelp/ShowUser.

modules/IrbHelp/__call/CreateMessage.inc

• Уведомление автору обращения при новом сообщении переведено на общий helper.
• Добавлены проверки существования заявки и пользователя; устранено ошибочное условие без $.

modules/IrbHelp/Actions/SetResponsible.inc

• Добавлена проверка роли SITESPEC/IRWORKER, существования заявки и уведомление о назначении.

modules/IrbHelp/Actions/SetSupportStatus.inc

• Добавлена проверка роли SITESPEC/IRWORKER, допустимых статусов, существования заявки и уведомление об изменении статуса.

modules/IrbHelp/Actions/UnlinkUser.inc

• Отмена разрешена автору обращения или IRWORKER; после отмены отправляется уведомление.

modules/IrbHelp/Actions/RateSupport.inc

• Добавлена проверка рейтинга 1..5, существования заявки и права автора на оценку.

modules/Templates/IRCONS/templates/js/irbHelpBtnActions.js

• Добавлены функции TakeResponsibility, PutResponsibility, SetStatusDone, CancelSupport, DeleteRecord, RateSupport.

modules/IrbHelp/Formats/bodyview.pft128

• Кнопка отмененного обращения больше не вызывает назначение исполнителя.
• Для активных заявок добавлена кнопка отклонения.

modules/IrbHelp/Formats/bodyviewUser.pft128

• Отмена доступна только для активных заявок.

modules/Admin/__call/EnsurePages.inc

• Добавлена системная страница IrbHelp/ShowWorker с правом VIEW для SITESPEC/IRWORKER.

modules/IrbHelp/Help/Workflow.md

• Описаны уведомления, SupportMail и действия обработки заявки.

Проверки:

• C:\i128\php\php.exe -l для измененных PHP/page/inc/pft128 файлов.
• node --check modules\Templates\IRCONS\templates\js\irbHelpBtnActions.js.
• git diff --check.

1. Связанные задачи

1.1. 🔗 blocks: IBK-470