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é

contracts/sales/v1/Api/OrderView.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MiniShop\Contracts\Sales\V1\Api;
+
+/**
+ * Published Language — sales.v1.OrderView
+ * DTO de consultation. Contrat immutable et versionne.
+ */
+final readonly class OrderView
+{
+    /**
+     * @param list<array{productName: string, quantity: int, unitPriceInCents: int, currency: string, lineTotalInCents: int}> $lines
+     */
+    public function __construct(
+        public string $orderId,
+        public string $customerId,
+        public string $status,
+        public int $totalInCents,
+        public string $currency,
+        public array $lines,
+    ) {}
+}

contracts/sales/v1/Event/OrderCancelled.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MiniShop\Contracts\Sales\V1\Event;
+
+/**
+ * Published Language — sales.v1.OrderCancelled
+ * Contrat immutable et versionne. Ne jamais modifier les champs existants.
+ */
+final readonly class OrderCancelled
+{
+    public function __construct(
+        public string $orderId,
+    ) {}
+}

contracts/sales/v1/Event/OrderConfirmed.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MiniShop\Contracts\Sales\V1\Event;
+
+/**
+ * Published Language — sales.v1.OrderConfirmed
+ * Contrat immutable et versionne. Ne jamais modifier les champs existants.
+ */
+final readonly class OrderConfirmed
+{
+    /**
+     * @param list<array{productName: string, quantity: int, unitPriceInCents: int, currency: string}> $lines
+     */
+    public function __construct(
+        public string $orderId,
+        public string $customerId,
+        public int $totalInCents,
+        public string $currency,
+        public array $lines,
+    ) {}
+}

contracts/sales/v1/Event/OrderPlaced.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MiniShop\Contracts\Sales\V1\Event;
+
+/**
+ * Published Language — sales.v1.OrderPlaced
+ * Contrat immutable et versionne. Ne jamais modifier les champs existants.
+ */
+final readonly class OrderPlaced
+{
+    /**
+     * @param list<array{productName: string, quantity: int, unitPriceInCents: int, currency: string}> $lines
+     */
+    public function __construct(
+        public string $orderId,
+        public string $customerId,
+        public int $totalInCents,
+        public string $currency,
+        public string $placedAt,
+        public array $lines,
+    ) {}
+}