docs: update system documentation references
This commit is contained in:
@@ -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).
|
||||
|
||||
## Примеры
|
||||
|
||||
|
||||
@@ -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,7 +2,8 @@
|
||||
|
||||
## Выбор проверки
|
||||
|
||||
Читай при изменении тестов или behavior с [testing risk](../../../docs/development/engineering-governance.md#risk-based-testing).
|
||||
Читай при изменении тестов, доступа, денежных расчётов, восстановления
|
||||
интерфейса или исправлении подтверждённой регрессии.
|
||||
Выбирай boundary по наблюдаемому исходу, а не внутреннему helper/component state.
|
||||
|
||||
| Изменение | Дешёвая надёжная проверка |
|
||||
|
||||
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user