126 lines
20 KiB
Markdown
126 lines
20 KiB
Markdown
# 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); режим «Редактировать» и блок логических ошибок
|