Как в FSD организовано взаимодействие между слоями и сущностями (entities, features, widgets и т.д.)?

Feature-Sliced Design (FSD) — это методология организации фронтенд-кода, где приложение разбивается на слои (layers), а каждый слой — на слайсы (slices) и сегменты (segments). Главная идея — управлять зависимостями через строгие правила импортов, чтобы код оставался предсказуемым и легко рефакторился.

Слои и направление зависимостей

Слои идут сверху вниз: app → processes → pages → widgets → features → entities → shared. Модуль может импортировать только то, что лежит ниже его слоя. Например, features может использовать entities и shared, но не widgets или pages.

Правила внутри слоя

• Слайсы одного слоя не должны импортировать друг друга напрямую.
• Каждый слайс предоставляет публичный API через index.ts.
• Сегменты внутри слайса: ui, model, lib, api, config.

Пример структуры

src/
  app/            // провайдеры, роутинг, глобальные стили
  pages/
    home/
      ui/HomePage.tsx
      index.ts
  widgets/
    header/
      ui/Header.tsx
      index.ts
  features/
    add-to-cart/
      ui/AddToCartButton.tsx
      model/slice.ts
      index.ts
  entities/
    product/
      ui/ProductCard.tsx
      model/types.ts
      index.ts
  shared/
    ui/Button.tsx
    api/http.ts

Пример импортов

// features/add-to-cart/ui/AddToCartButton.tsx
import { Button } from 'shared/ui/Button';
import { Product } from 'entities/product'; // можно: слой ниже

// widgets/header/ui/Header.tsx
import { AddToCartButton } from 'features/add-to-cart'; // можно
// import { HomePage } from 'pages/home'; // нельзя: слой выше

Публичный API слайса скрывает внутреннюю реализацию: снаружи видно только то, что экспортирует index.ts. Это позволяет свободно менять внутренности слайса без поломки зависимых модулей.

Зачем это нужно

• Устраняются циклические зависимости.
• Упрощается рефакторинг и удаление кода.
• Новые разработчики быстрее понимают, куда класть код.
• Легче тестировать и переиспользовать модули.

Итог: FSD стоит применять в средних и крупных SPA, где важны масштабируемость и предсказуемость архитектуры; для маленьких проектов строгие слои могут быть избыточны.