208 lines
16 KiB
Markdown
208 lines
16 KiB
Markdown
---
|
||
code: DOC-221273
|
||
title: "9. Загрузка документов для КФО"
|
||
---
|
||
|
||
# 9. Загрузка документов для КФО
|
||
|
||
### Структура модуля загрузки:
|
||
|
||
ссылка на модель данных: [2. Модель данных (сущности)](project/Document/DOC-019834)
|
||
|
||
### Описание:
|
||
|
||
* Первый этап формирования КФО: по каждой организации выбранного периметра (ГСК) собираются формы отчетности и ОСВ за отчетный период.
|
||
* Загруженные файлы автоматически маршрутизируются на распознавание, результат распознавания проверяется и подтверждается пользователем и становится источником данных для сводной ОСВ, логических проверок и консолидации.
|
||
* Точка входа - страница "Отчетность" выбранной ГК (Отчетность - ГК - Консолидации): список консолидаций, организации выбранной консолидации, кнопка "Загрузить документы" при нажатии на организацию.
|
||
|
||
### Визуальная форма:
|
||
|
||
Форма представляет собой выдвижную боковую панель, открывающуюся поверх страницы отчетности при клике по строке организации в панели "Организации" либо по кнопке "Документы" в этой строке.
|
||
|
||
|
||
|
||
#### Панель "Первичные документы"
|
||
|
||
Выдвижная панель: заголовок "Первичные документы", наименование организации, ИНН, кнопка "Загрузить документы".
|
||
|
||
| Поле | Системное наименование | Правила заполнения |
|
||
| --- | --- | --- |
|
||
| Документ | 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 - консолидация в статусе, запрещающем изменение документов - действие недоступно.
|
||
|
||
### Постусловия
|
||
|
||
* удаление зафиксировано в журнале действий.
|