Mixter is a project to discover CQRS/Event sourcing through koans in multiple languages.

At this point the koans have been ported to 5 languages: C#, Java 8, Scala, PHP and Javascript.

1. Checkout master branch
2. Execute ./run script
3. You will have to make tests pass green, then to go to next test, execute ./next

See few slides on http://devlyon.fr/mixter, it explains the main steps and goals for each.

You can view one solution for each language with a small Web API on branches [lang]-solution.

Feel free to use issues in this repo to give your feedback, to propose some improvements, to ask for other languages...and even better to submit pull requests.

We have done some choices that we consider implementation details, but that can hurt some people. So we try to explain them here.

1. use an AggregateRoot base class that accumulate uncommitted events that are picked by Repository on Save of the aggregate.

2. use DomainEvents.Raise(event) static call from AggregateRoot protected Apply method

We chose a third way that consists of passing an IEventPublisher (with Publish method) to each aggregate method to raise events. There is no more need to call Repository.Save and it avoids static method call.

We thought this "transient state" as a special projection (like Read model ones) to take further decision in the aggregate, that's why we call it DecisionProjection. We kept this class private inside the aggregate.

Perhaps something to introduce in further version.

You can contact us through GitHub or on Twitter : @clem_bouillier, @florentpellet, @jeanhelou, @ouarzy.

If you want to fork with your preferred language, you only need to follow some rules.

The KoanCli script is based on a naming convention in commit message.

• Failing tests should contain [Test KO]
• Resolving tests should contain [Test OK]

Currently the KoanCli script isn't dynamic and tests number must be static to know the correspondence between a test and a step. Here number of tests per step:

• Step 1, delete command: 4 tests
• Step 2, timeline messages: 1 tests
• Step 3, subscription aggregate: 4 tests
• Step 4, aggregates interaction: 4 tests
• Step 5, command handler: 2 tests

• Create KoanCli: no git knowledge required. You simply call run script to starting, and next to jump at next step. (#3)
• Remove reply message (#7)
• Rename publish to quack (#16)
• Fix several bug specific at languages (#15, #5, #4)
• Make PHP version work with PHP 7.2 (#36)

First version, use during a Mix-IT workshop 2015 : http://www.mix-it.fr/session/1041/agilite-par-le-code-grace-a-cqrs-et-eventsourcing