Missing complete example of Domain-Driven Design enterprise application

##Command Query CRUD Responsibility Segregation Not every piece of software is equally important... Not every piece will decide about company / product success or can cause not reversible negative business consequences like materialise brand risk or money loses. On the other hand scalability or non functional requirements are different for different activities in software. To accommodate to those differences, separate architectural patterns are applied:

![Visualisation of Command Query CRUD Responsibility Segregation] (https://github.com/michal-michaluk/factory/raw/master/command-query-crud.png)

Simple Create Read Update Delete functionality exposed with leverage of CRUD framework.

Goals of that approach:

  • fast initial development,
  • fast respond to typical changes (ex. „please add another 2 fields on UI”),
  • exposure of high quality API.

Complex Commands (business processing) going through Domain Model embedded in hexagonal architecture

Goals of that approach:

  • enable Implementing Domain Model first approach, by adding infrastructure adapters later,
  • keeping Domain Model as simple as possible by protecting it from accidental complexity caused by technological choices or transport models from external services,
  • make core business code technology agnostic, enabling continues technology migration and keeping long living projects up to date with fast evolving frameworks and libraries.

Complex Query

  • query based on projection of domain event to persistent expected by consumer read model,
  • read model composed at query execution time based directly on Domain Model persistent form,
  • mix of above: read model composed at query execution time based on pre-calculated persistent event projections which needs post processing to shape expected read model.

Additional complex calculation or projections can be partially delegated to Domain Model if desired.

Goals of that approach:

  • encapsulation of Domain Model complexity by providing consumer driven or published language API,
  • freeing Domain Model from exposing data for reads one more making Domain Model simpler,
  • improves reads performance and enable horizontal scalability.

##Hexagonal Architecture Only the most valuable part of that enterprise software is embedded in hexagonal architecture - complex business processing modeled in form of Domain Model.

Application Services - providing entry point to Domain Model functionality, Application Services are ports for Primary / Driving Adapters.

Domain Model - Object Oriented (in that case) piece of software modeling business rules, invariants, calculations and processing variants. Thanks to hexagon can be as clean and simple as possible - separating essential complexity of pure business from accidental complexity of technical choices, free of technical and convention constraints.

Ports - contract defined by Domain Model expressing expectations from external resources (services, database or other models). Declared interfaces alongside with IN-OUT parameters are Ports for Secondary / Driven Adapters.

Adapters - integration of technology (REST, database, external services, etc.) with Domain Model. Making useful application from Domain Model and technology.

##Implementing Domain Model as first In most projects the biggest risk is lack of domain knowledge among developers. We all known Java, databases and bunch of handy frameworks, but what about: Investment Banking, Automotive Manufacturing or even e-Commerce.

Lets face those risk at first, maintain and explore domain knowledge with Model Exploration Whirlpool and build Ubiquitous Language with your executable Domain Model from day one. Adding infrastructure and technology later is easy thanks to Hexagonal Architecture.

Starting from ZERO business knowledge through initial domain and opportunity exploration with Big Picture Event Storming:

Looking for system boundaries, impacted and required actors and there interactions with system under design:

Estimating depth of domain model and Command Query CRUD segregation:

Design level Event Storming with Domain Stories and Specification by Examples: <adjust-demand.feature>

Description
The missing, complete example of Domain-Driven Design enterprise application backed by Spring stack
Readme 9.9 MiB
Languages
Java 48%
Groovy 47.3%
Gherkin 4.6%
Dockerfile 0.1%