From 0b8fbeca6fac967fa64c58b3d95b1e07a7638cf6 Mon Sep 17 00:00:00 2001 From: Andrey Epifancev Date: Wed, 21 Oct 2026 09:58:55 +0400 Subject: [PATCH] =?UTF-8?q?docs(openspec):=20UI-=D0=BF=D0=BE=D0=BB=D0=BE?= =?UTF-8?q?=D0=B2=D0=B8=D0=BD=D1=8B=20=D0=B0=D1=80=D1=85=D0=B8=D0=B2=D0=BE?= =?UTF-8?q?=D0=B2=20statement-template-lines=20=D0=B8=20console-files=20?= =?UTF-8?q?=D0=B8=D0=B7=20arm-web=20(=D1=81=D1=83=D1=84=D1=84=D0=B8=D0=BA?= =?UTF-8?q?=D1=81=20-web);=20issue=20arm-web=20=E2=86=92=20#150=E2=80=93#1?= =?UTF-8?q?57=20(#148)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- .../.openspec.yaml | 2 + .../design.md | 20 ++++++ .../proposal.md | 18 ++++++ .../specs/document-review-ui/spec.md | 31 +++++++++ .../.openspec.yaml | 2 + .../2026-10-10-console-files-web/design.md | 63 +++++++++++++++++++ .../2026-10-10-console-files-web/proposal.md | 51 +++++++++++++++ .../specs/primary-files-ui/spec.md | 62 ++++++++++++++++++ web/CLAUDE.md | 5 +- 9 files changed, 252 insertions(+), 2 deletions(-) create mode 100644 openspec/changes/archive/2026-10-09-statement-template-lines-web/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-09-statement-template-lines-web/design.md create mode 100644 openspec/changes/archive/2026-10-09-statement-template-lines-web/proposal.md create mode 100644 openspec/changes/archive/2026-10-09-statement-template-lines-web/specs/document-review-ui/spec.md create mode 100644 openspec/changes/archive/2026-10-10-console-files-web/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-10-console-files-web/design.md create mode 100644 openspec/changes/archive/2026-10-10-console-files-web/proposal.md create mode 100644 openspec/changes/archive/2026-10-10-console-files-web/specs/primary-files-ui/spec.md diff --git a/openspec/changes/archive/2026-10-09-statement-template-lines-web/.openspec.yaml b/openspec/changes/archive/2026-10-09-statement-template-lines-web/.openspec.yaml new file mode 100644 index 0000000..8126432 --- /dev/null +++ b/openspec/changes/archive/2026-10-09-statement-template-lines-web/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-10-09 diff --git a/openspec/changes/archive/2026-10-09-statement-template-lines-web/design.md b/openspec/changes/archive/2026-10-09-statement-template-lines-web/design.md new file mode 100644 index 0000000..337879e --- /dev/null +++ b/openspec/changes/archive/2026-10-09-statement-template-lines-web/design.md @@ -0,0 +1,20 @@ +## Context + +Решения D-6 и R-7 взяты из design.md arm-core (change `statement-template-lines`, RSHB/arm-core#80). + +### D-6. Фронт (arm-web, PR в `test`) +`statementGrid`: ключ строки — `line.id ?? "code-" + line_code` (R-10), ключ ячейки — `rowKey:column_id`; `draftToPatch` +отправляет `line_id` или `line_code` по ключу. Достроенная пустая ячейка (`id = null`) без подсветки «требует проверки» +(`is_recognized = null`), введённое значение подсвечивается как правка. `formLayout` уже раскладывает строки по разделам — +меняется только то, что разделы теперь всегда полные. **Строки «БАЛАНС» (1600 по активу, 1700 по пассиву) выделяются +цветом** (просьба владельца 09.10.2026): фон всей строки — светло-фиолетовый (`#f9f0ff`, purple-1 палитры antd): серый +`#f2f4f7` уже у заголовков разделов, светло-синий `#e6f4ff` — «исправлено», оранжевый `#fff7e6` — «требует проверки»; +шрифт 700 у наименования, кода и сумм. Подсветка ячейки «требует проверки» / «правлено» перекрывает фон строки — сигнал о +данных важнее оформления. Признак — `formLayout` (`LayoutRow.grand: true` для 1600/1700 у `BALANCE`), цвет — `StatementTable`. + +## Decisions made without discussion + +| № | Дата | Решение | Обоснование | Что стоит ошибка | +|---|---|---|---|---| +| R-7 | 09.10.2026 | Цвет строк «БАЛАНС» — светло-фиолетовый `#f9f0ff` + жирный 700; подсветка ячейки перекрывает фон строки; ОФР не выделяется | Владелец просил выделить баланс по активу и пассиву, цвет не задал; в макете [41] строки «БАЛАНС» не видно; фиолетовый не занят: серый — разделы, синий — «исправлено», оранжевый — «требует проверки» | Цвет не понравится — правка одной константы | +| R-10 | 09.10.2026 | Ключ достроенной строки `code-`, а не `code:` | ':' разделяет rowKey и columnId в cellKey | Нет | diff --git a/openspec/changes/archive/2026-10-09-statement-template-lines-web/proposal.md b/openspec/changes/archive/2026-10-09-statement-template-lines-web/proposal.md new file mode 100644 index 0000000..9917ee9 --- /dev/null +++ b/openspec/changes/archive/2026-10-09-statement-template-lines-web/proposal.md @@ -0,0 +1,18 @@ +## Why + +RSHB/arm-core#80: сервер достраивает форму ББ/ОФР по справочнику редакции — строки и ячейки, которых не дало +распознавание, приходят с `id = null` (`origin = template`). Аналитик должен уметь заполнить их вручную. Кроме того, +итоговые строки «БАЛАНС» (1600 по активу, 1700 по пассиву) сливаются с обычными строками и «Итого по разделу». + +## What Changes + +- Строки и ячейки с `id = null` отображаются и редактируются как обычные. +- Правка достроенной строки уходит в `PATCH …/statement` по `line_code` (строки из БД — по `line_id`). +- Ключ строки на экране: `id`, а у достроенной — `code-<код>`. +- Строки 1600 и 1700 формы `BALANCE` выделяются фоном `#f9f0ff` и жирным шрифтом. + +## Non-goals + +- Порядок строк (раскладку по разделам делает `formLayout` как раньше). +- Правка кода и наименования строки. +- Выделение итогов ОФР. diff --git a/openspec/changes/archive/2026-10-09-statement-template-lines-web/specs/document-review-ui/spec.md b/openspec/changes/archive/2026-10-09-statement-template-lines-web/specs/document-review-ui/spec.md new file mode 100644 index 0000000..6291eaa --- /dev/null +++ b/openspec/changes/archive/2026-10-09-statement-template-lines-web/specs/document-review-ui/spec.md @@ -0,0 +1,31 @@ +## MODIFIED Requirements + +### Requirement: Форма ББ/ОФР — просмотр и правка +Экран SHALL показывать `GET /documents/{id}/statement`: шапку (ИНН, дата отчёта, единицы — значение и исходное при +правке; наименование, ОКУД/ОКПО) и таблицу «строка (код, наименование) × колонки» с суммами из `values[]`, включая +строки и ячейки, достроенные сервером по справочнику редакции (`id = null`). Ячейки с `confidence < 100` или +`is_recognized = false` SHALL подсвечиваться как «требует внимания», с `is_modified = true` — как «исправлено» с +исходным значением `original_amount` в подсказке; пустая достроенная ячейка не подсвечивается. Строки «БАЛАНС» формы +`BALANCE` (коды 1600 и 1700) SHALL выделяться фоном `#f9f0ff` и жирным шрифтом; подсветка ячейки перекрывает фон строки. +Единицы (`header.units`) SHALL выводиться над таблицей. Пока документ не `CONFIRMED`, ячейка SHALL быть редактируемой: +ввод проверяется по формату суммы (до 2 знаков после точки, знак минус допустим, пустое — `null`), сохранение +отправляет `PATCH /documents/{id}/statement {values: [...]}` суммой-строкой: ячейка строки из БД — `{line_id, +column_id, amount}`, ячейка достроенной строки (`id = null`) — `{line_code, column_id, amount}`; ответ заменяет +состояние экрана. Правка шапки (ИНН, дата отчёта, единицы) SHALL отправляться тем же `PATCH` в `header`; +`inn: null` не отправляется. + +#### Scenario: Исправление ячейки +- **WHEN** аналитик меняет значение ячейки и сохраняет +- **THEN** ячейка помечена «исправлено», проверки пересчитаны по ответу сервера, акцепт снят + +#### Scenario: Заполнение строки, которой не было в распознавании +- **WHEN** у формы нет строки 1700 из источника, аналитик вводит сумму в достроенную строку 1700 и сохраняет +- **THEN** уходит `{line_code: "1700", column_id, amount}`, по ответу строка получила `id`, ячейка помечена «исправлено» + +#### Scenario: Строки «БАЛАНС» +- **WHEN** открыта форма `BALANCE` +- **THEN** строки 1600 и 1700 выделены цветом и жирным, у ОФР выделения нет + +#### Scenario: Неверный формат суммы +- **WHEN** аналитик вводит «12,3,4» +- **THEN** запрос не отправляется, поле показывает ошибку формата diff --git a/openspec/changes/archive/2026-10-10-console-files-web/.openspec.yaml b/openspec/changes/archive/2026-10-10-console-files-web/.openspec.yaml new file mode 100644 index 0000000..8126432 --- /dev/null +++ b/openspec/changes/archive/2026-10-10-console-files-web/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-10-09 diff --git a/openspec/changes/archive/2026-10-10-console-files-web/design.md b/openspec/changes/archive/2026-10-10-console-files-web/design.md new file mode 100644 index 0000000..ecd4085 --- /dev/null +++ b/openspec/changes/archive/2026-10-10-console-files-web/design.md @@ -0,0 +1,63 @@ +## Context + +Панель [39] (`widgets/FilesDrawer/FilesDrawer.tsx`) берёт `current_legal_entity_id` и `current_version_id` из стора, +грузит `GET /legal-entities/{id}/files?limit=100` хуком `useLegalEntityFiles` (опрос раз в 5 с, пока есть +`UPLOADED`/`PROCESSING`) и загружает файлы через `uploadFiles(legalEntityId, files, versionId)` с query +`consolidation_version_id`. Список консолидаций ГК (`IConsolidation[]` с `consolidation_id`, `year`, `quarter`, +`versions[] {id, status}`) уже лежит в сторе `consolidations`. Сквозной дизайн — `../docs/openspec/changes/console-files/design.md`. + +## Decisions + +**D-1. Консолидация и статус версии — селектор, не новое поле стора.** `store/slices/consolidations/selectors.ts`: +чистая функция `findCurrentConsolidation(consolidations, versionId) -> { consolidation_id, year, quarter, version_status } +| null` (ищет версию по `id` в `versions[]`) и хук-обёртка `useCurrentConsolidation()` через `useAppSelector`. Поле +`current_consolidation_id`, упомянутое в сквозном дизайне, не вводится: оно выводится из уже хранимого и не может +рассинхронизироваться с `?version=` (R-1). + +**D-2. Один сервис, два маршрута.** `listLegalEntityFiles(legalEntityId, consolidationId: string | null)` и +`uploadFiles(legalEntityId, files, consolidationId: string | null)`: при `consolidationId` путь +`/consolidations/{cid}/legal-entities/{le}/files`, иначе `/legal-entities/{le}/files`. Обработка 422 `UploadResult` +без изменений. + +**D-3. Режим панели — локальное состояние `showAll`.** `useLegalEntityFiles(legalEntityId, consolidationId, open)`: +смена `consolidationId` сбрасывает список и перечитывает (как смена ЮЛ). В панели переключатель antd `Switch` с +подписью «Все документы организации» под кнопкой загрузки; `consolidationId = showAll ? null : current.consolidation_id`. +Если консолидация не найдена (версия не из списка) — панель работает в режиме «все» и переключатель скрыт. + +**D-4. Подпись консолидации у файла.** `widgets/FilesDrawer/consolidationLabel.ts`: +`consolidationLabel(fileConsolidationId, consolidations, currentConsolidationId) -> string | null`: `null`, если файл в +текущей консоли; «вне консолидации» при `null`; «2025 К1» (`year` + `quarterShortLabel`) по списку; «другая +консолидация», если id нет в списке. `buildDocumentRows(files, labelFor?)` добавляет результат в `subtitle` последним +элементом; `FilesList` получает `labelFor` от панели только в режиме «все». + +**D-5. Загрузка только в версии «в работе».** `IN_WORK_STATUSES = ['INITIATED', 'DOCUMENTS_PROCESSING', 'DATA_CORRECTION']` +в `selectors.ts`; кнопка «Загрузить документы» `disabled`, если `version_status` не в списке, с `Tooltip` «Загрузка +доступна только в версии в работе». Модалка получает `consolidationId` вместо `versionId`. + +**D-6. Опрос** без изменений: тот же хук, тот же интервал; перечитывается активный список. + +## Risks / Trade-offs + +- До выката arm-core#96 на стенд панель получит 404 от маршрутов консолидации — ветка вливается после ядра. +- `limit=100` остаётся: стол консоли меньше списка ЮЛ, ограничение стало мягче. + +## Decisions made without discussion + +1. 09.10.2026 — **R-1:** консолидация и статус версии выводятся селектором из `consolidations[]` + `current_version_id`, + а не хранятся отдельным полем `current_consolidation_id` (сквозной дизайн docs #90 называл поле). Цена ошибки: + низкая — если список ГК в сторе пуст (прямой переход по ссылке до загрузки списка), панель секунду работает в + режиме «все»; список грузится той же страницей. +2. 09.10.2026 — **R-2:** подпись консолидации показывается только в режиме «Все документы организации» и только у файлов + не из текущей консоли; в режиме стола подписи нет (все файлы — этой консоли или подхваченные). Цена ошибки: низкая. +3. 09.10.2026 — **R-3:** неизвестный `consolidation_id` (нет в списке ГК) подписывается «другая консолидация», а не + скрывается. Цена ошибки: нулевая. +4. 10.10.2026 — **R-4:** ручной прогон на стенде отложен до выката arm-core#96. Цена ошибки: UI-дефект всплывёт позже; + PR не вливать до прогона. +5. 10.10.2026 — **R-5:** trailer коммита 5b7b02a «Claude Haiku 5.5» вместо «Claude Fable 5.1» оставлен. Цена ошибки: + неверная атрибуция в одном коммите. +6. 10.10.2026 — **R-6:** промежуточное состояние (tsc-ошибка и versionId в UploadDocumentsModal между Task 2 и Task 3) + принято, чинится в Task 3. Цена ошибки: нулевая, закрыто в Task 3. +7. 10.10.2026 — **R-7:** `consolidation_id` в scripts/demo-prepare.sh берётся из карточки версии + `GET /consolidations/versions/$V`, а не из `POST /consolidations`. Цена ошибки: скрипт демо не запускался на живом ядре. +8. 10.10.2026 — **R-8:** после создания консолидации перечитывается список консолидаций группы (I-1). Цена ошибки: + правка выходит за Impact proposal, лишний запрос. diff --git a/openspec/changes/archive/2026-10-10-console-files-web/proposal.md b/openspec/changes/archive/2026-10-10-console-files-web/proposal.md new file mode 100644 index 0000000..8f90ce7 --- /dev/null +++ b/openspec/changes/archive/2026-10-10-console-files-web/proposal.md @@ -0,0 +1,51 @@ +## Why + +Панель «Первичные документы» [39], открытая из строки ЮЛ в карточке версии, показывает все файлы ЮЛ +(`GET /legal-entities/{id}/files`), в том числе загруженные в другие консолидации ГК. Решения владельца 09.10.2026 +(RSHB/arm-ka-docs#90, сквозной change `../docs/openspec/changes/console-files/`; ядро — RSHB/arm-core#96): файл +загружается в консолидацию (ГК + период) и образует её «рабочий стол»; ядро даёт маршруты +`POST/GET /consolidations/{cid}/legal-entities/{le}/files`, а query `consolidation_version_id` у +`POST /legal-entities/{id}/files` удаляет. Issue — RSHB/arm-web#26. + +## What Changes + +Экраны: [39] панель «Первичные документы», [40] модалка «Загрузка документов». Эндпоинты arm-core: +`GET /consolidations/{cid}/legal-entities/{le}/files` (новый), `POST /consolidations/{cid}/legal-entities/{le}/files` +(новый), `GET /legal-entities/{id}/files` (без изменений, в `FileOut` добавлено `consolidation_id`), +`POST /legal-entities/{id}/files` (без query версии). + +- Консолидация и статус открытой версии выводятся из стора (`consolidations[]` + `current_version_id`) селектором; + отдельного поля в сторе нет. +- `services/api/files.ts`: `listLegalEntityFiles(legalEntityId, consolidationId)` и + `uploadFiles(legalEntityId, files, consolidationId)` — с консолидацией маршруты `/consolidations/{cid}/…`, без неё + маршруты ЮЛ; query `consolidation_version_id` исчезает. +- Панель [39]: по умолчанию рабочий стол консолидации; переключатель «Все документы организации» переключает на список + ЮЛ; в режиме «все» у файла в подписи — его консолидация («2025 К1» по списку консолидаций ГК, «вне консолидации» при + `null`, «другая консолидация» при неизвестном id). Опрос раз в 5 с — по активному списку. +- Кнопка «Загрузить документы» недоступна, если открытая версия не «в работе» (`INITIATED`, `DOCUMENTS_PROCESSING`, + `DATA_CORRECTION`), с подсказкой. +- Типы: `FileOut.consolidation_id: string | null`. +- Спека `primary-files-ui`: три требования переписаны/добавлены. + +## Non-goals + +- Экран [60] «Монозаёмщики» и панель без контекста консолидации — не делаются (их пока нет во фронте). +- Пометка «документ не подходит версии» в панели — нет (чек-лист версии, OQ-120). +- Перенос файла между консолидациями, удаление файла из панели — нет (как и сейчас). +- Изменение экрана проверки документа [41] и сводной ОСВ — нет. +- `arm-core/web` (дубль фронта в ядре) не трогается. + +## Capabilities + +### New Capabilities + +### Modified Capabilities +- `primary-files-ui`: загрузка в консолидацию, рабочий стол и переключатель «Все документы организации», недоступная + загрузка вне версии «в работе». + +## Impact + +- `src/services/api/files.ts` (+ `files.test.ts`), `src/widgets/FilesDrawer/{FilesDrawer,FilesList,UploadDocumentsModal}.tsx`, + `src/widgets/FilesDrawer/{useLegalEntityFiles,documentRows}.ts` (+ тест), новый `src/widgets/FilesDrawer/consolidationLabel.ts` + (+ тест), новый `src/store/slices/consolidations/selectors.ts` (+ тест), `src/types/api.ts`. +- Зависимость: ядро с RSHB/arm-core#96 на стенде; до его выката панель получит 404 на маршрутах консолидации. diff --git a/openspec/changes/archive/2026-10-10-console-files-web/specs/primary-files-ui/spec.md b/openspec/changes/archive/2026-10-10-console-files-web/specs/primary-files-ui/spec.md new file mode 100644 index 0000000..32c0c0b --- /dev/null +++ b/openspec/changes/archive/2026-10-10-console-files-web/specs/primary-files-ui/spec.md @@ -0,0 +1,62 @@ +## MODIFIED Requirements + +### Requirement: Загрузка файлов ЮЛ в контексте версии +Панель «Файлы ЮЛ» [39]/[40], открытая из строки ЮЛ карточки версии, SHALL загружать выбранные файлы одним запросом +`POST /consolidations/{consolidation_id}/legal-entities/{legal_entity_id}/files` (multipart, поле `files` повторяется), +где `consolidation_id` — консолидация открытой версии (из списка консолидаций ГК в сторе по `current_version_id`), +без других полей формы и без query `consolidation_version_id`. Тип и период документа не спрашиваются. Кнопка +«Загрузить документы» SHALL быть недоступна с подсказкой «Загрузка доступна только в версии в работе», если статус +открытой версии не `INITIATED`, `DOCUMENTS_PROCESSING` или `DATA_CORRECTION`. После ответа панель SHALL показать итог: +принятые файлы (`accepted[].name`) и отклонённые с причиной (`rejected[].name` + `message`). Ответ 422 с телом +`UploadResult` SHALL трактоваться как «ни один файл не принят» с тем же показом `rejected[]`; ответ 422 с `detail` +(`ENTITY_NOT_IN_PERIMETER`), 409 (`CONSOLIDATION_NOT_EDITABLE`) и прочие ошибки — показом `message`. + +#### Scenario: Часть файлов отклонена +- **WHEN** аналитик загружает ОСВ-файл и файл, уже загруженный ранее у этого ЮЛ +- **THEN** первый показан принятым, второй — отклонённым с текстом причины `DUPLICATE_FILE` от сервера + +#### Scenario: Все файлы отклонены +- **WHEN** сервер отвечает 422 с телом `UploadResult` +- **THEN** панель показывает каждый отклонённый файл с причиной, а не общую ошибку + +#### Scenario: Загрузка идёт в консолидацию +- **WHEN** панель открыта из версии консолидации 2024 Q3 и аналитик загружает файл +- **THEN** запрос уходит на `/consolidations/{id консолидации 2024 Q3}/legal-entities/{id ЮЛ}/files` без query; после + приёма файл появляется в столе панели + +#### Scenario: Версия не в работе +- **WHEN** панель открыта из версии в статусе `CANCELLED` +- **THEN** кнопка «Загрузить документы» недоступна, при наведении — подсказка + +### Requirement: Список файлов и документов ЮЛ +Панель SHALL по умолчанию показывать рабочий стол консолидации открытой версии — +`GET /consolidations/{consolidation_id}/legal-entities/{id}/files` (новые первыми): имя, статус файла по-русски +(«Обработка» для `UPLOADED`/`PROCESSING`, «Ошибка» с причиной из `job` для `ERROR`) и вложенные `documents[]` — тип +(«ОСВ <счёт>», «Бух. баланс», «ОФР», «Расшифровка», «Прочее»), период («2024 К1», «2024 · 9 мес.», «период не +определён»), статус документа («Требуется проверка», «Загружен» для `CONFIRMED`, «Ошибка»). Документы `OSV`, `BALANCE`, +`INCOME` SHALL быть ссылками на `/documents/:document_id`. Переключатель «Все документы организации» SHALL переключать +панель на `GET /legal-entities/{id}/files`; в этом режиме у файла не из текущей консолидации в подписи SHALL стоять его +консолидация: «<год> К» по списку консолидаций ГК, «вне консолидации» при `consolidation_id = null`, «другая +консолидация», если id нет в списке. Если консолидация открытой версии не определена (версии нет в списке ГК), панель +SHALL работать в режиме «все» без переключателя. + +#### Scenario: PDF с двумя формами +- **WHEN** файл `aep_6.pdf` распознан +- **THEN** под файлом видны два документа — «Бух. баланс» и «ОФР» со статусом «Требуется проверка», каждый открывает + экран проверки + +#### Scenario: Стол и все документы +- **WHEN** у ЮЛ есть файлы, загруженные в консолидации 2024 Q3 и 2024 Q4, и файл, загруженный без контекста; панель + открыта из версии 2024 Q3 +- **THEN** по умолчанию виден только файл 2024 Q3; после переключателя «Все документы организации» видны все три, у + файла 2024 Q4 подпись «2024 К4», у файла без контекста — «вне консолидации», у файла 2024 Q3 подписи нет + +### Requirement: Опрос до окончания распознавания +Пока панель открыта и среди файлов активного списка (стол или все документы) есть `UPLOADED` или `PROCESSING`, панель +SHALL перечитывать этот список раз в 5 секунд и SHALL прекратить опрос, когда таких файлов нет или панель закрыта. +Переключение режима или смена ЮЛ SHALL сбрасывать список и перечитывать его. При закрытии панели карточка версии SHALL +перечитываться (обновить ячейки чек-листа). + +#### Scenario: Опрос останавливается +- **WHEN** все файлы активного списка перешли в `PROCESSED` или `ERROR` +- **THEN** запросы списка файлов прекращаются diff --git a/web/CLAUDE.md b/web/CLAUDE.md index 6f9f124..dc42da7 100644 --- a/web/CLAUDE.md +++ b/web/CLAUDE.md @@ -8,8 +8,9 @@ SPA кредитного аналитика АРМ КА: справочники документов, загрузка и проверка первичных файлов (ОСВ, ББ/ОФР из PDF), сводная ОСВ и шаги консолидации. Бэкенд — `../api` (`/api/v1`, единственный источник данных). С 21.10.2026 фронт ведётся здесь: задачи — worktree arm-core, ветка `feat/-`, PR в `main`. Прежний репозиторий `RSHB/arm-web` заморожен на `test` `de4e477` -(= arm-core `3157a15`), в нём остались история, открытые issue (номера вида `arm-web#7` в комментариях кода — оттуда) -и спеки экранов `openspec/specs/*-ui`. +(= arm-core `3157a15`), в нём осталась история (номера вида `arm-web#7` в комментариях кода — оттуда). Открытые issue +arm-web перенесены в arm-core #150–#157 (arm-web#7 → #151), спеки экранов и архив их изменений — в `../openspec/` +(архивы с суффиксом `-web` — UI-половины изменений, у которых бэкенд-половина лежит под тем же именем без суффикса). ## Источники истины для фронта 1. OpenAPI arm-core и гайд `../../docs/dev/frontend-api-guide.md` — эндпоинты, тела, коды ошибок. Типы в `src/types/`