Merge branch 'main' into #20-vacation-requests

# Conflicts:
#	app/Architecture/Providers/ObserverServiceProvider.php
#	app/Domain/Role.php
#	app/Domain/Rules/ApprovedVacationDaysInSameRange.php
#	app/Domain/Rules/DoesNotExceedLimitRule.php
#	app/Domain/Rules/MinimumOneVacationDayRule.php
#	app/Domain/Rules/PendingVacationRequestInSameRange.php
#	app/Domain/Rules/UsedVacationDaysInSameRange.php
#	app/Domain/Rules/VacationRequestRule.php
#	app/Domain/VacationRequestState.php
#	app/Domain/VacationRequestStateManager.php
#	app/Domain/VacationRequestValidator.php
#	app/Domain/VacationType.php
#	app/Domain/VacationTypeConfigRetriever.php
#	app/Eloquent/Models/User.php
#	app/Infrastructure/Http/Controllers/UserController.php
#	app/Infrastructure/Http/Kernel.php
#	app/Infrastructure/Http/Requests/UserRequest.php
#	database/factories/UserFactory.php
#	database/seeders/DatabaseSeeder.php
#	routes/web.php
#	tests/Feature/UserTest.php

app/Eloquent/Observers/VacationRequestObserver.php

@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Toby\Eloquent\Observers;
+
+use Illuminate\Contracts\Auth\Factory as Auth;
+use Illuminate\Events\Dispatcher;
+use Toby\Domain\Enums\VacationRequestState;
+use Toby\Domain\Events\VacationRequestStateChanged;
+use Toby\Eloquent\Models\User;
+use Toby\Eloquent\Models\VacationRequest;
+
+class VacationRequestObserver
+{
+    public function __construct(
+        protected Auth $auth,
+        protected Dispatcher $dispatcher,
+    ) {
+    }
+
+    public function creating(VacationRequest $vacationRequest): void
+    {
+        $year = $vacationRequest->from->year;
+
+        $vacationRequestNumber = $vacationRequest->user->vacationRequests()
+            ->whereYear("from", $year)
+            ->count() + 1;
+
+        $vacationRequest->name = "{$vacationRequestNumber}/${year}";
+    }
+
+    public function saved(VacationRequest $vacationRequest): void
+    {
+        if ($vacationRequest->isDirty("state")) {
+            $previousState = $vacationRequest->getOriginal("state");
+
+            $this->fireStateChangedEvent($vacationRequest, $previousState, $vacationRequest->state);
+        }
+    }
+
+    protected function fireStateChangedEvent(
+        VacationRequest $vacationRequest,
+        ?VacationRequestState $from,
+        VacationRequestState $to,
+    ): void {
+        $event = new VacationRequestStateChanged($vacationRequest, $from, $to, $this->getAuthUser());
+
+        $this->dispatcher->dispatch($event);
+    }
+
+    protected function getAuthUser(): ?User
+    {
+        /** @var User $user */
+        $user = $this->auth->guard()->user();
+
+        return $user;
+    }
+}