user/user-guide.md

@@ -7,8 +7,10 @@
 
 Инструкция описывает версию, выложенную на стенд заказчика 26.10.2026 (AURORA-1801: `arm-core` 22facb3 со встроенным
 фронтом, `arm-tabular-parser` 242e116, `arm-scan-gateway` 185a5d6). Основа текста — редакция тестировщика и
-руководителя проекта от 20.10.2026. Как поднять стенд, какие учётные записи есть и как заводить дефекты — в гайде
+руководителя проекта от 20.10.2026. Раздел 12 «Таблица корректировок» добавлен 03.11.2026 по коду main `arm-core`
-тестировщика [`../dev/qa-guide.md`](../dev/qa-guide.md).
+967fa01 (AURORA-1541/1540/1751) — на момент этой правки раздел ещё не выложен на стенд заказчика, снимки сделаны на
+стенде разработки. Как поднять стенд, какие учётные записи есть и как заводить дефекты — в гайде тестировщика
+[`../dev/qa-guide.md`](../dev/qa-guide.md).
 
 ## Содержание
 
@@ -25,10 +27,11 @@
 9. [Проверка форм ББ и ОФР](#9-проверка-форм-бб-и-офр)
 10. [Сводная ОСВ](#10-сводная-осв)
 11. [Шахматка ВГО](#11-шахматка-вго)
-12. [Справочники групп компаний и организаций](#12-справочники-групп-компаний-и-организаций)
+12. [Таблица корректировок](#12-таблица-корректировок)
-13. [Статусы и термины](#13-статусы-и-термины)
+13. [Справочники групп компаний и организаций](#13-справочники-групп-компаний-и-организаций)
-14. [Ограничения и известные ошибки](#14-ограничения-и-известные-ошибки)
+14. [Статусы и термины](#14-статусы-и-термины)
-15. [Если что-то пошло не так](#15-если-что-то-пошло-не-так)
+15. [Ограничения и известные ошибки](#15-ограничения-и-известные-ошибки)
+16. [Если что-то пошло не так](#16-если-что-то-пошло-не-так)
 
 ## Основные понятия
 
@@ -60,7 +63,7 @@
    ([https://raisa.go.rshbank.ru/aurora/apps/fastapi-arm-core/](https://raisa.go.rshbank.ru/aurora/apps/fastapi-arm-core/)),
    и войдите под учётной записью (раздел 2): введите **email** пользователя `ka_go@armka.local`. Пароля нет.
 2. Откройте «Отчётность → Группы компаний» и найдите нужную группу. Если группы, ГСК или организаций ещё нет, сначала
-   подготовьте справочники по разделу 12.
+   подготовьте справочники по разделу 13.
 3. Нажмите «Консолидации» в строке группы. Выберите существующую версию либо создайте новую консолидацию: укажите ГК,
    ГСК, год и квартал, проверьте состав организаций и нажмите «+ Создать» (разделы 5 и 6).
 4. Нажмите «Взять в работу» в строке версии, если будете сопоставлять контрагентов или менять статус (раздел 5.1).
@@ -72,11 +75,13 @@
 7. Нажмите «К отчётности →» в строке версии. В сводной ОСВ проверьте пробелы по кварталам и сопоставьте контрагентов без
    ИНН (раздел 10).
 8. Откройте вкладку «Шахматка» и проверьте расхождения во внутригрупповых расчётах (раздел 11).
-9. Выгрузите нужные таблицы в xlsx. Выгрузка сводной ОСВ учитывает текущие фильтры; для полного свода предварительно
+9. При необходимости откройте вкладку «Таблица корректировки» и распределите расхождение по статьям баланса с
-   сбросьте их (разделы 10 и 11).
+   комментарием (раздел 12).
+10. Выгрузите нужные таблицы в xlsx. Выгрузка сводной ОСВ учитывает текущие фильтры; для полного свода предварительно
+    сбросьте их (разделы 10 и 11).
 
-В результате вы получите сводную ОСВ и шахматку выбранной версии и файлы с их данными. Корректировки, гудвилл,
+В результате вы получите сводную ОСВ и шахматку выбранной версии, при необходимости — скорректированные расхождения
-формирование КФО и маршрут согласования в текущей версии ещё недоступны.
+ВГО, и файлы с данными. Гудвилл, формирование КФО и маршрут согласования в текущей версии ещё недоступны.
 
 ## 1. Что умеет текущая версия
 
@@ -101,11 +106,14 @@
   Внешний), сопоставление контрагента без ИНН с организацией справочника, экспорт в Excel;
 - шахматка ВГО: расчёты между организациями периметра с расхождениями, фильтры по компаниям и счетам дебета и кредита,
   результирующая таблица ВГО по статьям, выгрузка обеих таблиц в Excel;
+- таблица корректировок: агрегаты пар ВГО с расхождением сторон, раскрытие до строк ОСВ, перенос строки в другое
+  правило или в нераспределённые, окно «Корректировка операции» с разнесением суммы по статьям и комментарием, фильтр
+  по правилу, исключение строки из КФО, экспорт в Excel;
 - справочники: группы компаний, ЮЛ, ГСК и ГСЗ — просмотр, создание, изменение, перевод ЮЛ в другую ГК и вывод из ГК.
 
-Пока недоступны таблица корректировок, гудвилл, КФО, маршрут согласования (версия не продвигается дальше «Корректировки
+Пока недоступны гудвилл, КФО, маршрут согласования (версия не продвигается дальше «Корректировки данных»), добавление
-данных»), добавление версий, Единое хранилище, журнал действий, монозаёмщики и просмотр комментариев. Некоторые пункты
+версий, Единое хранилище, журнал действий, монозаёмщики и просмотр комментариев. Некоторые пункты меню и вкладки уже
-меню и вкладки уже видны, но ещё не открывают рабочий экран.
+видны, но ещё не открывают рабочий экран.
 
 ## 2. Вход в систему
 
@@ -145,8 +153,8 @@
 | — | **+ Новая консолидация** | окно создания консолидации (раздел 6) |
 | Отчётность | Группы компаний | список ГК (раздел 4) — основной вход в работу |
 | Отчётность | Монозаемщики | пока недоступно |
-| Справочники | ГК и организации | справочник групп компаний, ЮЛ, ГСК и ГСЗ (раздел 12) |
+| Справочники | ГК и организации | справочник групп компаний, ЮЛ, ГСК и ГСЗ (раздел 13) |
-| Справочники | ЮЛ вне ГК | организации, не входящие ни в одну ГК (раздел 12) |
+| Справочники | ЮЛ вне ГК | организации, не входящие ни в одну ГК (раздел 13) |
 | Документы | Единое хранилище | пока недоступно |
 | Система | Журнал действий | пока недоступно |
 | Система | Пользователи и роли | пока недоступно |
@@ -289,7 +297,7 @@
 ![Пустое окно создания консолидации](img/05-new-consolidation-empty.png)
 
 Перед созданием убедитесь, что в справочнике есть нужная ГК, её ГСК и не меньше двух организаций. Если чего-то не
-хватает, сначала выполните действия раздела 12. Затем заполните поля по порядку:
+хватает, сначала выполните действия раздела 13. Затем заполните поля по порядку:
 
 1. «Группа компаний» — ГК из списка доступных вам.
 2. «ГСК» — группа связанных компаний внутри ГК (поле активно после выбора ГК). Выберите ГСК по заданию на расчёт; если
@@ -651,9 +659,9 @@
 ![Сводная ОСВ](img/30-osv-summary.png)
 
 Шапка страницы общая для всех вкладок: название ГК и период, под ними — пояснение текущего этапа, справа — «Статус
-отчёта» и кнопка «Изменить статус» (раздел 5.2). Ниже — вкладки шагов консолидации: «ОСВ» и «Шахматка» (раздел 11).
+отчёта» и кнопка «Изменить статус» (раздел 5.2). Ниже — вкладки шагов консолидации: «ОСВ», «Шахматка» (раздел 11) и
-Вкладки «Таблица корректировки», «Гудвилл», «КФО», «КФО Общий» и «Подтверждение КФО клиента» в текущей версии
+«Таблица корректировки» (раздел 12). Вкладки «Гудвилл», «КФО», «КФО Общий» и «Подтверждение КФО клиента» в текущей
-недоступны, при наведении — «Будет в следующих срезах».
+версии недоступны, при наведении — «Будет в следующих срезах».
 
 Что на экране:
 
@@ -851,7 +859,7 @@
 | Долгосрочные кредиты и займы | кредит 67, 67.03 |
 | Краткосрочные кредиты и займы | кредит 66, 66.03, 66.04 |
 
-Строка «Итого» внизу складывает все пять статей по колонке. Правило итога ещё уточняется (см. раздел 14) — пока
+Строка «Итого» внизу складывает все пять статей по колонке. Правило итога ещё уточняется (см. раздел 15) — пока
 используйте суммы по статьям.
 
 ### 11.4 Выгрузка и полный экран
@@ -867,13 +875,113 @@
 
 ![Матрица на весь экран](img/74-chess-fullscreen.png)
 
-## 12. Справочники групп компаний и организаций
+## 12. Таблица корректировок
+
+Таблица корректировок показывает пары внутригрупповых расчётов (агрегаты ВГО) версии и позволяет вручную распределить
+расхождение между сторонами по статьям баланса с комментарием. Таблица строится из тех же данных, что и шахматка
+(раздел 11): учитываются только подтверждённые ОСВ и организации, определённые как периметр версии.
+
+Откройте «К отчётности →» в строке версии и выберите вкладку «Таблица корректировки».
+
+![Таблица корректировок](img/75-corrections-table.png)
+
+На экране три части:
+
+- строки агрегатов — пары счетов, сопоставленные правилами ВГО: компания, статья баланса и сумма со стороны Дт,
+  компания, статья и сумма со стороны Кт, отклонение в процентах и в сумме, и (если корректировка уже есть) блок
+  «Корректировка» с её статьями, суммами и комментарием;
+- нераспределённые строки под ними (на приглушённом фоне) — строки ОСВ, которые не попали ни в одно правило: видна
+  только своя сторона (счёт, строка баланса, сумма), сторона контрагента — только его название;
+- строка «Итого» внизу — сумма по видимым агрегатам.
+
+Отклонение выделяется красным, если оно больше 5% от меньшей из сумм сторон или если у агрегата нет встречной стороны
+(сумма одной стороны равна нулю). Флажок «Учитывать в КФО» у строки агрегата всегда отмечен и неактивен — агрегат
+учитывается в КФО целиком, лишнюю строку из него убирают через меню действий, а не флажком; у строк внутри агрегата
+флажка нет вовсе. У нераспределённой строки флажок можно снять — запрос уходит на сервер сразу, таблица перечитывается,
+а строка остаётся на экране приглушённой.
+
+### 12.1 Фильтры и панель
+
+Над таблицей:
+
+- «Отображение» — «Общий» (все агрегаты) или «По пресету»: тогда появляется поле «Правило» со списком правил
+  сопоставления ВГО (подпись вида «Правило N: ‹статья› — ‹статья›»), и в таблице остаются только агрегаты выбранного
+  правила и нераспределённые строки, которые ему подходят;
+- «Тип записи» — «Все», «Пары счетов» (только агрегаты) или «Нераспределенные записи»;
+- «Единицы» и «Знаков после запятой» — те же правила, что в шахматке (раздел 11);
+- «Сбросить фильтры» появляется, когда задан хотя бы один из фильтров;
+- «Настройка таблицы» справа над таблицей — отметьте нужные колонки каждого блока («Дебет», «Кредит», «Контроль»,
+  «Корректировка», «Учитывать в КФО»), чтобы скрыть остальные и уместить таблицу на экране без лишней прокрутки.
+
+![Отображение «По пресету» и выбор правила](img/76-corrections-filters.png)
+
+В заголовках колонок — свои фильтры: «ЮЛ» (подстрока названия, действует на обе стороны), «Строка баланса» (выбор
+кода) и «Счёт» (начало кода); у «Отклонение, %» — «Все» / «> 5%» / «≤ 5%». Фильтры «ЮЛ», «Счёт» и «Строка баланса»
+действуют и на нераспределённые строки; если задан фильтр «Отклонение, %», нераспределённые строки скрываются. Если
+фильтры ничего не нашли — «Нет записей для выбранных фильтров».
+
+### 12.2 Раскрытие агрегата и перенос строк
+
+Стрелка слева у строки агрегата раскрывает его до отдельных строк ОСВ: сначала строки стороны Дт, затем стороны Кт. У
+каждой строки — меню действий (значок «⋮»): «Перенести в правило…» (список правил, в которые строка может войти; при
+пустом списке пункт неактивен), «Убрать из правила» (строка уходит в нераспределённые) и «Вернуть к автоматике» —
+доступно, только если распределение этой строки было сделано вручную.
+
+![Раскрытый агрегат и меню действий строки](img/77-corrections-expand.png)
+
+У нераспределённой строки то же меню предлагает «Отнести к правилу…» (из списка подходящих правил) и, если строку
+раньше отнесли к правилу вручную и затем сбросили, «Вернуть к автоматике».
+
+![Меню действий нераспределённой строки](img/80-corrections-unallocated.png)
+
+### 12.3 Окно «Корректировка операции»
+
+Кнопка «Корректировать» у строки агрегата открывает окно «Корректировка операции»: слева и справа — компания и статья
+правила каждой стороны. Ниже — блок «Исходные данные ОСВ» по каждой стороне: счета, строки баланса и суммы, вошедшие в
+агрегат; крестик у строки убирает её из правила (она уходит в нераспределённые), «Добавить строку ОСВ» — добавляет в
+агрегат подходящую нераспределённую строку той же пары компаний и той же стороны. Эти действия со строками отправляются
+на сервер сразу, без кнопки «Сохранить».
+
+Если у агрегата ещё нет корректировки, в «Распределение корректировки» по каждой стороне подставляется одна строка —
+статья правила с текущей суммой стороны. «Добавить строку» добавляет ещё одну статью той же стороны, если сумму нужно
+разнести по нескольким статьям; крестик у строки удаляет статью.
+
+![Окно «Корректировка операции»](img/78-corrections-modal.png)
+
+Под блоками — итоги сторон и разница между ними с процентом к меньшей сумме (красным, если он больше 5% или одна
+сторона пустая), поле «Комментарий к корректировке» (обязательное) и кнопки «Отменить» и «Сохранить корректировки».
+«Сохранить корректировки» применяет корректировку сразу: окно закрывается, а строка агрегата в таблице показывает
+статьи, суммы и комментарий из блока «Корректировка».
+
+![Агрегат с сохранённой корректировкой](img/79-corrections-saved.png)
+
+Если выбранной статьи нет в форме компании, рядом с полем статьи появляется подсказка «Статья отсутствует в форме
+компании» — сохранить с такой статьёй не получится; выберите другую статью или уточните у ответственного за форму,
+прежде чем сохранять. Другие ошибки сохранения показываются текстом сервера; если корректировку успели изменить, пока
+было открыто окно, появится «Корректировку уже изменили, данные обновлены», и таблица перечитается. При закрытии окна
+с неотправленными правками система спросит «Есть несохранённые изменения. Закрыть без сохранения?» — «Остаться»
+сохранит правки в окне. Незавершённые правки окна (статьи и комментарий) также сохраняются в браузере и
+восстанавливаются, если вы вернётесь к этому же агрегату, не сохранив их: появится плашка «Восстановлены
+несохранённые правки от ЧЧ:ММ».
+
+Если версия закрыта для изменений или её ведёт другой аналитик, корректировать нельзя: кнопка показывает подсказку
+(«Версия закрыта для изменений», «Возьмите консолидацию в работу» или имя коллеги, который её ведёт), а флажки и пункты
+меню решений неактивны; окно «Корректировать» в этом случае открывается только на просмотр, без кнопки «Сохранить
+корректировки».
+
+### 12.4 Экспорт и полный экран
+
+«Экспорт» над таблицей скачивает книгу Excel с таблицей корректировок версии в текущем составе фильтров. «На весь
+экран» разворачивает таблицу вместе с панелью фильтров на весь экран, как в шахматке (раздел 11.4); кнопка меняется
+на «Свернуть», выйти можно и клавишей Esc.
+
+## 13. Справочники групп компаний и организаций
 
 Справочники нужны, чтобы выбрать правильные организации при создании консолидации и сопоставлении контрагентов. Сначала
 проверьте, нет ли нужной записи: повторное создание может привести к ошибке или путанице. Если действие недоступно,
 обратитесь к администратору или ответственному за ведение справочников.
 
-### 12.1 Как устроены справочники
+### 13.1 Как устроены справочники
 
 В «ГК и организации» слева находятся группы компаний, справа — состав выбранной группы. На вкладке «ЮЛ» показаны её
 организации, на вкладках «ГСК» и «ГСЗ» — связанные группы. Цифра рядом с названием вкладки показывает число записей.
@@ -893,7 +1001,7 @@
 Базовый или основной РФ — региональный филиал, к которому относится группа или организация. Не выбирайте случайный
 филиал: от него зависит доступ пользователей. Если правильное значение неизвестно, уточните его у ответственного.
 
-### 12.2 В каком порядке подготовить данные
+### 13.2 В каком порядке подготовить данные
 
 Если вы начинаете с новой группы, выполняйте действия по порядку: создайте ГК → создайте в ней ГСК → добавьте не меньше
 двух ЮЛ и включите их в эту ГСК → проверьте состав → создайте консолидацию по разделу 6. Если нужные записи уже
@@ -902,7 +1010,7 @@
 Например, для учебной группы можно задать названия «Учебная ГК» и «ГСК Учебная». Названия и ИНН организаций берите из
 документов, которые будете загружать. Для реальной работы используйте согласованные данные, а не вымышленные реквизиты.
 
-### 12.3 Создание группы компаний
+### 13.3 Создание группы компаний
 
 1. Откройте «Справочники → ГК и организации» и нажмите «Создать ГК/ЮЛ».
 2. В окне выбора нажмите «ГК».
@@ -917,7 +1025,7 @@
 **Результат: группа появилась в справочнике. Организаций в ней пока нет — это нормально. Следующий шаг — создать ГСК и
 добавить ЮЛ.**
 
-### 12.4 Создание ГСК или ГСЗ
+### 13.4 Создание ГСК или ГСЗ
 
 1. Нажмите «Создать ГК/ЮЛ» и выберите «ГСК» или «ГСЗ». Для подготовки консолидации выберите «ГСК».
 2. Введите наименование и обязательно выберите нужную «ГК». Даже если вы открыли форму из карточки группы, проверьте это
@@ -930,7 +1038,7 @@
 **Результат: группа появилась на своей вкладке. Число участников может быть равно нулю: участников вы назначаете в форме
 ЮЛ.**
 
-### 12.5 Добавление организации в ГК и ГСК
+### 13.5 Добавление организации в ГК и ГСК
 
 1. Нажмите «Создать ГК/ЮЛ» и выберите «ЮЛ».
 2. Укажите тип — ЮЛ или ИП. Введите ИНН и наименование из исходного документа: для ЮЛ ИНН содержит 10 цифр, для ИП —
@@ -953,7 +1061,7 @@
 После сохранения окно может закрыться без сообщения об успехе. Это не повод создавать запись повторно: сначала проверьте
 соответствующий список. Ошибка сохранения показывается внизу справа.
 
-### 12.6 Изменение организации и просмотр состава групп
+### 13.6 Изменение организации и просмотр состава групп
 
 1. Выберите ГК и вкладку «ЮЛ». Найдите организацию по названию или ИНН.
 2. В меню «…» её строки выберите «Изменить ЮЛ».
@@ -976,7 +1084,7 @@
 Изменение наименования, ID или даты ГСК/ГСЗ доступно через меню «… → Изменить». Проверьте дату перед сохранением.
 Удаление ГСК/ГСЗ разрешено администратору; при необходимости обратитесь к нему.
 
-### 12.7 Перевод в другую ГК и вывод из состава
+### 13.7 Перевод в другую ГК и вывод из состава
 
 Перевод используйте, когда организация должна перейти из одной ГК в другую. Закрытие и вывод — отдельные действия.
 Сначала уточните, какое событие требуется отразить и с какой даты оно действует.
@@ -994,7 +1102,7 @@
 Если нужно исправить принадлежность организации, не создавайте вторую запись с тем же ИНН. Используйте предусмотренное
 действие или обратитесь к ответственному за справочник.
 
-### 12.8 Организации вне ГК
+### 13.8 Организации вне ГК
 
 1. Откройте «Справочники → ЮЛ вне ГК». Здесь показаны организации без принадлежности к группе компаний.
 
@@ -1004,7 +1112,7 @@
 3. Нажмите «Создать ЮЛ». Введите тип, ИНН и наименование организации. Остальные известные реквизиты заполните при
    необходимости.
 4. Оставьте «ГК», «Входит в ГСК» и «Входит в ГСЗ» пустыми. Если организация должна быть участником ГК, вернитесь к
-   порядку раздела 12.5.
+   порядку раздела 13.5.
 5. Нажмите «Добавить». Найдите организацию в списке «ЮЛ вне ГК» и проверьте название и ИНН.
 
 **Если после обновления страницы список пуст, откройте «ГК и организации», дождитесь загрузки и вернитесь в «ЮЛ вне ГК».
@@ -1013,7 +1121,7 @@
 Поиск здесь используйте по названию или ИНН. В текущей версии поиск по CRM ID и региональному филиалу может не находить
 записи, хотя эти критерии указаны в подсказке поля.
 
-## 13. Статусы и термины
+## 14. Статусы и термины
 
 **Статус версии консолидации** (бейдж в таблице консолидаций и в шапке страницы отчёта):
 
@@ -1060,13 +1168,13 @@
 бухгалтерский баланс; ОФР — отчёт о финансовых результатах; ВГО — внутригрупповые обороты; КФО — консолидированная
 финансовая отчётность.
 
-## 14. Ограничения и известные ошибки
+## 15. Ограничения и известные ошибки
 
 Что пока недоступно:
 
-- Нельзя работать с монозаёмщиками, Единым хранилищем, журналом и историей изменений, корректировками, гудвиллом, КФО и
+- Нельзя работать с монозаёмщиками, Единым хранилищем, журналом и историей изменений, гудвиллом, КФО и маршрутом
-  маршрутом согласования. Также пока нельзя добавить новую версию, изменить состав уже созданной версии или исправить
+  согласования. Также пока нельзя добавить новую версию, изменить состав уже созданной версии или исправить строки ОСВ
-  строки ОСВ прямо в приложении.
+  прямо в приложении.
 - Отменённую версию нельзя вернуть в работу, а консолидацию той же ГК за тот же период нельзя создать заново.
 - Снять с себя версию («освободить») из интерфейса нельзя — её может только перехватить другой аналитик.
 - Комментарии к документам сохраняются, но их просмотр и удаление через интерфейс пока недоступны.
@@ -1133,7 +1241,7 @@
   чисел ячеек, под результирующей таблицей — сумма всех пяти статей. Правило итогов уточняется, используйте суммы по
   ячейкам и статьям.
 
-## 15. Если что-то пошло не так
+## 16. Если что-то пошло не так
 
 - «Сессия истекла». Войдите заново под учётной записью.
 - Файл долго находится в «Обработке». Убедитесь, что загрузка принята, и подождите: панель обновляется автоматически.
@@ -1147,6 +1255,10 @@
   у коллеги, договоритесь с ним или перехватите её с указанием причины.
 - В шахматке нет расчётов с организацией группы. Проверьте, что её ОСВ подтверждены, счёт не попал в «Пробелы», а
   контрагент без ИНН сопоставлен с организацией периметра (раздел 10.3).
+- В таблице корректировок нет нужного агрегата или строки. Проверьте фильтры («ЮЛ», «Счёт», «Строка баланса»,
+  «Отклонение, %») и переключатель «Тип записи» — строка может быть скрыта фильтром, а не отсутствовать (раздел 12).
+- При сохранении корректировки у статьи появляется «Статья отсутствует в форме компании». Выберите другую статью этой
+  стороны или уточните у ответственного за форму правильный код строки, прежде чем сохранять (раздел 12.3).
 - Если действие не выполняется или результат отличается от исходного документа, обратитесь к ответственному за
   сопровождение. Укажите раздел, организацию, период, имя файла и последовательность действий. Опишите, чего ожидали и
   что получилось; приложите снимок экрана с сообщением. Не передавайте пароли и другие данные доступа.