docs: update system documentation references
Frontend security / security (push) Successful in 9s
Frontend verify / verify (push) Successful in 4m14s

This commit is contained in:
2026-09-14 05:51:41 +03:00
parent 3be6e61b8f
commit dc3434c371
8 changed files with 21 additions and 15 deletions
+1 -1
View File
@@ -40,7 +40,7 @@ designTokens, color roles, CSSVariablesResolver и base styles. Внешний c
`shared/ui` содержит StateView/LoadingSkeleton. Existing route-aware AppShell также
лежит в shared/ui, но не является общим catalog primitive; его расположение не
служит основанием переносить новую domain/navigation логику в shared.
Изменяя foundation, прочитай [design system](../../../docs/development/design-system.md).
Изменяя foundation, прочитай [design system](../../../docs/design/overview.md).
## Примеры
+2 -2
View File
@@ -25,8 +25,8 @@ type User = paths["/api/v1/auth/me"]["get"]["responses"][200]["content"]["applic
Domain/UI type допустим, когда он отличается по смыслу, а не копирует transport DTO.
Generated TS вручную не исправляется. Frontend-команды не читают соседний
backend checkout и не проверяют backend runtime OpenAPI; изменение wire
shape/status/route следует
[OpenAPI contract flow](../../../docs/development/runtime-openapi-verification.md).
shape/status/route сохраняет
[границу HTTP-контракта](../../../docs/architecture/http-api.md#источник-контракта).
Одна UI-модель не требует менять API. `openapi:generate` работает offline от snapshot;
`openapi:check` генерирует во временный каталог и сравнивает, не меняя tracked files.
+2 -1
View File
@@ -2,7 +2,8 @@
## Выбор проверки
Читай при изменении тестов или behavior с [testing risk](../../../docs/development/engineering-governance.md#risk-based-testing).
Читай при изменении тестов, доступа, денежных расчётов, восстановления
интерфейса или исправлении подтверждённой регрессии.
Выбирай boundary по наблюдаемому исходу, а не внутреннему helper/component state.
| Изменение | Дешёвая надёжная проверка |
+2 -2
View File
@@ -13,7 +13,7 @@ Mantine component и общую тему. Для выпадающего выбо
Wrapper нужен для проектной ответственности, а не ради нового имени
для Button. Локальный CSS module принадлежит component; общий token вводи для
реально общей роли через [design system](../../../docs/development/design-system.md).
реально общей роли через [design system](../../../docs/design/overview.md).
| Состояние | Владелец |
| --- | --- |
@@ -154,5 +154,5 @@ incidental значения с объяснением, например пере
Type/style: `npm run typecheck`, `npm run lint`. Для risk behavior/изменения тестов
используй [Testing](frontend-testing.md). UI: keyboard, narrow viewport,
loading/error/empty/loaded и recovery по применимости. [Storybook](../../../docs/development/ui-catalog.md)
loading/error/empty/loaded и recovery по применимости. [Storybook](../../README.md#ui-каталог-storybook)
уже установлен; используй его как reference, но сверяй UI с задачей отдельно от build.