100 lines
11 KiB
Markdown
100 lines
11 KiB
Markdown
# 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
|