- 
-
-
- | For a social network | For a Git frontend (e.g., GitHub) |
|---|---|
|
|
| For a social network | For a Git frontend (e.g., GitHub) | Actions on behalf of users |
|---|---|---|
|
|
|
| For a social network | For a Git frontend (e.g., GitHub) |
|---|---|
|
|
| For a social network | For a Git frontend (e.g., GitHub) |
|---|---|
|
|
+ 
+
+
+
-
- 
+
-:::
-
-Каждый слой несет в себе особый семантический смысл, помогающий определить, какую ответственность следует возложить на модуль в вашем коде. Названия и значения слоёв стандартизированы для всех проектов, построенных с использованием Feature-Sliced Design.
-
-Всего существует **7 слоёв**, расположенных от наибольшей ответственности и зависимости к наименьшей:
-
-
-
-
-1. App (Приложение)
+1. App (Эпп)
2. Processes (Процессы, устаревший слой)
2. Pages (Страницы)
3. Widgets (Виджеты)
4. Features (Фичи/функции)
5. Entities (Сущности)
-6. Shared (Общий)
+6. Shared (Шэред)
-Вы не обязаны использовать все слои в своем проекте - добавляйте только те, что приносят пользу вашему проекту.
+Вы не обязаны использовать все слои в своем проекте - добавляйте только те, что приносят пользу вашему проекту. Как правило, в большинстве фронтенд-проектов будут как минимум слои Shared, Pages и App.
-## Правило импортов для слоёв {#import-rule-on-layers}
+На практике слои представляют собой папки с названиями в нижнем регистре (например, `📁 shared`, `📁 pages`, `📁 app`). Добавление новых слоев _не рекомендуется_, так как их семантика стандартизирована.
-Слои состоят из _слайсов_ — сильно сцепленных групп модулей. Feature-Sliced Design поддерживает низкую связанность, поэтому зависимости между слайсами регулируются **правилом импортов для слоёв**:
+## Правило импорта слоев
-> _Модуль в слайсе может импортировать другие слайсы только в том случае, если они расположены на слоях строго ниже._
+Слои состоят из _слайсов_ — высокосвязанных групп модулей. Зависимости между слайсами регулируются **правилом импорта слоев**:
-Например, в `~/features/aaa`, слайсом является `aaa`, поэтому файл `~/features/aaa/api/request.ts` не может импортировать код ни из какого модуля в папку из `~/features/bbb`, но может импортировать код из `~/entities` и `~/shared`, а также из соседних модулей в `~/features/aaa`.
+> _Модуль (файл) в слайсе может импортировать другие слайсы только если они находятся на слоях строго ниже._
+
+Например, папка `📁 ~/features/aaa` является слайсом с именем "aaa". Файл внутри нее, `~/features/aaa/api/request.ts`, не может импортировать код из любого файла в `📁 ~/features/bbb`, но может импортировать код из `📁 ~/entities` и `📁 ~/shared`, а также любой код из `📁 ~/features/aaa`, например, `~/features/aaa/lib/cache.ts`.
+
+Слои App и Shared являются **исключениями** из этого правила — они одновременно являются и слоем, и слайсом. Слайсы разделяют код по бизнес-доменам, и эти два слоя являются исключениями, потому что в Shared нет бизнес-доменов, а App объединяет все бизнес-домены.
+
+На практике это означает, что слои App и Shared состоят из сегментов, и сегменты могут свободно импортировать друг друга.
## Определения слоёв
+В этом разделе описывается семантическое значение каждого слоя, чтобы создать интуитивное представление о том, какой код в нём будет лежать.
+
### Shared
-Изолированные модули, компоненты и абстракции, отдельные от специфики проекта или бизнеса.
-Внимание: не следует использовать этот слой как [свалку утилит][ext--sova-utility-dump]!
+Этот слой формирует фундамент для остальной части приложения. Это место для создания связей с внешним миром, например, бэкенды, сторонние библиотеки, среда выполнения приложения (environment). Также это место для ваших собственных библиотек, сконцентрированных на конкретной задаче.
-Этот слой, в отличие от других, состоит не из слайсов, а непосредственно из сегментов.
+Этот слой, как и слой App, _не содержит слайсов_. Слайсы предназначены для разделения слоя на предметные области, но предметные области не существуют в Shared. Это означает, что все файлы в Shared могут ссылаться и импортировать друг друга.
-**Примеры содержимого**:
+Вот сегменты, которые вы обычно можете найти в этом слое:
-* UI-библиотека
-* API-клиент
-* Код, работающий с API браузера
+- `📁 api` — API-клиент и, возможно, функции для выполнения запросов к конкретным эндпоинтам бэкенда.
+- `📁 ui` — UI-кит приложения.
+ Компоненты на этом слое не должны содержать бизнес-логику, но могут быть тематически связаны с бизнесом. Например, здесь можно разместить логотип компании и макет страницы. Компоненты с UI-логикой также допустимы (например, автозаполнение или строка поиска).
+- `📁 lib` — коллекция внутренних библиотек.
+ Эта папка не должна рассматриваться как хелперы или утилиты ([прочитайте здесь, почему эти папки часто превращаются в свалку][ext-sova-utility-dump]). Вместо этого каждая библиотека в этой папке должна иметь одну область фокуса, например, даты, цвета, манипуляции с текстом и т.д. Эта область фокуса должна быть задокументирована в файле README. Разработчики в вашей команде должны знать, что можно и что нельзя добавлять в эти библиотеки.
+- `📁 config` — переменные окружения, глобальные фиче-флаги и другая глобальная конфигурация для вашего приложения.
+- `📁 routes` — константы маршрутов или шаблоны для сопоставления маршрутов.
+- `📁 i18n` — код, настраивающий систему переводов, а также глобальные строки перевода.
+
+Вы можете добавлять ещё сегментов, но убедитесь, что название этих сегментов описывает цель содержимого, а не его суть. Например, `components`, `hooks` и `types` — плохие имена сегментов, поскольку они не очень полезны при поиске кода.
### Entities
-Понятия из реального мира, которые вместе образуют суть проекта. Как правило, это термины, которые бизнес использует для описания продукта.
+Слайсы на этом слое представляют концепции из реального мира, с которыми работает проект. Обычно это термины, которые бизнес использует для описания продукта. Например, социальная сеть может работать с бизнес-сущностями, такими как Пользователь, Публикация и Группа.
-Каждый слайс этого слоя содержит статические элементы пользовательского интерфейса, хранилища данных и операции CRUD (создание-чтение-изменение-удаление).
+Слайс сущности может содержать хранилище данных (`📁 model`), схемы валидации данных (`📁 model`), функции запросов API, связанные с сущностями (`📁 api`), а также визуальное представление этой сущности в интерфейсе (`📁 ui`). Это визуальное представление не обязательно должно создавать полный блок пользовательского интерфейса — оно в первую очередь предназначено для переиспользования одного и того же внешнего вида на нескольких страницах приложения, и к нему может быть присоединена различная бизнес-логика через пропы или слоты.
-**Примеры слайсов**:
+#### Связи между сущностями
-| Для социальной сети | Для Git-фронтенда (например, GitHub) |
|---|---|
|
|
| Для социальной сети | Для Git-фронтенда (например, GitHub) | Действия от имени пользователя |
|---|---|---|
|
|
|
| Для социальной сети | Для Git-фронтенда (например, GitHub) |
|---|---|
|
|
| Для социальной сети | Для Git-фронтенда (например, GitHub) |
|---|---|
|
|
+
+
+
+ {translate({ id: "pages.versions.current" })}
| @@ -46,6 +44,11 @@ function Version() { Migration from v1 | ++ + Migration from v2.0 + + |