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

> Статус: **каркас**. Разделы с пометкой `[макет]` заполняются по HTML-макету — вручную или агентом по
> `scripts/mockup_index.py` + чтению одного экрана за раз. Разделы без пометки собраны из ТЗ (DOC-221273, DOC-037734,
> DOC-036960, DOC-221280) и DBML (блоки «Макет:»). Для каждого экрана: кто, что видит, что делает, что меняется в БД.

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

```
Вход (JWT РАИСА)
 └─ Главное меню
     ├─ Справочники ──────────── Группы компаний и организации ─┬─ Карточка ГК (ЮЛ | ГСК | ГСЗ | История | Архив)
     │                                                           ├─ Карточка ЮЛ (алиасы, членство, перевод, закрытие)
     │                                                           └─ Импорт из файла
     ├─ Отчётность ───────────── Список консолидаций ───────────── Карточка консолидации
     │                                                               ├─ Организации (периметр)  → Первичные документы (панель)
     │                                                               │       ├─ Загрузка документов (окно)
     │                                                               │       ├─ Чек-лист (модалка, CSV)
     │                                                               │       └─ Проверка распознавания (экран)
     │                                                               ├─ Сводная ОСВ (ручное сопоставление контрагента)
     │                                                               ├─ Сопоставление ВГО / Шахматка
     │                                                               ├─ Таблица корректировок (ББ | ОФР)
     │                                                               ├─ Гудвилл
     │                                                               ├─ КФО (сводка расхождений, экспорт)
     │                                                               ├─ Подтверждение КФО клиента (сценарий CONFIRM)
     │                                                               └─ Смена статуса / история / взять в работу
     ├─ Единое хранилище ─────── Дерево ГК → ГСК → организации → срезы по датам → просмотр / скачать / выгрузка
     ├─ Журнал действий
     └─ Администрирование ───── Пользователи | Роли и права (матрица) | Справочники (план счетов, правила)
```

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

| Шаг | Экран | Действие | БД |
|---|---|---|---|
| 1.1 | Справочники → ГК | Импорт из файла (ИНН, наименование, тип, базовый РФ, ID ГК) | `legal_entity`, `company_group`, `audit_event(DIRECTORY_IMPORT)` |
| 1.2 | Карточка ГК | Создать ГК вручную (CRM ID может быть пуст), закрепить за РФ | `company_group`, `company_group_history` |
| 1.3 | Карточка ГК → ГСК | Создать ГСК, добавить ЮЛ в состав | `related_group(kind=gsk)`, `related_group_member` |
| 1.4 | Карточка ЮЛ | Алиасы, перевод в другую ГК (дата), закрытие | `legal_entity_alias`, `legal_entity_history(event_type)` |
| 1.5 | Администрирование → Роли | Назначить роли, править матрицу прав | `user_role`, `role_permission`, `audit_event(ROLE_PERMISSION_CHANGE)` |

`[макет]` уточнить: фильтр «Базовый РФ», счётчик организаций, вкладка «Архив», форма перевода ЮЛ («Дата перевода ??»).

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

| Шаг | Экран | Действие | БД / статус |
|---|---|---|---|
| 2.1 | Список консолидаций | «Создать консолидацию»: ГК → ГСК → период → сценарий (CREATE/CONFIRM) → подход (BASIC/EXTENDED) → гудвилл | `consolidation`, `consolidation_version(INITIATED)`, `consolidation_member` |
| 2.2 | Карточка → Организации | Клик по организации → панель «Первичные документы» | — |
| 2.3 | Панель → «Загрузить документы» | drag-n-drop, тип документа в списке (Баланс/ОФР/ОСВ/Расшифровка/Прочее) | `stored_file(UPLOADED)`, `s3_object`, `recognition_job(queued)` → `DOCUMENTS_PROCESSING` |
| 2.4 | Панель (список) | Период, «Соответствует/Не соответствует», статус; удалить/заменить | `document.period_check`, `stored_file.status`, `SUPERSEDED` |
| 2.5 | Чек-лист | Матрица организация × документ со статусами; скачать CSV | `required_document_rule × member − document` |
| 2.6 | Проверка распознавания | Исходник слева, результат справа; логические ошибки; Редактировать → Сохранить; Подтвердить данные; переход к следующему документу | `financial_statement_value.is_modified`, `osv_entry.is_modified`, `document(CONFIRMED)`, `audit_event(RECOGNIZED_DATA_EDIT, DOCUMENT_CONFIRM)` → `DATA_CORRECTION` |

`[макет]` уточнить: как выглядит проверка для ОСВ (дерево строк? подсветка несопоставленных контрагентов?), кнопка
«Подтвердить данные» на документ или на файл, индикатор «исправлено полей».

## Путь 3. КА РФ консолидирует

| Шаг | Экран | Действие | БД / статус |
|---|---|---|---|
| 3.1 | Карточка | «Консолидировать» (доступно, когда чек-лист закрыт) | → `CONSOLIDATION_RF`; вычисления, ничего не пишется |
| 3.2 | Сводная ОСВ | Фильтры (компания, счёт, тип контрагента); строка без сопоставления → поиск ЮЛ → выбрать → алиас | `osv_entry.counterparty_id`, `legal_entity_alias`, `audit_event(OSV_COUNTERPARTY_MAP)` |
| 3.3 | Сопоставление ВГО | Авто-пары, спорные внизу; выбрать набор счетов | вычисляется |
| 3.4 | Шахматка | Матрица компаний, ячейки > 5 % подсвечены, комментарии к ячейке | `comment(chess_cell)` |
| 3.5 | Корректировки ББ / ОФР | Строка на пару: Дт строка/сумма, Кт строка/сумма, дочерние распределения, комментарий; импорт/экспорт xlsx | `correction`, `audit_event(CORRECTION_*)`; при расхождении ≥ 5 % → `ADJUSTMENT` |
| 3.6 | Гудвилл | Доля владения, включить в КФО, комментарий | `goodwill` |
| 3.7 | КФО | Колонки по компаниям (значение / в т. ч. ВГО / очищенные / доля), Итого, расхождения, пороги, обоснование; экспорт | `kfo_result`, `kfo_result_line(_company)` |
| 3.8 | Подтверждение КФО клиента (CONFIRM) | Ввод версии клиента и ВГО клиента, расхождение, причина | `client_kfo_line` |
| 3.9 | Смена статуса | «Отправить на верификацию» | → `VERIFICATION_RF`, `consolidation_status_history` |

`[макет]` уточнить: где живёт «взять в работу / перехват» (ANL-036), «Отклонено» как статус или событие (ANL-035),
«есть несохранённые изменения в КФО».

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

| Шаг | Роль | Экран | Действие | Статус |
|---|---|---|---|---|
| 4.1 | РКА РФ | Карточка (режим проверки) | Подтвердить → ГО / Вернуть с комментарием | `CONSOLIDATION_GO` / `CONSOLIDATION_RF` |
| 4.2 | КА ГО | Карточка | Проверка, ручные проверки, сравнение с клиентом; Вернуть / Верифицировать: № и дата решения УОБ | `VERIFIED` (или `VERIFICATION_GO` → РКА ГО) |
| 4.3 | система | — | Срез в ЕХ, версия read-only, файлы — в архивное хранилище | `ex_snapshot(_member,_item)` |
| 4.4 | КА | Карточка | «Новая версия» после VERIFIED | `consolidation_version.previous_version_id` |

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

| Кто | Экран | Что делает |
|---|---|---|
| КМ, Эксперт | Список консолидаций, карточка (read-only) | смотрят статус и КФО по своим/всем ГК |
| КА, РКА | Единое хранилище | дерево ГК → ГСК → дата → срез: просмотр КФО/сводной ОСВ/шахматки из payload, скачать первичку, выгрузка xlsx с выбором колонок |
| Администратор | Журнал действий | фильтры: раздел, объект, событие, поле, пользователь, период; IP/браузер для входов |

`[макет]` уточнить: состав дерева ЕХ, «Связать документ с организацией», какие выгрузки есть в ЛК ЕХ.

## Что заполнить по макету (чек-лист)

- [ ] Для каждого экрана из `docs/mockup/INDEX.md` — строка в таблицах выше или пометка «вне scope»
- [ ] Названия кнопок и статусов — как в макете (они пойдут в i18n-словарь фронта)
- [ ] Сквозные элементы: хлебные крошки, фильтры списков, экспорт, комментарии, «несохранённые изменения»
- [ ] Расхождения макета с ТЗ/DBML → `07-open-questions.md` с номером ANL