KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #cli #claude-code #mcp #rust #deepseek-harness #ai-agent

ddd-with-kotlin

★ 125 Open GitHub ↗

A demo project to show a Domain Driven Design with Kotlin.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

DDD with Kotlin
===============

[![Build Status](https://img.shields.io/travis/bringmeister/ddd-with-kotlin/master.svg)](https://travis-ci.org/bringmeister/ddd-with-kotlin)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/bringmeister/ddd-with-kotlin/master/LICENSE)

This is a simple demo project to show a Domain Driven Design with Kotlin.

Note that there is a similar version of this demo which is using event sourcing at [event-sourcing-with-kotlin](https://github.com/bringmeister/event-sourcing-with-kotlin).

## Run it

```
./gradlew bootRun
```

Then simulate an incoming event:

```
POST to http://localhost:8080/master_data_update
POST to http://localhost:8080/media_data_update
```

## Example Use Case

The subject of this demo is the `Product Service`.
The `Product Service` is located between five other components.
The `Master Data Service` will push new products to the `Product Service`.
This is the beginning of our business process.
The `Product Service` will register each new product at the `Media Data Service`.
After a product is registered, the `Product Service` will receive updates for this product from the `Media Data Service`. 
After an update was received, the `Product Service` will:
 - Update the `CDN` if media data has changed
 - Update the `Shop` and `search index` if master data has changed

## What to see

- A domain entity called `Product.kt` which encapsulates business logic and throws domain events.
- A process flow with events ("something has happened") and commands ("now do something").
- Value objects such as `ProductNumber.kt` or `ProductInformation.kt`.
- A ports-and-adapters package layout.
- An anti-corruption layer for external events - they will be transformed to internal commands.

## Resources

- https://martinfowler.com/tags/domain%20driven%20design.html
  * A collection of articles by Martin Fowler. 
    Each article enlightens a different aspect of DDD.
- https://docs.microsoft.com/en-us/dotnet/standard/microservices-architecture/microservice-ddd-cqrs-patterns/ddd-oriented-microservice
  * First article of series by Microsoft on how to use DDD for microservices.
    Although the series is using C#, the examples are easy to understand.

ddd-with-kotlin

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README