From 7ab91cc77d8372207c77bcff766f119c27296196 Mon Sep 17 00:00:00 2001
From: florentdevk <florentdevk@gmail.com>
Date: Wed, 1 Jul 2026 21:06:13 +0200
Subject: [PATCH] feat(application): add StartGame command, handler and
 GameRepository interface

---
 .../Command/StartGame/StartGameCommand.php    |  9 +++++
 .../Command/StartGame/StartGameHandler.php    | 27 +++++++++++++
 .../Repository/GameRepositoryInterface.php    | 15 +++++++
 .../StartGame/StartGameHandlerTest.php        | 39 +++++++++++++++++++
 4 files changed, 90 insertions(+)
 create mode 100644 src/Chess/Application/Command/StartGame/StartGameCommand.php
 create mode 100644 src/Chess/Application/Command/StartGame/StartGameHandler.php
 create mode 100644 src/Chess/Domain/Repository/GameRepositoryInterface.php
 create mode 100644 tests/Chess/Application/Command/StartGame/StartGameHandlerTest.php

diff --git a/src/Chess/Application/Command/StartGame/StartGameCommand.php b/src/Chess/Application/Command/StartGame/StartGameCommand.php
new file mode 100644
index 0000000..3842b6d
--- /dev/null
+++ b/src/Chess/Application/Command/StartGame/StartGameCommand.php
@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Chess\Application\Command\StartGame;
+
+final class StartGameCommand
+{
+}
diff --git a/src/Chess/Application/Command/StartGame/StartGameHandler.php b/src/Chess/Application/Command/StartGame/StartGameHandler.php
new file mode 100644
index 0000000..5111a16
--- /dev/null
+++ b/src/Chess/Application/Command/StartGame/StartGameHandler.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Chess\Application\Command\StartGame;
+
+use Chess\Domain\Model\Game;
+use Chess\Domain\Repository\GameRepositoryInterface;
+use Chess\Domain\Value\GameId;
+use Symfony\Component\Messenger\Attribute\AsMessageHandler;
+
+#[AsMessageHandler(bus: 'command.bus')]
+final class StartGameHandler
+{
+    public function __construct(
+        private readonly GameRepositoryInterface $repository,
+    ) {
+    }
+
+    public function __invoke(StartGameCommand $command): GameId
+    {
+        $game = Game::start();
+        $this->repository->save($game);
+
+        return $game->id();
+    }
+}
diff --git a/src/Chess/Domain/Repository/GameRepositoryInterface.php b/src/Chess/Domain/Repository/GameRepositoryInterface.php
new file mode 100644
index 0000000..aa2d099
--- /dev/null
+++ b/src/Chess/Domain/Repository/GameRepositoryInterface.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Chess\Domain\Repository;
+
+use Chess\Domain\Model\Game;
+use Chess\Domain\Value\GameId;
+
+interface GameRepositoryInterface
+{
+    public function save(Game $game): void;
+
+    public function findById(GameId $id): ?Game;
+}
diff --git a/tests/Chess/Application/Command/StartGame/StartGameHandlerTest.php b/tests/Chess/Application/Command/StartGame/StartGameHandlerTest.php
new file mode 100644
index 0000000..d4a12dc
--- /dev/null
+++ b/tests/Chess/Application/Command/StartGame/StartGameHandlerTest.php
@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Chess\Tests\Application\Command\StartGame;
+
+use Chess\Application\Command\StartGame\StartGameCommand;
+use Chess\Application\Command\StartGame\StartGameHandler;
+use Chess\Domain\Model\Game;
+use Chess\Domain\Repository\GameRepositoryInterface;
+use Chess\Domain\Value\GameId;
+use PHPUnit\Framework\TestCase;
+
+final class StartGameHandlerTest extends TestCase
+{
+    public function testItCreatesAndSavesAGame(): void
+    {
+        $repository = new class implements GameRepositoryInterface {
+            public ?Game $savedGame = null;
+
+            public function save(Game $game): void
+            {
+                $this->savedGame = $game;
+            }
+
+            public function findById(GameId $id): ?Game
+            {
+                return null;
+            }
+        };
+
+        $handler = new StartGameHandler($repository);
+        $gameId = $handler(new StartGameCommand());
+
+        self::assertInstanceOf(GameId::class, $gameId);
+        self::assertNotNull($repository->savedGame);
+        self::assertSame($gameId->toString(), $repository->savedGame->id()->toString());
+    }
+}