arm-ka-docs/context/10-user-journey.md

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

Статус реализации (на 05.10.2026, после Среза 1). Экраны справочника — [50], [51] (+ [51-01…51-04]), [61], [77]–[80], модалка импорта [38] — не реализованы: по решению владельца 04.10.2026 UI справочника вынесен в отдельный срез (09-delivery-plan.md, «UI справочника»). API этих экранов есть с Среза 1 (/api/v1/directories/*, импорт ЕЦП — POST /directories/import, правила — 05-domain-rules.md §13); пока справочники заполняются импортом и вызовами API. Экран администратора /admin («Пользователи и роли»: пользователи, роли, матрица прав) — минимальный, реализован в Срезе 1 (в макете его нет — п. 1.6 пути 1).

Чего в макете нет (есть в ТЗ, реализуется по ТЗ): пользователи и матрица прав (ТЗ 8.1); экран проверки распознавания для ОСВ/xlsx (строки ОСВ в панели документов — только для чтения, [39]); блок логических ошибок на экране проверки (в снимках не виден, [41] [41-02]); переключатель расчёта гудвилла (решение OQ-27, в снимках [31-03] его нет). Модалка смены статуса с комментарием в макете есть — [33-01]. Решения по полям ТЗ 5.1 (OQ-27): подход — базовый по умолчанию; гудвилл — переключатель на вкладке «Гудвилл»; сценарий «Подтверждение КФО клиента» — через меню «…» консолидации.

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

Шаги 1.1–1.5 — экраны макета; API есть с Среза 1, экраны реализуются отдельным срезом «UI справочника». Шаг 1.6 — экран /admin, реализован (минимальный).

Шаг	Экран	Действие	БД
1.1	Справочники → ГК и организации [50]	Импорт из файла [38]: файл .xlsx/.csv, РФ, колонки ИНН, Наименование, Тип, Базовый РФ ГК, ID ГК; дубли — «Пропустить существующие». Та же модалка открывается кнопкой Импорт на экране консолидаций ГК [34]	legal_entity, company_group, audit_event(DIRECTORY_IMPORT)
1.2	[51]	Создать ГК/ЮЛ → модалка «Выберите объект для добавления»: ГК / ЮЛ / ГСК / ГСЗ → форма. ГК [51-01]: Название ГК, ID ГК в CRM («генерируется автоматически» — это внутренний code, OQ-20; crm_id приходит из ЕЦП CRM), Базовый РФ ГК. ЮЛ [51-02] (добавляется в открытую карточку ГК): ИНН, КПП, ID ЮЛ в CRM, Тип (ЮЛ/ИП), Наименование организации, Альтернативные наименования (теги), Входит в ГСК, Входит в ГСЗ. ГСК [51-03] / ГСЗ [51-04]: ID в CRM, Наименование, Дата создания	company_group(+_history), legal_entity, legal_entity_alias, related_group, related_group_member
1.3	Карточка ГК → вкладка ГСК/ГСЗ [77]	список: ID ГСК/ГСЗ (GSK-001, GSZ-001), Наименование, Число участников, Дата создания; состав — через форму ЮЛ («Входит в ГСК/ГСЗ»). Меню «…» строки [77-01]: Изменить ГСК [77-02] (ID ГСК в CRM, Наименование, Дата создания), Удалить	related_group, related_group_member
1.4	Карточка ГК → ЮЛ → меню «…» [78]	Изменить ЮЛ [79] (те же поля, что при создании, + ГК; алиасы с удалением; членство в ГСК/ГСЗ); История изменений [79-02] → Журнал действий с фильтром по ГК и категории «Справочники»; Перевести в другую ГК [79-01]: ЮЛ, Текущая ГК, Новая ГК, Дата перевода (подсказка: «запись появится в архиве текущей ГК с событием „Переход в другую ГК“»); Вывести из состава ГК [80]: ЮЛ, Событие (Закрытие / Переход в другую ГК), Дата закрытия, Комментарий (необязательно)	legal_entity, legal_entity_alias, related_group_member, legal_entity_history(event_type, effective_date)
1.5	ЮЛ вне ГК [61] (заголовок экрана — «Юридические лица»)	Создать ЮЛ (монозаёмщик), поиск по ЮЛ, ИНН или ГК, фильтр «Архив». По снимку таблица показывает все ЮЛ с заполненной колонкой ГК, а не только вне ГК — расхождение с названием пункта (OQ-41)	legal_entity(company_group_id NULL)
1.6	/admin (нет в макете; минимальный экран, Срез 1)	назначить роли, править матрицу прав	user_role, role_permission, audit_event(ROLE_PERMISSION_CHANGE)

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

Шаг	Экран	Действие	БД / статус
2.1	Сайдбар → Новая консолидация [42]	ГК → ГСК (активна после ГК) → Год → Квартал → Создать. scenario = CREATE, approach = BASIC, goodwill_enabled = false по умолчанию (OQ-27) API (Срез 4): POST /consolidations ({company_group_id, related_group_id, year, quarter}; ≥ 2 члена ГСК), ГСК для выбора — справочники	consolidation, consolidation_version(INITIATED), consolidation_member из текущего состава ГСК
2.2	Отчётность → Группы компаний [03] → Консолидации → [34]	[03]: таблица ГК (Группа компаний, CRM ID, Основной РФ, Организаций), поиск по ГК, CRM ID или РФ. [34]: таблица консолидаций ГК: Год, Квартал, Версия (дерево версий под периодом), Статус (бейдж), ГСК, Дата создания, Дата верификации, Организаций; кнопки в строке Взять в работу, К отчетности (неактивна у статусов «Инициация» и «Верификация РФ» — по снимку, OQ-43), меню «…»; чекбокс «Только в работе». Выбор строки открывает панель Организации (Ответственный / Утверждён в РФ / Верифицирован в ГО; таблица Наименование, Документы, ОФР, Бух. баланс, ОСВ — перечень счетов, ИНН, Тип) API: GET /company-groups/{id}/consolidations?in_work_only= (периоды и версии, блокировка), GET /consolidations/versions/{id} (карточка: члены с ячейками чек-листа, история)	consolidation_version, consolidation_lock, consolidation_member, document
2.3	[34] → Взять в работу [35]	«Консолидация … будет закреплена за вами для редактирования» API: POST …/versions/{id}/lock (перехват — takeover_reason), DELETE …/lock; ручной статус — POST …/status	consolidation_lock, audit_event(CONSOLIDATION_LOCK)
2.4	[34] панель Организации → Редактировать состав [36]	фильтр по ГСК, «Показать все ЮЛ в ГК», чекбоксы, Сохранить API: PUT …/versions/{id}/members ({legal_entity_ids}), нужны статус «в работе» и своя блокировка	consolidation_member
2.5	строка организации → Документы → drawer «Первичные документы» [39]	список: документ (имя, формат, дата; подпись типа у прочих — «Прочий документ», «Бухгалтерская отчетность»), Период («2024 К1», «2025 · 9 мес.»), Проверка (✓ / ✗ / — Период, Контрагент), Статус (Загружен / Обработка / Требуется проверка / Ошибка); иконки: комментарий (поповер «Комментарий к документу …», [39-01]) и удалить; Редактировать документы — в снимке неактивна; Загрузить документы [40]: модалка с зоной «Перетащите файлы сюда» / Выбрать документы, Загрузить; тип документа и период в модалке не выбираются — определяются при распознавании API: загрузка — POST /legal-entities/{id}/files?consolidation_version_id=; документы и подтверждение — /files, /documents (Срез 2c); подтверждённый документ привязывается к версиям «в работе» автоматически	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 API: GET …/versions/{id}/checklist (rules[], rows[].cells[]: status, missing_quarters, document_ids); CSV в Срезе 4 нет	required_document_rule × consolidation_member − document(CONFIRMED)
2.7	drawer [39] → клик по PDF-документу → Проверка распознавания [41]	слева «Исходный документ» постранично с масштабом; справа «Результат распознавания»: шапка формы (организация, ИНН, ОКПО/ОКОПФ/ОКФС, адрес, аудит, ОКУД, отчётная дата, ОКЕИ, единица измерения) и таблица Пояснения / Наименование показателя / Код / колонки-даты (в таблице есть строки без кода «в том числе …» и строка «Гудвилл 1105» ФСБУ 4/2023 — OQ-36, OQ-37); выпадающий список Документ для перехода между документами ЮЛ; Добавить комментарий; Редактировать [41-02] → кнопки Сохранить / Отменить (значения таблицы редактируются на месте); Подтвердить данные. Блок логических ошибок — по ТЗ (в снимках не виден). Для ОСВ (xlsx) экран в макете не открывается — строки readonly, OQ-42	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] API: GET …/versions/{id}/osv (фильтры, limit ≤ 2000), …/osv/summary (баннер «Осталось: N» — unmapped_total, пробелы — gaps[]), …/counterparty-candidates?scope=&q=&entry_id= (блок «Рекомендуемые» — recommended), POST …/osv/entries/{entry_id}/counterparty (Связать), GET …/osv/export (Экспорт, xlsx)	вычисляется; osv_entry.counterparty_id, legal_entity_alias, audit_event(OSV_COUNTERPARTY_MAP)
3.2	Шахматка [31-01]	фильтры Год, Период, Компании, Дт-счета, Кт-счета; матрица компания × компания: сумма A / сумма B / (расхождение) красным; Итого; ниже результирующая таблица «Статья × компания»	вычисляется (§5–6 правил)
3.3	Таблица корректировки [31-02] [31-02-02]	фильтр «Отклонение» (Все); пары «Актив баланса ЮЛ-1 / Пассив баланса ЮЛ-2»: Наименование, Строка баланса, Счёт, Сумма; Контроль: % отклонения, Сумма отклонения; Корректировка: Строка баланса / Дт, Строка баланса / Кт, Комментарий; строка пары раскрывается в детализацию по субсчетам; Итого. В макете % отклонения считается к сумме стороны ЮЛ-1, а не к меньшей (OQ-35). Редактировать [31-02-01] → баннер «Режим редактирования включён…», ячейки пары и корректировки становятся полями ввода, Отменить изменения / Сохранить	correction (+ дочерние строки parent_correction_id), audit_event(CORRECTION_*); ≥ 5 % → ADJUSTMENT
3.4	Гудвилл [31-03]	здесь же включается/выключается расчёт гудвилла для консолидации (goodwill_enabled; переключателя в снимках нет — решение OQ-27); фильтр «Гудвилл: Все значения»; по головной организации (с «Выделить все» и строкой «Всего»): Учёт в отчёте ☐, Наименование дочерней организации, Доля владения, Фондовые вложения головной организации, Доля участия головной организации в уставном капитале дочерней организации, Уставный капитал, Гудвилл (+/−), Комментарий; Редактировать [31-03-01] → «Доступны для редактирования столбцы „Доля владения“ и „Комментарий“»	consolidation_version.goodwill_enabled, goodwill(ownership_share, include_in_kfo, comment)
3.5	КФО [31-04]	сводка расхождений «по статьям баланса N %» / «по статьям ОФР N %» (красным при превышении); Баланс (38 строк) и «Отчет о финансовых результатах»; по каждой ЮЛ: По данным клиента / В том числе взаимные обязательства (ОФР — «взаимные обороты») / Очищенные показатели / Доля в показателе по группе, %; КФО, подготовленная банком; Комментарий; «В т.ч. Гудвилл» под 1170; Редактировать комментарии [31-04-01] → поле ввода в каждой строке, Отменить изменения / Сохранить	kfo_result(_line, _line_company), kfo_result_line.comment, comment
3.6	КФО Общий [31-05]	динамика КФО по отчётным датам (01.01.2025 … 01.01.2026); Выбор периодов [31-05-01] — поповер «Отображаемые периоды»: «Выбрать все» / «Последний», чекбоксы дат	kfo_result_line верифицированных версий / ex_snapshot_item.payload
3.7	Подтверждение КФО клиента [31-06] (включается пунктом «Включить подтверждение КФО» в меню «…» консолидации [43]; при выключенном — вкладка скрыта)	шапка: Период отчетности, Расхождения по балансу, Расхождения по ОФР; таблица: ВГО (Версия клиента / Версия банка), Консолидированная отчётность (Версия клиента ст. 1 / Версия банка ст. 2), Расхождение сумма (ст. 1 − ст. 2), Расхождение % ((ст. 1 − ст. 2)/ст. 2 × 100 — к версии банка, а не к меньшей, OQ-35), Комментарий; Редактировать	client_kfo_line (сценарий CONFIRM)
3.8	Изменить статус [33] [33-01]	на верифицированном отчёте кнопка неактивна [33]; на отчёте в работе — модалка «Изменить статус» [33-01]: Текущий этап (бейдж), Новый этап (выпадающий список, предложен следующий по маршруту), Комментарий («Укажите комментарий к изменению статуса»); Отмена / Изменить статус	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] [43-01]	новая версия после VERIFIED создаётся сразу, без модалки: в дереве версий под периодом появляется строка со статусом «Инициация», датой создания = сегодня и тем же числом организаций	consolidation_version.previous_version_id, consolidation_member (копия периметра)
4.6	все	[34] меню «…» → История изменений [43] [43-02]	переход в Журнал действий с фильтрами (категория «Консолидация», ГК) и колонкой «Квартальная дата»; события «Смена статуса отчёта» / «Создание консолидации», кто/когда; «Сбросить фильтры»	consolidation_status_history, audit_event
—	КА	[34]	Отмена КФО (строка в бандле)	CANCELLED

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

Кто	Экран	Что делает
КМ, Эксперт	[03] [34] отчёт read-only	статус и КФО по своим / всем ГК
КА, РКА, Эксперт	Единое хранилище [62] [82] [83] [83-01]	дерево ГК → ГСК → организации; фильтры ГК / Организация / Год / Квартал / Типы документов; поиск по хранилищу. Справа для выбранного узла — список консолидаций-аккордеонов «Консолидация ГГГГ Кn • Верифицирована дд.мм.гггг — N файлов» (в макете есть и неверифицированные, OQ-38); раскрытая консолидация [83-01]: блок Сформированная отчетность (Документ / Сформирован / Ответственный / Утвердил / Верифицировал / Действия: КФО .xlsx, Шахматка .xlsx, Консолидированная отчётность .pdf) и Первичные документы по организациям (Документ с типом / Загружен / Ответственный / Действия: просмотр, скачать; «Показать все» / «Свернуть»)
Администратор	Журнал действий [63]	категории Все категории / Справочники / Консолидация / Доступ; Дата (с временем), ГК, ЮЛ, Пользователь (ФИО + роль), Событие, Что изменилось (список полей), Детали события («Показать»); «Показано 10 из 37», пагинация. Сюда же ведут «История изменений» консолидации [43-02] и ЮЛ [79-02] с предустановленными фильтрами

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

Статусы отчёта: Инициация, Загрузка и распознавание документов, Корректировка данных, Консолидация РФ, Верификация РФ, Консолидация ГО, Верифицирован, Отмена КФО. Подзаголовки статуса в шапке отчёта: «Отчет верифицирован ГО, КА ГО внес в систему номер и дату решения УОБ» (Верифицирован), «Автоматическая консолидация, ручные проверки и сравнение КФО клиента и банка» (Консолидация РФ). Статусы документов: Загружен, Обработка, Требуется проверка, Ошибка, Отсутствует (в чек-листе — Ошибка загрузки). Проверка документа: ✓ / ✗ / — Период, Контрагент. Тип контрагента: ГСК, ГК, Внешний. Кнопки: Новая консолидация, Консолидации →, Импорт, Взять в работу, Добавить версию, Включить/Отключить подтверждение КФО, История изменений, Только в работе, К отчетности, Редактировать состав, Скачать чек-лист, Документы, Загрузить документы, Выбрать документы, Редактировать документы, Показать ЮЛ без ИНН, Указать, Связать, Остаться / Перейти, Изменить статус, Редактировать, Отменить изменения, Сохранить, Отменить, Редактировать комментарии, Выбор периодов (Выбрать все / Последний), Экспорт, На весь экран, Настройка таблицы, Импорт из файла, Создать ГК/ЮЛ, Создать, Добавить, Создать ЮЛ, Изменить ЮЛ, Изменить ГСК, Удалить, Перевести в другую ГК, Перевести, Вывести из состава ГК, Вывести, Добавить комментарий, Подтвердить данные, Показать все, Свернуть, Показать, Сбросить фильтры, Назад. Роли пользователей в журнале макета (≠ ТЗ 8.1, ANL-034): Аналитик ДКБ, Кредитный аналитик, Утверждающий РФ, Верификатор ГО, Система распознавания / Сервис.

Уточнено по досъёмке макета (03.10.2026, scripts/mockup_crawl_extra.py)

• Модалка смены статуса — называется «Изменить статус» [33-01]: Текущий этап (бейдж), Новый этап (выпадающий список), Комментарий (textarea); Отмена / Изменить статус. Обязательность комментария при возврате в макете не видна — по ТЗ 6.10.
• Формы «Создать ГК / ЮЛ / ГСК / ГСЗ» [51-01…51-04] и «Изменить ЮЛ» [79] — поля перечислены в пути 1 (шаги 1.2, 1.4); дополнительно сняты «Изменить ГСК» [77-02], «Перевести ЮЛ в другую ГК» [79-01], «Вывести ЮЛ из состава ГК» [80].
• Правая часть ЕХ [83-01]: список консолидаций узла; в раскрытой — «Сформированная отчетность» (КФО .xlsx, Шахматка .xlsx, Консолидированная отчётность .pdf с колонками Сформирован / Ответственный / Утвердил / Верифицировал) и «Первичные документы» по организациям с действиями «просмотр» и «скачать». Кнопки «Связать» нет.
• Проверка распознавания для ОСВ (xlsx) — в макете отсутствует: строки ОСВ в панели документов помечены doc-row--readonly, клик не открывает экран (только PDF — doc-row--previewable). Режим «Редактировать» для PDF снят [41-02]: кнопки Сохранить / Отменить, значения правятся в таблице. Блок логических ошибок в макете не найден.

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

• Экран проверки для ОСВ (таблица строк с деревом, подсветка нераспознанных контрагентов) — макета нет, делать по ТЗ (DOC-221273) и §1 правил; решение UI — в Срезе 2.
• Блок «Логические ошибки» на экране проверки ББ/ОФР (ТЗ 6.3, §7 правил) — макета нет, делать по ТЗ в Срезе 3.
• Обязательность комментария при возврате на доработку в модалке «Изменить статус» и перечень допустимых «Новых этапов» по роли — макет показывает только следующий этап.