--- code: DOC-221273 title: "9. Загрузка документов для КФО" --- # 9. Загрузка документов для КФО ### Структура модуля загрузки: ссылка на модель данных: [2. Модель данных (сущности)](project/Document/DOC-019834) ### Описание: * Первый этап формирования КФО: по каждой организации выбранного периметра (ГСК) собираются формы отчетности и ОСВ за отчетный период. * Загруженные файлы автоматически маршрутизируются на распознавание, результат распознавания проверяется и подтверждается пользователем и становится источником данных для сводной ОСВ, логических проверок и консолидации. * Точка входа - страница "Отчетность" выбранной ГК (Отчетность - ГК - Консолидации): список консолидаций, организации выбранной консолидации, кнопка "Загрузить документы" при нажатии на организацию. ### Визуальная форма: Форма представляет собой выдвижную боковую панель, открывающуюся поверх страницы отчетности при клике по строке организации в панели "Организации" либо по кнопке "Документы" в этой строке. ![](/files/obj/CmfDocument/CmfDocument%3Aa08/CmfDocument%3Aa082150a-9d30-11f1-8365-5e0a7cdca547/image2026-7-27_14-20-6.png?version=1) #### Панель "Первичные документы" Выдвижная панель: заголовок "Первичные документы", наименование организации, ИНН, кнопка "Загрузить документы". | Поле | Системное наименование | Правила заполнения | | --- | --- | --- | | Документ | stored\\_file | Иконка формата (PDF / XLSX), имя файла, формат файла, дата загрузки | | Период | определяется из периода в документе | Например "2025 Q3", "2025 - 9 мес.". При невозможности определения - "-" | | Проверка периода | сравнение с периодом консолидации | "Соответствует" (зеленый) / "Не соответствует" (красный) / "Не определен" (серый) | | Статус | stored\\_file.status | Статус файла | | Действия | - | Кнопка удаления. Нажатие на строку открывает документ (проверка распознавания или предпросмотр) | #### Окно "Загрузка документов" * в шапке - наименование организации, по которой выполняется загрузка. * зона перетаскивания "Перетащите файлы сюда" и кнопка "Выбрать документы". * список выбранных файлов: иконка формата, имя файла, выпадающий список "Тип документа" со значениями Баланс, ОФР, ОСВ, Расшифровка, Прочее. Тип документа доступен для изменения. * кнопки "Отмена" и "Загрузить". * по нажатию "Загрузить" система создает записи **stored\\_file** (дата загрузки, тип, формат), выполняет дедупликацию по **content\\_hash** и ставит файлы в очередь распознавания. ![](/files/obj/CmfDocument/CmfDocument%3Aa08/CmfDocument%3Aa082150a-9d30-11f1-8365-5e0a7cdca547/image2026-7-27_14-52-36.png?version=1) #### Чек-лист загруженных документов Модальное окно "Чек-лист загруженных документов": строки - организации консолидации (наименование, ГК, ИНН), колонки - "Бух. баланс", "ОФР", группа "ОСВ" по обязательным счетам, группа "Прочие документы" по дополнительным необязательным счетам ОСВ. В ячейках - иконки статусов (Загружен, Обработка, Требуется проверка, Ошибка загрузки, Отсутствует). Фильтры - "Группа компаний" и "Документы". Кнопка "Скачать" - выгрузка матрицы в CSV. ![](/files/obj/CmfDocument/CmfDocument%3Aa08/CmfDocument%3Aa082150a-9d30-11f1-8365-5e0a7cdca547/image2026-7-27_14-56-54.png?version=1) #### Экран "Проверка распознавания" * блок "Документ" для переключения между документами организации, рядом - статус выбранного документа. * блок "Логические ошибки" (выводится при статусе "Требуется проверка"). * двухпанельная отображение: слева "Исходный документ" - постраничные изображения с масштабированием; справа "Результат распознавания" с таблицей формы по строкам и кодам. * ячейки, требующие внимания, подсвечиваются: значения с низким качеством распознавания и ячейки непройденных логических проверок. * действия: "Редактировать" - "Сохранить" / "Отменить", "Подтвердить данные" - фиксирует значения, переводит документ в статус "Загружен". ![](/files/obj/CmfDocument/CmfDocument%3Aa08/CmfDocument%3Aa082150a-9d30-11f1-8365-5e0a7cdca547/image2026-7-27_15-30-19.png?version=1) 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 - консолидация в статусе, запрещающем изменение документов - действие недоступно. ### Постусловия * удаление зафиксировано в журнале действий.