Слои задает проект
Состав слоев — это часть архитектуры конкретного проекта. Универсального списка слоев, подходящего для любого проекта, не существует.
Каждый проект самостоятельно определяет, какие слои ему нужны, где проходят их границы и какую ответственность несет каждый из них.
Поэтому одинаковые по назначению части системы могут находиться в разных слоях в разных проектах. То, что в одном проекте выделено в отдельный слой, в другом может быть частью существующего слоя.
Какую проблему решает
Попытка использовать заранее заданный набор слоев заставляет проект подстраиваться под чужую архитектуру вместо того, чтобы отражать собственные требования.
Это приводит к искусственным границам: появляются слои без самостоятельной ответственности, функциональность приходится перемещать между ними только ради соответствия шаблону, а исключения начинают восприниматься как ошибки.
Слои должны описывать структуру конкретного проекта, а не соответствие универсальной классификации.
Правила
Состав слоев определяет проект
Проект сам определяет список слоев, их количество и границы. Названия и состав слоев из других архитектур не являются обязательными.
Новый слой следует вводить тогда, когда он выражает самостоятельную архитектурную границу, а не только потому, что такая граница существует в другом проекте.
Допустимые зависимости определяет проект
Проект сам определяет, какие зависимости между его слоями являются допустимыми.
Если конкретная зависимость нарушает общепринятое направление зависимостей, это не делает ее автоматически ошибкой. Она может быть необходимой особенностью архитектуры конкретного проекта.
Важно, чтобы такая зависимость была осознанным решением, а не случайным результатом реализации.
Отступление от направления записывается повтором слоя
Внимание!
Крайне не рекомендуется повторять слои: это уменьшает гарантии.
Ответственность за повтор лежит на проекте: только он знает, временный это миграционный мост, стабильная часть архитектуры или ошибка в размещении кода.
По умолчанию каждый слой встречается в списке один раз, и импорт разрешен только в нижележащие слои. Повтор имени превращает слой в промежуток между первым и последним вхождением: слой становится двунаправленным со всем, что в этот промежуток попало. Смежный повтор (
entities, entities) открывает только горизонтальные связи — между одноименными слоями разных директорий.Повтор — не «настройка строгости», а заявление о снятой гарантии: внутри промежутка снова возможны взаимные зависимости и циклы. Зато размер послабления виден в той же схеме, где записан сам порядок, и измеряется расстоянием между вхождениями: миграция выражается их сдвигом навстречу друг другу, а закрытый долг — удалением повтора из списка.
Почему
Самостоятельное определение слоев дает конкретные практические выгоды:
Соответствие архитектуре проекта
Слои отражают реальные границы системы и ее ответственность, а не абстрактный архитектурный шаблон.
Отсутствие искусственных границ
Не требуется выделять отдельный слой только потому, что он предусмотрен некоторой методологией. Граница появляется тогда, когда она имеет значение для конкретного проекта.
Эволюция архитектуры
По мере изменения проекта состав слоев может изменяться вместе с ним. Добавление, объединение или разделение слоев является нормальным архитектурным изменением.
Осознанные исключения
Архитектура может содержать зависимости, необходимые именно этому проекту. Они не считаются ошибкой только из-за несоответствия универсальному правилу.
Примеры
Минимальный набор слоев:
app
pages
widgets
entities
commonДля нового проекта, у которого еще нет сформировавшихся архитектурных требований, этого набора может быть достаточно.
Добавление слоя при появлении новой архитектурной границы:
app
pages
widgets
features
entities
commonfeatures появляется не потому, что он является обязательным слоем, а потому что в проекте появилась самостоятельная ответственность, которую имеет смысл выделить в отдельную границу.
Другой состав слоев:
app
pages
features
entities
commonВ другом проекте features может быть необходимой архитектурной границей, тогда как widgets не требуется выделять отдельно.
Слой без самостоятельной ответственности:
app
pages
widgets
features
entities
commonЕсли features добавлен только потому, что он присутствует в используемом архитектурном шаблоне, но в проекте нет причины выделять его отдельно, такой слой не нужен.
Таким образом, один и тот же слой может быть необходим в одном проекте и не иметь смысла в другом.
Осознанное отступление, записанное повтором:
app
pages
legacy
widgets
features
entities
legacy
commonlegacy объявлен дважды, поэтому он двунаправлен со всем, что попало между вхождениями: старый код может тянуть entities, features и widgets, а они — его. Это и есть размер снятой гарантии: он виден прямо в схеме и сокращается по мере того, как вхождения сдвигаются навстречу друг другу.
Рекомендации
Начинайте с минимального набора
Если пока нет понимания, какие слои выделить, например в новом проекте, лучше использовать минимальный стандартный набор:
Слой Назначение app Всё, что касается приложения целиком: Провайдеры, создание стора pages Страницы widgets Большие самодостаточные блоки entities Модели и их представление в интерфейсе common Переиспользуемый код: uikit, библиотеки Он дает базовые архитектурные границы без необходимости заранее придумывать структуру, потребность в которой еще не подтверждена проектом.
Документируйте слои проекта
Всегда документируйте слои проекта, даже если это стандартные слои. Так будет легко подправить требования к слою. В идеале, всегда должно быть понятно к каком слою отнести тот или иной код
Добавляйте слой при появлении самостоятельной ответственности
Новый слой стоит выделять тогда, когда существующие границы перестают достаточно хорошо описывать структуру проекта. Не следует создавать слой заранее только на случай будущего роста.
Не путайте принцип с конкретной реализацией
Архитектурный принцип может быть общим, а его реализация — различаться от проекта к проекту. Конкретный набор слоев не является обязательной реализацией этого принципа.