ftes/conduit

RealWorld example backend implementing the CQRS/ES pattern in Elixir and Phoenix

Conduit

Discover why functional languages, such as Elixir, are ideally suited to building applications following the command query responsibility segregation and event sourcing (CQRS/ES) pattern.

Conduit is a blogging platform, an exemplary Medium.com clone, built as a Phoenix web application.

This is the full source code to accompany the "Building Conduit" eBook.

This book is for anyone who has an interest in CQRS/ES and Elixir. It demonstrates step-by-step how to build an Elixir application implementing the CQRS/ES pattern using the Commanded open source library.

---

MIT License

---

Getting started

Conduit is an Elixir application using Phoenix 1.4 and PostgreSQL for persistence.

Prerequisites

You must install the following dependencies before starting:

• Git.
• Elixir (v1.6 or later).
• PostgreSQL database (v9.5 or later).

Configuring Conduit

1. Clone the Git repo from GitHub:

   $ git clone https://github.com/slashdotdash/conduit.git

2. Install mix dependencies:

   $ cd conduit
   $ mix deps.get

3. Create the event store database:

   $ mix do event_store.create, event_store.init

4. Create the read model store database:

   $ mix do ecto.create, ecto.migrate

5. Run the Phoenix server:

   $ mix phx.server

This will start the web server on localhost, port 4000: http://0.0.0.0:4000

This application only includes the API back-end, serving JSON requests.

You need to choose a front-end from those listed in the RealWorld repo. Follow the installation instructions for the front-end you select. The most popular implementations are listed below.

• React / Redux
• Elm
• Angular 4+
• Angular 1.5+
• React / MobX

Any of these front-ends should integrate with the Conduit back-end due to their common API.

Running the tests

MIX_ENV=test mix event_store.create
MIX_ENV=test mix event_store.init
MIX_ENV=test mix ecto.create
MIX_ENV=test mix ecto.migrate
mix test

Need help?

Please submit an issue if you encounter a problem, or need support.