Andrey Epifancev 397a1a7aef fix(counter-pairs): правки финального ревью (I-1, I-2, I-3, M-1, M-2, M-3, M-5)

Подпись пары без служебных слов, тест пары на фикстурах РБ, модалка при уходе с «ОСВ» на любую вкладку,
без «Экспорт» в режиме пар, README и ARCHITECTURE, таблица решений design.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-27 19:22:25 +04:00

4.8 KiB

Raw Blame History

Архитектура фронта arm-core/web

SPA поверх API arm-core (/api/v1). Своих данных и бизнес-вычислений нет: всё производное (чек-лист, сводная ОСВ, статусы) считает сервер, фронт показывает и отправляет действия пользователя. До 21.10.2026 фронт вёлся в отдельном репозитории RSHB/arm-web и переносился сюда синхронизацией; теперь — только здесь.

Модули

Модуль	Ответственность	Зависит от
`src/api/`	HTTP-клиент, токен, разбор ошибок	`conf/`, `auth/token`
`src/auth/`	профиль `/me`, dev-вход, права для меню	`api/`
`src/services/api/`	вызовы ресурсов arm-core	`api/`, `types/`
`src/store/`	состояние экранов (Redux Toolkit)	`services/api/`
`src/utils/`	чистые функции: деньги, подписи, скачивание, правила консолидаций	`types/`
`src/hooks/`	общие React-хуки (виртуальный список, предупреждение `beforeunload`)	React
`src/types/`	DTO API (повторяют `../api/src/schemas/`)	—
`src/components/`	примитивы UI (таблица, теги, заголовок)	antd
`src/widgets/`	блоки экранов (`DocumentReview` — проверка документа со сканом, `ConsolidatedOsv` — сводная ОСВ, `FilesDrawer`; консолидации — см. ниже)	`components/`, `store/`, `services/api/`, `utils/`
`src/layouts/`	страницы-маршруты	`widgets/`

Виджеты экранов консолидаций

Требования — ../openspec/changes/consolidations-ui/ (после архивации — ../openspec/specs/consolidations-ui/), consolidation-setup, consolidated-osv-ui.

Виджет	Экран	Что делает
`ConsoleTable/ConsoleTable.tsx`	[34]	список консолидаций ГК: дерево версий, «Только в работе» (`in_work_only`), действия строки, меню «⋯»
`ConsoleTable/LockModal.tsx`	[35]	«Взять в работу» (`POST …/lock`) и перехват с причиной (`takeover_reason`)
`../utils/consolidations.ts`	—	правила без React: подписи и пояснения статусов версии, ручные переходы (`MANUAL_TRANSITIONS` — зеркало бэка), своя блокировка, «Версия», `in_work_only`, причина ≤ 1000
`ConsoleTable/consts.ts`	—	цвета бейджей статусов версии
`ConsolidatedOsv/OsvTabs.tsx`	[30]	вкладки шагов отчёта и модалка «Проверьте встречные записи участников» при уходе с «ОСВ» (список пар — `counter_pairs` сводки)
`ConsolidatedOsv/CounterPairsView.tsx`	[30]	режим «Встречные записи» вкладки «ОСВ»: пары, строки держателя, строки Б без ИНН с «Указать»
`ConsolidatedOsv/counterPairs.ts`	—	правила без React: подпись пары, параметры адреса режима (`?view=pairs&holder=&missing=`)
`ConsolidatedOsv/useNumberDisplay.tsx`	[30]	«Единицы» и «Знаков после запятой» сводной ОСВ (`formatScaledAmount` из `utils/money.ts`)
`../hooks/useBeforeUnload.ts`	—	предупреждение браузера о несохранённых правках в открытой модалке
`ConsoleLegalEntities/`	[34]	панель «Организации» выбранной версии и чек-лист
`NewConsoleModal/` (`CompanyOptionRow.tsx`)	[42]	«Новая консолидация»; строка ЮЛ с ИНН отдельной колонкой
`StatusChangeModal/ChangeStatusModal.tsx`	[33-01]	«Изменить статус» (`POST …/status`); открывается из шапки `layouts/ConsolidationReportPage.tsx`

Границы

Сетевые запросы — только через src/api/client.ts; fetch напрямую не вызывается.
components/ не знают про store и API; types/ ни от чего не зависят.
utils/ не импортирует React, store и API.

Сборка

npm run build → web/dist, Dockerfile ядра кладёт его в api/web/ и FastAPI отдаёт SPA (../README.md).

4.8 KiB Raw Blame History Unescape Escape