Распознавание и обработка документов

DreamOCR SDK

Программный комплект для интеграции распознавания и обработки документов в прикладные и серверные информационные системы.

ООО «АПЭРБОТ» · ИНН 5032312072 · ОГРН 1195081074924

Функциональные характеристики DreamOCR SDK

Редакция от 16 ноября 2026 года. ООО «АПЭРБОТ».

DreamOCR SDK предназначен для встраивания распознавания и обработки идентификационных, регистрационных, финансово-хозяйственных, юридических, кадровых и иных документов в прикладные и серверные информационные системы. Программа преобразует изображения документов в структурированные поля и результаты проверок для дальнейшей обработки вызывающим приложением.

Назначение и пользователи

SDK используется разработчиками интеграций, операторами систем обработки документов и администраторами серверного распознавания. Тип документа выбирается при вызове соответствующего модуля. Состав поставки и версии модулей фиксируются в спецификации выпуска.

Группы распознаваемых документов

ГруппаДанные и функции
Идентификационные и регистрационные документыРаспознавание персональных реквизитов, реквизитов документов и регистрационных отметок, обработка машиночитаемых зон.
Финансово-хозяйственные документыИзвлечение реквизитов первичных, расчётных и бухгалтерских документов, обработка табличных данных.
Юридические и кадровые документыИзвлечение реквизитов организаций, регистрационных сведений и значимых полей юридических и кадровых документов.
Дополнительная обработкаЧтение машиночитаемых кодов, проверка форматов и согласованности распознанных реквизитов.

Основные функции

Приём изображения документа и подготовка данных для распознавания: приведение формата, обработка ориентации и формирование входа выбранного модуля. Поддерживаемые входные форматы определяются документацией соответствующего модуля.

Поиск областей документа, распознавание символов, извлечение полей, обработка машиночитаемых зон, нормализация значений и проверка взаимосвязанных реквизитов. Для поддерживаемых первичных документов формируются результаты распознавания табличной части.

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

Интерфейсы и результаты

Модули предоставляют командные и программные интерфейсы. Результаты передаются в JSON; пакетные инструменты сохраняют JSONL и сопутствующие отчёты.

Основная среда серверной поставки - Linux x86-64. Вычисления выполняются на узле запуска соответствующего модуля. Прикладной графический интерфейс для работы SDK не требуется.

Правообладатель и сопровождение

ООО «АПЭРБОТ», ИНН 5032312072, ОГРН 1195081074924. По вопросам поставки, интеграции и сопровождения: sales@aprbot.com.

Техническое описание DreamOCR SDK

Редакция от 16 ноября 2026 года. ООО «АПЭРБОТ».

Документ описывает устройство модульной серверной поставки DreamOCR SDK, взаимодействие компонентов и представление результатов распознавания. Каждый модуль выполняет определённый маршрут обработки документов и включается в спецификацию поставки с указанием версии.

Архитектура и поток данных

Вызывающая система передаёт изображение и выбирает модуль обработки. Входной слой читает поддерживаемый файл и выполняет подготовку изображения. Вычислительный модуль определяет необходимые области, распознаёт реквизиты и применяет постобработку. Выходной слой формирует поля, результаты проверок и сведения об ошибке для вызывающей системы.

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

Состав вычислительного модуля

КомпонентНазначение
Исполняемый кодОбработка изображения, запуск вычислений, извлечение полей и формирование результата
Модели и ресурсыПараметры распознавания, описания областей документа, словари и настройки постобработки
Обвязка запускаПодготовка окружения, выбор профиля, запуск процесса и обработка кода возврата
Инструменты контроляПроверка состава выпуска, сравнение результатов и формирование отчётов

Паспортные модули

Распознавание паспорта РФ формирует структурированные поля документа. Обработка регистрационных отметок, заграничных и иностранных паспортов выполняется отдельными маршрутами с собственной схемой выходных реквизитов.

Первичные документы и таблицы

Маршруты первичных документов формируют реквизиты шапки и участников операции. Поддерживаемые табличные маршруты возвращают найденную структуру, текст и значения ячеек, а также координаты соответствующих областей. Названия и набор полей определяются схемой выбранного документа.

Разделение данных и параметров

Каталог выпуска отделяется от входных изображений и результатов. Оператор задаёт права доступа к файлам, срок хранения и порядок удаления обработанных документов в соответствии с назначением своей информационной системы.

Жизненный цикл и сопровождение DreamOCR SDK

Редакция от 10 ноября 2026 года. ООО «АПЭРБОТ».

ООО «АПЭРБОТ» организует разработку и сопровождение DreamOCR SDK: изменение программного кода, управление комплектами моделей, проверку выпусков, устранение ошибок и поддержку интеграций. Документ определяет порядок подготовки и сопровождения модульной серверной поставки.

Разработка и управление изменениями

Изменения регистрируются по задаче с указанием затронутого модуля и ожидаемого результата. Исходные тексты ведутся в системе контроля версий. Код, ресурсы моделей и настройки выпуска идентифицируются раздельно; изменение любого из них учитывается при подготовке новой версии модуля.

Для изменения определяются требования, способ реализации и контрольный сценарий. Выполняются разработка, ревью, сборка и проверка результата. Изменение схемы полей или API сопровождается описанием совместимости и необходимых действий в интеграции.

Проверка выпуска

Проверяется запуск из подготовленного комплекта, доступность необходимых ресурсов, обработка поддерживаемого входа и корректное сообщение об ошибке. Для распознавания контролируются состав полей, форматы значений и табличный результат. Для серверного адаптера проверяется полный цикл запроса и получение результата.

Регрессионная проверка проводится на закреплённых контрольных примерах. Результаты сохраняются с привязкой к версии кода, конфигурации и ресурсам моделей. Комплект выпуска сопровождается перечнем файлов и контрольными суммами.

Выпуск и обновление

Рабочие выпуски отделяются от экспериментальных сборок. В поставку включаются выбранные модули, необходимые ресурсы, инструкция запуска, документация и лицензионные уведомления компонентов. Входные документы, пользовательские результаты и параметры доступа не включаются в общий комплект выпуска.

Обновление разворачивается в отдельном каталоге и проходит контрольную проверку до переключения рабочей интеграции. Предыдущая версия сохраняется для возврата. При обновлении проверяется совместимость выходных полей, конфигурации и зависимостей.

Устранение неисправностей

Обращение содержит версию модуля, описание окружения, последовательность действий, ожидаемый и фактический результат и диагностические сообщения. Для воспроизведения используется согласованный пример с соблюдением требований к защите передаваемых данных. По результатам анализа готовится исправление или порядок настройки, выполняется контрольная проверка и сообщается результат заявителю.

Персонал сопровождения

РольНеобходимые компетенции и функции
АрхитекторАрхитектура Rust/Python-компонентов, интерфейсы, ревью и совместимость выпусков
РазработчикОбработка изображений, интеграция моделей, постобработка полей, исправление программного кода
Инженер сопровожденияРазвёртывание в Linux, диагностика, конфигурация, сбор контрольных материалов и проверка интеграции

Функции могут совмещаться специалистами команды. Организацию сопровождения и распределение задач обеспечивает руководитель ООО «АПЭРБОТ». Канал обращений по поставке, интеграции и сопровождению: sales@aprbot.com. Условия обслуживания определяются договором поставки и сопровождения.

Стоимость и условия поставки DreamOCR SDK

Редакция от 16 ноября 2026 года. ООО «АПЭРБОТ».

DreamOCR SDK предоставляется на платной основе. Стоимость рассчитывается индивидуально и указывается в коммерческом предложении ООО «АПЭРБОТ».

Получение расчёта стоимости

Для получения расчёта направьте запрос на sales@aprbot.com. В запросе укажите требуемый состав модулей, сценарий интеграции, предполагаемый объём обработки документов и контактные данные для подготовки предложения.

Оформление поставки

Состав поставки, предоставляемые права использования, стоимость, условия оплаты и сопровождения определяются договором с ООО «АПЭРБОТ».

Правообладатель и поставщик: ООО «АПЭРБОТ», ИНН 5032312072, ОГРН 1195081074924. Контакт по поставке и расчёту стоимости: sales@aprbot.com.

Инструкция по установке и эксплуатации DreamOCR SDK

Редакция от 17 ноября 2026 года. ООО «АПЭРБОТ».

DreamOCR SDK поставляется комплектами программных модулей для Linux x86-64. Дистрибутив содержит исполняемые программы, необходимые модели и ресурсы, файлы конфигурации и инструменты проверки целостности. Распознавание выполняется на компьютере, на котором установлен выбранный модуль.

1. Системные требования

Linux x86-64; glibc версии 2.35 или новее; Python версии 3.11 или новее; системные библиотеки libc, libm и libgcc_s. Для модуля банковских карт требуется libstdc++. Для паспортного модуля, регистрационных отметок и водительских удостоверений необходимы утилиты nice, ps и strace. Графическая оболочка для работы SDK не требуется.

2. Комплекты поставки

Идентификационные документы: паспорт РФ, регистрационные отметки, водительское удостоверение.

DreamOCR_SDK_Identity_Linux_x86_64_20261116.tar.gz

Первичные, юридические и кадровые документы, иностранные паспорта, СНИЛС, ИНН и банковские карты.

DreamOCR_SDK_Documents_Linux_x86_64_20261117_r2.tar.gz

QR-коды, линейные и двумерные штрихкоды.

DreamOCR_SDK_Barcodes_Linux_x86_64_20261117.tar.gz

3. Распаковка

Поместите полученные архивы в отдельный каталог. В примере используется каталог dreamocr-sdk в домашнем каталоге пользователя. Выполните команды из каталога с архивами:

tar -xzf DreamOCR_SDK_Identity_Linux_x86_64_20261116.tar.gz
tar -xzf DreamOCR_SDK_Documents_Linux_x86_64_20261117_r2.tar.gz
tar -xzf DreamOCR_SDK_Barcodes_Linux_x86_64_20261117.tar.gz

Каталоги выпуска сохраняйте отдельно от входных изображений и результатов. Не изменяйте файлы моделей и конфигурации внутри распакованного комплекта.

4. Проверка целостности

Из каталога с распакованными комплектами выполните:

cd DreamOCR_SDK_Documents_Linux_x86_64_20261117_r2
python3 dreamocr_documents.py verify
cd ..
cd DreamOCR_SDK_Barcodes_Linux_x86_64_20261117
python3 dreamocr_barcodes.py verify
cd ..

Успешная проверка возвращает JSON с verified: true. Для идентификационного комплекта перейдите в соответствующий подкаталог modules и выполните проверку выбранного модуля:

МодульКоманда проверки
passportpython3 -c "import run_dataset; run_dataset.verify()"
registration./run_dataset.sh --verify-only
driver./run_dataset.sh --verify-only

5. Подготовка входных данных

Создайте каталог inputs рядом с каталогами выпусков и поместите в него изображения. Для примеров ниже используйте одностраничное PNG-изображение document.png соответствующего типа. Имена файлов без расширения в одном задании должны быть уникальны. Каталог результатов должен быть новым и находиться вне каталога выпуска и входных данных.

6. Выбор документного модуля

Параметр --moduleНазначение
primaryПервичные, расчётные, бухгалтерские и строительные документы
legalЮридические и регистрационные документы организаций
foreignЗаграничные и иностранные идентификационные документы
militaryВоенные билеты
employmentТрудовые книжки
snilsСтраховые свидетельства
innСвидетельства ИНН физических лиц
bankcardБанковские карты

7. Распознавание документов

Перейдите в каталог документного комплекта. Пример обработки первичного документа:

python3 dreamocr_documents.py recognize --module primary \
  --output ../results-primary ../inputs/document.png

Для другого вида документа замените значение --module. Можно передать несколько изображений в одном вызове. Модуль snils принимает PNG; входные файлы модуля inn должны находиться в одном каталоге.

primary и legal сохраняют результаты в подкаталог rows. snils и inn сохраняют JSON по каждому изображению. foreign, military, employment и bankcard записывают результаты в results.jsonl. run.json содержит сведения о запуске и коды возврата, stderr.txt - диагностические сообщения. В ответах паспортных и кадровых маршрутов docs содержит распознанные поля основного документа, documents - результаты дополнительных документов.

8. Паспорт РФ, регистрация и водительские удостоверения

Задайте абсолютный путь к рабочему каталогу. Перейдите в подкаталог modules/passport, modules/registration либо modules/driver идентификационного комплекта. Запустите:

WORK="$HOME/dreamocr-sdk"
./run_dataset.sh "$WORK/inputs" "$WORK/results-identity" 1

Используйте изображения, соответствующие выбранному модулю. Результаты записываются в results.jsonl и report.json. Если проверяются несколько модулей последовательно, для каждого укажите отдельный новый каталог результатов.

9. Машиночитаемые коды

Перейдите в каталог комплекта штрихкодов. Пример чтения QR-кода из PNG-изображения:

python3 dreamocr_barcodes.py recognize --format qr \
  --output ../results-qr ../inputs/document.png

Значение all проверяет все поставляемые семейства. Доступны qr, linear, datamatrix, pdf417, aztec, microqr, rmqr и micropdf417. Для каждого выбранного семейства создаётся отдельный JSONL-файл. Входные форматы - PNG и JPEG.

10. Контроль результата и сопровождение

Проверьте код возврата, наличие файлов результата, тип распознанного документа и значения его полей. Отсутствие поддерживаемого документа или кода на изображении может давать пустой результат. При ошибке чтения файла, отсутствии ресурса или нарушении целостности устраните указанную причину и повторите запуск в новый каталог. По вопросам установки и интеграции: sales@aprbot.com. Правообладатель: ООО «АПЭРБОТ», ИНН 5032312072, ОГРН 1195081074924.