Vertical Slices
Описание
Vertical Slice Architecture (VSA) - подход к организации кода приложения, при котором код группируется по фичам (бизнес-функциональностям), а не разбивается на технические слои (Presentation/Business/DataAccess), как в Layered архитектуре. Каждый "слайс" содержит в себе все компоненты, необходимые для реализации конкретной фичи - UI/API, бизнес-логика, доступ к данным.
Таким образом, минимизируется связаность между слайсами и, напротив, максимизируется связанность внутри слайса.
Код группируется по отдельным юзкейсам, каждый из которых может быть добавлен/удален/изменен независимо от других.
Данный подход не накладывает ограничений на реализацию необходимых для каждого конкретного слайса компонентов, а также на организацию кода внутри слайса.
Каждый слайс может иметь абсолютно разную реализацию внутри, необходимую для покрытия требований по соответствующему юзкейсу, и использовать различные паттерны (TransactionScript, ActiveRecord, анемичная/богатая модель и т.д.).
Например, код фичи может:
использовать ORM для доступа к данным в SQL базе
содержать сырой SQL запрос к базе для возможности оптимизации сложной логики запроса
- проксировать запрос дальше в систему-источник
По принципу vertical слайса может быть организована не только фича, выставленная наружу клиентам. Например, слайсом также может быть и какой-то бэкграунд процесс (джоб, kafka консьюмер).
В случае с бэкграунд процессами можно пойти дальше. Например, если на событие из kafka топика требуется несколько разных реакций (сохранение в БД, отсылка e-mail, модификация разных сущностей в зависимости от типа события), то можно сам консьюмер организовать по принципу VSA:
В таком варианте с т.з. инфраструктуры kafka мы имеем только один консьюмер, а каждое сообщение из топика обрабатывается несколькими независимыми обработчиками, каждый из которых может иметь свои зависимости, по-своему обрабатывать сообщение или вообще отфильтровывать его. Такой подход уместен, когда одно и то же сообщение из топика должно быть обработано всеми обработчиками или когда распределение во времени разных типов сообщений не становится проблемой для бизнес-процессов (т.е. не возникает ситуации, когда один обработчик ждет неприемлемо долго, пока дойдет очередь до сообщения с "его типом", т.к. оно редкое по сравнению с сообщениями, обрабатываемыми другими обработчиками). В противном случае, стоит выделить отдельный консьюмер (с отдельной консьюмер группой).
Пример: сообщения из топика операций обрабатываются по-разному в зависимости от типа операции (пополнение/списание).
Структура проекта
С точки зрения структурирования проекта могут быть использованы разные подходы, вплоть до расположения всего кода, связанного с фичей, в одном файле - всё зависит от объема кода и субъективного удобства для команды.
Некоторые из опций:
1) Папка на фичу
2) Один файл на фичу, содержащий все компоненты
Controller, Validator, Request/Command, RequestHandler - все возможные компоненты находятся внутри файлов фич (Create/Retry)
3) Код с основной логикой в одном файле, вспомогательная логика - в отдельных
- RkcPaymentCreatedConsumer <-- файл с основной логикой (Consumer, Filter, Message, MessageHandler - все основные компоненты находятся внутри файла)
- RkcPaymentCreatedConsumer.DocumentNumberCounter <-- файл с доп. логикой
- RkcPaymentCreatedConsumer.Validator <-- файл с доп. логикой
То есть основная идея VSA заключается в том, чтобы весь код, связанный с конкретной бизнес-функциональностью, содержать в одном месте и изолировать от кода других бизнес-функциональностей, что упрощает понимание, тестирование и изменение. При этом VSA не запрещает переиспользовать код, вынося общую функциональность в соответствующие компоненты/классы и используя их в разных слайсах.
Trade-Offs
Преимущества | Недостатки |
|---|---|
| Фокус на бизнес-функциональности. VSA помогает сосредоточиться на бизнес-ценности и функциональности приложения, а не на техническом разделении компонентов. | Риск дублирования и усложнения кода фичи, если команда не распознает code smells и не понимает, когда следует произвести рефакторинг (например, выделение общей логики) |
| Отсутствие связанности между слайсами позволяет разным разработчикам работать над разными фичами одновременно. | Архитектура вертикальных слоёв склонна к повышенной энтропии |
| Гибкость. VSA позволяет использовать разные технологии и подходы в каждом слайсе, если это необходимо. | |
| Поддерживаемость. Навигация в проекте с VSA, а также его понимание сильно упрощаются, поскольку все компоненты конкретной функциональности находятся в одном месте. |
Когда использовать
VSA хорошо подходит, когда необходима быстрая и независимая разработка фич, а также когда требования к фичам часто меняются/дополняются. Простота поддержки и добавления фич - важное преимущество этого подхода. Энтропия внутри слайсов - наверное, главная проблема VSA.




