Архив¶
Экран «Архив» --- это файловое хранилище, в котором находятся все загруженные оригиналы документов. Здесь можно создавать папки, загружать отдельные файлы и целые архивные папки, запускать обработку, удалять и перемещать элементы. Архив устроен как привычная файловая система с вложенными папками.

Сводка по хранилищу¶
В верхней части экрана расположены пять карточек с общей статистикой:

| Карточка | Что показывает |
|---|---|
| Всего файлов | Общее число загруженных файлов во всех папках |
| Размер | Суммарный объём всех файлов в хранилище |
| Ожидают | Файлы, которые загружены, но ещё не прошли обработку (распознавание) |
| Обработано | Файлы, обработка которых завершена успешно |
| Папок | Общее число папок в хранилище |
Числа «Ожидают» и «Обработано» обновляются по мере работы программы. Если вы только что загрузили пачку файлов, число в карточке «Ожидают» вырастет, а по мере завершения обработки файлы будут переходить в «Обработано».
Навигация по папкам¶
Хлебные крошки¶
Над списком файлов расположена цепочка ссылок --- так называемые «хлебные крошки». Они показывают путь от корня хранилища до текущей папки. Каждый элемент цепочки является ссылкой: нажав на любой из них, вы перейдёте в соответствующую папку.
Значок домика в начале цепочки возвращает в корень хранилища.

Кнопка «Назад»¶
Если вы находитесь внутри какой-либо папки, справа от остальных кнопок появляется кнопка «Назад». Она возвращает вас на один уровень вверх --- в родительскую папку.
Кнопки действий¶
Справа от хлебных крошек расположены кнопки для работы с файлами и папками.

Кнопка «Папка»¶
Открывает поле ввода для создания новой папки. Введите название и нажмите «Создать». Папка появится внутри текущей открытой папки (или в корне хранилища, если вы находитесь в корне). Для отмены нажмите «Отмена».
Кнопка «Файл»¶
Открывает окно выбора файла на вашем компьютере. Поддерживаются форматы PDF и TIFF. Выбранный файл загружается в текущую папку. Во время загрузки кнопка показывает вращающийся значок и становится неактивной.
Кнопка «ZIP»¶
Открывает окно выбора архива в формате ZIP. Программа распакует содержимое архива и поместит все файлы в текущую папку. После загрузки появляется уведомление с числом добавленных файлов. Это удобный способ загрузить сразу много документов.
Кнопка «Яндекс Диск»¶
Открывает окно импорта файлов с Яндекс Диска. Подробнее об этой возможности --- в разделе «Импорт с Яндекс Диска» ниже.
Кнопка «Импорт договоров»¶
Появляется только тогда, когда вы находитесь внутри какой-либо папки (не в корне хранилища). Позволяет автоматически создать документы на основе имён файлов. Подробнее --- в разделе «Импорт договоров по именам файлов» ниже.
Список файлов и папок¶
Основная часть экрана --- таблица с содержимым текущей папки. Каждая строка таблицы --- это папка или файл.

Колонки таблицы¶
| Колонка | Что показывает |
|---|---|
| Флажок | Позволяет отметить элемент для массовых действий (перемещение, удаление) |
| Название | Имя папки (со значком папки и косой чертой в конце) или имя файла (со значком документа) |
| Размер / Статус | Для папок --- количество файлов и счётчики по статусам; для файлов --- размер и цветная метка статуса |
| Действия | Кнопки для работы с элементом |
| Удаление | Кнопка удаления (значок корзины) |
Папки¶
При нажатии на название папки вы переходите внутрь неё. Рядом с названием показана статистика:
- Число файлов в папке
- Зелёная галочка и число --- количество обработанных файлов
- Значок песочных часов и число --- количество ожидающих обработки файлов
- Оранжевый значок и число --- количество отменённых файлов
- Красный крестик и число --- количество файлов с ошибкой
Для каждой папки доступны действия:
- Обработать --- запускает обработку всех ожидающих файлов в папке. Если в папке есть файлы, которые уже были обработаны ранее (или завершились ошибкой, или были отменены), программа покажет окно подтверждения: «Обнаружено N файлов, которые уже были обработаны. Повторить обработку?» Пока папка обрабатывается, вместо кнопки «Обработать» отображается метка «В обработке» с вращающимся значком.
- ZIP --- скачивает все файлы папки в виде архива ZIP.
Файлы¶
При нажатии на название файла открывается окно просмотра оригинала. Если файл уже обработан, откроется просмотр с результатами распознавания. Если файл ещё не обработан, откроется простой просмотр исходного документа.
Рядом с размером файла отображается цветная метка статуса:
| Статус | Цвет | Что означает |
|---|---|---|
| pending | Жёлтый | Файл ожидает обработки |
| processing | Синий | Файл обрабатывается прямо сейчас |
| completed | Зелёный | Обработка завершена успешно |
| cancelled | Оранжевый | Обработка файла была отменена |
| failed | Красный | При обработке произошла ошибка |
Для файлов доступны действия:
- Обработать --- появляется только для файлов со статусом «ожидает», «отменён» или «ошибка». Добавляет файл в очередь обработки.
- Скачать --- загружает исходный файл на ваш компьютер.
Выбор нескольких элементов¶
Нажатие на флажок слева от элемента отмечает его. В заголовке таблицы есть общий флажок, который выделяет или снимает выделение со всех элементов разом.
Когда хотя бы один элемент выделен, над таблицей появляется синяя полоса с указанием количества выбранных элементов и кнопками:

- Переместить --- открывает окно выбора папки назначения. Выбранные файлы и папки будут перенесены в указанное место.
- Удалить --- удаляет все выбранные элементы. Перед удалением программа попросит подтверждение.
- Снять выбор --- убирает выделение со всех элементов.
Подгрузка при прокрутке¶
Если в папке много файлов, они загружаются порциями. Когда вы прокручиваете список вниз, следующая порция подгружается автоматически. Во время подгрузки внизу списка появляется вращающийся значок. После загрузки всех файлов в нижней части отображается итоговая строка «Показано файлов: N из M».
Импорт с Яндекс Диска¶
Кнопка «Яндекс Диск» открывает окно, в котором можно указать ссылку на папку Яндекс Диска. Программа скачает все PDF-файлы из указанной папки и поместит их в текущую папку архива.

Ход импорта¶
Пока импорт выполняется, в верхней части экрана (между сводкой и списком файлов) появляется синий баннер с информацией о процессе:
- Подготовка --- программа начинает подключение к Яндекс Диску.
- Сбор списка файлов --- программа определяет, какие файлы нужно скачать.
- Загрузка --- программа скачивает файлы. Отображается прогресс: «Загрузка: 5/20 файлов» и полоса прогресса.
Результаты импорта¶
Когда импорт завершён, вместо синего баннера появляется зелёный с итогами:
- Добавлено файлов --- сколько новых файлов загружено
- Пропущено дубликатов --- сколько файлов уже существовало в архиве и были пропущены
- Пропущено не-PDF --- сколько файлов оказались не в формате PDF и были пропущены
Баннер можно закрыть, нажав кнопку «Закрыть».
Ошибки и прерывания¶
Если импорт прервался по тайм-ауту или завершился с ошибкой, появляется жёлтый (тайм-аут) или красный (ошибка) баннер с описанием проблемы. На таком баннере есть кнопка «Продолжить», которая возобновляет прерванный импорт с того места, на котором он остановился.
Обработка папок¶
Когда вы запускаете обработку целой папки, в верхней части экрана появляется фиолетовый баннер «Обработка папки». Он показывает:

- Название обрабатываемой папки
- Текущий этап: «Подготовка» или «Создание заданий: 5/20 файлов»
- Полосу прогресса
- Имя файла, который обрабатывается в данный момент
Баннер исчезает автоматически, когда обработка завершена.
Что происходит при обработке папки
Программа берёт все файлы со статусом «ожидает» из выбранной папки и создаёт для каждого задание на распознавание. Эти задания попадают в очередь обработки, которую можно увидеть на экране Очередь обработки.
Импорт договоров по именам файлов¶
Кнопка «Импорт договоров» позволяет создать документы автоматически, разобрав названия файлов в текущей папке. Это полезно, когда файлы уже названы по определённому образцу, который включает номер договора, дату и контрагента.
Предварительный просмотр¶
При нажатии на кнопку «Импорт договоров» открывается окно с таблицей, где для каждого файла показано:

| Колонка | Что показывает |
|---|---|
| Файл | Имя файла |
| Номер | Номер договора, который программа извлекла из названия |
| Дата | Дата, которую программа извлекла из названия |
| Контрагент | Контрагент, которого программа извлекла из названия |
| Статус | Зелёная галочка, если программа смогла разобрать имя файла; красный значок, если не смогла |
Над таблицей показаны счётчики:
- Всего --- общее число файлов в папке
- Распознано --- число файлов, имена которых удалось разобрать
- Не распознано --- число файлов, имена которых не удалось разобрать
Если имя файла содержит пометку о дополнительном соглашении, рядом с номером договора отображается метка «доп».
Запуск импорта¶
После просмотра таблицы нажмите кнопку «Запустить импорт» внизу окна. Кнопка показывает число файлов, которые будут обработаны. Кнопка неактивна, если ни один файл не удалось распознать.
Ход и результаты¶
Во время импорта в верхней части экрана появляется синий баннер с прогрессом, аналогичный баннеру импорта с Яндекс Диска. По завершении появляется зелёный баннер с итогами:
- Создано документов --- сколько документов программа создала из имён файлов
- Не распознано --- сколько файлов программа не смогла разобрать
- Пропущено дубликатов --- сколько файлов пропущено, потому что такие документы уже существуют
Пустой архив¶
Если в хранилище ещё нет файлов, вместо таблицы отображается подсказка: «Архив пуст. Загрузите ZIP-архив или отдельные файлы». Если пуста только текущая папка, отображается надпись «Папка пуста».
Нижняя строка¶
Под основным списком файлов расположена итоговая строка с общими числами по всему хранилищу: количество файлов, общий размер, число ожидающих и число обработанных.