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

11 KiB Raw Blame History Unescape Escape