diff --git a/user/img/01-login.png b/user/img/01-login.png index b95e71c..381340b 100644 Binary files a/user/img/01-login.png and b/user/img/01-login.png differ diff --git a/user/img/02-main.png b/user/img/02-main.png index e2ad9fe..bc5494b 100644 Binary files a/user/img/02-main.png and b/user/img/02-main.png differ diff --git a/user/img/03-groups.png b/user/img/03-groups.png index 959de06..0383e74 100644 Binary files a/user/img/03-groups.png and b/user/img/03-groups.png differ diff --git a/user/img/04-group-page.png b/user/img/04-group-page.png index 2074e45..59d705e 100644 Binary files a/user/img/04-group-page.png and b/user/img/04-group-page.png differ diff --git a/user/img/05-new-consolidation-empty.png b/user/img/05-new-consolidation-empty.png index af7f498..f09db6c 100644 Binary files a/user/img/05-new-consolidation-empty.png and b/user/img/05-new-consolidation-empty.png differ diff --git a/user/img/06-new-consolidation-filled.png b/user/img/06-new-consolidation-filled.png index fde82a5..7924a60 100644 Binary files a/user/img/06-new-consolidation-filled.png and b/user/img/06-new-consolidation-filled.png differ diff --git a/user/img/07-consolidation-created.png b/user/img/07-consolidation-created.png index 3e508d1..ea23dcc 100644 Binary files a/user/img/07-consolidation-created.png and b/user/img/07-consolidation-created.png differ diff --git a/user/img/08-group-version-selected.png b/user/img/08-group-version-selected.png index 11bc6b7..0c88ae5 100644 Binary files a/user/img/08-group-version-selected.png and b/user/img/08-group-version-selected.png differ diff --git a/user/img/09-version-row-menu.png b/user/img/09-version-row-menu.png index 7c453b2..1b58c88 100644 Binary files a/user/img/09-version-row-menu.png and b/user/img/09-version-row-menu.png differ diff --git a/user/img/10-documents-panel.png b/user/img/10-documents-panel.png index 7377ac7..ac6318c 100644 Binary files a/user/img/10-documents-panel.png and b/user/img/10-documents-panel.png differ diff --git a/user/img/11-upload-modal-empty.png b/user/img/11-upload-modal-empty.png index c2adf40..c981641 100644 Binary files a/user/img/11-upload-modal-empty.png and b/user/img/11-upload-modal-empty.png differ diff --git a/user/img/12-upload-modal-files.png b/user/img/12-upload-modal-files.png index 8d73b20..8c44676 100644 Binary files a/user/img/12-upload-modal-files.png and b/user/img/12-upload-modal-files.png differ diff --git a/user/img/13-upload-accepted.png b/user/img/13-upload-accepted.png index 0a4c8b2..c32256c 100644 Binary files a/user/img/13-upload-accepted.png and b/user/img/13-upload-accepted.png differ diff --git a/user/img/14-documents-panel-processing.png b/user/img/14-documents-panel-processing.png index 47703b2..d195455 100644 Binary files a/user/img/14-documents-panel-processing.png and b/user/img/14-documents-panel-processing.png differ diff --git a/user/img/15-documents-panel-loaded.png b/user/img/15-documents-panel-loaded.png index 40e059a..1b9051c 100644 Binary files a/user/img/15-documents-panel-loaded.png and b/user/img/15-documents-panel-loaded.png differ diff --git a/user/img/16-upload-rejected-duplicate.png b/user/img/16-upload-rejected-duplicate.png index 191f74d..3d8089b 100644 Binary files a/user/img/16-upload-rejected-duplicate.png and b/user/img/16-upload-rejected-duplicate.png differ diff --git a/user/img/17-osv-document.png b/user/img/17-osv-document.png index 81b6865..b4bd80a 100644 Binary files a/user/img/17-osv-document.png and b/user/img/17-osv-document.png differ diff --git a/user/img/18-documents-panel-pdf.png b/user/img/18-documents-panel-pdf.png index 5541643..b554c8d 100644 Binary files a/user/img/18-documents-panel-pdf.png and b/user/img/18-documents-panel-pdf.png differ diff --git a/user/img/19-review-bb.png b/user/img/19-review-bb.png index 919932b..061bfc8 100644 Binary files a/user/img/19-review-bb.png and b/user/img/19-review-bb.png differ diff --git a/user/img/20-review-edit.png b/user/img/20-review-edit.png index 9223989..b50756a 100644 Binary files a/user/img/20-review-edit.png and b/user/img/20-review-edit.png differ diff --git a/user/img/21-review-violations.png b/user/img/21-review-violations.png index 9010ebb..811ec6b 100644 Binary files a/user/img/21-review-violations.png and b/user/img/21-review-violations.png differ diff --git a/user/img/22-review-confirm-blocked.png b/user/img/22-review-confirm-blocked.png index be1588d..a458c33 100644 Binary files a/user/img/22-review-confirm-blocked.png and b/user/img/22-review-confirm-blocked.png differ diff --git a/user/img/23-review-accept-modal.png b/user/img/23-review-accept-modal.png index 4389779..01fd576 100644 Binary files a/user/img/23-review-accept-modal.png and b/user/img/23-review-accept-modal.png differ diff --git a/user/img/24-review-accepted.png b/user/img/24-review-accepted.png index 2af7f27..d5fb85e 100644 Binary files a/user/img/24-review-accepted.png and b/user/img/24-review-accepted.png differ diff --git a/user/img/25-review-invalid-format.png b/user/img/25-review-invalid-format.png index da820f2..4d6d953 100644 Binary files a/user/img/25-review-invalid-format.png and b/user/img/25-review-invalid-format.png differ diff --git a/user/img/26-review-edit-header.png b/user/img/26-review-edit-header.png index 89e47d5..652bd7c 100644 Binary files a/user/img/26-review-edit-header.png and b/user/img/26-review-edit-header.png differ diff --git a/user/img/27-review-confirmed.png b/user/img/27-review-confirmed.png index 755dc52..fbac6b1 100644 Binary files a/user/img/27-review-confirmed.png and b/user/img/27-review-confirmed.png differ diff --git a/user/img/28-review-ofr.png b/user/img/28-review-ofr.png index 927b2d4..652abeb 100644 Binary files a/user/img/28-review-ofr.png and b/user/img/28-review-ofr.png differ diff --git a/user/img/29-review-ofr-confirmed.png b/user/img/29-review-ofr-confirmed.png new file mode 100644 index 0000000..76d355d Binary files /dev/null and b/user/img/29-review-ofr-confirmed.png differ diff --git a/user/img/30-osv-summary.png b/user/img/30-osv-summary.png index d514f0c..83dea25 100644 Binary files a/user/img/30-osv-summary.png and b/user/img/30-osv-summary.png differ diff --git a/user/img/31-osv-gaps.png b/user/img/31-osv-gaps.png index 864ef04..24d0846 100644 Binary files a/user/img/31-osv-gaps.png and b/user/img/31-osv-gaps.png differ diff --git a/user/img/32-osv-filter-company.png b/user/img/32-osv-filter-company.png index a42da4a..55f7dce 100644 Binary files a/user/img/32-osv-filter-company.png and b/user/img/32-osv-filter-company.png differ diff --git a/user/img/33-osv-filter-counterparty.png b/user/img/33-osv-filter-counterparty.png index f4804fd..0ce1deb 100644 Binary files a/user/img/33-osv-filter-counterparty.png and b/user/img/33-osv-filter-counterparty.png differ diff --git a/user/img/34-osv-filtered.png b/user/img/34-osv-filtered.png index be4214f..92f4347 100644 Binary files a/user/img/34-osv-filtered.png and b/user/img/34-osv-filtered.png differ diff --git a/user/img/35-osv-counterparty-type.png b/user/img/35-osv-counterparty-type.png index 1ee9c18..693ace2 100644 Binary files a/user/img/35-osv-counterparty-type.png and b/user/img/35-osv-counterparty-type.png differ diff --git a/user/img/36-osv-no-inn.png b/user/img/36-osv-no-inn.png index bef33de..117cd3b 100644 Binary files a/user/img/36-osv-no-inn.png and b/user/img/36-osv-no-inn.png differ diff --git a/user/img/37-osv-map-modal.png b/user/img/37-osv-map-modal.png index f7b86fd..2994110 100644 Binary files a/user/img/37-osv-map-modal.png and b/user/img/37-osv-map-modal.png differ diff --git a/user/img/38-osv-filter-account.png b/user/img/38-osv-filter-account.png index d134178..5a15161 100644 Binary files a/user/img/38-osv-filter-account.png and b/user/img/38-osv-filter-account.png differ diff --git a/user/img/40-admin-users.png b/user/img/40-admin-users.png index c6eeaf3..cc4ad24 100644 Binary files a/user/img/40-admin-users.png and b/user/img/40-admin-users.png differ diff --git a/user/img/41-admin-create-user.png b/user/img/41-admin-create-user.png index 2eeae27..6de3fe7 100644 Binary files a/user/img/41-admin-create-user.png and b/user/img/41-admin-create-user.png differ diff --git a/user/img/42-admin-matrix.png b/user/img/42-admin-matrix.png index 5f9c368..89ce1dd 100644 Binary files a/user/img/42-admin-matrix.png and b/user/img/42-admin-matrix.png differ diff --git a/user/img/43-stub-mono.png b/user/img/43-stub-mono.png index 9f79067..5076567 100644 Binary files a/user/img/43-stub-mono.png and b/user/img/43-stub-mono.png differ diff --git a/user/img/44-sidebar-collapsed.png b/user/img/44-sidebar-collapsed.png index 3975c31..f6ec533 100644 Binary files a/user/img/44-sidebar-collapsed.png and b/user/img/44-sidebar-collapsed.png differ diff --git a/user/img/45-catalogue-groups.png b/user/img/45-catalogue-groups.png new file mode 100644 index 0000000..855697b Binary files /dev/null and b/user/img/45-catalogue-groups.png differ diff --git a/user/img/46-catalogue-gsk.png b/user/img/46-catalogue-gsk.png new file mode 100644 index 0000000..43ec98a Binary files /dev/null and b/user/img/46-catalogue-gsk.png differ diff --git a/user/img/47-catalogue-create-choice.png b/user/img/47-catalogue-create-choice.png new file mode 100644 index 0000000..f1caf17 Binary files /dev/null and b/user/img/47-catalogue-create-choice.png differ diff --git a/user/img/48-catalogue-le-form.png b/user/img/48-catalogue-le-form.png new file mode 100644 index 0000000..ac49f1a Binary files /dev/null and b/user/img/48-catalogue-le-form.png differ diff --git a/user/img/49-catalogue-le-outside.png b/user/img/49-catalogue-le-outside.png new file mode 100644 index 0000000..d1796b2 Binary files /dev/null and b/user/img/49-catalogue-le-outside.png differ diff --git a/user/img/50-checklist-modal.png b/user/img/50-checklist-modal.png new file mode 100644 index 0000000..c6d1a73 Binary files /dev/null and b/user/img/50-checklist-modal.png differ diff --git a/user/img/52-document-select.png b/user/img/52-document-select.png new file mode 100644 index 0000000..a0c1045 Binary files /dev/null and b/user/img/52-document-select.png differ diff --git a/user/img/53-comment-modal.png b/user/img/53-comment-modal.png new file mode 100644 index 0000000..14d9b9e Binary files /dev/null and b/user/img/53-comment-modal.png differ diff --git a/user/img/54-documents-panel-all.png b/user/img/54-documents-panel-all.png new file mode 100644 index 0000000..22fb6bf Binary files /dev/null and b/user/img/54-documents-panel-all.png differ diff --git a/user/img/55-file-warnings.png b/user/img/55-file-warnings.png new file mode 100644 index 0000000..cf0b55e Binary files /dev/null and b/user/img/55-file-warnings.png differ diff --git a/user/img/56-delete-modal.png b/user/img/56-delete-modal.png new file mode 100644 index 0000000..7d74906 Binary files /dev/null and b/user/img/56-delete-modal.png differ diff --git a/user/img/57-replace-modal.png b/user/img/57-replace-modal.png new file mode 100644 index 0000000..9cf3624 Binary files /dev/null and b/user/img/57-replace-modal.png differ diff --git a/user/img/58-review-nocode.png b/user/img/58-review-nocode.png new file mode 100644 index 0000000..9befb92 Binary files /dev/null and b/user/img/58-review-nocode.png differ diff --git a/user/img/59-review-row-menu.png b/user/img/59-review-row-menu.png new file mode 100644 index 0000000..52313ce Binary files /dev/null and b/user/img/59-review-row-menu.png differ diff --git a/user/user-guide.md b/user/user-guide.md index c841918..7983fba 100644 --- a/user/user-guide.md +++ b/user/user-guide.md @@ -1,16 +1,18 @@ -# Инструкция пользователя АРМ КА (прототип) +# АРМ КА — Инструкция пользователя -Документ описывает работу с текущей версией приложения **АРМ КА** — автоматизированного рабочего места кредитного -аналитика ДКБ: фронт `arm-web` (ветка `test`) и ядро `arm-core` (`main`) по состоянию на 09.10.2026. Снимки экранов -сделаны на локальном стенде с демо-данными группы компаний «Русский Бисквит» (окно браузера 1600×1000); на вашем стенде -названия организаций, даты и суммы могут отличаться, устройство экранов — то же. +АРМ КА — автоматизированное рабочее место кредитного аналитика ДКБ. Эта инструкция поможет создать консолидацию, +загрузить и проверить документы, получить сводную оборотно-сальдовую ведомость (ОСВ) и выгрузить её в Excel. На снимках +экранов приведены демонстрационные данные группы компаний «Русский Бисквит»; названия организаций, даты и суммы в вашем +интерфейсе могут отличаться. -Для кого: аналитик, который проверяет приложение или работает в нём впервые. Как поднять стенд, какие учётные записи -есть и как заводить дефекты — в гайде тестировщика [`../dev/qa-guide.md`](../dev/qa-guide.md) (разделы 4, 4.4 и 11); -здесь только путь пользователя по экранам. +Инструкция описывает фронт `arm-web` (ветка `test`) и ядро `arm-core` (`main`) по состоянию на 20.10.2026. Как поднять +стенд, какие учётные записи есть и как заводить дефекты — в гайде тестировщика +[`../dev/qa-guide.md`](../dev/qa-guide.md). ## Содержание +- [Основные понятия](#основные-понятия) +- [Быстрый старт](#быстрый-старт) 1. [Что умеет текущая версия](#1-что-умеет-текущая-версия) 2. [Вход в систему](#2-вход-в-систему) 3. [Устройство интерфейса](#3-устройство-интерфейса) @@ -21,10 +23,48 @@ 8. [Просмотр ОСВ](#8-просмотр-осв) 9. [Проверка форм ББ и ОФР](#9-проверка-форм-бб-и-офр) 10. [Сводная ОСВ](#10-сводная-осв) -11. [Администрирование: пользователи и роли](#11-администрирование-пользователи-и-роли) -12. [Статусы и термины](#12-статусы-и-термины) -13. [Ограничения текущей версии](#13-ограничения-текущей-версии) -14. [Если что-то пошло не так](#14-если-что-то-пошло-не-так) +11. [Справочники: группы компаний и организации](#11-справочники-группы-компаний-и-организации) +12. [Администрирование: пользователи и роли](#12-администрирование-пользователи-и-роли) +13. [Статусы и термины](#13-статусы-и-термины) +14. [Ограничения и известные ошибки](#14-ограничения-и-известные-ошибки) +15. [Если что-то пошло не так](#15-если-что-то-пошло-не-так) + +## Основные понятия + +Консолидация — работа с отчётностью выбранных организаций группы за указанные год и квартал для получения общего +результата. В текущей версии основной доступный результат — сводная ОСВ. + +Версия — конкретный вариант консолидации со своим составом организаций и статусом. При создании появляется версия 1; +функция добавления новой версии пока недоступна. Перед загрузкой документов выбирайте нужную версию в таблице +консолидаций. Загружать документы можно только в версию «в работе» — в статусе «Инициация», «Обработка документов» или +«Коррекция данных». + +Периметр — список организаций, включённых в выбранную версию и её расчёт. При создании его задают галочками в блоке «ЮЛ +консолидации». + +ГСК — группа связанных компаний внутри выбранной ГК. Выбирайте ГСК, указанную в задании на расчёт. Её участники +отмечаются автоматически, но перед созданием проверьте весь периметр. + +## Быстрый старт + +Маршрут: вход → выбор ГК → создание консолидации → загрузка → проверка → свод → выгрузка. + +1. Войдите в приложение по инструкции раздела 2. +2. Откройте «Отчётность → Группы компаний», найдите нужную ГК и нажмите «Консолидации» (разделы 4 и 5). +3. Если нужной консолидации нет, нажмите «+ Новая консолидация», выберите ГК, ГСК, год и квартал, проверьте состав + организаций и нажмите «Создать» (раздел 6). Если она уже есть, выберите нужную версию. +4. В выбранной версии откройте «Документы» нужной организации и загрузите её файлы. Повторите для остальных организаций; + дождитесь обработки (раздел 7). +5. Проверьте распознанные данные по исходникам, период, организацию и единицы измерения. При необходимости исправьте ББ + и ОФР и подтвердите документы. Документы без замечаний — и ОСВ, и формы ББ/ОФР — подтверждаются автоматически + (разделы 8 и 9). +6. Нажмите «К отчётности →» в строке версии. В сводной ОСВ проверьте пробелы по кварталам и сопоставьте контрагентов без + ИНН (раздел 10). +7. Установите нужные фильтры и выгрузите свод в XLSX. Выгрузка учитывает текущие фильтры; для полного свода + предварительно сбросьте их (раздел 10). + +Результат этого маршрута — проверенная сводная ОСВ и её выгрузка. Формирование КФО и маршрут согласования в текущей +версии ещё недоступны. ## 1. Что умеет текущая версия @@ -32,23 +72,27 @@ - список групп компаний (ГК) с поиском и фильтрами; - создание консолидации за квартал: ГК, группа связанных компаний (ГСК), год, квартал, состав юридических лиц (ЮЛ); -- страница ГК: список консолидаций и версий, состав организаций версии, чек-лист документов в CSV; -- загрузка первичных документов по каждому ЮЛ: ОСВ в Excel (`xls`, `xlsx`, `xlsb`), бухгалтерский баланс (ББ) и отчёт - о финансовых результатах (ОФР) в PDF и Excel; тип документа и период определяются автоматически; +- страница ГК: список консолидаций и версий, состав организаций версии, окно «Чеклист» с выгрузкой в CSV; +- загрузка первичных документов по каждому ЮЛ: ОСВ в Excel (`xls`, `xlsx`, `xlsb`), бухгалтерский баланс (ББ) и отчёт о + финансовых результатах (ОФР) в PDF и Excel; тип документа и период определяются автоматически; +- удаление ошибочного файла и замена файла актуальной версией; +- предупреждения распознавания у файла, документа, строки и ячейки; - просмотр распознанной ОСВ (только чтение) и подтверждение документа; -- проверка форм ББ/ОФР рядом со сканом: правка значений, логические проверки, принятие нарушений с комментарием, - подтверждение; +- проверка форм ББ/ОФР рядом со сканом: правка значений и шапки, разбор строк без кода и расшифровок, подтверждение + отдельных значений, логические проверки, принятие нарушений с комментарием, подтверждение формы; +- комментарий к документу; - сводная ОСВ по версии: фильтры, список пробелов по кварталам, тип контрагента (ГСК / ГК / Внешний), сопоставление контрагента без ИНН с организацией справочника, экспорт в Excel; +- справочники: группы компаний, ЮЛ, ГСК и ГСЗ — просмотр, создание, изменение, перевод ЮЛ в другую ГК и вывод из ГК; - администрирование: пользователи, роли, матрица «роль × право». -Чего в этой версии **нет** (пункты меню и вкладки показаны, но не работают — см. раздел 13): шахматка, таблица -корректировок, гудвилл, КФО, маршрут согласования и смена статусов вручную, Единое хранилище, журнал действий, экраны -справочников ГК/ЮЛ, монозаёмщики. Вход через корпоративный SSO заменён формой входа для разработки. +Чего в этой версии **нет** (пункты меню и вкладки показаны, но не работают — см. раздел 14): шахматка, таблица +корректировок, гудвилл, КФО, маршрут согласования и смена статусов вручную, Единое хранилище, журнал действий, +монозаёмщики, просмотр комментариев. Вход через корпоративный SSO заменён формой входа для разработки. ## 2. Вход в систему -Откройте адрес стенда (на локальном стенде — `http://localhost:3000/`). Появится форма «Вход для разработки». +Появится форма «Вход для разработки». ![Форма входа](img/01-login.png) @@ -56,7 +100,7 @@ 2. Нажмите «Войти (dev)». Список учётных записей стенда и их ролей — `qa-guide.md`, раздел 4.4. Для прохода по этой инструкции достаточно -`ka_go@armka.local` (аналитик головного офиса, роль KA_GO); раздел 11 требует `admin@armka.local`. +`ka_go@armka.local` (аналитик головного офиса, роль KA_GO); раздел 12 требует `admin@armka.local`. После входа открывается главная страница с ФИО пользователя и его ролями. @@ -70,8 +114,8 @@ ## 3. Устройство интерфейса -Слева — боковое меню, справа — рабочая область с «хлебными крошками» (например, «Отчётность › Группы компаний») -и кнопкой «← Назад» на вложенных экранах. +Слева — боковое меню, справа — рабочая область с «хлебными крошками» (например, «Отчётность › Группы компаний») и +кнопкой «← Назад» на вложенных экранах. Меню: @@ -80,10 +124,11 @@ | — | **+ Новая консолидация** | окно создания консолидации (раздел 6) | | Отчётность | Группы компаний | список ГК (раздел 4) — основной вход в работу | | Отчётность | Монозаемщики | заглушка | -| Справочники | ГК и организации, ЮЛ вне ГК | заглушки | +| Справочники | ГК и организации | справочник групп компаний, ЮЛ, ГСК и ГСЗ (раздел 11) | +| Справочники | ЮЛ вне ГК | организации, не входящие ни в одну ГК (раздел 11) | | Документы | Единое хранилище | заглушка | | Система | Журнал действий | заглушка | -| Система | Пользователи и роли | администрирование (раздел 11) | +| Система | Пользователи и роли | администрирование (раздел 12) | Кнопка «‹» в шапке меню сворачивает его до иконок; «›» разворачивает обратно. @@ -93,9 +138,10 @@ ![Заглушка «Монозаёмщики»](img/43-stub-mono.png) -Общие элементы таблиц: строка поиска над таблицей, воронка в заголовке колонки — фильтр по этой колонке (зелёная -воронка — фильтр активен), «Настройка таблицы» — выбор видимых колонок, «Сбросить фильтры» появляется, когда хотя бы -один фильтр применён. Уведомления об успехе и ошибках появляются вверху экрана и исчезают через несколько секунд. +Общие элементы таблиц: строка поиска над таблицей, воронка в заголовке колонки — фильтр по этой колонке (зелёная воронка +— фильтр активен), «Настройка таблицы» — выбор видимых колонок, «Сбросить фильтры» появляется, когда хотя бы один фильтр +применён. Уведомления об успехе и ошибках появляются вверху экрана и исчезают через несколько секунд; на экранах +справочников ошибки показываются внизу справа. ## 4. Группы компаний @@ -113,32 +159,41 @@ ![Страница группы компаний](img/04-group-page.png) -**Консолидации** — все консолидации группы, по строке на версию: «Год», «Квартал» (К1…К4), «Версия» (номер), -«Статус» (цветной бейдж, раздел 12), «ГСК», «Дата создания», «Дата верификации», «Организаций» (размер периметра). -Клик по строке выбирает версию: строка подсвечивается зелёным, адрес страницы получает `?version=`, а блок -«Организации» заполняется составом этой версии. +**Консолидации** — все консолидации группы, по строке на версию: «Год», «Квартал» (К1…К4), «Версия» (номер), «Статус» +(цветной бейдж, раздел 13), «ГСК», «Дата создания», «Дата верификации», «Организаций» (размер периметра). Клик по строке +выбирает версию: строка подсвечивается зелёным, адрес страницы получает `?version=`, а блок «Организации» +заполняется составом этой версии. ![Выбранная версия](img/08-group-version-selected.png) +Если консолидаций ещё нет, блок «Организации» будет пустым, даже когда в группу входят юридические лица. Создайте +консолидацию по разделу 6. Если консолидации есть, выберите строку нужной версии: после этого появится состав +организаций и станет доступна панель документов. + В строке версии: - «К отчётности →» — переход к сводной ОСВ версии (раздел 10); -- меню «⋮»: «Добавить версию» (в прототипе отвечает «Будет позже»), «Отключить подтверждение КФО» и «История - изменений» (заглушки). +- меню «⋮»: «Добавить версию» и «Отключить подтверждение КФО» (в прототипе отвечают «Будет позже»), «История изменений» + (открывает заглушку «Журнал действий»). ![Меню строки версии](img/09-version-row-menu.png) -**Организации** — периметр выбранной версии. Над таблицей: «Ответственный» (кто создал версию), «Утверждён в РФ» и -«Верифицирован в ГО» (в этой версии всегда «—»), кнопки «Настройка таблицы» и «Скачать чек-лист». Колонки: -«Наименование», «Документы» (кнопка открытия панели документов, раздел 7), «ОФР» и «Бух.баланс» (статус формы за -отчётный период: «Отсутствует», «Обработка», «Требуется проверка», «Загружен»), «ОСВ» (счета, по которым загружены -ведомости), «ИНН», «Тип» (ЮЛ / ИП). +**Организации** — периметр выбранной версии. Над таблицей: «Ответственный» (кто взял версию в работу, а если её никто не +взял — кто её создал), «Утверждён в РФ» и «Верифицирован в ГО» (в этой версии всегда «—»), кнопки «Настройка таблицы» и +«Скачать чек-лист». Колонки: «Наименование», «Документы» (кнопка открытия панели документов, раздел 7), «ОФР» и +«Бух.баланс» (статус формы за отчётный период: «Отсутствует», «В обработке», «Распознан», «Требуется проверка», +«Загружен», «Ошибка»), «ОСВ» (счета, по которым загружены ведомости), «ИНН», «Тип» (ЮЛ / ИП). -«Скачать чек-лист» сохраняет файл `checklist-<ГК>-<год>-Q<квартал>.csv` (разделитель `;`, открывается в Excel) со -статусом каждого требуемого документа по каждому ЮЛ периметра. Кнопка активна только при выбранной версии. +«Скачать чек-лист» открывает окно «Чеклист»: по строке на каждое ЮЛ периметра и по колонке на каждый требуемый документ +— «Бух.баланс», «ОФР» и ОСВ по счетам (01, 58, 60, 62, 66, 67, 76, 90). В ячейках — значки статуса, расшифровка значков +— в строке «Условные обозначения» над таблицей. ОСВ отмечается как «Отсутствует», если за какой-либо квартал периода её +нет (см. «Пробелы» в разделе 10). Кнопка «Скачать чек-лист» в окне сохраняет файл `checklist-<ГК>-<год>-Q<квартал>.csv` +(разделитель `;`, открывается в Excel) и закрывает окно. Кнопка на странице активна только при выбранной версии. -Таблица консолидаций обновляется при перезагрузке страницы (F5): сразу после создания консолидации новая строка может -появиться только после обновления. +![Окно «Чеклист»](img/50-checklist-modal.png) + +Новая консолидация появляется в таблице сразу после создания. Смена статуса версии (например, на «Коррекция данных» +после загрузки документов) видна после перезагрузки страницы (F5). ## 6. Новая консолидация @@ -149,7 +204,8 @@ Заполните поля по порядку: 1. «Группа компаний» — ГК из списка доступных вам. -2. «ГСК» — группа связанных компаний внутри ГК (поле активно после выбора ГК). +2. «ГСК» — группа связанных компаний внутри ГК (поле активно после выбора ГК). Выберите ГСК по заданию на расчёт; если + выбор неясен, уточните его у ответственного за расчёт. 3. «Год» — текущий и три предыдущих. 4. «Квартал» — 1–4 квартал. @@ -159,8 +215,8 @@ ![Заполненное окно с составом ЮЛ](img/06-new-consolidation-filled.png) -«Создать» создаёт консолидацию и версию 1 в статусе «Инициация», показывает уведомление «Создана консолидация <год>, -<квартал>» и открывает страницу ГК с выбранной версией. +«Создать» создаёт консолидацию и версию 1 в статусе «Инициация», показывает уведомление «Создана консолидация \<год\>, +\<квартал\>» и открывает страницу ГК с выбранной новой версией. ![Консолидация создана](img/07-consolidation-created.png) @@ -175,20 +231,36 @@ ## 7. Первичные документы: загрузка и статусы Документы загружаются по каждой организации отдельно. На странице ГК выберите версию и нажмите «Документы» в строке -организации (или кликните по строке). Справа откроется панель «ПЕРВИЧНЫЕ ДОКУМЕНТЫ» с названием и ИНН организации и -списком всех её файлов (не только текущего периода). +организации (или кликните по строке). Справа откроется панель «ПЕРВИЧНЫЕ ДОКУМЕНТЫ» с названием и ИНН организации. + +По умолчанию панель показывает документы этой организации, относящиеся к выбранной консолидации: загруженные в неё, а +также ОСВ предыдущих кварталов, которые нужны для периода версии (например, для консолидации за 2 квартал — ОСВ за 1 и 2 +кварталы). Переключатель «Все документы организации» над таблицей показывает все файлы организации — подробнее в разделе +7.3. ![Панель первичных документов](img/10-documents-panel.png) Колонки панели: «Документ» (имя файла; под ним — тип документа, формат и дата загрузки, например «ОСВ 60 · XLS · -09.10.2026»), «Период» (определённый из документа, например «2024 К3»), «Проверка» (две отметки: «Период» и -«Контрагент» — совпадает ли организация в шапке документа с ЮЛ, на которое он загружен: ✓ совпадает, ✗ не совпадает, -— не проверялось), «Статус» (раздел 12). Крестик в правом верхнем углу закрывает панель. +20.10.2026»), «Период» (определённый из документа, например «2024 К3»), «Проверка» (две отметки: «Период» и «Контрагент» +— совпадает ли организация в шапке документа с ЮЛ, на которое он загружен: ✓ совпадает, ✗ не совпадает, «—» не +проверялось), «Статус» (раздел 13; под статусом — значок с числом предупреждений, раздел 7.4) и кнопка-корзина для +удаления или замены файла (раздел 7.5). Крестик в правом верхнем углу закрывает панель. + +Отметка «Период» временно не вычисляется и всегда показывает «—»: пока сверяйте период документа с периодом версии по +колонке «Период». + +Клик по строке открывает документ: ОСВ — на экране «Просмотр ОСВ» (раздел 8), ББ и ОФР — на экране «Проверка +распознавания» (раздел 9). Если документ открыть нельзя (расшифровка, прочий документ, файл ещё в обработке или с +ошибкой), появится уведомление «Просмотр данного документа недоступен». ### 7.1 Загрузка +Загрузка возможна только в версию «в работе» (статусы «Инициация», «Обработка документов», «Коррекция данных»). В других +статусах кнопка «Загрузить документы» неактивна, а при наведении появляется подсказка «Загрузка доступна только в версии +в работе». + 1. «Загрузить документы» → окно «Загрузка документов». -2. Перетащите файлы в область или нажмите «Выбрать документы». Принимаются ОСВ, ББ и ОФР в форматах `xls`, `xlsx`, +2. Переместите файлы в область или нажмите «Выбрать документы». Принимаются ОСВ, ББ и ОФР в форматах `xls`, `xlsx`, `xlsb`, `pdf`, `png`, `jpg`; тип документа и период система определяет сама. ![Окно загрузки](img/11-upload-modal-empty.png) @@ -201,130 +273,276 @@ ![Файлы приняты](img/13-upload-accepted.png) 4. «Готово» закрывает окно. Принятые файлы появляются в панели со статусом «Обработка»; панель сама опрашивает сервер - раз в 5 секунд, пока есть файлы в обработке. Распознавание Excel-ОСВ занимает 5–15 секунд, PDF — до минуты. + раз в 5 секунд, пока есть файлы в обработке. Время распознавания зависит от объёма файла и загрузки стенда. Для + тестовых документов ориентир — 5–15 секунд для Excel-ОСВ и до минуты для PDF; это не гарантированный срок обработки. ![Файлы в обработке](img/14-documents-panel-processing.png) -Когда распознавание завершено, у каждого файла заполняются тип, период и проверки; чистые ОСВ (период распознан, -организация совпала) подтверждаются автоматически и получают статус «Загружен». +Когда распознавание завершено, у каждого файла заполняются тип, период и проверки. Документы без замечаний (организация +совпала, нет нарушений и препятствий подтверждению) подтверждаются автоматически и получают статус «Загружен» — это +касается и ОСВ, и форм ББ/ОФР. ![Документы распознаны](img/15-documents-panel-loaded.png) -Повторная загрузка файла с тем же именем для того же ЮЛ отклоняется: «Отклонено: 1 — файл «…» уже загружен для этого -ЮЛ», уведомление «Ни один файл не принят». +Повторная загрузка файла с тем же содержимым для того же ЮЛ отклоняется независимо от имени файла: «Отклонено: 1 — файл +«…» уже загружен для этого ЮЛ», уведомление «Ни один файл не принят». Переименование файла не позволяет загрузить дубль. ![Дубликат отклонён](img/16-upload-rejected-duplicate.png) +Изменённый файл (с другим содержимым) принимается. После его распознавания работает автозамена: если у этого ЮЛ уже есть +файл с документом того же типа, того же счёта ОСВ и того же периода, прежний файл заменяется новым и исчезает из панели +— даже если его документы были подтверждены. Документы нового файла нужно проверить заново, если они не подтвердились +автоматически. Заменить файл явно, с указанием причины, можно через корзину (раздел 7.5). + +Статус версии в таблице консолидаций меняется по мере работы с документами: после первого принятого файла — «Обработка +документов», после первого подтверждённого документа или документа, требующего проверки, — «Коррекция данных». Ждать +загрузки по всем организациям не нужно. Новый статус виден после F5. + ### 7.2 Один файл — несколько документов -PDF с бухгалтерской отчётностью даёт два документа: «Бух. баланс · PDF» и «ОФР · PDF». Если в скане другая -организация, у обоих будет «Контрагент ✗» и статус «Требуется проверка» — их нужно проверить вручную (раздел 9). +Если PDF содержит бухгалтерский баланс и ОФР и обе формы распознаны, в панели появляются два документа: «Бух. баланс · +PDF» и «ОФР · PDF». PDF с одной формой не обязан создавать два документа. Если в распознанной форме другая организация, +у соответствующего документа будет «Контрагент ✗» и статус «Требуется проверка» — проверьте форму вручную по разделу 9. +Система не запрещает подтвердить такую форму, поэтому решение остаётся за аналитиком. ![PDF распознан в два документа](img/18-documents-panel-pdf.png) -После того как по всем организациям периметра загружены документы, статус версии в таблице консолидаций меняется: -«Обработка документов», пока идёт распознавание, затем «Коррекция данных» (видно после F5). +### 7.3 Все документы организации + +Переключатель «Все документы организации» показывает все файлы организации, независимо от консолидации и периода. У +файлов, загруженных в другую консолидацию, во второй строке добавляется её период, например «· 2025 К1», а у файлов вне +консолидаций — «вне консолидации». Каждое новое открытие панели возвращает переключатель в исходное положение. +Заменённые файлы не показываются ни в одном режиме. + +![Все документы организации](img/54-documents-panel-all.png) + +### 7.4 Предупреждения + +Под статусом документа показывается значок с числом предупреждений: синий «i» — информация, красный «!» — ошибка. Клик +по значку открывает окно «Предупреждения» с разделами «Предупреждения файла», «Предупреждения обработки» и +«Предупреждения документа»; у каждой строки — метка «Информация» или «Ошибка». + +![Предупреждения документа](img/55-file-warnings.png) + +Информационные предупреждения не мешают работе. Например, у ОСВ часто встречается «иерархия строк — по группировке листа +(outline)», у сканов — «ИНН не найден», «Дата отчёта не разобрана». Те же предупреждения показываются на экранах +просмотра документа (разделы 8 и 9). + +### 7.5 Удаление и замена файла + +Кнопка-корзина в конце строки открывает окно «Удаление документа» с выбором причины. Удаление и замена действуют на файл +целиком — со всеми его документами. + +![Удаление документа](img/56-delete-modal.png) + +- **«Ошибочный документ» → «Удалить»** — файл удаляется без возможности восстановления, уведомление «Файл удалён». + Сервер откажет, если в файле есть документы, подтверждённые пользователем вручную, если файл заменил более раннюю + версию или если документ привязан к версии консолидации вне корректировки данных — текст причины появится в + уведомлении. +- **«Замена документа» → «Заменить»** открывает окно «Замена документа»: укажите причину замены (обязательно, до 4000 + символов), перетащите новый файл в область или нажмите «Выбрать документ» и нажмите «Загрузить». Кнопка «Заменить» + активна только в версии «в работе». + +![Замена документа](img/57-replace-modal.png) + +После загрузки появится уведомление «Файл загружен: прежний будет заменён после разбора, если совпадут тип, счёт и +период». Причина замены сохраняется комментарием к заменяемому документу. ## 8. Просмотр ОСВ -Клик по строке ОСВ в панели документов открывает экран «Просмотр ОСВ»: крошки «Отчётность › <ЮЛ> › Проверка -документа», имя файла, формат и дата, справа — статус документа. +Клик по строке ОСВ в панели документов открывает экран «Просмотр ОСВ»: крошки «Отчётность › \<ЮЛ\> › Проверка +документа», имя файла, формат и дата. Справа вверху — список «Документ» и статус документа, ниже — кнопка «Добавить +комментарий». ![Просмотр ОСВ](img/17-osv-document.png) -- Строки ОСВ только для чтения, суммы в рублях. Колонки: «Субсчёт», «Контрагент / аналитика», «ИНН», сальдо на начало - периода (Дебет / Кредит), обороты за период (Дебет / Кредит), сальдо на конец периода (Дебет / Кредит). Ноль - показывается как «—». -- Поле «Контрагент или ИНН» фильтрует строки, «Субсчёт» — выбор субсчёта; «Строк: N» — число строк после фильтра. -- Внизу «Итого по документу». -- «✓ Подтвердить» активна только для документа в статусе «Требуется проверка»; у автоматически подтверждённых ОСВ +- Строки ОСВ только для чтения, суммы в рублях. Колонки показываются по содержимому файла: «Субсчёт»; колонка аналитики + — «Контрагент», название вида аналитики из файла (например «Основные средства») или «Аналитика», если видов несколько; + «ИНН» — только если в ОСВ есть контрагенты; «Подразделение» — если оно есть в файле; далее сальдо на начало периода + (Дебет / Кредит), обороты за период (Дебет / Кредит), сальдо на конец периода (Дебет / Кредит). Ноль показывается как + «—». +- Поле «Контрагент или ИНН» (или «Поиск по аналитике», если контрагентов нет) фильтрует строки, «Субсчёт» — выбор + субсчёта; «Строк: N» — число строк после фильтра. +- Таблица прокручивается внутри экрана, внизу закреплена строка «Итого по документу». +- Если у документа есть предупреждения, над таблицей показывается блок «Предупреждения (N)» (раздел 7.4). +- «Подтвердить» активна только для документа в статусе «Требуется проверка»; у автоматически подтверждённых ОСВ («Загружен») она неактивна. Подтверждение переводит документ в «Загружен», после чего он участвует в сводной ОСВ. +### 8.1 Переход между документами и комментарий + +Список «Документ» в шапке экрана содержит другие документы той же организации из той же консолидации — с типом, +форматом, датой и статусом. Выбор пункта открывает этот документ без возврата к панели. Так же удобно переходить между +ББ и ОФР одного файла. + +![Список «Документ»](img/52-document-select.png) + +«Добавить комментарий» открывает окно с полем «Комментарий» (до 4000 символов). «Добавить» сохраняет комментарий, +уведомление «Комментарий добавлен». Комментарий можно оставить к документу в любом статусе; посмотреть сохранённые +комментарии в текущей версии нельзя (раздел 14). + +![Добавить комментарий](img/53-comment-modal.png) + ## 9. Проверка форм ББ и ОФР -Клик по строке «Бух. баланс» или «ОФР» в панели документов открывает экран «Проверка распознавания». Слева — -«ИСХОДНЫЙ ДОКУМЕНТ»: страницы PDF с масштабом («−», «100%», «+», сброс). Справа — «РЕЗУЛЬТАТ РАСПОЗНАВАНИЯ». +Клик по строке «Бух. баланс» или «ОФР» в панели документов открывает экран «Проверка распознавания». Шапка экрана — как +у просмотра ОСВ: список «Документ», статус, «Добавить комментарий» (раздел 8.1). Слева — «ИСХОДНЫЙ ДОКУМЕНТ»: страницы +PDF с масштабом («−», «100%», «+», сброс). Справа — «РЕЗУЛЬТАТ РАСПОЗНАВАНИЯ». ![Проверка бухгалтерского баланса](img/19-review-bb.png) Правая часть сверху вниз: -- шапка: «ИНН», «Дата отчёта», «Единица измерения». Нераспознанное значение — «—» на оранжевом фоне; -- название формы («Бухгалтерский баланс» / «Отчёт о финансовых результатах») и дата, если она есть; -- блок проверок: зелёный «Проверки пройдены» или красный «Нарушения (N)» с формулами (раздел 9.2); +- шапка: «Организация», «ИНН», «Дата отчёта», «Единица измерения». Нераспознанное значение — «—». Оранжевым фоном + выделяются только поля, которые система просит проверить; значок «i» или «!» рядом со значением — предупреждение, + текст которого виден при наведении; +- название формы («Бухгалтерский баланс» / «Отчёт о финансовых результатах») и дата «на ДД.ММ.ГГГГ», если она известна; +- блок проверок: зелёный «Проверки пройдены» или красный «Нарушения (N)», жёлтый «Предупреждения проверок (N)» (раздел + 9.3); +- блок «Предупреждения (N)» — предупреждения распознавания с указанием места: строка, поле шапки, колонка. Ссылка + «Показать» прокручивает таблицу к нужной строке; +- переключатели «Показать расшифровки (N)» и «Показать пустые строки детализации (N)» (раздел 9.1); +- красная строка «Изменённых значений: X. Значений, требующих проверки: Y» — пока документ в статусе «Требуется + проверка»; - таблица формы: «Наименование показателя», «Код», колонки периодов как в документе. Разделы («АКТИВ», «I. Внеоборотные - активы» …) — серые полосы, итоговые строки — жирным, строки «БАЛАНС» (1600 и 1700) — фиолетовым фоном. Пустые - значения — «-». Ячейка с уверенностью распознавания ниже 100 % подсвечена оранжевым, при наведении — «Уверенность: - N%». В форме показаны все строки шаблона, в том числе отсутствующие в источнике (пустые). + активы» …) — серые полосы, итоговые строки — жирным, строки «БАЛАНС» (1600 и 1700) — фиолетовым фоном. -Кнопки: «✎ Редактировать» и «✓ Подтвердить данные». +Кнопки: «Редактировать» и «Подтвердить данные». -Формы, загруженные в Excel, открываются тем же экраном, но слева вместо скана — «Превью недоступно для этого формата» -и кнопка «Скачать исходник». +Формы, загруженные в Excel, открываются тем же экраном, но слева вместо скана — «Превью недоступно для этого формата» и +кнопка «Скачать исходник». -### 9.1 Правка значений +Суммы ББ и ОФР отображаются в единице измерения, указанной в шапке формы. При импорте Excel (`xls`, `xlsx`) учитываются +числовые форматы ячеек, масштаб и округление исходного отчёта. Например, если Excel показывает 90 при единице «тыс. +рублей», в результате распознавания также отображается 90, а не 90 000. Расходы, показанные в исходнике в скобках, +сохраняют отрицательный знак; прочерк не заменяется скрытой ненулевой суммой. Для `xlsb` формат чисел не читается: +значения берутся как они хранятся в файле, а у документа появляется предупреждение «формат чисел xlsb не читается». -«✎ Редактировать» переводит таблицу и шапку в режим ввода; кнопки меняются на «✓ Сохранить» и «Отменить». +### 9.1 Строки и значения формы + +В таблице есть строки нескольких видов: + +- **строка с кодом** — обычная строка формы. Если её наименование в файле отличается от справочного, справочное + показывается первым, а распознанное — второй строкой серым; +- **строка без кода** — код не распознан или его нет в документе. Строка выделена красноватым фоном, в колонке «Код» + серым — распознанный текст или «—»; при наведении — «Код не распознан: «…»» или «Кода в строке нет»; +- **расшифровка** — строка «в том числе», которая в суммы формы не входит. По умолчанию расшифровки скрыты, их + показывает переключатель «Показать расшифровки (N)»; +- **подстрока (строка детализации)** — показывается с отступом сразу под своей строкой-родителем. Пустые подстроки + скрыты, их показывает переключатель «Показать пустые строки детализации (N)»; +- **шаблонная строка** — строка формы, которой нет в документе: система достраивает форму по справочнику, такая строка + пустая. Ввод суммы в неё создаёт строку. + +![Строка без кода](img/58-review-nocode.png) + +Значения: + +- пустое значение — «-»; если сумма не распознана, а текст есть, вместо суммы серым показан распознанный текст (например + «(Ю4)»); +- оранжевым подсвечены только значения, которые система просит проверить; низкая уверенность распознавания сама по себе + подсветку не включает; +- при наведении на ячейку видно: «Исходное: …» (если значение исправлено), «Распознано: «…»», «Уверенность: N%», «Не + распознано как сумма: «…»», «Подтверждено аналитиком» и тексты предупреждений; +- серая галочка слева от суммы — значение подтверждено аналитиком, значок «i» или «!» — у значения есть предупреждение. + +Если в форме есть строки без кода со значениями, над таблицей появляется ссылка «Разберите строки без кода: N», а +«Подтвердить данные» неактивна, пока такие строки не разобраны (раздел 9.2). + +### 9.2 Правка значений + +«Редактировать» переводит таблицу и шапку в режим ввода; кнопки меняются на «Сохранить» и «Отменить». Все правки +отправляются на сервер одним сохранением. ![Режим правки](img/20-review-edit.png) - Суммы вводятся числом (без пробелов, дробная часть через точку или запятую); знак «−» допустим. -- Шапка: «ИНН», «Дата отчёта» строго в формате `ГГГГ-ММ-ДД`, «Единица измерения». Поля шапки можно заменить, но нельзя - очистить. +- Шапка: «Организация» (до 1000 символов), «ИНН» (10 или 12 цифр), «Дата отчёта» в формате `ГГГГ-ММ-ДД`, «Единица + измерения». Поля шапки можно заменить, но нельзя очистить. У даты отчёта, которую система просит проверить, есть + кнопка «Подтвердить». Правка организации или ИНН пересчитывает проверку «Контрагент». +- Рядом со значением, которое система просит проверить, есть кнопка-галочка «Подтвердить значение»; у подтверждённого — + «Снять подтверждение». - «Отменить» сбрасывает все несохранённые правки. -- «✓ Сохранить» отправляет изменения: уведомление «Изменения сохранены», проверки пересчитываются. Исправленная ячейка - подсвечивается голубым, при наведении видно «Исходное: <значение>» — распознанное значение не теряется. +- «Сохранить» отправляет изменения: уведомление «Изменения сохранены», проверки пересчитываются. Исправленная ячейка + подсвечивается голубым, при наведении видно «Исходное: \<значение\>» — распознанное значение не теряется. ![Правка шапки: дата отчёта](img/26-review-edit-header.png) +**Меню строки «⋮».** В режиме правки рядом с наименованием строки есть кнопка «⋮» с действиями: + +- у строки без кода — «Это расшифровка»; чтобы назначить код, введите его в поле «Код» этой строки; +- у расшифровки — «Назначить код»; +- у строки с кодом — «Сделать расшифровкой», «Сменить код», а также «Подтвердить код» или «Снять подтверждение кода»; +- после выбора действия — «Отменить изменение строки». + +Поле «Код» подсказывает варианты «\<код\> — \<наименование\>» из справочника формы. Код — 4 или 5 цифр. Выбранное +действие отмечается в колонке «Код» меткой («→ расшифровка», «→ код подтверждён»). У шаблонных строк меню нет. + +![Меню строки](img/59-review-row-menu.png) + Если в ячейке не число (например `abc`), она обводится красным с подсказкой «Неверный формат суммы», появляется -уведомление «Исправьте суммы с неверным форматом», и запрос на сервер не уходит. +уведомление «Исправьте суммы с неверным форматом», и запрос на сервер не уходит. Похожим образом отклоняются неверный +код («Код — 4 или 5 цифр») и неверная дата колонки («Дата в формате ГГГГ-ММ-ДД»). ![Неверный формат суммы](img/25-review-invalid-format.png) -### 9.2 Логические проверки и нарушения +### 9.3 Логические проверки и нарушения -После каждого сохранения система проверяет форму по контрольным соотношениям (итоги разделов, баланс актива и пассива, -связи строк ОФР). Нарушения показываются красным блоком «Нарушения (N)»: «Колонка N: <формула> — ожидалось X, -получено Y». Жёлтый блок «Расхождения в пределах округления» — отклонения, которые не блокируют подтверждение. +После каждого сохранения система проверяет форму по контрольным соотношениям: итоги разделов, баланс актива и пассива, +связи строк ОФР. Нарушения показываются красным блоком «Нарушения (N)»: «Колонка N: \<формула\> — ожидалось X, получено +Y». Ссылка «Показать» прокручивает таблицу к строке и на пару секунд обводит её синей рамкой; ячейки, участвующие в +нарушении, отмечены значком «!». -![Нарушения после правки](img/21-review-violations.png) +![Нарушения формы](img/21-review-violations.png) -Пока есть нарушения, «✓ Подтвердить данные» отвечает красным блоком «не пройдены логические проверки формы: исправьте +Жёлтый блок «Предупреждения проверок (N)» показывает соотношения, которые не блокируют подтверждение: мягкие проверки +(например, «сумма подстрок = родитель») и расхождения в пределах округления. Жёлтый блок «Межформенная проверка ББ↔ОФР» +сверяет показатели баланса и ОФР одного файла. + +Пока есть нарушения, «Подтвердить данные» отвечает красным блоком «не пройдены логические проверки формы: исправьте значения или акцептуйте с комментарием» с тем же списком, документ не подтверждается. ![Подтверждение заблокировано нарушениями](img/22-review-confirm-blocked.png) -Два пути: исправить значения (раздел 9.1) или принять нарушения осознанно — «Принять с комментарием». В окне -«Принять нарушения» комментарий обязателен (до 2000 символов), без него «Принять» неактивна. +Два пути: исправить значения (раздел 9.2) или принять нарушения осознанно — «Принять с комментарием». В окне «Принять +нарушения» комментарий обязателен (до 2000 символов), без него «Принять» неактивна. Пока есть несохранённые правки, +«Принять с комментарием» неактивна с подсказкой «Сначала сохраните изменения». ![Окно принятия нарушений](img/23-review-accept-modal.png) После принятия под нарушениями появляется синий блок «Нарушения приняты» с датой, временем и комментарием; подтверждение -становится возможным. Любая новая правка значений сбрасывает принятие — нарушения нужно принять заново. +становится возможным. Правка данных — сумм, кодов строк, шапки — сбрасывает принятие, и нарушения нужно принять заново. +Подтверждение отдельных значений и дат принятие не сбрасывает. ![Нарушения приняты](img/24-review-accepted.png) -### 9.3 Подтверждение +### 9.4 Подтверждение -Для подтверждения в шапке должна быть «Дата отчёта» на конец квартала (например `2025-06-30`). Если дата пустая или не -на конец квартала, «✓ Подтвердить данные» показывает красный блок с текстом сервера и подсказкой «Исправьте дату отчёта -в шапке и сохраните». - -Когда проверки пройдены (или нарушения приняты) и дата указана, «✓ Подтвердить данные» подтверждает документ: -уведомление «Документ подтверждён», статус «Загружен», кнопки «Редактировать» и «Подтвердить данные» становятся -неактивными — дальнейшая правка невозможна. +«Подтвердить данные» подтверждает документ, если для этого нет препятствий: уведомление «Документ подтверждён», статус +«Загружен», кнопки «Редактировать» и «Подтвердить данные» становятся неактивными — дальнейшая правка невозможна. ![Документ подтверждён](img/27-review-confirmed.png) +Система проверяет по порядку и показывает красный блок с причиной, если: + +| Причина | Текст | Что сделать | +|---|---|---| +| Не определён период формы | «у формы не определён период: поправьте дату отчёта» и подсказка «Исправьте дату отчёта в шапке и сохраните» | укажите «Дату отчёта» на конец квартала (например `2025-06-30`) и сохраните | +| Есть строки без кода со значениями | «в форме есть нераспознанные строки со значениями: назначьте код или отметьте строку расшифровкой» и ссылка «Разберите строки без кода: N» | назначьте код или отметьте строку расшифровкой (раздел 9.2) | +| Форма этого типа и периода в файле уже подтверждена | «форма этого типа и периода в файле уже подтверждена» и ссылка «Открыть подтверждённую форму» | проверьте подтверждённую форму | +| Есть нарушения логических проверок | «не пройдены логические проверки формы…» | исправьте значения или примите нарушения (раздел 9.3) | + +Если «Дата отчёта» пуста, период формы определяется по датам колонок, поэтому пустая дата не всегда мешает +подтверждению. + ОФР того же файла открывается отдельным документом с колонками периодов ОФР («За январь – июнь 2025 г.» и т. п.); правила проверки и подтверждения те же. ![Проверка ОФР](img/28-review-ofr.png) +![ОФР подтверждён после принятия нарушений](img/29-review-ofr-confirmed.png) + ## 10. Сводная ОСВ -Нажмите «К отчётности →» в строке версии. Откроется экран «<ГК> — <год> К<квартал>» со статусом отчёта в правом +Нажмите «К отчётности →» в строке версии. Откроется экран «\<ГК\> — \<год\> К\<квартал\>» со статусом отчёта в правом верхнем углу и вкладками: «ОСВ» (активна), «Шахматка», «Таблица корректировки», «Гудвилл», «КФО», «КФО Общий», «Подтверждение КФО клиента» (неактивны, подсказка «Будет в следующих срезах»). @@ -334,14 +552,14 @@ PDF с бухгалтерской отчётностью даёт два док - **Жёлтый баннер «Требуется указать соответствия»** — сколько строк с внешними контрагентами без ИНН ещё не сопоставлено («Осталось: N»); кнопка «Показать ЮЛ без ИНН» включает фильтр только по таким строкам (раздел 10.3). -- **«Пробелы: N»** — свёрнутый список счетов, по которым за часть кварталов периода нет ОСВ; строки таких счетов в - свод не попадают. Клик раскрывает список: «<ЮЛ> — счёт <код> — нет кварталов: Q1, Q2». +- **«Пробелы: N»** — свёрнутый список счетов, по которым за часть кварталов периода нет ОСВ; строки таких счетов в свод + не попадают. Клик раскрывает список: «\<ЮЛ\> — счёт \<код\> — нет кварталов: Q1, Q2». ![Список пробелов](img/31-osv-gaps.png) - **Таблица**: «Компания ГК», «Счёт» (субсчёт), «Период» (например «9 мес. 2024 г.»), «Контрагенты», «ИНН», сальдо на - начало, обороты, сальдо на конец (Дебет / Кредит), «Тип контрагента». Суммы в рублях с копейками, ноль — «—». - По 500 строк на страницу, внизу «Строк: N» — общее число строк по текущим фильтрам и переключатель страниц. Таблица + начало, обороты, сальдо на конец (Дебет / Кредит), «Тип контрагента». Суммы в рублях с копейками, ноль — «—». По 500 + строк на страницу, внизу «Строк: N» — общее число строк по текущим фильтрам и переключатель страниц. Таблица прокручивается по горизонтали. - **«Экспорт»** — сохраняет `svod-osv_<ГК>_<год>-Q<квартал>_v<версия>.xlsx` с листами «Сводная ОСВ» и «Пробелы» по текущим фильтрам. @@ -368,8 +586,8 @@ PDF с бухгалтерской отчётностью даёт два док ![Фильтр по счёту](img/38-osv-filter-account.png) -Пример: организация «ПЕКАРНЯ СЧАСТЛИВОЧНАЯ» и контрагент `бисквит` оставляют строки расчётов с «РУССКИЙ БИСКВИТ, АО» -по счетам 60, 62, 76 — это внутригрупповые обороты. +Пример: организация «ПЕКАРНЯ СЧАСТЛИВОЧНАЯ» и контрагент `бисквит` оставляют строки расчётов с «РУССКИЙ БИСКВИТ, АО» по +счетам 60, 62, 76 — это внутригрупповые обороты. ![Отфильтрованные строки](img/34-osv-filtered.png) @@ -386,17 +604,17 @@ PDF с бухгалтерской отчётностью даёт два док - ИНН из файла — просто число моноширинным шрифтом; - красная кнопка «Указать» на подсвеченном фоне — в файле ИНН нет и контрагент не связан с организацией справочника; -- серая «таблетка» с ИНН — в файле ИНН не было, но контрагент уже связан с организацией справочника (подсказка - «Связано с организацией справочника — изменить»). +- серая «таблетка» с ИНН — в файле ИНН не было, но контрагент уже связан с организацией справочника (подсказка «Связано + с организацией справочника — изменить»). «Показать ЮЛ без ИНН» в баннере оставляет только строки с «Указать»; кнопка меняется на «Показать все строки». ![Только строки без ИНН](img/36-osv-no-inn.png) -Клик по «Указать» (или по серой таблетке) открывает окно «Выбор организации для связи с <контрагент>»: +Клик по «Указать» (или по серой таблетке) открывает окно «Выбор организации для связи с \<контрагент\>»: -1. Введите часть названия или ИНН в поле поиска. По умолчанию поиск идёт по организациям ГК и периметра; галочка - «Искать во всём справочнике (не только в группе)» расширяет его на весь справочник (нужно не меньше трёх символов). +1. Введите часть названия или ИНН в поле поиска. По умолчанию поиск идёт по организациям ГК и периметра; галочка «Искать + во всём справочнике (не только в группе)» расширяет его на весь справочник (нужно не меньше трёх символов). 2. В таблице — «ИНН», «Организация», «ГК», «ГСК», «ГСЗ» и кнопка «Связать»; у уже связанной организации — неактивное «Связано». Рекомендуемые совпадения показываются первыми. 3. «Связать» сохраняет связь: имя контрагента из ОСВ закрепляется за организацией как псевдоним, строка получает ИНН и @@ -404,15 +622,65 @@ PDF с бухгалтерской отчётностью даёт два док ![Окно выбора организации](img/37-osv-map-modal.png) -Сопоставление — правка версии, для неё нужна ваша блокировка (создание версии её не берёт). Если версия ещё не -взята вами в работу, перед первой связью система спросит «Взять версию в работу?» с пояснением, что пока блокировка у вас, другие пользователи не смогут править версию; -«Взять в работу» продолжает, «Отмена» прерывает. Если версия уже в работе у другого пользователя, связь невозможна — -появится сообщение с его именем. +Сопоставление — правка версии, для неё нужна ваша блокировка (создание версии её не берёт). Если версия ещё не взята +вами в работу, перед первой связью система спросит «Взять версию в работу?» с пояснением, что пока блокировка у вас, +другие пользователи не смогут править версию; «Взять в работу» продолжает, «Отмена» прерывает. Если версия уже в работе +у другого пользователя, связь невозможна — появится сообщение «Версию держит \<ФИО\>: правки недоступны, пока блокировка +не снята». -Связь действует на все версии, в которые входит документ с этим контрагентом, и сохраняется для следующих периодов: -в новой консолидации те же имена сопоставятся автоматически. +Если имя контрагента уже закреплено за другой организацией, система спросит «Имя уже закреплено за другой организацией» +и предложит «Перенести» псевдоним на выбранную организацию или «Отмена». -## 11. Администрирование: пользователи и роли +Связь действует на все версии, в которые входит документ с этим контрагентом, и сохраняется для следующих периодов: в +новой консолидации те же имена сопоставятся автоматически. + +## 11. Справочники: группы компаний и организации + +«Справочники → ГК и организации» открывает экран «Группы компаний и организаций». Слева — список ГК с поиском «Поиск по +ГК или CRM ID»; в карточке ГК — название, CRM ID и число организаций. Справа — выбранная ГК: базовый РФ, число +организаций и вкладки «ЮЛ», «ГСК», «ГСЗ» с количеством. + +![Справочник: группы компаний и организации](img/45-catalogue-groups.png) + +**Вкладка «ЮЛ»**: «Статус» («Активно» / «Не активно»), «ИНН», «КПП», «Организация», «Тип» (ЮЛ / ИП), «Основной РФ». +Галочка «Архив» показывает закрытые ЮЛ. Меню «…» в строке: «Изменить ЮЛ», «История изменений» (заглушка «Журнал +действий»), «Перевести в другую ГК», «Вывести из состава ГК». + +**Вкладки «ГСК» и «ГСЗ»**: «ID», «Наименование», «Число участников», «Дата создания». Клик по наименованию открывает +вкладку «ЮЛ», отфильтрованную по участникам этой группы (плашка «Фильтр по: …» с кнопкой «Сбросить»). Меню строки: +«Изменить», «Удалить». + +![Вкладка «ГСК»](img/46-catalogue-gsk.png) + +«Создать ГК/ЮЛ» открывает окно «Выберите объект для добавления»: ГК, ЮЛ, ГСК или ГСЗ. + +![Выбор объекта для добавления](img/47-catalogue-create-choice.png) + +Формы: + +- **ГК** — «Название ГК» (обязательно), «ID ГК в CRM», «Базовый РФ ГК»; +- **ЮЛ** («Добавить юридическое лицо» / «Изменить юридическое лицо») — «ИНН» (10 цифр для ЮЛ, 12 для ИП), «КПП», «ID ЮЛ + в CRM», «Тип», «Наименование организации», «Альтернативные наименования» (введите синоним и нажмите Enter), «Базовый + РФ ГК», «ГК», «Входит в ГСК», «Входит в ГСЗ». При изменении ИНН, тип и ГК не редактируются; +- **ГСК / ГСЗ** — «ID в CRM», «Наименование», «ГК», «Дата создания»; +- **«Перевести ЮЛ в другую ГК»** — «Новая ГК», «Дата перевода» (не раньше сегодняшней); +- **«Вывести ЮЛ из состава ГК»** — «Событие» («Закрытие» / «Переход в другую ГК»), «Дата закрытия», «Комментарий». + +![Изменение юридического лица](img/48-catalogue-le-form.png) + +Альтернативные наименования — те же псевдонимы, что создаются при сопоставлении контрагентов в сводной ОСВ (раздел +10.3): по ним система узнаёт организацию в ОСВ без ИНН. + +После успешного сохранения окно закрывается без уведомления; ошибки показываются внизу справа с заголовком «Ошибка». +Удалить ГСК или ГСЗ может только администратор. Перед сохранением формы «Изменить юридическое лицо» проверьте поля +«Входит в ГСК» и «Входит в ГСЗ» — см. «Известные ошибки» в разделе 14. + +«Справочники → ЮЛ вне ГК» открывает экран «Юридические лица» — организации, не входящие ни в одну ГК: поиск, та же +таблица без вкладок, галочка «Архив», кнопка «Создать ЮЛ». + +![Юридические лица вне ГК](img/49-catalogue-le-outside.png) + +## 12. Администрирование: пользователи и роли «Система → Пользователи и роли». Раздел доступен пользователю с правом администрирования (на стенде — `admin@armka.local`); остальным показывается «Нет доступа». @@ -422,32 +690,30 @@ PDF с бухгалтерской отчётностью даёт два док ![Пользователи](img/40-admin-users.png) -«Создать пользователя» → окно «Новый пользователь»: «Email» (обязателен; адреса в домене `.local` отклоняются), -«ФИО» (обязательно), «Табельный номер», «Филиал» (обязателен), «Сегмент», «Роли». Созданный пользователь может войти -сразу. +«Создать пользователя» → окно «Новый пользователь»: «Email» (обязателен; адреса в домене `.local` отклоняются), «ФИО» +(обязательно), «Табельный номер», «Филиал» (обязателен), «Сегмент», «Роли». После создания появляется уведомление +«Пользователь \ создан»; созданный пользователь может войти сразу. ![Новый пользователь](img/41-admin-create-user.png) -Вкладка **«Матрица прав»** — таблица «право × роль» с галочками; роли системные. Изменения накапливаются и -отправляются кнопкой «Сохранить», «Отменить изменения» возвращает исходное состояние. +Вкладка **«Матрица прав»** — таблица «право × роль» с галочками; роли системные. Изменения накапливаются и отправляются +кнопкой «Сохранить» (уведомление «Сохранено ролей: N»), «Отменить изменения» возвращает исходное состояние. ![Матрица прав](img/42-admin-matrix.png) Защита последнего администратора: нельзя снять роль ADMIN или право администрирования у единственного администратора и -нельзя его деактивировать — сервер отвечает ошибкой, роли не меняются. +нельзя его деактивировать — сервер отвечает ошибкой «Нельзя оставить систему без активного пользователя с правом +USERS_ADMIN», роли не меняются. -Известный дефект этого экрана в прототипе: уведомления об успехе и ошибке не показываются; результат виден по -обновлению таблицы или по ответу сервера во вкладке Network браузера. - -## 12. Статусы и термины +## 13. Статусы и термины **Статус версии консолидации** (бейдж в таблице консолидаций и в шапке сводной ОСВ): | Статус | Когда | |---|---| | Инициация | версия создана, документов ещё нет | -| Обработка документов | есть загруженные файлы, распознавание не завершено | -| Коррекция данных | документы распознаны, аналитик проверяет и сопоставляет данные | +| Обработка документов | в консолидацию принят хотя бы один файл | +| Коррекция данных | есть подтверждённый документ или документ, требующий проверки; аналитик проверяет и сопоставляет данные | | Консолидация РФ, Верификация РФ, Консолидация ГО, Верифицирован, Отмена КФО | следующие этапы маршрута; в этой версии недостижимы | **Статус документа** (панель документов, экраны просмотра): @@ -455,48 +721,85 @@ PDF с бухгалтерской отчётностью даёт два док | Статус | Значение | |---|---| | Обработка | файл принят, идёт распознавание | -| Требуется проверка | распознан с замечаниями (шапка другой организации, не определён период, нарушения проверок) — нужна проверка и подтверждение аналитиком | +| Требуется проверка | распознан с замечаниями (шапка другой организации, не определён период, нарушения проверок, строки без кода) — нужна проверка и подтверждение аналитиком | | Загружен | подтверждён (автоматически или вручную), участвует в своде и чек-листе | | Ошибка | распознавание не удалось | -| Отсутствует | в блоке «Организации»: документ этого типа за период не загружен | -**Проверка документа**: «Период» — распознан ли отчётный период и попадает ли в период версии; «Контрагент» — -совпадает ли организация из документа с ЮЛ, на которое он загружен. +В колонках «ОФР» и «Бух.баланс» блока «Организации» и в окне «Чеклист» свои подписи: «Отсутствует» (документ этого типа +за период не загружен), «В обработке», «Распознан», «Требуется проверка», «Загружен», «Ошибка». + +**Проверка документа**: «Период» — попадает ли отчётный период документа в период версии (временно не вычисляется, +всегда «—»); «Контрагент» — совпадает ли организация из документа с ЮЛ, на которое он загружен. **Тип контрагента**: ГСК — участник группы связанных компаний версии; ГК — другая организация той же группы компаний; Внешний — все остальные. +**Строки формы**: строка без кода — код не распознан или его нет в документе; расшифровка — строка «в том числе», в +суммы формы не входит; подстрока (строка детализации) — часть строки-родителя, показывается под ней с отступом; +шаблонная строка — достроена по справочнику, пустая. + +**Предупреждение** — замечание распознавания: «Информация» (не мешает работе) или «Ошибка» (требует внимания). +**Автозамена** — замена прежнего файла новым с тем же типом, счётом и периодом (раздел 7.1). + Сокращения: ГК — группа компаний; ГСК — группа связанных компаний; ГСЗ — группа связанных заёмщиков; ЮЛ — юридическое -лицо (включая ИП); РФ — региональный филиал; ГО — головной офис; ОСВ — оборотно-сальдовая ведомость; ББ — -бухгалтерский баланс; ОФР — отчёт о финансовых результатах; КФО — консолидированная финансовая отчётность. +лицо (включая ИП); РФ — региональный филиал; ГО — головной офис; ОСВ — оборотно-сальдовая ведомость; ББ — бухгалтерский +баланс; ОФР — отчёт о финансовых результатах; КФО — консолидированная финансовая отчётность. -## 13. Ограничения текущей версии +## 14. Ограничения и известные ошибки -Это особенности прототипа, а не дефекты: +Особенности прототипа, а не дефекты: -- Нет экранов: справочники ГК/ЮЛ/ГСК, монозаёмщики, Единое хранилище, журнал действий, шахматка, корректировки, - гудвилл, КФО, смена статусов и маршрут согласования, «Добавить версию», редактирование состава версии, экран - чек-листа (только CSV), комментарии к документам, удаление файлов, правка строк ОСВ. +- Нет экранов: монозаёмщики, Единое хранилище, журнал действий (и «История изменений», которая на него ведёт), шахматка, + корректировки, гудвилл, КФО, смена статусов и маршрут согласования, «Добавить версию», редактирование состава версии, + правка строк ОСВ. +- Комментарий к документу можно добавить, но посмотреть или удалить сохранённые комментарии нельзя. - «ГСК» и «Дата верификации» в таблице консолидаций, «Утверждён в РФ» и «Верифицирован в ГО» всегда «—». -- Таблица консолидаций и статус версии обновляются по F5; блок «Организации» перечитывается при закрытии панели - документов. -- Панель документов показывает первые 100 файлов организации, все периоды вместе; загрузка возможна только из панели - организации внутри выбранной версии. -- Документы типа «Прочий документ» (расшифровки) в панели не открываются. +- Статус версии обновляется по F5; блок «Организации» перечитывается при закрытии панели документов. +- Отметка «Период» в колонке «Проверка» временно не вычисляется и всегда «—» — это временное решение; период документа + сверяйте по колонке «Период». +- Панель документов показывает первые 100 файлов организации; загрузка возможна только из панели организации внутри + выбранной версии «в работе». +- Документы типа «Прочий документ» (расшифровки) не открываются — уведомление «Просмотр данного документа недоступен». - Фильтр «Счёт» принимает только корень счёта; фильтр «Тип контрагента» — одно значение. -- Шапку формы (ИНН, дату, единицу измерения) нельзя очистить, только заменить. Время принятия нарушений показывается - в часовом поясе браузера, остальные даты — по Москве. +- Шапку формы (организацию, ИНН, дату, единицу измерения) нельзя очистить, только заменить. Время принятия нарушений + показывается в часовом поясе браузера, остальные даты — по Москве. +- На экранах справочников нет уведомлений об успехе: окно просто закрывается. - Распознавание PDF на локальном стенде работает через эмулятор ИС Сканирование: распознаются только PDF из набора тестовых данных (`fixtures/ocr`), остальные получают статус «Ошибка». -- Уведомления в «Пользователи и роли» не появляются (дефект зарегистрирован). - Предупреждения в консоли браузера от библиотеки компонентов ни на что не влияют. -## 14. Если что-то пошло не так +### Известные ошибки + +Справочники (исправления запланированы в AURORA-1671 и AURORA-1636): + +- **Форма «Изменить юридическое лицо»**: при открытии формы поля «Входит в ГСК» и «Входит в ГСЗ» сбрасываются в «— не + указан —», даже если организация в них состоит. Если сохранить форму, не выбрав их заново, организация выйдет из + ГСК/ГСЗ. Перед сохранением выберите ГСК и ГСЗ повторно. +- **Создание ЮЛ, ГСК или ГСЗ из карточки ГК**: поле «ГК» в форме пустое. ЮЛ, сохранённое без выбора ГК, становится + организацией вне ГК — выберите ГК вручную. +- **«Изменить ГСК/ГСЗ»**: пустая «Дата создания» при сохранении заменяется сегодняшней. +- **Очистка полей**: стереть CRM ID у ГСК/ГСЗ или КПП у ЮЛ в форме изменения нельзя — пустое значение не сохраняется. +- **Список ЮЛ в карточке ГК** показывает не больше 200 организаций. +- **Фильтр по ГСК** (плашка «Фильтр по: …») не сбрасывается при выборе другой ГК — у следующей ГК таблица пустая; + нажмите «Сбросить». +- **«ЮЛ вне ГК»**: список может оставаться пустым при открытии из меню сразу после входа или после обновления страницы. +- **«История изменений»** у ЮЛ открывает журнал действий без фильтра (сейчас это заглушка). + +Прочее (задачи пока не заведены): + +- **Удаление ГСК/ГСЗ**: пункт «Удалить» виден всем, но сервер разрешает удаление только администратору («недостаточно + прав: требуется DIRECTORY_DELETE»). +- **Проверка формы**: текст отказа по периоду повторяется дважды — «…поправьте дату отчёта. Исправьте дату отчёта в + шапке и сохраните.» +- **Опечатки в интерфейсе**: пункт меню версии «Отключить подвтерждение КФО», заголовок окна «Чеклист» (без дефиса). + +## 15. Если что-то пошло не так - «Сессия истекла» — войдите заново (раздел 2). -- Файл остаётся в «Обработке» дольше минуты — проверьте, что на стенде запущены сервисы распознавания - (`qa-guide.md`, раздел 4.2 и 12); панель продолжит опрашивать сервер сама. +- Файл остаётся в «Обработке» дольше минуты — проверьте, что на стенде запущены сервисы распознавания (`qa-guide.md`, + разделы 4.2 и 12); панель продолжит опрашивать сервер сама. - Документ в статусе «Ошибка» — распознавание не удалось; для PDF на локальном стенде это ожидаемо для файлов вне тестового набора. -- Дефект — issue в Gitea: экраны — `RSHB/arm-web`, ответы сервера — `RSHB/arm-core`. Шаблон и как понять, чей баг — +- Кнопка «Загрузить документы» неактивна — версия не «в работе» (раздел 7.1). +- Дефект — issue в Gitea: экраны — `RSHB/arm-web`, ответы сервера — `RSHB/arm-core`. Шаблон и как понять, чей баг, — `qa-guide.md`, раздел 11. Приложите скриншот экрана и запрос с ответом из вкладки Network.