diff --git a/openspec/changes/consolidations-ui/.openspec.yaml b/openspec/changes/archive/2026-10-23-consolidations-ui/.openspec.yaml similarity index 100% rename from openspec/changes/consolidations-ui/.openspec.yaml rename to openspec/changes/archive/2026-10-23-consolidations-ui/.openspec.yaml diff --git a/openspec/changes/consolidations-ui/design.md b/openspec/changes/archive/2026-10-23-consolidations-ui/design.md similarity index 100% rename from openspec/changes/consolidations-ui/design.md rename to openspec/changes/archive/2026-10-23-consolidations-ui/design.md diff --git a/openspec/changes/consolidations-ui/proposal.md b/openspec/changes/archive/2026-10-23-consolidations-ui/proposal.md similarity index 100% rename from openspec/changes/consolidations-ui/proposal.md rename to openspec/changes/archive/2026-10-23-consolidations-ui/proposal.md diff --git a/openspec/changes/consolidations-ui/specs/consolidated-osv-ui/spec.md b/openspec/changes/archive/2026-10-23-consolidations-ui/specs/consolidated-osv-ui/spec.md similarity index 100% rename from openspec/changes/consolidations-ui/specs/consolidated-osv-ui/spec.md rename to openspec/changes/archive/2026-10-23-consolidations-ui/specs/consolidated-osv-ui/spec.md diff --git a/openspec/changes/consolidations-ui/specs/consolidations-ui/spec.md b/openspec/changes/archive/2026-10-23-consolidations-ui/specs/consolidations-ui/spec.md similarity index 100% rename from openspec/changes/consolidations-ui/specs/consolidations-ui/spec.md rename to openspec/changes/archive/2026-10-23-consolidations-ui/specs/consolidations-ui/spec.md diff --git a/openspec/changes/consolidations-ui/tasks.md b/openspec/changes/archive/2026-10-23-consolidations-ui/tasks.md similarity index 100% rename from openspec/changes/consolidations-ui/tasks.md rename to openspec/changes/archive/2026-10-23-consolidations-ui/tasks.md diff --git a/openspec/specs/consolidated-osv-ui/spec.md b/openspec/specs/consolidated-osv-ui/spec.md index 5a89ee6..38ba723 100644 --- a/openspec/specs/consolidated-osv-ui/spec.md +++ b/openspec/specs/consolidated-osv-ui/spec.md @@ -79,3 +79,28 @@ #### Scenario: Экспорт с фильтром - **WHEN** аналитик скачивает свод с фильтром по ЮЛ - **THEN** сохраняется xlsx, а ошибка сервера показывается текстом, а не скачивается + +### Requirement: Единицы и знаки после запятой +Над таблицей сводной ОСВ [30] SHALL быть два выпадающих списка: «Единицы» — «руб.», «тыс. руб.», «млн руб.», «млрд руб.» +(по умолчанию «руб.»: суммы API — в рублях) и «Знаков после запятой» — 0, 1, 2, 3 (по умолчанию 2). Выбор SHALL менять +только показ сумм шести денежных колонок (сальдо на начало, обороты, сальдо на конец, Дт/Кт); запрос, фильтры и экспорт в +xlsx не меняются. Пересчёт SHALL выполняться над строкой суммы из API без арифметики с плавающей точкой: запятая +сдвигается на 3/6/9 разрядов, округление до выбранного числа знаков — половина от нуля, разряды разделяются пробелом, +дробная часть — через запятую. Нулевая сумма SHALL показываться «—» при любых единицах; ненулевая сумма, округлившаяся до +нуля, — нулём с выбранным числом знаков, без знака «минус». + +#### Scenario: Тысячи рублей +- **WHEN** выбраны «тыс. руб.» и 3 знака, сумма строки — `24000.00` +- **THEN** в ячейке «24,000» + +#### Scenario: Округление без потери разрядов +- **WHEN** выбраны «тыс. руб.» и 2 знака, сумма — `4454151.93` +- **THEN** в ячейке «4 454,15» + +#### Scenario: Ноль +- **WHEN** сумма ячейки — `0.00`, выбраны любые единицы и число знаков +- **THEN** в ячейке «—» + +#### Scenario: Малая сумма в крупных единицах +- **WHEN** выбраны «млн руб.» и 2 знака, сумма — `-0.40` +- **THEN** в ячейке «0,00» diff --git a/openspec/specs/consolidations-ui/spec.md b/openspec/specs/consolidations-ui/spec.md new file mode 100644 index 0000000..40a3561 --- /dev/null +++ b/openspec/specs/consolidations-ui/spec.md @@ -0,0 +1,259 @@ +# consolidations-ui Specification + +## Purpose +Аналитик работает со списком консолидаций ГК [34] (флажок «Только в работе», «Версия», меню «⋯»), берёт версию в работу или перехватывает её [35], создаёт консолидацию [42] и меняет статус версии из шапки страницы отчёта [30], [33-01]; при уходе со «Сводной ОСВ» с несопоставленными строками — предупреждение [31-00]. + +## Requirements + +### Requirement: Список консолидаций ГК +Экран консолидаций ГК [34] SHALL показывать версии из `GET /company-groups/{id}/consolidations` таблицей с колонками +Год, Квартал (К1–К4), Версия, Статус (бейдж, подписи — «Подписи статусов версии»), ГСК, Дата создания, Дата верификации, +Организаций (`members_count`) и колонкой действий: «Взять в работу» (или «В работе»), «К отчётности», меню «⋯». Версии +одного периода SHALL показываться деревом: верхняя строка — первая версия периода из ответа API (по убыванию +`version_no`), остальные — раскрываемыми строками под ней. Колонка «ГСК» SHALL иметь фильтр в заголовке, «Дата создания» — +без фильтра. Пока API не отдаёт ГСК консолидации и дату верификации, колонки «ГСК» и «Дата верификации» SHALL показывать +«—». Рядом с заголовком «Консолидации» — число строк («N шт.»). Клик по строке SHALL выбирать версию для панели +«Организации» и подсвечивать строку. + +#### Scenario: Колонки списка +- **WHEN** открыт список консолидаций ГК «Русский бисквит» +- **THEN** у таблицы колонки Год, Квартал, Версия, Статус, ГСК, Дата создания, Дата верификации, Организаций и колонка + действий; у «ГСК» есть фильтр, у «Дата создания» — нет; в «ГСК» и «Дата верификации» — «—» + +#### Scenario: Выбор версии +- **WHEN** аналитик кликает по строке версии 2024 К3 +- **THEN** строка подсвечена, панель «Организации» показывает состав этой версии + +### Requirement: Колонка «Версия» +Колонка «Версия» SHALL быть пустой у версии с `version_no = 1` и показывать номер у версий с `version_no ≥ 2`. + +#### Scenario: Единственная версия периода +- **WHEN** у консолидации 2025 К1 одна версия (`version_no = 1`) +- **THEN** ячейка «Версия» пустая + +#### Scenario: Вторая версия периода +- **WHEN** у консолидации 2024 К1 версии 2 и 1 +- **THEN** у строки версии 2 в колонке «Версия» — «2», у строки версии 1 — пусто + +### Requirement: Фильтр «Только в работе» +Над таблицей SHALL быть флажок «Только в работе», по умолчанию **выключенный**. Включённый флажок SHALL перечитывать список +запросом `GET /company-groups/{id}/consolidations?in_work_only=true` (отбор делает сервер: остаются версии со статусом не +из `VERIFIED`, `CANCELLED`, `ARCHIVED`, `REJECTED`); выключенный — запросом с `in_work_only=false` (или без параметра). +Фронт MUST NOT фильтровать версии по статусу сам. + +#### Scenario: Открытие экрана +- **WHEN** аналитик впервые открывает список консолидаций ГК +- **THEN** флажок «Только в работе» снят, запрос — с `in_work_only=false`, в таблице есть верифицированные и отменённые + версии + +#### Scenario: Включение фильтра +- **WHEN** аналитик отмечает «Только в работе» +- **THEN** список перечитан с `in_work_only=true`, отменённой версии в таблице нет + +### Requirement: Взять в работу +Кнопка «Взять в работу» в строке SHALL открывать модалку «Взять консолидацию в работу?» [35]. Состояние блокировки +модалка SHALL брать из свежей карточки `GET /consolidations/versions/{id}` (`lock`): +- блокировки нет — текст «Консолидация <год> К · <ГК> будет закреплена за вами для редактирования.», кнопки + «Отмена» / «Взять в работу»; «Взять в работу» отправляет `POST /consolidations/versions/{id}/lock` без + `takeover_reason`; +- версию держит другой пользователь — текст «Консолидация взята в работу <ФИО>. Укажите причину замены.» и поле причины + (обязательно, ≤ 1000 символов, строка из пробелов считается пустой); «Взять в работу» неактивна, пока причина пуста, и + отправляет `POST …/lock {takeover_reason}` (перехват). + +После 200/201 модалка SHALL закрыться с сообщением «Консолидация взята в работу.» и перечитать список. Ответ 409 +`LOCKED_BY_OTHER` на запрос без причины (версию успели взять) SHALL переводить модалку в режим перехвата с предупреждением +«<ФИО> только что взял(-а) консолидацию в работу.» и пустым полем причины. Ответ 409 `VERSION_NOT_EDITABLE` SHALL +закрывать модалку с сообщением «Нельзя взять в работу отменённую версию.». Прочие ошибки (403 без права +`CONSOLIDATION_EDIT`, иные 409/422) SHALL показываться текстом сервера (`ApiError.message`), модалка остаётся открытой. ФИО +в тексте модалки не получает вторую точку («Соколов А. В. Укажите причину замены.»). У версии со статусом `CANCELLED` кнопка +«Взять в работу» SHALL быть неактивной (условие — по коду статуса, а не по подписи); у версии, которую держит текущий +пользователь, вместо неё SHALL показываться неактивная кнопка «В работе». + +#### Scenario: Свободная версия +- **WHEN** аналитик нажимает «Взять в работу» у версии без блокировки и подтверждает +- **THEN** отправлен `POST …/lock` без тела причины, модалка закрыта, в строке — неактивная «В работе» + +#### Scenario: Перехват с причиной +- **WHEN** версию держит «Соколов А. В.», аналитик нажимает «Взять в работу» +- **THEN** модалка показывает «Консолидация взята в работу Соколов А. В. Укажите причину замены.» и поле причины; + «Взять в работу» неактивна, пока причина пуста; после ввода «Отпуск» отправлен `POST …/lock {takeover_reason: "Отпуск"}` + +#### Scenario: Версию взяли, пока модалка открыта +- **WHEN** в модалке свободной версии аналитик нажимает «Взять в работу», а сервер отвечает 409 `LOCKED_BY_OTHER` +- **THEN** модалка остаётся открытой в режиме перехвата с предупреждением «<ФИО> только что взял(-а) консолидацию в + работу.» и пустым полем причины + +#### Scenario: Отменённая версия +- **WHEN** версия в статусе «Отменена» +- **THEN** «Взять в работу» в её строке неактивна + +#### Scenario: Нет права +- **WHEN** пользователь без `CONSOLIDATION_EDIT` подтверждает перехват, сервер отвечает 403 +- **THEN** показан текст ответа сервера («недостаточно прав: требуется CONSOLIDATION_EDIT»), модалка открыта + +#### Scenario: Панель «Организации» после взятия в работу +- **WHEN** в списке выбрана версия, аналитик берёт её в работу +- **THEN** список и карточка выбранной версии перечитаны, «Ответственный» в панели «Организации» — текущий владелец + блокировки + +### Requirement: Меню «⋯» строки консолидации +Меню «⋯» строки SHALL содержать пункты «Добавить версию», «Отключить подтверждение КФО», «История изменений» с иконками +[43]. Пока функции нет, пункты SHALL быть неактивными (`disabled`) с подсказкой «Будет позже»; нажатие на неактивный пункт +MUST NOT выполнять действий (ни перехода, ни всплывающего сообщения). + +#### Scenario: Неактивный пункт +- **WHEN** аналитик открывает «⋯» и нажимает «История изменений» +- **THEN** пункт неактивен, видна подсказка «Будет позже», переход в «Журнал действий» не происходит + +### Requirement: Панель «Организации» +Пока в списке не выбрана версия, панель «Организации» SHALL показывать заголовок «Организации» с подписью «Выберите +консолидацию» и текст «Выберите консолидацию выше» вместо таблицы. В колонках «ОФР» и «Бух. баланс» статус «Отсутствует» +SHALL быть нейтральным серым бейджем (как в легенде чек-листа [37]); красный — только у «Ошибка». + +#### Scenario: Версия не выбрана +- **WHEN** открыт список консолидаций, строка не выбрана +- **THEN** панель «Организации» без таблицы и без «0 шт.», в ней текст «Выберите консолидацию выше» + +#### Scenario: Документ отсутствует +- **WHEN** у ЮЛ выбранной версии нет ББ +- **THEN** в колонке «Бух. баланс» — серый бейдж «Отсутствует» + +### Requirement: Подписи статусов версии +Фронт SHALL показывать статусы версии одними подписями в списке, фильтре колонки «Статус», шапке карточки и модалке +«Изменить статус»: `INITIATED` — «Инициация», `DOCUMENTS_PROCESSING` — «Обработка документов», `DATA_CORRECTION` — +«Корректировка данных», `CONSOLIDATION_RF` — «Консолидация РФ», `VERIFICATION_RF` — «Верификация РФ», `CONSOLIDATION_GO` — +«Консолидация ГО», `VERIFICATION_GO` — «Верификация ГО», `VERIFIED` — «Верифицирован», `CANCELLED` — «Отменена», +`ADJUSTMENT` — «Корректировка», `ARCHIVED` — «В архиве», `REJECTED` — «Отклонён». + +#### Scenario: Корректировка данных +- **WHEN** версия в статусе `DATA_CORRECTION` +- **THEN** в списке и в карточке — бейдж «Корректировка данных» + +#### Scenario: Отменённая версия +- **WHEN** версия в статусе `CANCELLED` +- **THEN** в списке и в карточке — бейдж «Отменена» + +### Requirement: Вид модалки «Новая консолидация» +Модалка [42] (состав и создание — спека `consolidation-setup`) SHALL показывать поля без звёздочек обязательности и кнопку +«+ Создать» (иконка «плюс»), неактивную, пока не выбраны ГК, ГСК, год, квартал и не отмечено не меньше двух ЮЛ. В блоке +«ЮЛ консолидации» строка ЮЛ SHALL содержать флажок, наименование (длинное — с многоточием) и ИНН отдельной колонкой, +выровненной по правому краю независимо от длины наименования; над списком — поиск по наименованию, под списком — +«Выбрано: N / M». + +#### Scenario: Выравнивание ИНН +- **WHEN** в блоке «ЮЛ консолидации» есть ЮЛ «ВМГ, ООО» и «ПЕКАРНЯ СЧАСТЛИВОЧНАЯ, ООО» +- **THEN** их ИНН стоят в одной колонке на одной вертикали + +#### Scenario: Одно ЮЛ +- **WHEN** выбраны ГК, ГСК, год, квартал и отмечено одно ЮЛ +- **THEN** «+ Создать» неактивна + +### Requirement: Кнопка «Изменить статус» в карточке версии +Шапка карточки версии [30] SHALL показывать справа «Статус отчёта» (бейдж) и кнопку «Изменить статус». Кнопка SHALL быть +активной, только если версия взята в работу текущим пользователем (`lock.locked_by` карточки = `id` из `/me`) и для +текущего статуса есть хотя бы один ручной переход (требование «Модалка «Изменить статус»»). Без своей блокировки кнопка +SHALL быть неактивной с подсказкой «Возьмите консолидацию в работу»; при своей блокировке и отсутствии ручных переходов — +неактивной. + +#### Scenario: Версия не взята в работу +- **WHEN** аналитик открыл карточку версии `DATA_CORRECTION`, блокировки нет +- **THEN** «Изменить статус» неактивна, подсказка «Возьмите консолидацию в работу» + +#### Scenario: Версия у текущего пользователя +- **WHEN** аналитик взял версию `DATA_CORRECTION` в работу и открыл карточку +- **THEN** «Изменить статус» активна + +#### Scenario: Нет ручных переходов +- **WHEN** аналитик держит блокировку версии `VERIFIED` +- **THEN** «Изменить статус» неактивна + +### Requirement: Модалка «Изменить статус» +Модалка [33-01] SHALL показывать «Текущий этап» (бейдж статуса), «Новый этап» (выпадающий список) и «Комментарий» +(≤ 1000 символов), кнопки «Отмена» / «Изменить статус». Варианты «Нового этапа» SHALL совпадать с ручными переходами бэка +(`MANUAL_TRANSITIONS` в `api/src/services/consolidation_status.py`; API их не отдаёт, фронт держит зеркало в одном месте): +- `INITIATED` → `CANCELLED`; +- `DOCUMENTS_PROCESSING` → `CANCELLED`, `INITIATED`; +- `DATA_CORRECTION` → `CANCELLED`, `INITIATED`; +- из остальных статусов ручных переходов нет. + +По умолчанию в «Новом этапе» ничего не выбрано. «Изменить статус» SHALL быть активной, только когда выбран новый этап и +комментарий непуст после обрезки пробелов (комментарий обязателен для обоих переходов). Нажатие SHALL отправлять +`POST /consolidations/versions/{id}/status {to_status, comment}` (комментарий обрезан); при 200 модалка закрывается, а +карточка версии на экране заменяется карточкой из ответа: бейдж, пояснение под заголовком и состояние кнопки «Изменить +статус» берутся из неё (после «Отменена» блокировка снята — кнопка неактивна). Ответы 409 (`VERSION_NOT_EDITABLE`, +`LOCK_REQUIRED`, `LOCKED_BY_OTHER`, `TRANSITION_NOT_ALLOWED`) и 422 (`COMMENT_REQUIRED`) SHALL показываться сообщением об +ошибке, модалка остаётся открытой, статус на экране не меняется. + +#### Scenario: Варианты из «Корректировки данных» +- **WHEN** аналитик держит блокировку версии `DATA_CORRECTION` и открывает «Изменить статус» +- **THEN** «Текущий этап» — «Корректировка данных», в «Новом этапе» ничего не выбрано, варианты — «Отменена» и + «Инициация»; «Изменить статус» неактивна + +#### Scenario: Отмена версии +- **WHEN** аналитик выбирает «Отменена», пишет комментарий «Дубль» и нажимает «Изменить статус» +- **THEN** отправлен `POST /consolidations/versions/{id}/status {to_status: "CANCELLED", comment: "Дубль"}`; модалка + закрыта; бейдж — «Отменена», «Изменить статус» неактивна; в списке консолидаций у версии статус «Отменена» + +#### Scenario: Возврат в «Инициацию» +- **WHEN** аналитик держит блокировку версии `DOCUMENTS_PROCESSING`, выбирает «Инициация» и пишет комментарий +- **THEN** после ответа 200 бейдж — «Инициация», кнопка «Изменить статус» остаётся активной (переход в «Отменена» доступен) + +#### Scenario: Комментарий из пробелов +- **WHEN** выбран новый этап, комментарий состоит из пробелов +- **THEN** «Изменить статус» неактивна + +#### Scenario: Переход отклонён сервером +- **WHEN** пока модалка открыта, статус версии изменился, и сервер отвечает 409 `TRANSITION_NOT_ALLOWED` +- **THEN** показано сообщение об ошибке, модалка открыта, бейдж на экране прежний + +### Requirement: Пояснение статуса под заголовком карточки +Под заголовком карточки версии «<ГК> — <год> <квартал>» SHALL показываться пояснение текущего статуса, а не его +название: `CONSOLIDATION_RF` — «Автоматическая консолидация, ручные проверки и сравнение КФО клиента и банка», `VERIFIED` — +«Отчет верифицирован ГО, КА ГО внес в систему номер и дату решения УОБ» (макет [30], [33-01]); `INITIATED`, +`DOCUMENTS_PROCESSING`, `DATA_CORRECTION`, `CANCELLED` — тексты аналитика, до их получения — временные из ТЗ «Статусная +модель» (`design.md`, решение без обсуждения (б)): `INITIATED` — «Система зафиксировала состав ГСК на отчетную дату и +инициатора (КА РФ или КА ГО)», `DOCUMENTS_PROCESSING` — «КА загружает документы; система отправляет pdf файлы в ИС +Сканирование, производит парсинг ОСВ, бухгалтерского баланса и ОФР», `DATA_CORRECTION` — «Выявлены некорректные данные в +ИС Сканирование, проводится ручная корректировка. Пользователь валидирует распарсенные данные и вносит правки», +`CANCELLED` — «Заявка на формирование/подтверждение КФО аннулирована по инициативе пользователя». Тексты держатся в одном +месте рядом с подписями статусов. + +#### Scenario: Пояснение «Корректировки данных» +- **WHEN** открыта карточка версии `DATA_CORRECTION` +- **THEN** под заголовком — пояснение статуса, а не слова «Корректировка данных» + +#### Scenario: Пояснение после смены статуса +- **WHEN** версия переведена в «Отменена» из модалки «Изменить статус» +- **THEN** пояснение под заголовком сменилось на пояснение статуса `CANCELLED` без перезагрузки страницы + +### Requirement: Предупреждение «Остались неуказанные ИНН» +При уходе со вкладки «ОСВ» на другую вкладку отчёта версии, если в сводке `unmapped_total > 0`, фронт SHALL показывать +модалку [31-00] «Остались неуказанные ИНН»: «В ОСВ остались неуказанные ИНН», «Не заполнено ИНН: N. Точно хотите перейти +в другой раздел?», кнопки «Остаться» / «Перейти». «Остаться» SHALL закрывать модалку без перехода, «Перейти» — выполнять +переход. При `unmapped_total = 0` переход SHALL выполняться без модалки. Пока шагов после ОСВ нет, их вкладки +неактивны («Будет в следующих срезах») и модалка не вызывается; вкладка становится активной, когда для неё задан переход +(первой — «Шахматка»). + +#### Scenario: Есть несопоставленные строки +- **WHEN** в сводке `unmapped_total = 2` и аналитик выбирает другую вкладку отчёта +- **THEN** показана модалка «Не заполнено ИНН: 2. Точно хотите перейти в другой раздел?»; «Остаться» оставляет вкладку + «ОСВ», «Перейти» открывает выбранную вкладку + +#### Scenario: Все строки сопоставлены +- **WHEN** `unmapped_total = 0` и аналитик выбирает другую вкладку отчёта +- **THEN** вкладка открывается без модалки + +### Requirement: Предупреждение о несохранённых правках в модалках консолидаций +Пока открыта модалка с начатым вводом, браузер SHALL спрашивать подтверждение при закрытии или перезагрузке вкладки +(стандартный диалог `beforeunload`, текст задаёт браузер): «Взять консолидацию в работу?» — введена причина перехвата +(непустая после обрезки пробелов); «Изменить статус» — выбран новый этап или введён комментарий; «Новая консолидация» — +выбрано хотя бы одно из полей ГК, ГСК, год, квартал. После закрытия модалки (отправка или «Отмена») предупреждения нет. +Переход по меню приложения при открытой модалке закрыт её маской. + +#### Scenario: Причина перехвата введена +- **WHEN** в модалке перехвата введена причина «Отпуск» и аналитик перезагружает вкладку +- **THEN** браузер показывает диалог подтверждения ухода + +#### Scenario: Ничего не введено +- **WHEN** модалка «Изменить статус» открыта, этап не выбран, комментарий пуст, аналитик закрывает вкладку +- **THEN** вкладка закрывается без диалога