Feat/carte

.gitignore

@@ -1,3 +1,5 @@
 /vendor/
 /.phpunit.cache/
-.php-cs-fixer.cache
+/.phpunit.result.cache
+/phpunit.xml
+.php-cs-fixer.cache

src/Domain/Card.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace App\Domain;
+
+final class Card
+{
+    private const VALID_RANKS = ['2', '3', '4', '5', '6', '7', '8', '9', '10', 'Jack', 'Queen', 'King', 'Ace'];
+    private const VALID_SUITS = ['Hearts', 'Diamonds', 'Clubs', 'Spades'];
+
+    public function __construct(
+        private readonly string $rank,
+        private readonly string $suit,
+    ) {
+        if (!in_array($rank, self::VALID_RANKS, true)) {
+            throw new \InvalidArgumentException("Invalid rank: {$rank}");
+        }
+
+        if (!in_array($suit, self::VALID_SUITS, true)) {
+            throw new \InvalidArgumentException("Invalid suit: {$suit}");
+        }
+    }
+
+    public function numericValue(): int
+    {
+        return match ($this->rank) {
+            'Jack', 'Queen', 'King' => 10,
+            'Ace' => 11,
+            default => (int) $this->rank,
+        };
+    }
+
+    public function rank(): string
+    {
+        return $this->rank;
+    }
+
+    public function suit(): string
+    {
+        return $this->suit;
+    }
+}

tests/Domain/CardTest.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Tests\Domain;
+
+use App\Domain\Card;
+use PHPUnit\Framework\TestCase;
+
+final class CardTest extends TestCase
+{
+    public function testCardHasNumericValue(): void
+    {
+        $card = new Card('7', 'Hearts');
+
+        $this->assertSame(7, $card->numericValue());
+    }
+
+    public function testFaceCardHasNumericValueOf10(): void
+    {
+        $card = new Card('Jack', 'Hearts');
+
+        $this->assertSame(10, $card->numericValue());
+    }
+
+    public function testAceHasNumericValueOf11(): void
+    {
+        $card = new Card('Ace', 'Spades');
+
+        $this->assertSame(11, $card->numericValue());
+    }
+
+    public function testInvalidRankThrowsException(): void
+    {
+        $this->expectException(\InvalidArgumentException::class);
+
+        new Card('invalid', 'Hearts');
+    }
+}