Step 01 — Published Language

- Extraction des DTOs publics dans contracts/sales/v1/ : OrderPlaced, OrderConfirmed, OrderCancelled, OrderView - NaiveSalesEventPublisher traduit les événements domaine en contrats v1 - Tests de contrat (schéma, sérialisation JSON) pour stabilité du langage publié
2026-03-04 00:29:51 +01:00
parent a4a14e441b
commit 21b8f37411
10 changed files with 358 additions and 19 deletions
--- a/tests/Contract/Sales/v1/OrderPlacedSchemaTest.php
+++ b/tests/Contract/Sales/v1/OrderPlacedSchemaTest.php
@@ -0,0 +1,79 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MiniShop\Tests\Contract\Sales\v1;
+
+use MiniShop\Contracts\Sales\V1\Event\OrderPlaced;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * Tests de stabilite du contrat sales.v1.OrderPlaced.
+ * Garantit que le schema est stable et ne casse pas les consommateurs downstream.
+ */
+final class OrderPlacedSchemaTest extends TestCase
+{
+    public function test_contract_has_required_fields(): void
+    {
+        $event = new OrderPlaced(
+            orderId: 'order-001',
+            customerId: 'cust-001',
+            totalInCents: 3000,
+            currency: 'EUR',
+            placedAt: '2026-01-15T10:30:00+00:00',
+            lines: [
+                ['productName' => 'Widget', 'quantity' => 2, 'unitPriceInCents' => 1500, 'currency' => 'EUR'],
+            ],
+        );
+
+        self::assertSame('order-001', $event->orderId);
+        self::assertSame('cust-001', $event->customerId);
+        self::assertSame(3000, $event->totalInCents);
+        self::assertSame('EUR', $event->currency);
+        self::assertSame('2026-01-15T10:30:00+00:00', $event->placedAt);
+        self::assertCount(1, $event->lines);
+    }
+
+    public function test_contract_serializes_to_stable_json(): void
+    {
+        $event = new OrderPlaced(
+            orderId: 'order-001',
+            customerId: 'cust-001',
+            totalInCents: 3000,
+            currency: 'EUR',
+            placedAt: '2026-01-15T10:30:00+00:00',
+            lines: [
+                ['productName' => 'Widget', 'quantity' => 2, 'unitPriceInCents' => 1500, 'currency' => 'EUR'],
+            ],
+        );
+
+        $json = json_encode($event, JSON_THROW_ON_ERROR);
+        $decoded = json_decode($json, true, flags: JSON_THROW_ON_ERROR);
+
+        self::assertArrayHasKey('orderId', $decoded);
+        self::assertArrayHasKey('customerId', $decoded);
+        self::assertArrayHasKey('totalInCents', $decoded);
+        self::assertArrayHasKey('currency', $decoded);
+        self::assertArrayHasKey('placedAt', $decoded);
+        self::assertArrayHasKey('lines', $decoded);
+    }
+
+    public function test_contract_deserializes_from_json(): void
+    {
+        $json = '{"orderId":"order-001","customerId":"cust-001","totalInCents":3000,"currency":"EUR","placedAt":"2026-01-15T10:30:00+00:00","lines":[{"productName":"Widget","quantity":2,"unitPriceInCents":1500,"currency":"EUR"}]}';
+
+        $decoded = json_decode($json, true, flags: JSON_THROW_ON_ERROR);
+
+        $event = new OrderPlaced(
+            orderId: $decoded['orderId'],
+            customerId: $decoded['customerId'],
+            totalInCents: $decoded['totalInCents'],
+            currency: $decoded['currency'],
+            placedAt: $decoded['placedAt'],
+            lines: $decoded['lines'],
+        );
+
+        self::assertSame('order-001', $event->orderId);
+        self::assertSame(3000, $event->totalInCents);
+    }
+}