docs: refine frontend conventions and routing

2026-09-15 05:42:14 +03:00
parent 0244acf429
commit 718365cd5a
10 changed files with 202 additions and 134 deletions
@@ -27,20 +27,17 @@ Slice именуется по ответственности, а не `helpers`,

 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

-Общий visual foundation принадлежит `shared/theme`. `tokens.json` — переносимый
-WealthLedger v1 source; `theme.ts` адаптирует доверенный JSON в Mantine без runtime
-schema. App и Storybook используют public API `shared/theme/index.ts`: theme,
-designTokens, color roles, CSSVariablesResolver и base styles. Внешний consumer
-читает JSON напрямую. Mantine defaults и локальные domain styles остаются у владельцев.
-`shared/ui` содержит StateView/LoadingSkeleton. Existing route-aware AppShell также
-лежит в shared/ui, но не является общим catalog primitive; его расположение не
-служит основанием переносить новую domain/navigation логику в shared.
-Изменяя foundation, прочитай [design system](../../../docs/design/overview.md).
+Mental model, theme и data flow — в [architecture](../architecture.md).
+При изменении foundation прочитай [design system](../../../docs/design/overview.md).

 ## Примеры

@@ -52,5 +49,7 @@ designTokens, color roles, CSSVariablesResolver и base styles. Внешний c

 После placement/import change: `npm run deps`, `npm run typecheck`, `npm run knip`;
 после собственного behavior — применимые tests. Финальный gate указан в AGENTS.
-Review отдельно проверяет смысл owner: разрешённый dependency graph не доказывает
+Existing dependency config не запрещает все same-layer imports: их и смысл
+owner проверяет review. Не объявляй Steiger установленным; graph проверяет
+текущий dependency-cruiser. Review отдельно проверяет смысл owner: разрешённый dependency graph не доказывает
 правильный выбор слоя.