arm-ka-docs/source/tz/АРМ КА.Техническое задание - 03_9. Загрузка документов для КФО.md

code, title

code	title
DOC-221273	9. Загрузка документов для КФО

9. Загрузка документов для КФО

Структура модуля загрузки:

ссылка на модель данных: 2. Модель данных (сущности)

Описание:

• Первый этап формирования КФО: по каждой организации выбранного периметра (ГСК) собираются формы отчетности и ОСВ за отчетный период.
• Загруженные файлы автоматически маршрутизируются на распознавание, результат распознавания проверяется и подтверждается пользователем и становится источником данных для сводной ОСВ, логических проверок и консолидации.
• Точка входа - страница "Отчетность" выбранной ГК (Отчетность - ГК - Консолидации): список консолидаций, организации выбранной консолидации, кнопка "Загрузить документы" при нажатии на организацию.

Визуальная форма:

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

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

Выдвижная панель: заголовок "Первичные документы", наименование организации, ИНН, кнопка "Загрузить документы".

Поле	Системное наименование	Правила заполнения
Документ	stored\_file	Иконка формата (PDF / XLSX), имя файла, формат файла, дата загрузки
Период	определяется из периода в документе	Например "2025 Q3", "2025 - 9 мес.". При невозможности определения - "-"
Проверка периода	сравнение с периодом консолидации	"Соответствует" (зеленый) / "Не соответствует" (красный) / "Не определен" (серый)
Статус	stored\_file.status	Статус файла
Действия	-	Кнопка удаления. Нажатие на строку открывает документ (проверка распознавания или предпросмотр)

Окно "Загрузка документов"

• в шапке - наименование организации, по которой выполняется загрузка.
• зона перетаскивания "Перетащите файлы сюда" и кнопка "Выбрать документы".
• список выбранных файлов: иконка формата, имя файла, выпадающий список "Тип документа" со значениями Баланс, ОФР, ОСВ, Расшифровка, Прочее. Тип документа доступен для изменения.
• кнопки "Отмена" и "Загрузить".
• по нажатию "Загрузить" система создает записи stored\_file (дата загрузки, тип, формат), выполняет дедупликацию по content\_hash и ставит файлы в очередь распознавания.

Чек-лист загруженных документов

Модальное окно "Чек-лист загруженных документов": строки - организации консолидации (наименование, ГК, ИНН), колонки - "Бух. баланс", "ОФР", группа "ОСВ" по обязательным счетам, группа "Прочие документы" по дополнительным необязательным счетам ОСВ. В ячейках - иконки статусов (Загружен, Обработка, Требуется проверка, Ошибка загрузки, Отсутствует). Фильтры - "Группа компаний" и "Документы". Кнопка "Скачать" - выгрузка матрицы в CSV.

Экран "Проверка распознавания"

• блок "Документ" для переключения между документами организации, рядом - статус выбранного документа.
• блок "Логические ошибки" (выводится при статусе "Требуется проверка").
• двухпанельная отображение: слева "Исходный документ" - постраничные изображения с масштабированием; справа "Результат распознавания" с таблицей формы по строкам и кодам.
• ячейки, требующие внимания, подсвечиваются: значения с низким качеством распознавания и ячейки непройденных логических проверок.
• действия: "Редактировать" - "Сохранить" / "Отменить", "Подтвердить данные" - фиксирует значения, переводит документ в статус "Загружен".

UC-01 Загрузка документов по организации

UC-01: Загрузка документов по организации

Общая информация

Параметр	Значение
ID	UC-01
Название	Загрузка документов по организации
Основной актер	КА РФ / КА ГО
Предусловия	Создана консолидация, организация входит в ее состав

Основной поток (Basic Flow)

1. Пользователь открывает панель "Первичные документы" организации и нажимает "Загрузить документы";
2. Пользователь перетаскивает файлы в зону загрузки либо выбирает их через диалоговое окно (допускается несколько файлов);
3. Система создает записи stored\_file , выполняет дедупликацию по content\_hash , ставит файлы в очередь распознавания (статус "Обработка") и закрывает окно;
4. В списке документов появляются строки с периодом, результатом проверки периода и текущим статусом.

Альтернативные потоки

• A1 - период файла не соответствует периоду консолидации: строка подсвечивается, выводится "Не соответствует" с подсказкой о периоде консолидации, загрузка не блокируется, решение остается за пользователем;
• A2 - дубликат файла (совпадение content\_hash ): повторная запись не создается, пользователю выводится предупреждение;
• A3 - недопустимый формат файла: файл отклоняется с сообщением.

Постусловия

• файлы сохранены и переданы на распознавание;
• статусы документов в панели "Организации" и чек-листе актуализированы.

UC-02: Автоматическая обработка и распознавание

UC-02: Автоматическая обработка и распознавание

Общая информация

Параметр	Значение
ID	UC-02
Название	Автоматическая обработка и распознавание
Основной актер	Система
Предусловия	Файл загружен (статус "Обработка")

Основной поток (Basic Flow)

1. система создает recognition\_job и маршрутизирует файл: XLSX - в табличный сервис, PDF/PNG/JPG - в сервис сканирования;
2. результат сопоставляется по recognition\_job.id . Строки записываются в osv\_entry / financial\_statement\_line / financial\_statement\_value с привязкой к файлу и периоду;
3. система выполняет контроль качества распознавания (порог 100%) и логические проверки;
4. при отсутствии замечаний документ получает статус "Загружен", при замечаниях - "Требуется проверка", при сбое обработки - "Ошибка".

Постусловия

• статус документа и агрегированные статусы комплектов обновлены;
• для статуса "Требуется проверка" доступен экран проверки документа.

UC-03: Проверка и подтверждение распознанных данных

UC-03: Проверка и подтверждение распознанных данных

Общая информация

Параметр	Значение
ID	UC-03
Название	Проверка и подтверждение распознанных данных
Основной актер	КА РФ / КА ГО
Предусловия	Документ распознан, статус "Требуется проверка"

Основной поток (Basic Flow)

1. пользователь открывает документ из панели "Первичные документы", система открывает экран с исходными страницами слева и результатом распознавания справа;
2. система выводит блок "Логические ошибки" с непройденными проверками и подсвечивает проблемные ячейки;
3. пользователь сверяет значения с исходным документом, при необходимости нажимает "Редактировать", исправляет значения в подсвеченных ячейках и нажимает "Сохранить";
4. пользователь нажимает "Подтвердить данные", система пересчитывает логические проверки, фиксирует значения (с сохранением в журнале действий) и переводит документ в статус "Загружен";
5. выпадающий список "Документ" позволяет перейти к следующему документу организации без возврата к списку.

Альтернативные потоки

• A1 - логические проверки не пройдены после правок - документ остается в "Требуется проверка", блок ошибок обновляется;
• A2 - отмена редактирования ("Отменить") возвращает прежние значения.

Постусловия

• подтвержденные данные доступны для сводной ОСВ и консолидации;
• правки зафиксированы в журнале действий.

UC-04: Просмотр и выгрузка чек-листа загруженных документов

UC-04: Просмотр и выгрузка чек-листа загруженных документов

Общая информация

Параметр	Значение
ID	UC-04
Название	Просмотр и выгрузка чек-листа загруженных документов
Основной актер	КА РФ / КА ГО / РКА РФ
Предусловия	Выбрана консолидация

Основной поток (Basic Flow)

1. пользователь нажимает "Скачать чек-лист" в панели "Организации";
2. система открывает матрицу компаний и загруженных документов;
3. пользователь при необходимости ограничивает набор ГСК и колонок документов и нажимает "Скачать" - система выгружает матрицу в CSV. Матрица позволяет до запуска консолидации увидеть отсутствующие и проблемные документы по каждой организации.

Постусловия

• получена матрица компаний и загруженных документов.

UC-05: Удаление документа

UC-05: Удаление документа

Общая информация

Параметр	Значение
ID	UC-05
Название	Удаление документа
Основной актер	КА РФ / КА ГО
Предусловия	Документ загружен, консолидация не переведена в "Консолидация РФ"

Основной поток (Basic Flow)

1. пользователь нажимает кнопку удаления в строке документа;
2. система удаляет файл и связанные результаты разбора, обновляет статусы комплектов;
3. при необходимости пользователь загружает корректный файл (UC-01).

Альтернативные потоки

• A1 - консолидация в статусе, запрещающем изменение документов - действие недоступно.

Постусловия

• удаление зафиксировано в журнале действий.