10. Пользовательский путь (по макету dkb_24.09.26 и ТЗ)

Источник: макет docs/mockup/ (снимки screens/, индекс INDEX.md) — для состава экранов, названий кнопок и статусов; ТЗ (DOC-221273, DOC-037734, DOC-036960, DOC-221280) — для правил и переходов, которых в макете нет. Номера [NN] — файлы docs/mockup/screens/NN-*.png. Названия кнопок и статусов — как в макете, они пойдут в словарь UI.

Карта экранов

Вход (JWT РАИСА)
 └─ Сайдбар
     ├─ [+ Новая консолидация] ─── модалка: ГК → ГСК → Год → Квартал → Создать                        [42]
     ├─ ОТЧЁТНОСТЬ
     │   ├─ Группы компаний ─── таблица ГК ── [Консолидации →] ── Консолидации ГК                     [03] [34]
     │   │                                                        ├─ [Взять в работу]                 [35]
     │   │                                                        ├─ меню «…»: Добавить версию · Вкл/Откл подтверждение КФО · История изменений [43]
     │   │                                                        ├─ панель Организации
     │   │                                                        │    ├─ [Документы] → Первичные документы (drawer) [39] [40]
     │   │                                                        │    │        └─ клик по документу → Проверка распознавания [41]
     │   │                                                        │    ├─ [Редактировать состав]      [36]
     │   │                                                        │    └─ [Скачать чек-лист]          [37]
     │   │                                                        └─ [К отчетности] → Отчёт «ГК — ГГГГ Кn»
     │   │                                                               ├─ ОСВ (сводная)           [30] [32]
     │   │                                                               ├─ Шахматка                [31-01]
     │   │                                                               ├─ Таблица корректировки   [31-02]
     │   │                                                               ├─ Гудвилл                 [31-03]
     │   │                                                               ├─ КФО                     [31-04]
     │   │                                                               ├─ КФО Общий               [31-05]
     │   │                                                               ├─ Подтверждение КФО клиента [31-06]
     │   │                                                               └─ [Изменить статус]       [33]
     │   └─ Монозаемщики ─── таблица ЮЛ вне ГК с документами ── [Документы] → drawer                [60] [84]
     ├─ СПРАВОЧНИКИ
     │   ├─ ГК и организации ─── список ГК | карточка ГК: вкладки ЮЛ / ГСК / ГСЗ, Архив             [50] [77]
     │   │                        [Импорт из файла] [38]  [Создать ГК/ЮЛ] → ГК | ЮЛ | ГСК | ГСЗ        [51]
     │   │                        меню ЮЛ «…»: Изменить ЮЛ, Вывести из состава ГК                     [78–80]
     │   └─ ЮЛ вне ГК ─── таблица ЮЛ, [Создать ЮЛ]                                                    [61]
     ├─ ДОКУМЕНТЫ
     │   └─ Единое хранилище ─── дерево ГК → ГСК → Организации | документы и срезы узла               [62] [82] [83]
     └─ СИСТЕМА
         └─ Журнал действий ─── категории Справочники / Консолидация / Доступ, таблица событий         [63]

Чего в макете нет (есть в ТЗ, реализуется по ТЗ): пользователи и матрица прав (ТЗ 8.1), модалка смены статуса с комментарием. Решения по полям ТЗ 5.1 (OQ-27): подход — базовый по умолчанию; гудвилл — переключатель на вкладке «Гудвилл»; сценарий «Подтверждение КФО клиента» — через меню «…» консолидации.

Путь 1. Куратор/администратор готовит справочники

Шаг	Экран	Действие	БД
1.1	Справочники → ГК и организации [50]	Импорт из файла [38]: файл .xlsx/.csv, РФ, колонки ИНН, Наименование, Тип, Базовый РФ ГК, ID ГК; дубли — «Пропустить существующие»	`legal_entity`, `company_group`, `audit_event(DIRECTORY_IMPORT)`
1.2	[51]	Создать ГК/ЮЛ → выбор: ГК / ЮЛ / ГСК / ГСЗ → форма (ГК: наименование, CRM ID, основной РФ)	`company_group(+_history)`
1.3	Карточка ГК → вкладка ГСК/ГСЗ [77]	список ГСК: ID (GSK-001), Наименование, Число участников, Дата создания; создание ГСК, состав — через ЮЛ	`related_group`, `related_group_member`
1.4	Карточка ГК → ЮЛ → меню «…» [78–80]	Изменить ЮЛ (алиасы, членство в ГСК/ГСЗ); Вывести из состава ГК: Событие (Закрытие / Переход в другую ГК), Дата закрытия, Комментарий	`legal_entity`, `legal_entity_alias`, `legal_entity_history(event_type, effective_date)`
1.5	ЮЛ вне ГК [61]	Создать ЮЛ (монозаёмщик), поиск, фильтры	`legal_entity(company_group_id NULL)`
1.6	(нет в макете)	назначить роли, править матрицу прав	`user_role`, `role_permission`, `audit_event(ROLE_PERMISSION_CHANGE)`

Путь 2. КА РФ создаёт КФО и загружает первичку

Шаг	Экран	Действие	БД / статус
2.1	Сайдбар → Новая консолидация [42]	ГК → ГСК (активна после ГК) → Год → Квартал → Создать. `scenario = CREATE`, `approach = BASIC`, `goodwill_enabled = false` по умолчанию (OQ-27)	`consolidation`, `consolidation_version(INITIATED)`, `consolidation_member` из текущего состава ГСК
2.2	Отчётность → Группы компаний [03] → Консолидации → [34]	таблица консолидаций ГК: период, дерево версий, статус-бейдж, ГСК, даты, число организаций	`consolidation_version`
2.3	[34] → Взять в работу [35]	«Консолидация … будет закреплена за вами для редактирования»	`consolidation_lock`, `audit_event(CONSOLIDATION_LOCK)`
2.4	[34] панель Организации → Редактировать состав [36]	фильтр по ГСК, «Показать все ЮЛ в ГК», чекбоксы, Сохранить	`consolidation_member`
2.5	строка организации → Документы → drawer «Первичные документы» [39]	список: документ (имя, формат, дата), Период («2024 К1»), Проверка (✓/✗ Период, ✓/✗ Контрагент), Статус; комментарий, удаление; Загрузить документы [40] (несколько файлов, тип документа)	`stored_file(UPLOADED)`, `s3_object`, `recognition_job(queued)`, `document.period_check/counterparty_check` → `DOCUMENTS_PROCESSING`
2.6	[34] → Скачать чек-лист [37]	матрица Организация × (Бух. баланс, ОФР, ОСВ 01 58 60 62 66 67 76 90, Прочие); легенда: Загружен / Обработка / Требуется проверка / Ошибка загрузки / Отсутствует; Скачать CSV	`required_document_rule × consolidation_member − document(CONFIRMED)`
2.7	drawer [39] → клик по документу → Проверка распознавания [41]	слева «Исходный документ» постранично с масштабом; справа «Результат распознавания»: шапка формы (организация, ИНН, ОКПО/ОКОПФ/ОКФС, адрес, аудит, ОКУД, отчётная дата, ОКЕИ, единица измерения) и таблица Пояснения / Показатель / Код / колонки-даты; выпадающий список Документ для перехода между документами ЮЛ; Добавить комментарий; Редактировать → Сохранить; Подтвердить данные. Блок логических ошибок — по ТЗ (в снимке документ без ошибок)	`financial_statement_meta/column/line/value.is_modified`, `osv_entry.is_modified`, `document(CONFIRMED)`, `comment`, `audit_event(RECOGNIZED_DATA_EDIT, DOCUMENT_CONFIRM)` → `DATA_CORRECTION`

Монозаёмщики [60] [84]: тот же drawer документов без консолидации — первичка в ЕХ напрямую.

Путь 3. КА РФ консолидирует (отчёт «ГК — ГГГГ Кn»)

Вход: [34] → К отчетности. Шапка отчёта: крошки, заголовок, пояснение статуса («Отчёт верифицирован ГО, КА ГО внёс в систему номер и дату решения УОБ»), бейдж Статус отчёта, Изменить статус. Общие элементы вкладок: Единицы (тыс. руб.), Знаков после запятой, Настройка таблицы, Экспорт, На весь экран.

Шаг	Вкладка	Действие	БД
3.1	ОСВ [30]	сводная ОСВ: Компания ГК, Счёт, Период, Контрагенты, ИНН, 6 сумм, Тип контрагента. Баннер «Требуется указать соответствия… Осталось: N» → Показать ЮЛ без ИНН [32-osv-no-inn] → Указать → модалка «Выбор организации для связи с …» [32-osv-map-counterparty]: ИНН, Организация, ГК, ГСК, ГСЗ, блок «Рекомендуемые», Связать. При уходе с вкладки с несопоставленными — «Остались неуказанные ИНН… Остаться / Перейти» [31-00]	вычисляется; `osv_entry.counterparty_id`, `legal_entity_alias`, `audit_event(OSV_COUNTERPARTY_MAP)`
3.2	Шахматка [31-01]	фильтры Год, Период, Компании, Дт-счета, Кт-счета; матрица компания × компания: сумма A / сумма B / (расхождение) красным; Итого; ниже результирующая таблица «Статья × компания»	вычисляется (§5–6 правил)
3.3	Таблица корректировки [31-02]	пары «Актив баланса ЮЛ-1 / Пассив баланса ЮЛ-2»: Наименование, Строка баланса, Счёт, Сумма; Контроль: % и сумма отклонения; Корректировка: Дт, Кт, Комментарий; Редактировать	`correction`, `audit_event(CORRECTION_*)`; ≥ 5 % → `ADJUSTMENT`
3.4	Гудвилл [31-03]	здесь же включается/выключается расчёт гудвилла для консолидации (`goodwill_enabled`); по головной организации: Учёт в отчёте ☐, Дочерняя организация, Доля владения, Фондовые (финансовые) вложения ГО, Доля участия ГО в УК ДО, Уставный капитал, Гудвилл (+/−), Комментарий; Редактировать	`consolidation_version.goodwill_enabled`, `goodwill`
3.5	КФО [31-04]	сводка расхождений «по статьям баланса N %» / «по статьям ОФР N %» (красным при превышении); Баланс (38 строк) и ОФР; по каждой ЮЛ: По данным клиента / В т. ч. взаимные обязательства / Очищенные показатели / Доля в показателе по группе %; КФО, подготовленная банком; Комментарий; «В т.ч. Гудвилл» под 1170; Редактировать комментарии	`kfo_result(_line, _line_company)`, `comment`
3.6	КФО Общий [31-05]	динамика КФО по отчётным датам (01.01.2025 … 01.01.2026), Выбор периодов	`kfo_result_line` верифицированных версий / `ex_snapshot_item.payload`
3.7	Подтверждение КФО клиента [31-06] (включается пунктом «Включить подтверждение КФО» в меню «…» консолидации [43]; при выключенном — вкладка скрыта)	Версия клиента (ст. 1), Версия банка (ст. 2), ВГО, Консолидированная отчётность, Расхождение сумма и % ((ст. 1 − ст. 2)/ст. 2 × 100), Комментарий; Редактировать	`client_kfo_line` (сценарий CONFIRM)
3.8	Изменить статус [33]	модалка «Смена статуса отчёта» (комментарий обязателен при возврате; в макете не снята — кнопка неактивна у верифицированного)	`consolidation_status_history`, `audit_event(CONSOLIDATION_STATUS_CHANGE)`

Путь 4. Согласование и верификация

Шаг	Роль	Где	Действие	Статус
4.1	КА РФ	Отчёт → Изменить статус	Отправить на верификацию	`VERIFICATION_RF` (бейдж «Верификация РФ»)
4.2	РКА РФ	Отчёт (read-only + корректировка ОСВ)	Подтвердить → «Консолидация ГО» / Вернуть с комментарием	`CONSOLIDATION_GO` / `CONSOLIDATION_RF`
4.3	КА ГО	Отчёт	Проверка, сравнение с клиентом; Вернуть / Верифицировать с № и датой решения УОБ	`VERIFIED` (бейдж «Верифицирован», пояснение в шапке)
4.4	система	—	срез в ЕХ, версия read-only	`ex_snapshot(_member,_item)`
4.5	КА	[34] меню «…» → Добавить версию [43]	новая версия после VERIFIED (в списке — дерево версий под периодом)	`consolidation_version.previous_version_id`
4.6	все	[34] меню «…» → История изменений [43]	переходы статусов, кто/когда/комментарий	`consolidation_status_history`, `audit_event`
—	КА	[34]	Отмена КФО (строка в бандле)	`CANCELLED`

Путь 5. Потребители результата

Кто	Экран	Что делает
КМ, Эксперт	[03] [34] отчёт read-only	статус и КФО по своим / всем ГК
КА, РКА, Эксперт	Единое хранилище [62] [82] [83]	дерево ГК → ГСК → организации; фильтры ГК / организация / год / квартал / тип документа; поиск по хранилищу; документы и срезы узла, скачивание
Администратор	Журнал действий [63]	категории Справочники / Консолидация / Доступ; Дата, ГК, ЮЛ, Пользователь, Событие, Что изменилось, Детали события; пагинация

Словарь UI (из макета)

Статусы отчёта: Инициация, Загрузка и распознавание документов, Корректировка данных, Консолидация РФ, Верификация РФ, Консолидация ГО, Верифицирован, Отмена КФО. Статусы документов: Загружен, Обработка, Требуется проверка, Ошибка, Отсутствует. Тип контрагента: ГСК, ГК, Внешний. Кнопки: Новая консолидация, Консолидации →, Взять в работу, Добавить версию, Включить/Отключить подтверждение КФО, История изменений, Только в работе, К отчетности, Редактировать состав, Скачать чек-лист, Документы, Загрузить документы, Редактировать документы, Показать ЮЛ без ИНН, Указать, Связать, Изменить статус, Редактировать, Редактировать комментарии, Выбор периодов, Экспорт, На весь экран, Настройка таблицы, Импорт из файла, Создать ГК/ЮЛ, Создать ЮЛ, Изменить ЮЛ, Вывести из состава ГК, Сбросить фильтры.

Что осталось уточнить по макету

Модалка «Смена статуса отчёта» — состав полей (Комментарий, целевой статус) — снять на консолидации в работе
Формы «Создать ГК / ЮЛ / ГСК / ГСЗ» и «Изменить ЮЛ» — поля
Правая часть ЕХ при выборе организации/среза — что показывается и что скачивается
Проверка распознавания для ОСВ (xlsx) — как выглядит левая панель (в снимке — PDF); режим «Редактировать» и блок логических ошибок

20 KiB Raw Blame History Unescape Escape