200 изменений в версии DOC-V 8.5.10: визуализация ЭЦП в PDF, подсказки по настройке и многое другое

DOC-V 8.5.10 — одна из самых насыщенных версий ветки 8.5: в неё вошло больше двухсот изменений сервера и интерфейса. DOC-V теперь сам подсказывает администратору, что поправить в настройках сервера, подписывает PDF в формате PAdES с видимым штампом, отдаёт выборки документов внешним системам по REST, а ИИ-администратор научился настраивать действия любого типа.

Ниже — главное по разделам. В конце статьи собрано, что стоит проверить перед обновлением: часть изменений меняет привычное поведение.

🩺 Рекомендации по настройке: DOC-V подсказывает, что поправить на сервере

Производительность DOC-V во многом зависит от настроек сервера базы данных, которые после установки часто остаются заводскими. Теперь DOC-V проверяет их сам. В панели администрирования появилась страница «Рекомендации по настройке», а на стартовой странице администратора — одноимённая строка в блоке «Состояние системы».

• Что проверяется: пул буферов InnoDB, пул соединений DOC-V с базой, лимит соединений сервера БД и сборка библиотеки KalkanCrypt.
• Что видно в рекомендации: что не так, что сделать и ориентир именно для этой машины — с учётом объёма данных и памяти сервера.
• Решение за администратором: сами настройки DOC-V не меняет. Рекомендацию можно принять к сведению или проверить снова после изменений.
• Без лишних писем: о новой рекомендации администратор получает письмо один раз.

⚙️ Параметры сервера — на странице «Настройки»

Раньше большинство параметров сервера задавалось только в файле doc-v.conf, и для каждой правки нужен был доступ к серверу. В 8.5.10 их можно менять в панели администрирования:

• Новая вкладка «Параметры сервера»: уведомления администратору, обслуживание, ход работы, REST, перенос и импорт.
• Параметры файлов и пользователей — на вкладках «Файлы» и «Пользователь». Всего на странице 30 параметров.
• Файл главнее: если ключ вписан в doc-v.conf, на странице он показывается недоступным полем, чтобы было видно, откуда берётся значение.
• Остаются в файле параметры даты и времени, электронной подписи и ИИ.
• ИИ-администратор видит и меняет эти параметры тоже.

🤖 ИИ-администратор настраивает действия любого типа

В ИИ-администраторе появился полный каталог действий DOC-V. Раньше он заводил действия только готовыми поведениями, теперь — любое из 31 типа:

• Действия точек маршрута, кнопки точек и журналов, а также действия в описании нового типа документа он заводит и меняет сам.
• Объясняет ручную настройку любого действия — по вкладкам и панелям формы, если администратор хочет сделать всё сам.
• Рискованные действия — только с согласия: «Доступ», «Запуск», HTTP-запрос, почту, Telegram, «Удаление», «Архивацию» и «Импорт» ИИ-администратор заводит, только когда администратор это подтвердит.

✍️ Электронная подпись: PAdES, штампы и несколько файлов разом

Самый большой блок изменений версии. Подпись в формате PAdES встраивается прямо в PDF: документ открывается в обычном просмотрщике PDF вместе с видимым штампом подписи, отдельный файл подписи не нужен.

NCALayer (Казахстан)

• Все файлы поля — одним вводом пароля.
• Формат PAdES: подпись в PDF, штамп по стандартному или своему шаблону, метка времени документа.
• Вкладки «Штамп» и «Колонтитул» в настройках действия: где стоит штамп, колонтитул на страницах, вид.
• Окно подписи не зависает: оно закрывается при ошибке NCALayer и при обрыве соединения.

КриптоПро (Россия)

• PAdES с видимой подписью и стандартным штампом по ГОСТ Р 7.0.97-2016 (ИНН, СНИЛС, ОГРН, должность).
• Несколько файлов — одним выбором сертификата. Выбор сертификата запоминается.
• Совместная открепленная подпись и подпись добавлением в существующий файл подписи — для документов, которые подписывают несколько человек.
• Открепленная подпись ключом ГОСТ 2012-512, плагин находится в новых версиях Chrome, ошибки плагина видны пользователю.

QR-подписание ЭЦП через eGov

• PAdES со штампом — так же, как в NCALayer.
• Несколько файлов — одним подтверждением в eGov Mobile или eGov Business.

Проверка подписи через Kalkan

• Каждая подпись проверяется отдельно. Сертификат подписанта должен быть выпущен НУЦ РК и действовать на момент подписи.
• Отзыв сертификата проверяется по OCSP НУЦ РК — по умолчанию включено. Серверу нужен доступ к http://ocsp.pki.gov.kz; выключить проверку можно параметром [Network] KalkanOCSP = off.
• Понятный результат: при неудачной проверке ИИН, БИН и роли очищаются, чтобы условия маршрута не увидели данные прежней подписи. Причины отказа — на языке установки, в JSON-результате есть статус и коды отказов.
• Надёжность библиотеки: версия KalkanCrypt пишется в журнал при запуске, а одновременные первые проверки после старта больше не приводят к сбою.

И ещё о скорости: подпись PAdES файла в 20 МБ теперь занимает около секунды вместо ~33 секунд.

🖥️ DOC-V Desktop: приложение для Windows и Linux

У DOC-V появилось настольное приложение. На Windows и Linux профиль пользователя предлагает установить его вместо PWA: кнопка «Установить DOC-V Desktop» даёт установщик для Windows, пакет .deb для Debian, Ubuntu и Astra Linux или AppImage для других дистрибутивов. При первом запуске приложение спрашивает адрес сервера DOC-V.

• Вкладки, как в браузере. Ctrl+T, Ctrl+W, Ctrl+Tab, перетаскивание; ссылки на документы открываются вкладкой рядом с исходной. Заголовок вкладки — название документа или пункта меню, а после перезапуска вкладки восстанавливаются.
• Привычное меню DOC-V на странице. Окно без системной рамки: строка вкладок окрашивается в цвет темы DOC-V, под ней — обычное меню.
• Счётчик уведомлений на значке приложения, в трее и в заголовке окна. Крестик прячет окно в трей — уведомления продолжают приходить.
• Понятный экран вместо белого окна, если связи нет: приложение объясняет, что случилось — нет сети, сервер не отвечает, проблема с сертификатом, — и само переподключается, когда сервер снова доступен.
• Несколько серверов: при смене сервера вкладки прежнего сохраняются и открываются снова, когда вы к нему вернётесь.
• Обновляется само: новая версия скачивается в фоне и ставится по кнопке «Обновить» или при следующем запуске.
• Обновления с сервера организации. Сервер DOC-V один раз скачивает установщики и раздаёт их приложениям по локальной сети — это работает и в закрытом контуре. Для сервера без интернета есть скрипты, которые готовят файлы обновлений на другом компьютере.

Полностью приложение раскрывается с DOC-V 8.5.10. Со старыми версиями сервера оно тоже работает, но меню DOC-V открывается кнопкой «☰» в строке вкладок, а у вкладок нет названий.

📱 Интерфейс: прокрутка, телефон и значки

• Подгрузка страниц прокруткой. Дошли до конца строк журнала — следующая страница подгружается сама, пагинатор переходит на её номер. Нужна конкретная страница — нажмите её номер. Так же листаются «Таблица документов», «Коллекция документов», поле «Таблица», «Ход работы», удалённые документы и журнал исходящих сообщений.
• Журнал на телефоне: компактные строки на телефоне и планшете, номера страниц в пагинаторе, вкладки видов не прокручиваются вбок — не поместившиеся собраны в «Ещё N». Меню, профиль и колокольчик на телефоне тоже стали аккуратнее.
• Окно выбора значка: около 4 200 значков вместо ~2 000, поиск по-русски, категории, «Недавние» и «Используются». Шрифт значков при этом стал в 10 раз легче — 323 КБ вместо 3,2 МБ.
• Эмодзи для точек маршрута выбираются в том же окне и выглядят одинаково в Windows, Android, Linux и на устройствах Apple.
• Поиск по уведомлениям в колокольчике — по новым и просмотренным.
• Новый вид профиля: плавающие кнопки ИИ можно убрать — вместо них останется пункт в меню профиля. В PWA и DOC-V Desktop появился пункт «Скопировать ссылку».
• Мелочи, которые экономят время: «Выбрать все» со счётчиком над карточками журнала, смена группы кнопок прямо из списка кнопок, «Мониторинг» на стартовой странице разворачивается на всё окно.

🧭 Маршруты: «Исполнители текущей точки», схема и проверка

• Переменная «Исполнители текущей точки» — исполнители той точки, где документ стоит сейчас. Работает в делегировании кнопок, «Доступе», «Записи», «Сообщении», условиях, колонках, стилях и пользовательских фильтрах журналов. Например, одна кнопка «Согласовать» на все точки маршрута или фильтр журнала «ждут меня».
• Схема маршрута: в редакторе маршрута есть переключатель «Схема / Список» и наложение «где поле пишут и читают».
• Проверка маршрута находит переходы в несуществующие и чужие точки, бесконечные циклы и недостижимые точки — до того, как на них наткнутся пользователи.
• Вкладка «Использование» деревом: «тип → точка → строки», у каждой строки видно, пишет она поле или читает; есть поиск и фильтры.
• Читаемые описания: в описаниях «Записи», «Условия», «Повтора» и фильтров вместо УИДов показываются названия документов. У вложенных действий в «Условии», «Повторе» и «Контроле» можно оставить комментарий.

🔌 REST API: выборка документов и честные коды ответов

• Режим «Выборка документов». GET-запрос отдаёт JSON со списком документов, подходящих под условия; документ обработки при этом не создаётся. Права — пользователя ключа или сервиса, до 1 000 документов за запрос, дальше — через offset.
• Действие «Выборка» от имени пользователя отбирает только документы, доступные указанному пользователю.
• Отказы приходят с кодом HTTP: 400 — нет параметра или некорректный JSON, 401 — нет ключа, 403 — IP не в списке, 422 — значение уникального поля уже есть или ошибка сохранения, 500 — сбой. Текст в теле ответа прежний.
• Ключ в заголовке: X-API-Key или Authorization: Bearer. Настройка «Ключ только в заголовке» запрещает передавать ключ в адресе, а сам ключ больше не попадает открытым текстом в журналы.
• Защита от сканеров: обращение по адресу с точкой (.env, .git/…) блокирует IP-адрес сразу, без порога.

🛡️ Надёжность записи данных

• Сохранения не ждут повторов записи другого типа: задержка сократилась с секунд до микросекунд.
• Ход работы и пересчёт коллекций записываются и при постоянной высокой нагрузке, а ход работы не пропадает из-за одной длинной записи.
• Ошибка в данных одной строки не отменяет весь пакет значений полей. Текст в неверной кодировке (например, ответ в windows-1251) больше не останавливает запись, а HTTP-запрос сам переводит ответ в UTF-8.
• «Скрытое» поле с шифрованием хранит до 8 192 символов.
• «Использование» типа и журнала учитывает задачи планировщика, системные настройки и действия — тип, на который они ссылаются, не удалится как неиспользуемый.
• Копии действий и журналов получают свои внутренние идентификаторы и больше не делят форму с оригиналом.
• «Регистрация» с номером «наибольший + 1» сразу освобождает номера удалённых документов.

⚠️ Перед обновлением: что изменилось в поведении

sha256sum lib/libkalkancryptwr-64.so

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

• REST: отказы приходят с кодом HTTP, а не 200. Если внешняя система ориентируется только на текст ответа, включите переключатель «Отказы REST с кодом 200» — он вернёт прежнее поведение. Обязательный параметр без привязанного поля теперь тоже проверяется.
• Поле «Целое число» больше не вырезает запятую: «100,12» → 100 (раньше было 10012), «1.000.000» → 1000000.
• Действие «ЭЦП (ЕСЭДО)» удалено: обновление убирает его из настроек, кнопки с ним остаются кнопками перехода.
• Фоновый режим не прячет результат: действия, которые показывают что-то пользователю (HTTP-запрос «в браузере», импорт с выбором файла, удаление текущего документа, создание из кнопки и др.), выполняются на переднем плане. У NCALayer и КриптоПро «Фоновый режим» всегда выключен.
• После удаления текущего документа действия ниже в блоке и в точке не выполняются.
• «Повтор» заканчивается на итерации, где документ переведён в другую точку, — перевод больше не теряется.
• «Пустое значение не сравнивается» в новых «Условиях»: с пустым искомым ложны «содержится в», «содержит», «начинается с», «заканчивается на» и их отрицания. Старые «Условия» работают как раньше; перевести их на новый режим можно флажком.
• Действие «ИИ» повторяет запрос при сбое, а при неудаче очищает поле результата — старый ответ больше не попадает в документ.
• DOC-V Desktop: сервер скачивает установщики приложения для раздачи, если активных учётных записей 10 и больше. Отключается параметром [Desktop] UpdateMirror.

💡 Как обновиться до DOC-V 8.5.10?

Обновление бесплатное: обновления платформы и купленных модулей бесплатны, ежегодной подписки на Software Maintenance нет. 8.5 — основная ветка разработки DOC-V: новые возможности, включая ИИ-ассистента и ИИ-администратора, появляются в ней. Стабильная ветка — DOC-V 8.4.

Для обновления запустите задачу планировщика ↗ на сервере DOC-V. Если появятся вопросы, обратитесь в техническую поддержку ↗.