---

[I128-2258] Новый редактор записей ИРБИС (he3)

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.2 >> [I128-2258] Новый редактор записей ИРБИС (he3)📄 Скачать в DOCX

---

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

Компоненты: ИРБИС 128. Модуль he3 - Табличная форма ввода данных, Комплексное решение АБИС ИРБИС64/128

Завершено: 08.06.2026 12:48

Модуль he3 - Современный Web-редактор записей ИРБИС64 (на базе технологии WS)

ИДЕОЛОГИЯ И АРХИТЕКТУРНЫЕ ЦЕЛИ:

1. Чистое API и разделение слоев (Separation of Concerns):    - Бэкенд (PHP) не генерирует JS-код или HTML (отказ от паттернов he2).    - Модуль работает как API: отдает строгий JSON (UI Schema и данные записи) и принимает JSON для сохранения.    - Фронтенд (ExtJS 3) читает схему и динамически строит интерфейс на клиенте.

2. Единый источник истины (Single Source of Truth) - рабочие листы:    - Полный отказ от дублирующей системы FieldTypes (.field файлов).    - Все формы ввода строятся исключительно на основе файлов конфигурации ИРБИС (.ws / .wss).    - Специфичный Web-функционал (WYSIWYG, File Upload) реализуется через выделение пула       пользовательских InMode (зарезервирован диапазон 128000-128999). Это сохраняет 100% совместимость       с десктопным АРМ Каталогизатор, который игнорирует неизвестные методы ввода.

3. Плоский (табличный) интерфейс ИРБИС:    - Замена перегруженного древовидного редактора со "спойлерами" на классический вид.    - Общая компоновка (Border Layout):       Сверху (North) — панель инструментов (сохранение, ФЛК, добавление полей).       По центру (Center) — рабочая область, разделенная на вкладки согласно конфигурации WS.         На каждой вкладке располагается своя плоская таблица (грид) с полями записи.      * Снизу (South) — панель предпросмотра редактируемой записи с выбором формата просмотра.    - Гибкая механика редактирования (по Enter или двойному клику): в зависимости от настроек       может открываться вспомогательный инструмент (например, модальное окно редактора подполей       по WSS) либо предоставляться возможность прямого inline-редактирования склеенной строки поля.    - Автоматическая синхронизация повторений полей между вкладками и умная разбивка       многострочного текста (textarea) на повторяющиеся поля на лету.

4. Строгая структура директорий модуля:    - classes/ - вспомогательные PHPклассы (парсеры, DTO, бизнеслогика).    - JS/ - JS-компоненты фронтенда (ExtJS).    - Actions/ - классы обработки API-запросов (endpoints).

5. Агностичность UIсхемы (FrameworkAgnostic):    - Генерируемый JSON Schema не должен содержать привязок к ExtJS (никаких xtype или layout).    - Только семантическое описание: тип данных, правила валидации, семантика виджета (например, "dictionary", "file").

6. Безопасность данных и UX:    - Оптимистичные блокировки (Optimistic Locking) для предотвращения затирания данных при параллельном редактировании.    - Поддержка восстановления из LocalStorage при обрыве связи (Автосохранение).    - Локальная история изменений (Стек состояний Undo/Redo) для безопасной отмены (Ctrl+Z)       и повтора (Ctrl+Y) пользовательских действий с автоматической синхронизацией черновика.

7. Производительность (Lazy Loading):    - Ленивая подгрузка больших справочников (.mnu, .tre) и связанных записей только по мере необходимости (поиск/скроллинг).

8. Двухуровневая валидация (ФЛК):    - Правила из WS валидируются на лету в браузере (клиент) и строго проверяются в API при сохранении (сервер).

9. Принцип единой ответственности (SRP) и делегирование:    - Модуль he3 выступает только оркестратором. Вся низкоуровневая работа со специфичными структурами       данных делегируется профильным модулям (парсинг .ws -> в модуль WS, чтение .tre -> в модуль Tre и т.д.).

10. Строгая типизация (DTO) и унифицированный контракт API:    - Отказ от неструктурированных массивов. Внутренний обмен данными использует типизированные DTO.    - Все API-ответы оборачиваются в единый конверт (например, {success: bool, data: mixed, message: string}).    - Централизованный перехват исключений (Exception Handling) на уровне Actions.

11. Серверные черновики (Drafts) и отсутствие сессионного состояния:    - Сервер не хранит промежуточное состояние формы в оперативной памяти (сессиях PHP).    - При начале редактирования создается временная копия записи (Черновик) в выделенной БД (например, DRAFTS).    - Клиент взаимодействует с API, передавая ID черновика (DraftID) и изменения (дельты).    - Это обеспечивает надежное автосохранение, защиту от потери данных при обрыве связи и решает       проблему передачи тяжеловесных бинарных полей при каждом запросе предпросмотра/ФЛК.    - Бизнеслогика преобразования (WS -> UI Schema) должна быть изолирована и покрыта Unitтестами.

12. Непрерывная документация (DocsasCode):    - Документация является неотъемлемой частью кодовой базы (папка Help).    - Обязательный минимум:       Root.help - структура и оглавление.       General.md - общее описание модуля и архитектуры.       UserGuide.md - руководство пользователя (в т.ч. навигация с клавиатуры).       AdminGuide.md - справочник администратора (расширенные InMode, настройка WSS, структура DopInf).

13. UX профессионального ввода (Keyboard-First):    - Обеспечение высокой скорости работы библиографа за счет полной поддержки навигации с клавиатуры       (Tab, Enter, стрелки) по гридам и модальным окнам.     - Поддержка привычных горячих клавиш (F2 - средства ввода, и т.д.).

14. Расширяемость (Plugin Architecture):    - Модуль he3 должен предоставлять API для регистрации сторонних виджетов. Другие модули системы       должны иметь возможность добавлять свои обработчики пользовательских InMode без изменения кода ядра he3.

15. Локализация (i18n):    - Все системные сообщения, тексты ошибок валидации и элементы интерфейса должны использовать       механизмы интернационализации ИРБИС 128.      (Внимание: в текущей реализации требуется вынос захардкоженных строк в языковые файлы системы).

16. Синхронизация состояния и предпросмотр:    - Фронтенд использует единое хранилище состояния (Store) для редактируемой записи.    - Изменения в Store синхронизируются с серверным черновиком в фоне (Debounce-сохранение).    - Эндпоинты предпросмотра и проверки ФЛК оперируют исключительно серверным черновиком. Фронтенд       просто отправляет команду "Отформатируй черновик DraftID", минимизируя сетевой трафик.

 

-

• feat(he3): добавлен модуль he3 — современный Web-редактор записей ИРБИС64

  Начата реализация нового модуля he3, представляющий собой современный табличный (плоский) редактор записей, построенный на базе API-first подхода и строгой привязки к конфигурациям рабочих листов (.ws / .wss).

  Основные нововведения и архитектурные решения:

  • Архитектура API и схемы: Бэкенд отделен от генерации UI. Добавлен WsParser, который на лету преобразует файлы рабочих листов в строгие DTO (FormSchema, TabSchema, FieldSchema) для динамического построения интерфейса на клиенте.
  • Серверные черновики (Drafts): Реализован DraftService, использующий SQLite (he3_drafts) для безопасного автосохранения, работы с оптимистичными блокировками и защиты от потери данных.
  • Фронтенд ядро (ExtJS): Добавлен he3.core.js с табличным интерфейсом, нативной историей состояний (Undo/Redo), двухуровневой валидацией (ФЛК) и полноценной поддержкой горячих клавиш (Keyboard-First).
  • Расширяемая система виджетов: Внедрена Plugin-архитектура для методов ввода (InMode). Реализованы модальные окна и виджеты для:
    • Словарей и иерархических справочников (.mnu, .tre)
    • Тематического рубрикатора (ГРНТИ) и Авторитетных файлов
    • Тезауруса (с поиском по фрагменту и древовидным рядом)
    • Редактирования подполей (динамические и статические WSS)
    • Загрузки локальных файлов и серверного файлового менеджера
    • Генерации контента с помощью ИИ (ИРБИС-ИИ)
  • Стили и ресурсы: В ExtJS/resources добавлены новые SVGиконки для интерфейса редактора и обновлен cssфайл irballnotheme.css. Модуль WIrbis обновлен для подключения новых JS-файлов.
  • Документация (DocsasCode): В папку Help добавлены подробные руководства для пользователя и администратора. (В разработке)

• Интеграция нового редактора he3 в модуль Каталогизатор

  • Настройки модуля: В конфигурацию Cataloguer (ApplyGeneralVariablesConfig.inc) добавлена настройка editorType, позволяющая администратору переключаться между классическим редактором (he2) и современным (he3). Переменная передается на клиентскую сторону через Show.inc.
  • Динамический вызов редактора: Изменены клиентские скрипты irbisc.js и irbisreclist128.js. Теперь действия двойного клика по гриду, а также кнопки "Создать" и "Редактировать" в тулбаре динамически определяют нужный action (he2/GetSidEditor или he3/GetSidEditor) в зависимости от текущих настроек пользователя.
  • Серверные экшены he3: Добавлены новые файлы GetSidEditor.inc и GetSidEditorNew.inc в модуль he3 для обработки запросов на открытие окна редактора.
  • Оконный режим he3:
    • Базовый компонент редактора Irbis.he3.Editor в he3.core.js переведен с Ext.Viewport на Ext.Panel, что позволяет встраивать его в другие контейнеры.
    • Создана новая модальная обертка Irbis.he3.EditorWindow, которая отвечает за показ редактора he3 в диалоговом окне.
    • Добавлена логика автоматического закрытия окна при успешном сохранении записи (CommitDraft) и последующего обновления связанного грида в интерфейсе АРМ.

• Добавление настройки формата предпросмотра, кнопки печати и улучшение рендеринга записей в редакторе he3

  Настройки и интерфейс АРМ Каталогизатор:

  • В конфигурацию модуля Cataloguer добавлена новая настройка recEditPft («Формат просмотра в редакторе») со значением по умолчанию full.
  • Обеспечена передача параметра recEditPft (или irbPft) по цепочке вызовов: от глобальных настроек АРМа до кнопок создания/редактирования записей (в списках записей, панелях вкладок и мониторе ссылок) и инициализации окна редактора Irbis.he3.EditorWindow.

  Редактор he3 (Frontend):

  • В панель предпросмотра записи добавлен выпадающий список для выбора формата расформатирования (WIrbis.PftSelector).
  • В тулбар панели предпросмотра добавлена кнопка «Печать» (выводит текущий HTML предпросмотра в новое окно для печати браузером).
  • Улучшена верстка таблицы редактирования полей: столбцы «Метка», «Поле» и «Повт.» теперь имеют фиксированную ширину (fixed: true), а для таблицы включен режим forceFit: true.
  • Доработан метод refreshPreview: теперь он использует формат из селектора (или переданный по умолчанию irbPft), а также добавлены надежные проверки и обработка ошибок при получении некорректного ответа от сервера (включая обработку сетевых ошибок).
  • Инициализация данных редактора и предпросмотра при открытии окна сделана с небольшой задержкой (defer), чтобы PftSelector успел корректно загрузить свой store.

  Редактор he3 (Backend):

  • Синхронизация кэша: В экшене InitDraft добавлено сохранение данных черновика в системный кэш записи (EditorDatacontent, EditorDatamfn) через SidSave(). Это необходимо для корректной работы системного расформатирования в режиме редактирования.
  • Предпросмотр (PreviewDraft):
    • Улучшена логика применения значений по умолчанию из рабочих листов (WS) перед расформатированием.
    • Исправлена обработка форматов: теперь корректно обрабатываются системные форматы (ALL, brief, full, @).
    • Для системных форматов при вызове Format128 теперь передается флаг array('modeEditor' => 'edit'), чтобы i128f брал данные из кэша редактирования.
    • Добавлена постобработка результатов форматирования: удаление RTFтегов (\b0, \b, \par, \tab и фигурных скобок), которые часто возвращает ИРБИС в режиме редактирования, и применение BBCodes.

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

1.1. 🔗 blocks: I128-31

1.2. 🔗 blocks: I128-46

1.3. 🔗 blocks: I128-47

1.4. 🔗 blocks: I128-48

1.5. 🔗 blocks: I128-49

1.6. 🔗 blocks: I128-50

1.7. 🔗 blocks: I128-52

1.8. 🔗 blocks: I128-104

1.9. 🔗 Соответствует задача: I128-2395