Paperless в привычных папках: виртуальная файловая система поверх документов

11 октября 2026 · 5 минут чтения

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

Для электронного архива мы выбрали Paperless-ngx — систему управления документами (DMS). Она распознаёт текст сканов, помогает находить документы и классифицировать их по компаниям, типам и другим свойствам.

Для бухгалтеров переход в электронный архив уже означает смену привычного порядка работы. Им привычно искать документы в папках и открывать их обычными приложениями. Добавлять к этому ещё и обучение веб-интерфейсу Paperless я не хочу: внедрение должно облегчать их работу.

Поэтому я сделал виртуальную файловую систему — слой, который показывает документы Paperless как файлы и папки. С разработкой помогли агенты для разработки, которые пишут и проверяют код. Папка archive этой системы доступна через Samba только для чтения. Ниже — путь документа от загрузки до просмотра.

Куда положить документ и откуда забрать

Мы собрали загрузку, сканы и архив в одной общей сетевой папке. В её корне находятся три папки: inbox, scans и archive. Папка errors вложена в inbox:

Общая папка/├── inbox/       # загрузить документ│   └── errors/  # ошибки обработки├── scans/       # загрузить скан с МФУ└── archive/     # открыть или скачать

• /scans — сканы попадают сюда напрямую по сети с принтера (МФУ).
• /inbox — сюда кладут документы с личного компьютера, из почты и других источников, минуя сканеры.
• /inbox/errors — отклонённые файлы и причины отказа. Их можно скачать, исправить проблему и отправить документ в inbox повторно. Эта папка доступна только для чтения.
• /archive — виртуальное представление документов Paperless. Здесь обработанные документы можно найти и открыть в привычном файловом менеджере. Архив доступен только для чтения.

Документ поступает через inbox или scans. Обработчик проверяет файлы из обеих папок и передаёт их в Paperless на импорт и классификацию. После обработки файл исчезает из входной папки, а документ появляется в Paperless и становится доступен в archive. Когда документ понадобится, его можно найти и открыть из archive. Скачать его можно и из веб-интерфейса Paperless.

Одна коллекция, три структуры

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

В имя файла добавлен идентификатор документа (ID): он различает записи с одинаковыми названиями.

По годам

Так удобно искать документ, если помнишь его дату:

archive/По годам/2025/Маяк/2025-11-07 Акт № 18 [1044].pdf2026/Север/2026-03-12 Счёт № 42 [1042].pdf2026-03-15 Договор поставки [1043].pdfБез даты/Без компании/Скан без подписи [1045].pdf

По компаниям

Если помнишь контрагента, удобнее начать с него:

archive/По компаниям/Маяк/Акты/2025-11-07 Акт № 18 [1044].pdfСевер/Договоры/2026-03-15 Договор поставки [1043].pdfСчета/2026-03-12 Счёт № 42 [1042].pdfБез компании/Без типа/Скан без подписи [1045].pdf

По типам документов

Здесь можно сразу открыть договоры, счета или акты за нужный год:

archive/По типам/Акты/2025/2025-11-07 Акт № 18 [1044].pdfДоговоры/2026/2026-03-15 Договор поставки [1043].pdfСчета/2026/2026-03-12 Счёт № 42 [1042].pdfБез типа/Без даты/Скан без подписи [1045].pdf

Счёт [1042] виден во всех трёх структурах — это три пути к одному документу, без отдельных копий для каждого представления. Документы с незаполненными свойствами остаются видимыми в директориях «Без даты», «Без компании» и «Без типа».

Чтобы построить эти пути, виртуальная файловая система получает документы и их свойства из Paperless через интерфейс программирования приложений (API). Samba предоставляет доступ к этому представлению по сетевому протоколу SMB.

Почему папка archive только для чтения

Несколько путей к одному документу делают запись неоднозначной. Удалить счёт из одной директории — значит удалить его из Paperless или убрать только из этого представления? Перенести в другую — значит поменять компанию, дату или тип?

Поэтому папка archive доступна только для чтения: документы можно открывать и копировать. Удаление, переименование, перемещение и сохранение изменений в ней запрещены. Изменять документы и их свойства нужно в Paperless. Отредактированная локальная копия автоматически обратно не загружается.

Так мы сохранили привычный способ доступа к документам и упростили для бухгалтеров переход в электронный архив. С агентами такая адаптация стала для меня практически доступной.

Термины

• DMS — система для хранения, поиска и управления документами и их свойствами.
• Paperless-ngx — DMS с открытым исходным кодом и фокусом на поисковом архиве.
• Агент для разработки — помощник на основе языковой модели, который пишет код и проверяет результат.
• Классификация — назначение документу свойств, например контрагента и типа.
• Виртуальная файловая система — представление коллекции как файлов и директорий.
• Samba и SMB — программа и протокол для доступа к сетевому диску.
• API — программный интерфейс для получения документов и их свойств.
• ID документа — идентификатор записи, различающий одноимённые документы.

Источники

• Авторская постановка Данила от 8–9 октября 2026 года: опыт использования Paperless, структура общей сетевой папки и создание с агентами виртуального представления через Samba. Назначение папок сверено с рабочими инструкциями 9 октября.
• Авторское пояснение и редакционные уточнения Данила от 11 октября 2026 года: задача перехода с бумаги в электронный архив, два способа загрузки документов, трудности внедрения и роль агентов в создании привычного файлового доступа.
• Paperless-ngx: возможности — открытый исходный код, собственный сервер, распознавание и поиск документов.
• Paperless-ngx: использование и импорт — поведение директории приёма.
• Paperless-ngx: API — доступ к документам и свойствам.
• Samba: параметр read only — сетевой доступ только для чтения.

Возможности Paperless сверены с документацией 9 октября 2026 года; остальные технические источники проверены 8 октября. Виртуальные структуры реализованы отдельным слоем поверх Paperless.

Автор: Данил Письменный · Дата: 11 октября 2026