Add analyser to visualize the event sourced domain

.github/workflows/phpunit.yml

@@ -0,0 +1,46 @@
+# https://help.github.com/en/categories/automating-your-workflow-with-github-actions
+
+name: "Unit tests"
+
+on:
+    pull_request:
+    push:
+        branches:
+            - "[0-9]+.[0-9]+.x"
+            - "renovate/*"
+
+concurrency:
+    group: ${{ github.workflow_ref }}
+    cancel-in-progress: true
+
+jobs:
+    phpunit:
+        name: "Unit tests"
+
+        runs-on: ${{ matrix.operating-system }}
+
+        strategy:
+            matrix:
+                dependencies:
+                    - "locked"
+                php-version:
+                    - "8.5"
+                operating-system:
+                    - "ubuntu-latest"
+
+        steps:
+            - name: "Checkout"
+              uses: actions/checkout@v7
+
+            - name: "Install PHP"
+              uses: "shivammathur/setup-php@2.40.0"
+              with:
+                  php-version: "${{ matrix.php-version }}"
+                  ini-values: memory_limit=-1, opcache.enable_cli=1
+
+            - uses: ramsey/composer-install@4.0.0
+              with:
+                dependency-versions: ${{ matrix.dependencies }}
+
+            - name: "PHPUnit"
+              run: "vendor/bin/phpunit"

.gitignore

@@ -4,3 +4,4 @@ phpunit.xml
 .phpunit.result.cache
 .phpcs-cache
 phpstan.neon
+var/

Makefile

@@ -27,6 +27,16 @@ phpstan-baseline: vendor
 .PHONY: static
 static: phpstan cs                                              			 	## run static analyser
 
+.PHONY: phpunit
+phpunit: vendor                                                                 ## run phpunit tests
+	vendor/bin/phpunit
+
+.PHONY: test
+test: phpunit                                                                   ## run tests
+
+.PHONY: dev
+dev: static test                                                                ## run dev tools
+
 .PHONY: docs
 docs: docs-extract-php docs-php-lint docs-phpcs docs-inject-php
 

README.md

@@ -13,6 +13,7 @@
 * [Recording in apply methods](https://patchlevel.dev/docs/event-sourcing-phpstan-extension/latest/getting-started#recording-in-apply-methods) is reported as an error, because recording events while replaying them leads to duplicated events.
 * [Writing state outside apply methods](https://patchlevel.dev/docs/event-sourcing-phpstan-extension/latest/getting-started#writing-state-outside-apply-methods) is reported as an error, because state that is not derived from an event is lost when the aggregate is reloaded.
 * [Typed decisions](https://patchlevel.dev/docs/event-sourcing-phpstan-extension/latest/getting-started#typed-decisions) for the dynamic consistency boundary, so PHPStan knows the state of every projection a decision reads, also when several are read at once.
+* [Analyser](https://patchlevel.dev/docs/event-sourcing-phpstan-extension/latest/analyser) that turns your aggregates, commands, events, decisions and subscribers into a diagram inspired by Event Storming or into JSON for your own tooling.
 
 ## Installation
 

composer.json

@@ -29,7 +29,9 @@
     "patchlevel/coding-standard": "^1.3.0",
     "patchlevel/event-sourcing": "4.0.x-dev",
     "phpstan/phpstan-strict-rules": "^2.0.4",
+    "phpunit/phpunit": "^10.5.0 || ^11.0.0 || ^12.0.0",
     "roave/security-advisories": "dev-master",
+    "symfony/http-kernel": "^6.4.0 || ^7.0.0 || ^8.0.0",
     "wnx/commonmark-markdown-renderer": "^1.6"
   },
   "config": {