docs: simplify conventions layout

2026-09-15 05:58:31 +03:00
parent 718365cd5a
commit 9f7e342333
11 changed files with 93 additions and 114 deletions
@@ -74,7 +74,7 @@ Network/unknown error получает безопасное локальное
 [usePortfolio](../../src/entities/portfolio/api/usePortfolio.ts) — entity query;
 [shared client](../../src/shared/api/client.ts) — transport/auth boundary.
 Изменяя header/retry/invalidation, проверяй наблюдаемое поведение через MSW и
-[Testing](frontend-testing.md); не обращайся к реальному T-Bank.
+[Testing](testing.md); не обращайся к реальному T-Bank.
 `npm run openapi:check`, `npm run typecheck` и targeted tests проверяют разные
 части решения. Для API semantics нужны exact docs и проверки наблюдаемого
 HTTP-поведения на стороне backend.
@@ -1,55 +0,0 @@
-# Frontend architecture
-
-## Выбор владельца
-
-Сначала найди владельца поведения и ближайший пример. Расширяй existing slice,
-если ответственность остаётся связной. Размер файла или возможный будущий reuse
-не создают новую архитектурную границу.
-
-| Ответственность | Размещение |
-| --- | --- |
-| Bootstrap, глобальные providers, routes | `app` |
-| Композиция маршрута и поведение, нужное только этому экрану | `pages/<page>` |
-| Самостоятельная пользовательская возможность с собственным смыслом | `features/<capability>` |
-| Представление/поведение бизнес-сущности | `entities/<entity>` |
-| Переиспользуемый код без WealthLedger domain meaning | `shared` |
-
-Локальный FSD profile: `app → pages → features → entities → shared`, без `widgets`.
-Крупный уникальный блок остаётся в своей page. Form, mutation или click handler
-сами по себе не требуют feature. Два callers не делают domain helper generic shared.
-Slice именуется по ответственности, а не `helpers`, `hooks` или `types`.
-
-**Безопасный путь:** при сомнении оставь код у ближайшего допустимого owner.
-Извлекай его, когда появилась самостоятельная ответственность или реальный reuse.
-Не вводи новый layer и не обходи public API, чтобы устранить неудобный import.
-
-## Imports и public API
-
-Cross-slice consumer использует `@/` и `index.ts` владельца, например
-`@/entities/portfolio`. Alias Vite и TypeScript согласован. Другой slice не
-импортирует внутренний файл напрямую. Slices `pages`, `features`, `entities` не зависят от соседнего slice своего слоя;
-композиция принадлежит вышележащему owner. Existing меж-slice исключения
-не являются разрешением добавлять новые.
-
-Направление зависимостей и public imports частично проверяет
-`npm run deps`; Knip проверяет использование exports, а не смысл placement.
-
-## UI foundation
-
-Mental model, theme и data flow — в [architecture](../architecture.md).
-При изменении foundation прочитай [design system](../../../docs/design/overview.md).
-
-## Примеры
-
- Общая busy-область: существующий [LoadingSkeleton](../../src/shared/ui/LoadingSkeleton.tsx), а не domain widget в shared.
- Account-income state views: [страница](../../src/pages/account-income/ui/AccountIncomePage.tsx) и её flat `components/*.view.tsx`; новый page-local filter остаётся здесь.
- Portfolio query: [entity public API](../../src/entities/portfolio/index.ts); новая UI-сводка с бизнес-смыслом не становится shared только из-за нескольких экранов.
-
-## Проверка
-
-После placement/import change: `npm run deps`, `npm run typecheck`, `npm run knip`;
-после собственного behavior — применимые tests. Финальный gate указан в AGENTS.
-Existing dependency config не запрещает все same-layer imports: их и смысл
-owner проверяет review. Не объявляй Steiger установленным; graph проверяет
-текущий dependency-cruiser. Review отдельно проверяет смысл owner: разрешённый dependency graph не доказывает
-правильный выбор слоя.
@@ -29,5 +29,5 @@ RTL suite и не тестируй внутренности Mantine. Сущес
 `npm run typecheck`, `npm run deps:storybook`, `npm run build:catalog` проверяют
 типы, изоляцию и сборку. Build не выполняет `play` как CI interaction suite;
 для проверки interaction открой story в браузере, для regression используй
-существующий [Testing](frontend-testing.md). Визуальное соответствие задаче,
+существующий [Testing](testing.md). Визуальное соответствие задаче,
 keyboard и узкий viewport проверяются отдельно от успешной сборки.
@@ -27,7 +27,7 @@ Hooks вызываются без условий и ранних выходов
 контракту стабильной identity; не добавляй их ко всем значениям/handlers.
 React Compiler включён в Vite, но не доказывает выигрыш и не заменяет effect
 correctness. Не удаляй существующую memoization без понимания её consumers.
-Container/VM/view и state owners — в [UI](frontend-ui.md).
+Container/VM/view и state owners — в [UI](ui.md).

 ## Domain literals and magic values

@@ -39,15 +39,15 @@ Backend vocabulary бери из generated `paths`, не создавай руч

 `ProblemDetailsDto.code` сейчас `string`. Не объявляй закрытый frontend error
 enum и не превращай неизвестный code в известный через cast. Повторяющуюся
-обработку своди у ответственного owner; [errors](frontend-data.md#errors).
+обработку своди у ответственного owner; [errors](data.md#errors).

 `noMagicNumbers` в Biome — error; fixtures/tests/stories исключены только
 из этого правила. Policy получает имя и единицы; подавление допустимо для
 incidental value с объяснением. Обычный UI-текст не превращай в constant:
-его owner — [i18n](frontend-ui.md#строки-и-валидация).
+его owner — [i18n](ui.md#строки-и-валидация).
 Semantic magic strings и props profile требуют review.

 ## Проверка

 `npm run typecheck` и `npm run lint`; behavior проверяй по
-[Testing](frontend-testing.md), placement — по [FSD](frontend-architecture.md).
+[Testing](testing.md), placement — по [FSD](../architecture.md).
@@ -22,7 +22,7 @@ Wrapper нужен для проектной ответственности, а

 | Состояние | Владелец |
 | --- | --- |
-| Ответ сервера / query lifecycle | TanStack Query, [data rules](frontend-data.md) |
+| Ответ сервера / query lifecycle | TanStack Query, [data rules](data.md) |
 | Ввод и ошибки формы | React Hook Form + Zod, container/VM |
 | Параметр навигации, который должен переживать переход/ссылку | Router/URL |
 | Локальное открытие, focus, rendering fallback | React UI state |
@@ -101,6 +101,6 @@ Types, props, hooks и memoization — в [TypeScript/React](typescript-react.md
 ## Проверка

 Type/style: `npm run typecheck`, `npm run lint`. Для risk behavior/изменения тестов
-используй [Testing](frontend-testing.md). UI: keyboard, narrow viewport,
+используй [Testing](testing.md). UI: keyboard, narrow viewport,
 loading/error/empty/loaded и recovery по применимости. [Storybook](storybook.md) задаёт выбор stories и изоляцию каталога;
 сверяй UI с задачей отдельно от build.