EventSourcing Workshop
In here, you will find a "from scratch" PHP-based implementation of Event-Sourcing, kept to a minimum on purpose, to allow workshop attendees to explore and experiment with its concepts.
DISCLAIMER: Not a production project
This is not a library nor production-ready project: this is an educational project. Its target audience is students and backend engineers that want to get better at abstracting/maintaining business logic.
Knowledge required
To work in this project, you need some rough knowledge about:
php- you should be familiar with
php's syntax - the provided test suite and tooling should help you prevent mistakes, but you should have basic knowledge of how
phpruns and fails. - we use functional and object-oriented paradigms: you may be up for a crash-course, if you never saw code structured this way.
- you should be familiar with
composerphpclass autoloading and dependency installation is handled for you, but if something goes wrong, you should know somecomposerbasics
sql- the entire workshop is based on SQLite databases: it's just files, but you need to know some very basic SQL
make- most repetitive tasks have been added to a
Makefile: runmaketo see what's available
- most repetitive tasks have been added to a
dockeranddocker-compose- to ensure everyone runs on the same environment, we run tests inside a docker container. Building images and starting/stopping containers is sufficient: we will not use any advanced docker features
- don't worry too much if you don't: the
Makefileshould abstract most docker stuff away
Firing it up
Run:
make composer-install
make quality-assurance
make interactive-shell
Architecture
EventSourcingWorkshop\EventSourcingdocumentationEventSourcingWorkshop\Commandingdocumentation- example implementation used in integration tests
Exercises
Note: all exercises are under the watchful eye of static analysis and CS tooling. Use make quality-assurance to validate your current work!
- Standalone recording of a temperature
- Tracking the last recorded temperature at each location
- Tracking the average recorded temperature at each location, but in the database
- Send an alert when the temperature is below freezing point
- Payment aggregate
- Collaborative event-sourcing:
- TODO: idea of mapping a speed-trap fine management process
- TODO: idea of mapping a hotel reservation + stay process
License
This software is proprietary: please contact the author for permission to use, but for now, these sources are not freely reusable outside educational purposes. Yes: you are reading correctly, this is not MIT/BSD software :-P
4 Dec 14, 2022
3 Aug 21, 2022
591 Jan 4, 2023
5 Sep 21, 2022
2 Nov 21, 2021
7 Aug 23, 2022
11 Apr 26, 2022
113 Dec 6, 2022
204 Dec 21, 2022
141 Jun 16, 2022
13 Dec 22, 2022
0 Jul 9, 2022
7.1k Jan 3, 2023
100 Dec 30, 2022
2 May 26, 2022
2 Apr 25, 2022
1.7k Dec 9, 2022
14 Dec 18, 2022
0 Feb 7, 2022