Clean Architecture

Clean Architecture

Atomiv was envisioned to help you design and implement high quality architectures for software projects and products. Atomiv provides a templated solution architecture based on well-known best practices in clean architecture.

At the system center, we have the Core Layer, composed of the Application Layer and the Domain Layer. Everything else - the external world (Infrastructure, REST API) is “just a detail”.

Architecture diagram


The historical foundations of clean architecture are as follows:

Furthermore, it is rooted in the following design and development approaches:

  • Domain Driven Design (DDD) (Eric Evans)
  • Use Case Driven Design (UCDD)
  • Test Driven Development (TDD) (Kent Beck)
  • Acceptance Test Driven Development (ATDD)
  • Behavior Driven Development (BDD)
  • Command Query Responsibility Segregation (CQRS)


To summarize, the dependencies are as follows:

  • The Core Layer is self-contained and it does not dependent on any other layers.
  • The Domain Layer does not have dependencies on other layers.
  • The Application Layer Interface do not contain dependencies on other layers.
  • The Application Layer Implementation depends both on Application Layer interfaces and the Domain Layer.

Other layers contain dependencies as follows:

  • The Infrastructure Layer depends on the Core Layer, because it implements the interfaces defined in the Core Layer. Thus, it is an “implementation detail” with ORM’s, frameworks and external systems.
  • The Presentation Layer depends on the Application Layer interfaces.
  • The DI Layer depends on the Core Layer and the Infrastructure Layer.
  • The Test Layer depends on the layers it is testing.

The core benefits is that due to the independence of the Application Core, it ensures separation of concerns and modularity, swappability of databases, UIs and any frameworks, and also enables the system to be testable. These factors increase system quality and decreasing overall total development and maintenance cost.


System Architecture

Architecture - 1

Layer Components

Architecture - 2

Example Domain

Architecture - 3

Microservice Landscape

Architecture - 4

Valentina Cupać
Valentina Cupać

Valentina is a Software Architecture Consultant who is focused on standardizing software architecture and software development to achieve high quality efficiently.