arm-core/openspec/changes/corrections-table-ui/proposal.md

Why

AURORA-1541: вкладка «Таблица корректировки» страницы отчёта версии — заглушка «Будет в следующих срезах». Аналитику нужен экран, где видно расхождения ВГО по правилам и парам компаний, строки ОСВ, из которых они сложились, нераспределённые строки, и где вносится корректировка агрегата. Срок задачи — 02.11.2026, к 03.11 начинается тестирование корректировок (AURORA-1542).

Основа — аналитика Лысенко (DOC-272613 «Корректировка данных агрегатом», ответы на вопросы 1–7 от 27.10.2026 в AURORA-1395, DOC-274230 «Правила пар счетов») и дизайн от 23.10.2026 (вложение к DOC-272613). Где дизайн расходится с аналитикой, действует аналитика (решение владельца 28.10.2026); вопросы по расхождениям — комментарий [design-23-10-check] в AURORA-1395 и в AURORA-1396.

What Changes

Срез 5 (09-delivery-plan.md, «ВГО: автоматическое сопоставление, шахматка, корректировки»). Репозиторий — arm-core, только web/. Бэкенд — AURORA-1540 (Цыганков) по контракту ../docs/dev/api-contract-corrections.md + api-contract-corrections.openapi.yaml (docs #183); пока API нет, экран работает на встроенном фейке контракта под флагом REACT_APP_CORRECTIONS_MOCK.

• Вкладка «Таблица корректировки» (…/versions/{id}/correction) становится доступной.
• Таблица агрегатов «правило × компания 1 × компания 2»: блоки Дебет / Кредит / Контроль / Корректировка, раскрытие до строк ОСВ под своей стороной, нераспределённые строки после агрегатов, строка «Итого» по видимым строкам.
• Панель: «Отображение» (Общий / По пресету + выбор правила), «Тип записи», единицы и знаки, «Сбросить фильтры», «Настройка таблицы», «Экспорт», «На весь экран»; фильтры в заголовках колонок.
• Окно «Корректировка операции» агрегата: исходные строки ОСВ сторон (убрать, добавить подходящую нераспределённую), распределение по статьям каждой стороны, контроль распределения, комментарий, «Сохранить корректировки».
• Решения по строке: «Учитывать в КФО» (флажок строки), «Отнести к правилу» / «Перенести в правило», «Убрать из правила», «Вернуть к автоматике»; «Отменить корректировку» агрегата с комментарием.
• Режим только чтения по editable / read_only_reason ответа.
• Новая спека corrections-table-ui; дельта intercompany-matrix-ui (вкладка «Таблица корректировки» доступна).

Non-goals

• Бэкенд, DBML (correction как есть в v5.23; vgo_assignment — новая версия DBML в рамках AURORA-1540).
• ОФР: в дизайне его нет, вопрос в AURORA-1396; экран запрашивает только statement_type = balance.
• Импорт xlsx (вопрос по ТЗ 6.8 в [design-23-10-check]).
• Корректировка строки ОСВ и нераспределённой строки — по аналитике корректируется только агрегат (ждёт п. 2).
• Переход из ячейки шахматки в таблицу с фокусом на паре — AURORA-1653.
• Учёт корректировок в шахматке — AURORA-1643.

Capabilities

New Capabilities

• corrections-table-ui: экран «Таблица корректировки» версии консолидации.

Modified Capabilities

• intercompany-matrix-ui: MODIFIED «Вкладки страницы отчёта по версии» — «Таблица корректировки» доступна.

Impact

• web/src/widgets/ConsolidatedOsv/OsvTabs.tsx — вкладка correction без disabled.
• web/src/layouts/ConsolidationReportPage.tsx — содержимое вкладки correction.
• Новое: web/src/widgets/CorrectionTable/ (таблица, панель, окно корректировки, чистые функции + тесты), web/src/services/api/corrections.ts, типы контракта в web/src/types/api.ts (или types/corrections.ts), фейк контракта.
• web/src/conf/config.ts — флаг REACT_APP_CORRECTIONS_MOCK.
• Таблицы DBML v5.23: correction, elimination_rule, osv_entry — только читаются через API; новых полей фронт не вводит.
• Правила: 05-domain-rules.md §8 (корректировки) в нынешнем виде описывает только запись корректировки; разнесение строк и vgo_assignment в §8 нет — ASSUMPTION: до обновления §8 источник — DOC-272613 и ответы 1–7 (обновление §8 и DBML — в рамках AURORA-1540 / AURORA-1751).