Обзор Teedy: хранение, поиск и обработка документов на своём сервере
Teedy относится не к PDF-ридерам, а к серверным системам управления документами: в нём файлы загружают в общую библиотеку, снабжают метаданными и тегами, распознают для полнотекстового поиска, разграничивают права и проводят через рабочие процессы. Такое позиционирование важно для правильной оценки продукта. Teedy способен хранить PDF рядом с офисными файлами и изображениями, но его задача — не править содержимое страницы как в PDF-редакторе, а сделать корпоративный или личный архив управляемым и доступным через браузер.
| Параметр | Актуальное состояние |
|---|---|
| Разработчик и проект | Sismics, открытый upstream sismics/docs; прежнее название — Sismics Docs |
| Тип | Веб-система управления документами, self-hosted и облачный сервис Teedy |
| Последняя стабильная версия upstream | 1.11; официальный Docker-образ закрепляется тегом sismics/docs:v1.11 |
| Ключевые функции | OCR, полнотекстовый поиск, метаданные Dublin Core, теги, версии файлов, права, workflow, аудит, REST API и webhooks |
| Развёртывание | Docker либо WAR на Java-сервере приложений; PostgreSQL рекомендован для production |
| Лицензия | GNU GPL 2.0 для открытой self-hosted версии |
| Русский язык | Русский присутствует в списке поддерживаемых языков интерфейса |
| Главное ограничение на 2026 год | Стабильный релиз 1.11 старый, а для него опубликованы актуальные записи об уязвимостях; публичное развёртывание требует отдельной оценки риска |
Скачать Teedy
Новейшая версия для Виндовс, macOS и Линукс. Удобный редактор PDF под российские реалии.
Безопасная точка получения self-hosted Teedy — официальный репозиторий Sismics и его раздел Releases. Для обычного развёртывания проект предлагает готовый Docker-образ, а для классического Java-развёртывания — WAR-пакет. В текущем README стабильным обозначен образ sismics/docs:v1.11. Тег latest связан с master-веткой, которую сами разработчики называют потенциально нестабильной и не рекомендуют для production, поэтому подмена закреплённой версии на latest ради «самого нового» кода повышает риск несовместимости.
Для самостоятельной сборки доступен исходный код. Этот путь нужен прежде всего разработчикам и администраторам, которые готовы сопровождать Java-приложение и его зависимости. Сборка требует JDK 11, Maven 3, NPM, Grunt и Tesseract 4. Пользователю, которому нужен просто рабочий архив документов, обычно рациональнее исходить из Docker Compose: в официальном образе уже есть средства OCR и обработки медиаданных, а данные можно вынести в постоянные тома.
Что такое Teedy
Teedy — открытая система управления документами от Sismics, ранее известная как Sismics Docs. Проект рассчитан на частных пользователей и организации, которым нужен единый индексируемый архив с контролем доступа, версиями, действиями пользователей и автоматизацией. В отличие от файловой папки Teedy хранит не только сам файл, но и контекст: название, описание, дату, язык, теги, стандартные поля Dublin Core, пользовательские метаданные, права и историю действий.
Текущий статус требует оговорки. Репозиторий не архивирован, в 2026 году в нём появляются новые issues, а milestone 1.12 остаётся открытым без даты выпуска. При этом последним официально помеченным стабильным релизом upstream остаётся 1.11 от 12 марта 2023 года. Это означает не «снятие с поддержки», а заметно медленный цикл стабильных релизов. Для новой инсталляции возраст версии нельзя игнорировать при оценке библиотек, Java-окружения и безопасности.
Параллельно Sismics предлагает облачный Teedy. На официальной странице заявлены шифрование AES-256 и хранение облачных данных во французских дата-центрах, а также 30-дневная пробная регистрация без кредитной карты. Это другой эксплуатационный сценарий: self-hosted даёт контроль над сервером и местом хранения, облачный вариант снимает с пользователя часть администрирования. Их не следует смешивать с независимыми форками Teedy, которые могут иметь собственные версии и дополнительные механизмы аутентификации.
Основные функции Teedy
OCR и полнотекстовый поиск
Одна из центральных функций — поиск не только по заголовкам и тегам, но и по содержимому поддерживаемых файлов. Для изображений и сканированных документов применяется OCR, а официальный Docker-образ включает средства распознавания. Поиск поддерживает подсказки и подсветку совпадений; в истории версий отдельно отмечены wildcard-поиск, поиск по типу файла и точный поиск по заголовку. Практическая ценность этой модели проявляется в архивах, где имя файла вроде scan_00421.pdf ничего не говорит, но внутри есть номер договора, фамилия или сумма.

OCR не превращает Teedy в специализированный редактор распознанного текста. Результат нужен прежде всего для индекса и поиска. Качество зависит от исходного скана и языковых данных Tesseract, поэтому для архивов с критичными номерами, суммами или кодами полезно проверять найденный текст по изображению документа, а не использовать распознавание как единственный источник юридически значимых данных.
Метаданные и иерархические теги
Teedy поддерживает поля Dublin Core и пользовательские метаданные. Это позволяет отделить структуру архива от имён файлов: например, договор можно описать контрагентом, типом, датой, источником и внутренним идентификатором, а затем отфильтровать документы по этим признакам. Теги умеют образовывать вложенную структуру, поэтому их можно использовать как тематическую классификацию, не перемещая физические файлы между папками.

Версии, workflow и совместная работа
Для файлов предусмотрено версионирование. Обновлённый файл можно связать с уже существующим документом, сохраняя историю версий, вместо создания несвязанных копий «финал», «финал2» и «последний». Workflow позволяет проводить документ через этапы проверки или подтверждения; при переходах могут выполняться действия. В карточке доступны комментарии и заметки, а журнал аудита фиксирует изменения с привязкой к пользователю и времени.

Эти возможности делают Teedy пригодным для небольших процессов согласования, но не превращают его в универсальную BPM-платформу. Если процесс состоит из десятков ветвей, сложных SLA, внешних подписей и регламентной отчётности, логичнее оценивать специализированный workflow-движок или более тяжёлую EDMS.
Права доступа, 2FA и аудит
Доступ можно выдавать пользователям и группам; поддерживаются иерархические группы и LDAP-аутентификация. Также поддерживается двухфакторная аутентификация. Документ можно расшарить ссылкой человеку без учётной записи, поэтому такие ссылки следует рассматривать как отдельный канал доступа и выдавать только там, где это соответствует политике организации.
Шифрование файлов при хранении заявлено как AES-256. Это защищает иной слой, чем авторизация или транспорт. Даже зашифрованное хранилище не компенсирует слабый пароль, чрезмерные права, ошибочно опубликованный URL или отсутствие HTTPS. Для чувствительных архивов контроль должен сочетать минимальные права, защищённый сетевой периметр, резервные копии и журналирование.
Импорт, API и внешние события
Кроме ручной загрузки, Teedy умеет импортировать EML, сканировать почтовый ящик и автоматически добавлять сообщения, а официальный сайт также указывает импорт из каталога на диске и SMB-ресурса. Для массовой загрузки существует отдельный importer с разовым и сканирующим режимами. REST API даёт программный доступ к системе, а webhooks позволяют уведомлять внешние сервисы о событиях. Это даёт основу для интеграции со сканером, почтовым шлюзом, CRM или внутренним порталом без копирования документов вручную.
Интерфейс и удобство использования
Интерфейс Teedy строится вокруг документа, а не вокруг многоуровневого файлового дерева. Пользователь видит список документов, поиск и классификацию по тегам; в карточке документа сосредоточены файлы, метаданные, workflow, права, активность и комментарии. Такая логика быстрее осваивается, если воспринимать документ как запись каталога с вложенными файлами, а не как один файл в папке.
Официальный проект называет интерфейс адаптивным. Веб-модель удобна для команды: не требуется ставить тяжёлый клиент на каждую рабочую станцию, а одна и та же библиотека открывается с разных устройств через браузер. Обратная сторона — зависимость от доступности сервера и сети. Если сервер Teedy остановлен, локальный браузер не заменит автономный DMS-клиент, даже если сами исходные файлы физически лежат на диске сервера.
Русский язык присутствует в официальном списке значений DOCS_DEFAULT_LANGUAGE и в интерфейсе публичной демонстрации. При этом язык интерфейса и язык OCR — разные настройки: наличие русской локализации не следует автоматически трактовать как гарантию установленного русского набора Tesseract в любом стороннем образе или вручную собранной системе.
Порог освоения умеренный для конечного пользователя и заметно выше для администратора. Загрузка, поиск, теги и комментарии понятны без знания Java. Настройка PostgreSQL, SMTP, LDAP, резервного копирования, HTTPS, обновлений и восстановления уже требует навыков серверного администрирования. Именно эта разница определяет, кому подходит self-hosted: бесплатная лицензия не означает бесплатное сопровождение.
Поддерживаемые форматы и совместимость
В актуальном README явно перечислены изображения, PDF, ODT, DOCX и PPTX, а также видеофайлы. Официальный сайт дополнительно приводит TXT как пример формата, по которому выполняется полнотекстовый поиск. Для электронной почты предусмотрен импорт EML. Формулировка «поддерживается» здесь означает хранение, индексирование, поиск и доступные представления, а не полноценное редактирование исходного офисного документа.
Teedy не является заменой текстовому редактору или верстальной системе. DOCX и ODT разумно править в приложении, которое понимает их структуру, например в LibreOffice, а в Teedy возвращать новую версию файла и сохранять управленческий контекст. Аналогично PDF-функции Teedy ориентированы на архив, просмотр и поиск, а не на покомпонентное изменение страницы.
В истории проекта присутствуют экспорт в PDF и загрузка всех файлов документа в ZIP. Это полезно для передачи набора вложений и выхода из системы, но не следует ожидать универсальной двусторонней конвертации: официальная документация не обещает экспорт DOCX в ODT, PDF в редактируемый офисный формат или сохранение сложной разметки при таких преобразованиях.
Паспорт обратимости операций
| Операция | Что сохраняется | Что проверить перед действием |
|---|---|---|
| Загрузка документа | Файл и карточка с метаданными становятся частью библиотеки | Корректность названия, языка, тегов и прав |
| Добавление новой версии | История версий файла внутри документа | Что загружается именно версия существующего документа, а не новая независимая карточка |
| Экспорт или скачивание | Результат можно открыть вне Teedy; для набора файлов предусмотрен ZIP | Наличие всех вложений и читаемость результата в стороннем ПО |
| Публикация ссылкой | Сам документ остаётся в Teedy, появляется отдельный способ доступа | Кому передана ссылка и не раскрывает ли она больше, чем требуется |
| Удаление инсталляции | Данные сохраняются только если заранее сохранены постоянные каталоги и база | Резервная копия /data, PostgreSQL и конфигурации, а также проверенный экспорт критичных документов |
Производительность и стабильность
Проект заявляет, что Teedy тестировался на коллекции до одного миллиона документов. Это характеристика разработчика, а не независимый бенчмарк и не гарантия одинаковой скорости на любом сервере. Реальная нагрузка определяется числом файлов, размером индекса, сложностью OCR, дисковой подсистемой, количеством параллельных пользователей и внешними импортерами.
Для production README прямо рекомендует PostgreSQL; встроенная H2 предназначена только для тестирования. Это важнее абстрактных советов о количестве памяти: официального минимального объёма RAM или числа ядер для Teedy не опубликовано. При планировании нужно закладывать ресурсы не только на Java-процесс, но и на PostgreSQL, индексирование, Tesseract, создание миниатюр через ffmpeg и извлечение медиаданных. Чем больше сканов без текстового слоя, тем выше доля фоновой обработки.
Стабильность следует оценивать с учётом возраста релиза. Версия 1.11 остаётся официально последней стабильной, в то время как master продолжает развиваться и прямо не рекомендуется разработчиками для production. На 11 сентября 2026 года NVD содержит, в частности, CVE-2025-22963 для Teedy до 1.11 включительно — CSRF-сценарий захвата учётной записи, а также CVE-2026-50885 для v1.11 — некорректный контроль доступа в share-based read endpoints. Эти записи не доказывают компрометацию любой установки, но делают публикацию 1.11 напрямую в Интернет без дополнительного анализа плохой практикой.
Для закрытого архива разумно ограничить сетевой доступ, использовать HTTPS на входе, минимальные ACL и актуальную инфраструктуру, а перед production-развёртыванием проверить состояние upstream, доступные исправления и собственную модель угроз. Если организация требует предсказуемого security lifecycle с регулярными стабильными релизами, этот критерий может перевесить функциональные достоинства Teedy.
Лицензирование и версии
Исходный Teedy распространяется по GNU GPL 2.0. Для self-hosted установки нет лицензионной платы за количество документов или пользователей со стороны открытого проекта: расходы возникают на сервер, хранение, резервные копии, домен, администрирование и возможную поддержку. Условия GPL особенно важны организациям, которые модифицируют и распространяют программу; сам факт внутреннего использования не превращает продукт в подписочный сервис.
В upstream нужно различать стабильный релиз и ветку разработки. Официальный README закрепляет v1.11 как latest stable и отдельно маркирует sismics/docs:latest, собранный из master, как потенциально нестабильный. Milestone 1.12 открыт и на момент проверки имеет 17 закрытых задач из 20 без установленной даты. Поэтому нельзя называть 1.12 выпущенной стабильной редакцией только потому, что такой номер встречается в разработке или на отдельных инсталляциях.
Облачный сервис Teedy лицензируется эксплуатационно иначе: сервер обслуживает Sismics, а официальный сайт предлагает 30-дневный trial без обязательств и без кредитной карты. Публичная посадочная страница не показывает надёжно проверяемую актуальную цену тарифа, поэтому фиксированную сумму в обзор подставлять не следует. Перед коммерческим использованием стоимость и лимиты нужно смотреть в текущем интерфейсе регистрации или у поставщика.
Системные требования
Docker
Официальный контейнер включает OCR и средства медиаконвертации и слушает порт 8080. Постоянные файлы Teedy размещаются в /data, который необходимо вынести в volume или bind mount. Без настройки PostgreSQL приложение использует встроенную H2, но документация разрешает этот вариант только для тестов; для production приведена конфигурация с PostgreSQL. Для корректного формирования внешних ссылок задаётся DOCS_BASE_URL.
Разработчик не публикует минимальные значения CPU, RAM и свободного диска, поэтому универсальные числа вроде «2 ГБ памяти достаточно» были бы выдумкой. Диск рассчитывается по объёму оригиналов, версиям, индексу, базе и резервным копиям. Для сервера с большим потоком сканов полезнее провести нагрузочную проверку на собственном наборе документов, чем ориентироваться на случайную спецификацию из стороннего каталога.
Ручное Java-развёртывание
Для WAR upstream указывает Java 11, Tesseract 4, ffmpeg, mediainfo и сервер веб-приложений вроде Jetty или Tomcat. Если Teedy собирается из исходников, дополнительно требуются JDK 11, Maven 3, NPM и Grunt. Это подтверждённые зависимости; конкретную поддерживаемую комбинацию версии Linux, Windows или macOS официальный README не фиксирует как матрицу сертификации.
Клиентская сторона
Рабочее место использует адаптивный веб-интерфейс. Официальной таблицы минимальных версий Chrome, Firefox, Edge или Safari проект не публикует, поэтому разумный эксплуатационный критерий — современный поддерживаемый браузер и проверка ключевых операций в корпоративной конфигурации. Русский код языка rus доступен как значение интерфейсной локали.
Карта критических зависимостей
| Зависимость | Для чего нужна | Что произойдёт при сбое | Практическая мера |
|---|---|---|---|
| PostgreSQL | Production-база метаданных | Карточки и операции библиотеки становятся недоступны | Регулярная резервная копия и контроль восстановления вместе с /data |
| /data | Постоянные данные Teedy | Потеря или недоступность файловой части | Отдельный постоянный том, права доступа и резервное копирование |
| Tesseract | OCR | Сканированные изображения хуже индексируются по тексту | Проверять установленные языковые данные и очередь обработки |
| ffmpeg и mediainfo | Миниатюры и метаданные видео | Медиафункции работают неполно | Использовать официальный образ либо контролировать версии зависимостей вручную |
| SMTP, IMAP, SMB | Уведомления и автоматический импорт | Основной архив может работать, но соответствующая автоматизация остановится | Разделять сервисные учётные записи и контролировать ошибки импорта |
| DNS, HTTPS и reverse proxy | Безопасный внешний доступ | Ссылки могут вести не туда, а трафик — идти без требуемой защиты | Согласовать DOCS_BASE_URL с реальным внешним адресом и TLS-конфигурацией |
Преимущества и недостатки Teedy
Плюсы и минусы
Self-hosted и открытый код. Организация может держать библиотеку на собственной инфраструктуре и не привязываться к обязательной облачной подписке.
Полноценная DMS-модель. Метаданные, вложенные теги, права, версии файлов, workflow, аудит и комментарии работают вокруг единой карточки документа.
OCR и полнотекстовый поиск. Система ищет по содержимому поддерживаемых файлов, включая сканы после распознавания.
Автоматический импорт. Поддерживаются EML, почтовый ящик, каталог/SMB и отдельный bulk importer.
Интеграции. REST API и webhooks позволяют включить архив в существующие процессы.
Русская локализация. Русский язык присутствует в официальной конфигурации интерфейса.
Минусы
Старый стабильный релиз. Upstream всё ещё считает 1.11 последней стабильной версией, хотя она выпущена в 2023 году.
Актуальные security-риски. Для 1.11 опубликованы записи CVE, что требует осторожности при новом публичном развёртывании.
Администрирование остаётся на владельце. PostgreSQL, резервные копии, TLS, SMTP/IMAP, обновления и мониторинг не исчезают из-за Docker.
Не PDF-редактор. Teedy не предназначен для глубокого изменения содержимого страниц, форм и сложной офисной разметки.
Нет подтверждённых минимальных аппаратных требований. Ресурсы приходится оценивать по собственному объёму и профилю OCR.
Сравнение с аналогами
| Продукт | Основная роль | OCR и поиск | Права, workflow, версии | Развёртывание и акцент |
|---|---|---|---|---|
| Teedy | Веб-DMS общего назначения | OCR и полнотекстовый индекс | Есть ACL, workflow, аудит и версии файлов | Docker/WAR; компактная Java-система, но стабильный upstream-релиз старый |
| Paperless-ngx | Архив входящих бумажных и цифровых документов | Tesseract, PDF/A, полнотекстовый поиск | Метаданные и история; сильный акцент на автоматическое потребление и классификацию | Активно развиваемый self-hosted проект, Docker Compose — основной путь |
| Mayan EDMS | Корпоративная EDMS | OCR, извлечение текста и индексирование | Развитые ACL, workflow, версии, аудит и REST API | Более тяжёлая и масштабируемая платформа; актуальная ветка 4.12 поддерживается в 2026 году |
| Docspell | Органайзер документов для дома и малых/средних групп | Tesseract, полнотекстовый поиск, PDF/PDF-A | Нет версионирования и тонких прав на уровне Teedy; есть общие аккаунты, теги и метаданные | Self-hosted, автоматическое извлечение метаданных, IMAP и REST API |
| Sumatra PDF | Локальный просмотр документов | Не DMS-индекс с серверным OCR | Нет серверных ACL, workflow и библиотеки версий | Лёгкий настольный ридер: рациональнее для быстрого открытия файлов, а не управления архивом |
Teedy стоит выбирать не потому, что он «лучше PDF-просмотрщика», а когда нужна серверная библиотека. Для локального чтения PDF без базы, пользователей и администрирования проще Sumatra PDF или другой ридер, например Okular. Если нужны комментарии и стандартные функции распространённого PDF-клиента, уместно отдельно оценить Adobe Acrobat Reader.
Если главная задача — профессиональное OCR и преобразование сложных сканов, специализированный ABBYY FineReader решает другой класс задач. Для локальных операций вроде сборки, конвертации и печати PDF без развертывания DMS практичнее инструмент наподобие PDF24 Creator. Среди именно self-hosted архивов Paperless-ngx логичнее при поточном сканировании и автоматической классификации, Mayan EDMS — при сложном корпоративном управлении, а Docspell — при метаданных и автоматизации без требования тонкого ACL и версий.
Инструкция по установке
Docker Compose для постоянной инсталляции
1. Подготовьте сервер с Docker и Docker Compose и заранее определите постоянные каталоги для данных Teedy и PostgreSQL. Не храните production-библиотеку только во внутреннем слое контейнера.
2. Возьмите Compose-пример из официального upstream и закрепите образ sismics/docs:v1.11, а не latest. В production используйте PostgreSQL; вариант со встроенной H2 оставьте для короткого теста.
3. Задайте DOCS_BASE_URL так, чтобы он совпадал с реальным адресом пользователей. Если сервер доступен извне, настройте HTTPS через обслуживаемый reverse proxy и ограничьте ненужный сетевой доступ.
4. Настройте постоянный mount для /data и том PostgreSQL. Учётные данные базы и административный пароль не держите в публичном Compose-файле; официальный пример рекомендует переменные окружения или другой способ защищённого хранения секретов.
5. Запустите стек и дождитесь готовности приложения. Первый контроль — доступность страницы входа, соединение с PostgreSQL и отсутствие циклических ошибок в журнале контейнера.
6. Сразу замените стандартный пароль администратора admin, если установка стартовала с ним. До этого момента не публикуйте сервис в Интернет.
7. Создайте тестовый документ, добавьте файл и метаданные, затем найдите его по фразе из содержимого. Этот простой цикл одновременно проверяет запись в хранилище, индекс и базовую работу OCR/поиска.
Ручная установка WAR
Для ручного пути установите Java 11, Tesseract 4, ffmpeg и mediainfo, затем подготовьте Jetty или Tomcat. WAR берётся из официального релиза и развёртывается средствами выбранного сервера приложений. После старта действуют те же требования к смене стандартного пароля, постоянному хранилищу, базе, HTTPS и резервному копированию. Универсальную команду удаления для Jetty и Tomcat приводить некорректно: способ undeploy зависит от конкретной серверной конфигурации.
Первый запуск и базовая настройка
До загрузки реального архива создайте обычного пользователя и группу, настройте минимальные права, выберите язык интерфейса и проверьте, что DOCS_BASE_URL формирует корректные ссылки. Если планируется импорт почты, используйте отдельную сервисную учётную запись IMAP и сначала тестовый ящик. Для SMTP, LDAP и webhooks также сначала проверяйте непроизводственный сценарий: ошибка интеграции не должна блокировать доступ к самой библиотеке.
После функциональной проверки сделайте первую резервную копию и убедитесь, что в неё входят и файловые данные, и PostgreSQL. Копия только /data или только базы неполна: документ в DMS состоит из файла и связанного состояния.
Обновление с запасным выходом
1. Зафиксируйте текущий тег образа, Compose-файл, переменные окружения и версии PostgreSQL.
2. Остановите поток автоматического импорта и создайте согласованную резервную копию /data и базы.
3. Проверьте release notes выбранной версии и не заменяйте stable на master/ latest без отдельного тестового контура.
4. Обновите копию инсталляции или тестовый стенд и проверьте вход, загрузку, поиск, версии, права, workflow и экспорт нескольких эталонных документов.
5. Только после проверки переносите изменение в production. План отката должен возвращать не только старый контейнер, но и совместимое состояние базы и файлов.
На 2026 год этот порядок особенно важен из-за разрыва между стабильной 1.11 и развивающейся веткой 1.12. «Новый коммит» и «новый стабильный релиз» — не одно и то же.
Безопасное удаление
Перед удалением экспортируйте критичные документы и сделайте проверенную резервную копию /data, PostgreSQL и конфигурации. Команда docker compose down по умолчанию удаляет контейнеры и сети, но не именованные тома; ключ -v удаляет и тома, поэтому применять его до подтверждённой копии данных нельзя. Bind mount также остаётся на файловой системе хоста, пока администратор не удалит его вручную. После остановки убедитесь, что резервная копия читается и содержит обе части DMS, и только затем освобождайте постоянное хранилище.
Практические кейсы
Архив договоров и счетов со сканера
Цель. Сделать бумажный поток доступным по номеру, контрагенту и словам внутри документа. Подготовка. Определите короткий справочник тегов, обязательные метаданные и язык OCR; создайте отдельную группу с правом чтения финансовых документов. Шаги. Загружайте сканы вручную или через importer, заполняйте название и ключевые поля, назначайте теги и дождитесь индексирования. Затем найдите документ по фразе, которой нет в имени файла. Проверка. Откройте найденный скан и сравните критичные номера с изображением. Ограничение. Плохая геометрия, низкое разрешение и сложные таблицы снижают качество OCR, а Teedy не является редактором распознанной вёрстки.
Согласование документа внутри небольшой команды
Цель. Убрать пересылку нескольких «финальных» копий по почте. Подготовка. Создайте пользователей и группы, выдайте права только участникам процесса и настройте workflow с понятными этапами. Шаги. Автор загружает документ, добавляет описание и запускает согласование; проверяющие оставляют комментарии и переводят запись на следующий этап; исправленный файл добавляется как новая версия. Проверка. В карточке должны быть видны актуальный файл, предыдущая версия и журнал действий. Ограничение. Сложные многофилиальные BPM-сценарии с внешними SLA могут потребовать более специализированной платформы.
Автоматический импорт входящей почты
Цель. Собирать вложения и сообщения из выделенного почтового ящика без ручной загрузки. Подготовка. Создайте сервисный IMAP-аккаунт с минимальными правами и тестовую папку. Шаги. Настройте автоматическое сканирование inbox, отправьте несколько контрольных писем с ожидаемыми типами файлов и проверьте, что записи появились в Teedy. После этого подключайте рабочий адрес. Проверка. Сопоставьте число контрольных сообщений, их вложения и метаданные с импортированными документами. Ограничение. Не следует предполагать идеальную дедупликацию: повторную доставку, изменения правил почтового сервера и ошибки соединения нужно контролировать отдельно.
Интеграция с внутренним сервисом через API и webhooks
Цель. Создавать документы из бизнес-приложения и получать событие после изменения. Подготовка. Выделите отдельную учётную запись с минимальными правами и зафиксируйте используемые API-вызовы. Шаги. Сначала выполните создание тестового документа через REST API, затем подключите webhook к непроизводительному endpoint и измените документ. Проверка. Сервис должен получить ожидаемое событие, а документ — остаться доступным с корректными правами. Ограничение. При обновлении Teedy интеграцию нужно регрессионно проверить, особенно если она опирается на недокументированные поля или поведение конкретной версии.
Контроль перед сохранением и передачей
Откройте документ из Teedy и убедитесь, что загружена нужная версия, а не соседний файл с похожим названием.
Проверьте обязательные метаданные и теги; для числовых реквизитов сравните OCR с исходным изображением.
Выполните поиск по уникальной фразе, чтобы убедиться, что индекс действительно содержит текст документа.
Откройте вкладку прав и убедитесь, что документ не доступен лишней группе или общей ссылке.
Если передаётся ZIP или экспортированный PDF, откройте результат в сторонней программе до отправки и проверьте число вложений.
Для новой версии убедитесь, что предыдущая версия остаётся в истории и не была заменена отдельной несвязанной карточкой.
Перед массовым импортом или удалением проверьте актуальность резервной копии базы и /data.
Часто задаваемые вопросы
Можно ли хранить несколько файлов в одной карточке?
Да. Модель документа допускает набор файлов, а история релизов отдельно упоминает загрузку всех файлов документа одним ZIP. Это удобно, например, для договора с приложениями, которые должны иметь общие метаданные и права.
Есть ли точный поиск по названию?
Да. В релизе 1.10 появился оператор точного поиска по title; вместе с полнотекстовым запросом, тегами, языком, датами и типом файла это позволяет отделять поиск по карточке от поиска внутри содержимого.
Можно ли дать файл человеку без учётной записи Teedy?
Для документов предусмотрено расшаривание по URL. Такой URL следует считать самостоятельным доступом: перед передачей нужно проверить права и не размещать ссылку там, где её сможет получить более широкий круг людей.
Обязательно ли использовать облако для OCR?
Нет. В self-hosted варианте OCR выполняется с помощью Tesseract; официальный Docker-образ включает средства распознавания. Облачная подписка Sismics для этой функции не является обязательной.
Есть ли ограничения на число документов?
Upstream заявляет тестирование до одного миллиона документов, но не публикует универсальный лимит, гарантию задержки или минимальное железо для такого объёма. Практический предел определяется сервером, базой, индексом и профилем OCR.
Что означает наличие версии 1.12 в разработке?
Это не новый стабильный релиз upstream. Milestone 1.12 открыт без даты, тогда как README продолжает маркировать v1.11 как latest stable. Сторонние форки и отдельные инсталляции с номером 1.12 не меняют эту классификацию.
Можно ли использовать Teedy вместе с обычным PDF-ридером?
Да. DMS хранит и находит документ, а скачанный PDF можно открыть любым подходящим локальным просмотрщиком. Это нормальное разделение ролей и часто удобнее, чем требовать от серверной системы всех функций настольного клиента.
Вывод
Teedy подходит тем, кому нужен self-hosted архив с OCR, полнотекстовым поиском, метаданными, тегами, версиями, правами, workflow, аудитом и API и кто готов сопровождать Docker/Java, PostgreSQL, резервные копии и сетевую безопасность. Типичные задачи — общий архив договоров, счетов, сканов и входящей почты, где важны быстрый поиск и контролируемый доступ.
Как PDF-редактор, офисный пакет или специализированная OCR-станция Teedy выбирать не стоит. В 2026 году отдельным критерием риска остаются возраст стабильной 1.11 и опубликованные для неё уязвимости. Для публичного или регулируемого хранилища этот фактор может быть решающим.
Paperless-ngx сильнее ориентирован на автоматическое превращение входящих документов в поисковый архив, Mayan EDMS — на более тяжёлую корпоративную EDMS, Docspell — на небольшие библиотеки и извлечение метаданных. Если же требуется только быстро открыть PDF на компьютере, сервер Teedy избыточен и рациональнее локальный просмотрщик.