https://github.com/tpluscode/pgs.ddd

Base libraries to start with CQRS and Event Sourcing
https://github.com/tpluscode/pgs.ddd

Last synced: 6 days ago
JSON representation

Base libraries to start with CQRS and Event Sourcing

• Host: GitHub
• URL: https://github.com/tpluscode/pgs.ddd
• Owner: tpluscode
• License: mit
• Created: 2016-03-30T14:18:33.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2016-04-26T12:24:43.000Z (over 8 years ago)
• Last Synced: 2024-10-24T10:03:01.408Z (2 months ago)
• Language: C#
• Homepage:
• Size: 119 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# PGS.DDD

Base libraries to start with CQRS and Event Sourcing

## About

The solution consists of a number of projects, each published as a NuGet package on myget (https://www.myget.org/F/pgs-ddd/api/v2).

It should be ready to build out-of-the box. To work with the dependencies [Paket](http://fsprojects.github.io/Paket/) is used. 

It is best handled from the command line. There is a handy [VS plugin too](https://visualstudiogallery.msdn.microsoft.com/ce104917-e8b3-4365-9490-8432c6e75c36).

### PGS.DDD.Domain

This library should be referenced by the business domain. This is there **Aggregate Roots**, **Entities** and **Domain Events** live.

To create an event-sourced **AR**, just inherit the `AggregateRoot` class.

``` c#

public class BusinessPerson : AggregateRoot

{ 

  private CompanyId _employer;

  public BusinessPerson(PersonId id) : base(id) { }

  public void StartWorkAt(CompanyId company)

  {

    // maybe some buisiness checks here to ensure consistent state?

  

    // push event

    Handle(StartedWorkingAt(company));

  }

  

  // each event is handled in a OnX method

  // it should be private or protected

  private void OnStartedWorkingAt(StartedWorkingAt ev)

  {

    _employer = ev.CompanyId;

  }

  

  // keeping event classes nested in their respective Aggregate Root

  // helps prevent name clashes

  public class StartedWorkingAt : DomainEvent

  {

    public StartedWorkingAt(CompanyId company)

    {

    }

  }

}

```

### PGS.DDD.Application

This one should be referenced by Application services layer and contains base interfaces for their implementation:

* `IEventPublisher`, `IEventHandler` - for working with domain events

* `IServiceBus` - combines both above

* `IIdConverter` - to convert domain ids into event stream identifiers

### PGS.DDD.Data.EventSourced

Implementation of an in-memory event store and a **repository** backed by events persisted to hard storage

### PGS.DDD.Data.NEventStore

An implementation of event store using [NEventStore](https://github.com/NEventStore/NEventStore).

### PGS.DDD.ServiceBus

Basic, in-memory implementation of `IServiceBus`.