docs: describe local frontend packages and ownership

OpenSpec change: evolve-frontend-stack
2026-09-22 22:11:04 +03:00
parent 15d1d820f5
commit 55610ea2b4
2 changed files with 44 additions and 2 deletions
@@ -86,6 +86,20 @@ Frontend организован слоями `app → pages → features → ent
 где локальная аутентификация отделена от подключения брокера и инвестиционных
 сценариев. Это внутренняя организация приложений, не набор микросервисов.

+Маршруты и AppShell принадлежат `app`. Page controller/VM управляет запросами,
+формой и восстановлением; presentation получает данные и callbacks, поля
+могут использовать контекст React Hook Form. В OperationForm controller
+сохраняет intent операции, черновик и явное принятие актуальной версии после
+конфликта. В account-income чистые преобразования периода принадлежат модели
+страницы и не связывают форму с её запросами.
+
+Локальные packages tokens/ui/icons образуют [визуальную основу](../design/overview.md#общая-основа-и-каталог)
+внутри frontend и входят в сборку SPA. Это библиотеки, а не дополнительные
+runtime-контейнеры. Провайдеры темы принадлежат приложению и Storybook;
+предметные компоненты и API-клиент остаются в приложении. Отдельный API-пакет
+и registry-поставка визуальных пакетов не реализованы. Существующие Docker
+images приложения не означают независимого npm-выпуска этих библиотек.
+
 Финансовые HTTP-запросы браузера идут через backend. Пользователь вводит token
 T-Bank в форме и отправляет его для сохранения, но API не возвращает token
 в ответах; SPA не использует его для прямых брокерских запросов. Прямая