This repository contains an example event sourced application, used in Ambar's Event Sourcing course. You can take (or retake) the course for free in this link.

To run this application you need Docker. Once you have Docker installed, please clone the code, navigate to local-development and run dev_start.sh.

git clone git@github.com:ambarltd/courses-v2.git
cd courses-v2/local-development
./dev_start.sh

Now open your browser to localhost:8080 and try the application out! You will receive further instructions in the top menu.

This example application contains an event sourced financial institution that allows you to:

1. Sign up
2. Verify your email
3. Sign in / sign out
4. View credit card products you can enrol in (Platinum and Starter)

The application is written in PHP, but we will soon have an extra feature (5. Credit Card Enrolment), implemented in multiple languages.

If you change the code, simply redeploy your Docker containers, and refresh your browser.

cd courses-v2/local-development
./dev_start.sh
./dev_start_with_data_deletion.sh # use this if you want to delete your existing event store, and projection db

To make sense of this application, please review the slides and recordings you received during your course.

application/                # Source code
├── frontend-javascript/    # Source code for the frontend
└── backend-php/            # Source code for the backend

cloud-deployment-examples/  # Infrastructure code examples, in case you ever want to deploy this to the cloud.

local-development/          # Local development environment defined with Docker Compose
│
│
├── docker-compose.yml      # Docker Compose definition
│                           #     Includes an event store (Postgres), projection db (Mongo),
│                           #     backend (PHP + Nginx), frontend (JavaScript + Nginx),
│                           #     and an Ambar emulator (for projections and reactions)
│
│
├── ambar-config.yml        # Configuration for Ambar emulator
│                           #     Needed for projections and reactions as per 
│                           #     https://hub.docker.com/r/ambarltd/emulator
│
├── dev_start.sh            # Starts the application's containers and gives you first steps!
└── dev_shutdown.sh         # Stops the application's Docker containers

If you get stuck, please ask us questions in the #event-sourcing channel of our Slack community. If you're not part of our Slack, please sign up here. Or if you'd like a free private walkthrough, simply book one here.