Namasté ... come and meet BeauForma, the company you wished you worked for, and while you're at it, get an introduction in how to design, author and test projections for your next DDD/CQRS/ES project, hands-on. Bring a computer and pair up with a buddy.

1. PROJECTIONS
EXPLAINED
{ YVES REYNHOUT }

2. AGENDA
Meet the domain
Projections
Terminology
Designing
Authoring
Testing

3. WELCOME @
BEAUFORMA (FR)

4. YOU ARE THE PRODUCT

5. ON THE OUTSIDE

6. ON THE INSIDE

7. THAT IS ...
IF YOU CAN AFFORD US
;-)

10. CHALLENGES

11. CONTEXT MAP

12. REWARD

13. WHAT'S NOT TO LIKE ABOUT
BEAUFORMA?

14. BUT, DUDE ... WE'RE
HERE FOR
PROJECTIONS,
REMEMBER?

15. TERMINOLOGY
Event: a fact, something that happened, a message, a
datastructure
Stream: a sequence of events, partitioned by something
Event store: a collection of streams (simplified)
Disclaimer: not authoritive, just my take

18. 1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
13:
14:
15:
16:
17:
18:
19:
open System
type GuestStartedShopping = {
SubsidiaryId : Guid;
FeelGoodCartId : Guid;
GuestId : Guid;
StartDateAndTime : DateTime;
}
type GuestCheckedOutCart = {
FeelGoodPackageId : Guid;
FeelGoodCartId : Guid;
GuestId : Guid;
Items : Guid array;
}
type GuestAbandonedCart = {
FeelGoodCartId : Guid;
GuestId : Guid;
LastSeenDateAndTime : DateTime;
}

19. 1:
2:
3:
4:
5:
6:
7:
8:
type ItemWasAddedToCart = {
FeelGoodCartId : Guid;
ItemId : Guid;
}
type ItemWasRemovedFromCart = {
FeelGoodCartId : Guid;
ItemId : Guid;
}

20. VANILLA CQRS+ES

21. TERMINOLOGY
ProjectionHandler: a function that projects an event
Projection: a collection of handlers that form a unit
Projector: a function that dispatches an event or a batch
of events to the matching handler(s)
[Optional] ProjectionHandlerResolver: a function that
returns the handlers that match an event
Disclaimer: not authoritive, just my take

25. EXAMPLE
1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
13:
14:
open StackExchange.Redis
let inline (!>) (x:^a) : ^b =
((^a or ^b) : (static member op_Implicit : ^a ­> ^b) x)
let activeShoppersProjection (connection:IDatabase, message:Object) =
match message with
| :? GuestStartedShopping ­>
connection.StringIncrement(!> "ActiveShoppers", 1L) |> ignore
| :? GuestAbandonedCart ­>
connection.StringDecrement(!> "ActiveShoppers", 1L) |> ignore
| :? GuestCheckedOutCart ­>
connection.StringDecrement(!> "ActiveShoppers", 1L) |> ignore
| _ ­> ()

26. EXAMPLE
1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
public class ActiveShoppersProjection : ConnectedProjection<IDatabase>
{
public ActiveShoppersProjection()
{
When<GuestStartedShopping>((connection, message) =>
connection.StringIncrementAsync("ActiveShoppers"));
When<GuestAbandonedCart>((connection, message) =>
connection.StringDecrementAsync("ActiveShoppers"));
When<GuestCheckedOutCart>((connection, message) =>
connection.StringDecrementAsync("ActiveShoppers"));
}
}

27. EXAMPLE
1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
13:
14:
15:
16:
17:
18:
19:
20:
21:
public interface IHandler<TMessage>
{
void Handle(IDatabase connection, TMessage message);
}
public class ActiveShoppersProjection : IHandler<GuestStartedShopping>,
IHandler<GuestAbandonedCart>, IHandler<GuestCheckedOutCart>
{
public void Handle(IDatabase connection, GuestStartedShopping message)
{
connection.StringIncrement("ActiveShoppers");
}
public void Handle(IDatabase connection, GuestAbandonedCart message)
{
connection.StringDecrement("ActiveShoppers");
}
public void Handle(IDatabase connection, GuestCheckedOutCart message)
{
connection.StringDecrement("ActiveShoppers");
}
}

28. VANILLA CQRS+ES

29. VANILLA DDD

30. DESIGNING
PROJECTIONS
consumer driven (by screen, api, model, ...)
affected by the choice of store (e.g. required querying
capabilities, non-functional requirements, ...)

32. DATASTRUCTURES

34. EXERCISE
Define a datastructure for this widget

35. POSSIBLE SOLUTION
1:
2:
3:
4:
5:
6:
7:
8:
type GuestsArrivingRecord = {
RecordId: string;
SubsidairyId: Guid;
Date: DateTime;
AppointmentId : Guid;
GuestName : string;
AppointmentDateAndTime : DateTime
}

36. POSSIBLE SOLUTION
1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
type GuestsArrivingDocument = {
DocumentId: string;
SubsidairyId: Guid;
Date: DateTime;
Appointments : Appointment array
}
type Appointment = {
AppointmentId : Guid;
GuestName : string;
AppointmentDateAndTime : DateTime
}

37. EVENTS

38. 1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
13:
14:
15:
16:
17:
18:
19:
20:
type GuestBookedAppointment = {
AppointmentId : Guid;
GuestId : Guid;
AppointmentDateAndTime : DateTime;
FeelGoodPackageId : Guid;
SubsidiaryId : Guid
}
type GuestRescheduledAppointment = {
AppointmentId : Guid;
GuestId : Guid;
AppointmentDateAndTime : DateTime;
FeelGoodPackageId : Guid;
SubsidiaryId : Guid
}
type GuestSwappedAppointmentFeelGoodPackage = {
AppointmentId : Guid;
GuestId : Guid;
FeelGoodPackageId : Guid;
SubsidiaryId : Guid
}

39. 1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
type GuestCancelledAppointment = {
AppointmentId : Guid;
GuestId : Guid;
Reason : string;
SubsidiaryId : Guid
}
type SubsidiaryCancelledAppointment = {
AppointmentId : Guid;
GuestId : Guid;
Reason : string;
SubsidiaryId : Guid
}

40. EXERCISE
Fill your datastructure using these events
- booking.fshttps://goo.gl/BTBTfi

41. OBSERVATIONS
Not all events are useful,
Information might be missing from events,
Not all data is for viewing
Events challenge the datastructure
What about your observations?

44. OBSERVATIONS
Not all data comes from one projection,
Not all data is owned by one model

45. ONE EXTRA EVENT TO TAKE INTO ACCOUNT
1:
2:
3:
4:
5:
type GuestRegistered = {
GuestId : Guid;
FullName : string;
DateOfRegistration: DateTime;
}

46. EXERCISE
Extend your projection with the event
- booking|guests.fshttps://goo.gl/BTBTfi

47. POSSIBLE SOLUTION
1:
2:
3:
4:
5:
type GuestDocument = {
DocumentId: string;
GuestId: Guid;
FullName: string;
}

48. AUTHORING
PROJECTIONS

49. EXERCISE
Express the projection in your language and store of choice
- booking|guests.fshttps://goo.gl/BTBTfi

50. RECIPE?
define message types in code (for statically typed
languages)
define and implement projection handlers for each
message type
define and implement a dispatcher to those projection
handlers
test drive in the program's main

51. NOT CHALLENGING ENOUGH?

52. EVENTSTORE
IP Address: 178.62.229.196
Http Port: 2113
Tcp Port: 1113
Login: admin
Password: changeit
REDIS
IP Address: 178.62.229.196
Port: 6379
ELASTICSEARCH
IP Address: 178.62.229.196
Port: 9200

53. POSTGRES
IP Address: 46.101.161.64
Port: 5432
Login: dddeu16
Password: dddeu16
Database: dddeu16
SslMode: required
Server Certificate: see online environment file
- online-
environment.md
https://goo.gl/BTBTfi

54. TESTING PROJECTIONS

56. EXAMPLE
1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
13:
14:
15:
16:
17:
18:
19:
20:
21:
public class ActiveShoppersProjectionScenarios
{
public Task when_multiple_active_shoppers()
{
return MemoryCacheProjection.For(new ActiveShoppersProjection())
.Given(
new GuestStartedShopping {
SubsidiaryId = BonifacioId,
FeelGoodCartId = RandomCartId(),
GuestId = OliverMartinezId,
StartDateAndTime = Today.At(6.PM())
},
new GuestStartedShopping {
SubsidiaryId = BonifacioId,
FeelGoodCartId = RandomCartId(),
GuestId = RodriguezId,
StartDateAndTime = Today.At(4.PM())
})
.Expect(new CacheItem("ActiveShoppersCount", 2));
}
}