Clean Vertical Slice Architecture

Wanneer goed geïmplementeerd, vertonen Clean Architecture en Vertical Slice Architecture opvallende overeenkomsten. Onenigheden tussen voor en tegenstanders ontstaan vaak door misverstanden in plaats van door gebreken in de concepten.

Kritiek op Clean Architecture:

• Verspreiding van code door de codebase
• Strakke koppeling tussen functies
• Onnodige complexiteit

Zijn deze kritieken werkelijk op Clean Architecture gericht, of eerder een gevolg van een slechte package cohesion strategie?

Clean Architecture

Slechte Clean Architecture

Veel implementatie- en projecttemplates hebben de neiging om classes te categoriseren op type, wat lijkt op de bekende structuur van MVC-projecttemplates.

MySolution.sln
  📂 MyCompany.MyProject.Api
    📂 Controllers
      📄 AccountController.cs
      📄 OrderController.cs
  📂 MyCompany.MyProject.Application
    📂 Interfaces
      📄 IAccountRepository.cs
      📄 IAccountService.cs
      📄 IOrderRepository.cs
      📄 IOrderService.cs
    📂 Services
      📄 AccountService.cs
      📄 OrderService.cs
    📂 Validators
      📄 AccountValidator.cs
      📄 OrderValidator.cs
  📂 MyCompany.MyProject.Domain
    📄 Account.cs
    📄 Order.cs
  📂 MyCompany.MyProject.Infrastructure
    📄 AccountRepository.cs
    📄 OrderRepository.cs

Navigeren door verschillende mappen om de Order-functionaliteit aan te passen is omslachtig. Deze simplistische organisatorische benadering, hoewel aanvankelijk intuïtief, faalt om effectief te schalen. Het is als het opslaan van alle sokken in één lade—geschikt voor één persoon maar onpraktisch voor een groter huishouden.

Ik wed dat je je sokken scheidt van die van je partner, en dat elk van je kinderen de sokken in zijn of haar eigen kamer heeft opgeslagen.

Betere clean architecture

MySolution.sln
  📂 MyCompany.MyProject.Api
    📂 Controllers
      📄 AccountController.cs
      📄 OrderController.cs
  📂 MyCompany.MyProject.Application
    📂 Accounts
      📄 Account.cs
      📄 AccountService.cs
      📄 AccountValidator.cs
      📄 IAccountRepository.cs  
      📄 IAccountService.cs
    📂 Orders
      📄 IOrderRepository.cs
      📄 IOrderService.cs
      📄 Order.cs
      📄 OrderService.cs
      📄 OrderValidator.cs  
  📂 MyCompany.MyProject.Infrastructure
    📄 AccountRepository.cs
    📄 OrderRepository.cs

Bepaalde details zijn staan open voor discussie en kunnen variëren afhankelijk van de specifieke kenmerken van je applicatie. Bijvoorbeeld:

• Domeinobjecten kunnen samen gegroepeerd worden in een map of kunnen geplaatst worden in de featuremap.
• De groepering van controllers en repositories kan worden aangepast afhankelijk van de applicatie.

Vertical Slice Architecture komt voor uit een goed ontworpen Clean Architecture.

Vertical Slice Architecture

Wat dacht je van het integreren van AccountRepository.cs in de Accounts-map? Zeker. En de AccountController.cs? Het samenvoegen zou de architectuur niet wijzigen.

Extreme Vertical Slice Architecture

MySolution.sln   
  📂 MyCompany.MyProject.Api
    📂 Accounts
      📄 Account.cs
      📄 AccountController.cs
      📄 AccountRepository.cs
      📄 AccountService.cs
      📄 AccountValidator.cs
      📄 IAccountRepository.cs  
      📄 IAccountService.cs
    📂 Orders
      📄 IOrderRepository.cs
      📄 IOrderService.cs
      📄 Order.cs
      📄 OrderController.cs
      📄 OrderRepository.cs
      📄 OrderService.cs
      📄 OrderValidator.cs   

Het is belangrijk om afhankelijkheden zo ver mogelijk naar de rand van je applicatie te duwen. Het voorkomen dat webgerelateerde elementen doordringen in services of databasedetails validators besmetten, is van het grootste belang.

Sommige implementaties van Vertical Slice Architecture falen echter wanneer de architectuur het niet ontmoedigd om code op de verkeerde plekt te plaatsen.Externe afhankelijkheden zoals ORM en web frameworks kunnen onbedoeld de kernapplicatielogica binnendringen, wat leidt tot koppeling van bedrijfslogica aan implementatiedetails.

Vertical Slice Clean Architecture

Het gebruik van een mappenstructuur kan helpen om de onderscheidingen te verduidelijken. Waardoor de oplossing weer geleidelijk op Clean Architecture begint te lijken.

MySolution.sln   
  📂 MyCompany.MyProject.Api
    📂 Accounts
      📂 Presentation
        📄 AccountController.cs
      📂 Core 
        📄 Account.cs      
        📄 AccountService.cs
        📄 AccountValidator.cs
        📄 IAccountRepository.cs  
        📄 IAccountService.cs
      📂 Infrastructure
        📄 AccountRepository.cs

Afzonderlijke projecten zijn te verkiezen om het gebruik van externe afhankelijkheden binnen de kern van de applicatie te voorkomen.

Clean vs Vertical Slice Architectures

Wanneer je goed kijkt, beginnen Clean en Vertical Slice Architecture als twee handen op één buik te lijken. Ze streven beide naar modulaire, flexibele ontwerpen die gemakkelijk te onderhouden en schalen zijn. De kleine verschillen komen voornamelijk neer op hoe ze in de praktijk worden gebracht. Wanneer je ze goed implementeert, eindig je met software die gemakkelijk te gebruiken, aanpasbaar en betrouwbaar is.

Referenties

• Clean Architecture - Amazon
• Hexagonal Architecture - Wikipedia
• Package Principles - Wikipedia
• Vertical Slice - Wikipedia
• Clean Architecture is About Vertical Slices - YouTube