Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Docs: Features, design & usage #23

Merged
merged 1 commit into from
Jan 1, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 43 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,36 @@
# Event-Sourcing-Admin-Bundle

This bundle provides a simple admin interface for the [patchlevel/event-sourcing-bundle](https://github.com/patchlevel/event-sourcing-bundle).
This bundle provides a dashboard for
the [patchlevel/event-sourcing](https://github.com/patchlevel/event-sourcing) library. This needs
the [patchlevel/event-sourcing-bundle](https://github.com/patchlevel/event-sourcing-bundle) to work properly.

This bundle was initially designed as an DX tool for development but it can also be run on production. If you want to
run it in production be sure to place it behind a login / security measure. Otherwise you will risk that somebody would
mess with your subscriptions, gather internal information about your system and users.

Features:

* Store view
* Filter by Aggregates
* Filter by ID's
* Jump into inspection from there
* Inspection
* View aggregate details by ID
* See all events which are recorded
* See the current serialized state, if configured properly
* See the current snapshot, if configured properly
* See the current state via as a dump via `symfony/var-dumper`
* Time travel to see the state of the aggregate at different point of times
* Events
* See all registered events
* See all registered subscriber for these events
* Subscriptions
* See all registered subscribtions and their current state
* Filter by Group
* Filter by RunMode
* Filter by Status
* Filter by search
* Some simple subscription controls like: play, pause or delete subscription

## Screenshots

Expand All @@ -23,22 +53,29 @@ This bundle provides a simple admin interface for the [patchlevel/event-sourcing
## Installation

```bash
composer require patchlevel/event-sourcing-bundle
composer require --dev patchlevel/event-sourcing-bundle
```

## Configuration

```yaml
# config/packages/patchlevel_event_sourcing_admin.yaml
patchlevel_event_sourcing_admin:
when@dev:
patchlevel_event_sourcing_admin:
enabled: true
```

## Routes

```yaml
# config/routes/patchlevel_event_sourcing_admin.yaml
event_sourcing:
resource: '@PatchlevelEventSourcingAdminBundle/config/routes.yaml'
prefix: /es-admin
when@dev:
event_sourcing:
resource: '@PatchlevelEventSourcingAdminBundle/config/routes.yaml'
prefix: /es-admin
```

## Production usage

If you run this on production you would need to install this package as a normal dependency and adjust the configuration
accordingly. Also be sure to place it behind a login / security measure.
Loading