CR 2026-08-14. Ввод без плана ввода

1. Суть изменения

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

Экран очереди упрощается следом: вместо пяти вкладок по этапам обработки остаются две — «Пакет ввода» со списком кадров и «Проверка карты», где пользователь проверяет, правит и принимает данные. Подсказка поиска — «№ пакета · шифр · инв. № · заглавие».

Вид документа и редакцию бланка определяет Сервис. Если при проверке вид оказался распознан неверно, пользователь отклоняет его и может указать верный: пакет уходит на повторную обработку с контекстом «такой-то вид отвергнут, верным считать такой-то», а пользователь берёт следующий пакет, не дожидаясь результата. Пакет, в котором не опознан ни один вид, помечается как ошибочный.

2. Разбор

2.1. Что меняется по существу

Выбор плана ввода исчезает из работы пользователя. Вместо последовательности шагов, заданной заранее, ввод сводится к съёмке страниц подряд; номер страницы присваивается по порядку съёмки и правится перетаскиванием. Определение вида документа и редакции бланка переносится с пользователя на Сервис.

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

Если не опознан ни один вид, пакет помечается как ошибочный: обрабатывать нечего, и дальше он идёт в ручной разбор, а не по кругу.

Полнота пакета ввода определяется не Сервисом, а пользователем: ввод завершается командой «Сохранить и перейти к следующей». Сверху действует настраиваемое ограничение — наибольшее число кадров в пакете, по умолчанию пять.

2.2. Почему это ускоряет ввод

Из работы уходят два действия на каждую карту: выбор плана и следование его шагам. При объёме архива около 50 тыс. карт это заметно. Дополнительно снимается ошибка, которую план допускал: оператор мог выбрать план, не соответствующий бумаге, и заметить это только на проверке.

2.3. Чем платим

Распознавание становится обязательным звеном ввода. Раньше план гарантировал, что Сервис знает, что за карта; теперь это гипотеза модели. Пакет с неопознанным видом не может быть разобран в значения вообще, а не только частично.

Появляется цикл повторной обработки с обратной связью. Это новое поведение очереди: пакет возвращается в неё с контекстом «вид такой-то отвергнут, верным считать такой-то». От бесконечного хождения по кругу защищает не счётчик попыток, а то, что пользователь вправе указать верный вид, а неопознанный вовсе пакет уходит в ошибку.

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

2.4. Что переживает переделку

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

3. Очередь обработки: две вкладки вместо пяти этапов

3.1. Что должно остаться на вкладке «Пакет ввода»

Кроме того, что названо в запросе — пересъёмка, повторная обработка, отметка включения кадра в обработку, — на этой вкладке живёт то, что было на прежних этапах «Предобработка» и «Проверка файлов»:

3.2. Полнота пакета и полнота карты

Сервис определяет вид формы, а значит и число её страниц, и распределяет кадры по страницам. Из этого следуют три случая.

Кадров больше, чем страниц. Лишние помечаются «не относится к форме», галочка включения снимается — в обработку они не идут. Пользователь может удалить их, но не обязан: удалить всегда успеется, восстановить снятое — нет.

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

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

Единственный контроль на выходе — обязательные поля: карта не создаётся, пока они не заполнены. Обязательность задаётся составом вида документа и от того, сколько кадров в пакете, не зависит.

3.3. Поведение вкладок

Пакет ввода. Список кадров, опознанный вид карты и опознанные страницы. Действия над кадрами: пересъёмка, повторная обработка, отметка включения кадра в обработку, удаление, добавление недостающего, порядок страниц. Кнопка подтверждения переводит на «Проверку карты». Кнопка «Вид документа не распознан» отклоняет вид с указанием верного и отправляет пакет на повторную обработку.

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

3.4. Повторная обработка после правки кадров

Пакет с изменёнными кадрами возвращается в очередь по кнопке «Поставить в очередь», а не автоматически. Момент повторной обработки выбирает человек — иначе каждое движение кадра запускало бы распознавание заново. После постановки Сервис предлагает сразу взять следующий пакет.

Новые результаты распознавания не затирают введённое пользователем. Отсюда же требование к хранению: у значения два набора — то, что видит и правит пользователь, и то, что вернула модель.

3.5. Состояния пакета

Вместо пяти этапов у пакета четыре состояния: в очереди, проверка, завершён, ошибка. По ним же фильтруется очередь.

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

3.6. Что схлопывание вкладок меняет по существу

Пять этапов (ADR-003 «Статус пакета из подтверждённых этапов») были не пятью экранами, а моделью подтверждения: из последнего подтверждённого этапа выводился статус пакета, на этапах строились фильтры очереди и каскадный отзыв. Всё это заменяется четырьмя состояниями, поэтому переделка задевает не только экран.

Проверка карты становится единым действием: поля, экземпляр, экспертиза и вид документа проверяются на одной вкладке, а результат — принятие карты либо отклонение вида с отправкой на повторную обработку.

4. Blast radius

4.1. Отменяется целиком

4.2. Переделывается

4.3. Затрагивается косвенно

5. План проработки

5.1. Почему прототип первым

Из пяти неясностей четыре — про поведение экрана: чем заменить подсказку плана, что показывать до того, как вид распознан, как выглядит отклонение вида, куда девается ошибочный пакет. На прототипе это решается за вечер, в тексте — обсуждается неделю и всё равно проверяется прототипом.

Обратный порядок — сначала ADR, потом макет — оправдан, когда решение диктует поведение. Здесь наоборот: решение почти принято, а его цена выяснится только на экране.

5.2. Что придётся трогать в прототипах

Экран ввода переписывается целиком: степпер по шагам плана заменяется лентой кадров. Экран очереди — частично: на этапе проверки добавляется отклонение вида с выбором верного, в список пакетов — состояние ошибки.

Старый прототип не копируем: он в истории репозитория, и этого достаточно.

6. Прототип экрана ввода

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

Открыть в новой вкладке

Прежний вариант со степпером по плану удалён: он остаётся в истории репозитория.

7. Прототип очереди

Две вкладки вместо пяти этапов, четыре состояния пакета, отклонение вида с указанием верного, повторная обработка по кнопке «Поставить в очередь».

Открыть в новой вкладке

8. Вопросы, закрытые заказчиком

9. Открытые вопросы

Открытых вопросов нет.

10. Итог

10.1. Сделано

10.2. Сверх плана

Работа вскрыла то, чего в blast radius не было.

Понадобилось второе решение. Схлопывание пяти этапов в две вкладки отменяло ADR-003 «Статус пакета из подтверждённых этапов», а отменить решение можно только другим решением — появился ADR-008 «Четыре состояния пакета и две вкладки проверки». В первоначальном разборе я этого не увидел: считал схлопывание вкладок правкой экрана.

Эпик обработки и сценарий проверки остались на старой модели и нашлись только проверкой на документы-сироты — их не было в blast radius.

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

10.3. Что изменилось в объёме

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

10.4. Что осталось незакрытым

FR-008 «Свободное формирование пакета кадров» не удалено и не отменено, а переписано в «Свободное формирование пакета кадров»: номер требования сохраняет след — планы рассматривались, от них отказались осознанно, — а содержание описывает действующий порядок ввода. ADR-001 «План ввода определяется видом ИК» и ADR-003 «Статус пакета из подтверждённых этапов» остаются в спеке как замещённые — их аргументация понадобится, если новый подход не оправдается.

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