ksv741
718365cd5a
2.3 KiB
Frontend mental model
React + TypeScript + Vite SPA. Router задаёт navigation; providers в app
подключают auth, TanStack Query, i18n и Mantine. Vite использует React Compiler;
Vitest — отдельную JSDOM конфигурацию. Точные versions/scripts — в
package.json, реализация — source of truth.
app → pages → features → entities → shared
page container → page VM → entity/feature query → shared/api → backend /api/v1
↓
props → state/section views
widgets не используется. Pages владеют route composition и локальным поведением;
features — самостоятельными возможностями пользователя; entities — устойчивыми
доменными понятиями; shared — техническими primitives без domain responsibility.
Правила выделения owner и public index.ts — в
FSD convention.
Server state и lifecycle запроса принадлежат TanStack Query; VM собирает данные
для view. Transport — openapi-fetch/openapi-react-query, типизированные из
предоставленного snapshot через openapi-typescript. Backend владеет wire
contract; frontend не читает его checkout для генерации и не вызывает T-Bank.
Data convention задаёт auth/cache границы.
shared/theme/tokens.json — переносимый source design tokens; theme.ts
адаптирует доверенный JSON к Mantine без runtime schema. App и Storybook читают
public API shared/theme. Storybook показывает synthetic presentation states,
не использует application API. RTL/MSW проверяют поведение приложения отдельно.
Existing route-aware AppShell расположен в shared/ui; это legacy placement, а не образец нового shared primitive. Общий план улучшений читается только при migration через router.