From 6e0be3dbf39dcb309ae5292cb0839fb2a820bba9 Mon Sep 17 00:00:00 2001
From: Matthieu <mtholot19@gmail.com>
Date: Fri, 13 Mar 2026 13:47:59 +0100
Subject: [PATCH] feat(sync) : add DTOs and SyncStrategyInterface

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 src/DTO/SyncConfirmation.php               | 13 ++++++++
 src/DTO/SyncExecutionResult.php            | 27 +++++++++++++++
 src/DTO/SyncPreviewResult.php              | 38 ++++++++++++++++++++++
 src/Service/Sync/SyncStrategyInterface.php | 27 +++++++++++++++
 4 files changed, 105 insertions(+)
 create mode 100644 src/DTO/SyncConfirmation.php
 create mode 100644 src/DTO/SyncExecutionResult.php
 create mode 100644 src/DTO/SyncPreviewResult.php
 create mode 100644 src/Service/Sync/SyncStrategyInterface.php

diff --git a/src/DTO/SyncConfirmation.php b/src/DTO/SyncConfirmation.php
new file mode 100644
index 0000000..87b8606
--- /dev/null
+++ b/src/DTO/SyncConfirmation.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\DTO;
+
+class SyncConfirmation
+{
+    public function __construct(
+        public readonly bool $confirmDeletions = false,
+        public readonly bool $confirmTypeChanges = false,
+    ) {}
+}
diff --git a/src/DTO/SyncExecutionResult.php b/src/DTO/SyncExecutionResult.php
new file mode 100644
index 0000000..d0cfdb0
--- /dev/null
+++ b/src/DTO/SyncExecutionResult.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\DTO;
+
+use JsonSerializable;
+
+class SyncExecutionResult implements JsonSerializable
+{
+    public function __construct(
+        public readonly int $itemsUpdated,
+        public readonly array $additions = [],
+        public readonly array $deletions = [],
+        public readonly array $modifications = [],
+    ) {}
+
+    public function jsonSerialize(): array
+    {
+        return [
+            'itemsUpdated'  => $this->itemsUpdated,
+            'additions'     => $this->additions,
+            'deletions'     => $this->deletions,
+            'modifications' => $this->modifications,
+        ];
+    }
+}
diff --git a/src/DTO/SyncPreviewResult.php b/src/DTO/SyncPreviewResult.php
new file mode 100644
index 0000000..62bd20e
--- /dev/null
+++ b/src/DTO/SyncPreviewResult.php
@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\DTO;
+
+use JsonSerializable;
+
+class SyncPreviewResult implements JsonSerializable
+{
+    public function __construct(
+        public readonly string $modelTypeId,
+        public readonly string $category,
+        public readonly int $itemCount,
+        public readonly array $additions = [],
+        public readonly array $deletions = [],
+        public readonly array $modifications = [],
+    ) {}
+
+    public function hasImpact(): bool
+    {
+        return array_sum($this->additions) > 0
+            || array_sum($this->deletions) > 0
+            || array_sum($this->modifications) > 0;
+    }
+
+    public function jsonSerialize(): array
+    {
+        return [
+            'modelTypeId'   => $this->modelTypeId,
+            'category'      => $this->category,
+            'itemCount'     => $this->itemCount,
+            'additions'     => $this->additions,
+            'deletions'     => $this->deletions,
+            'modifications' => $this->modifications,
+        ];
+    }
+}
diff --git a/src/Service/Sync/SyncStrategyInterface.php b/src/Service/Sync/SyncStrategyInterface.php
new file mode 100644
index 0000000..18f6ae6
--- /dev/null
+++ b/src/Service/Sync/SyncStrategyInterface.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service\Sync;
+
+use App\DTO\SyncConfirmation;
+use App\DTO\SyncExecutionResult;
+use App\DTO\SyncPreviewResult;
+use App\Entity\ModelType;
+
+interface SyncStrategyInterface
+{
+    public function supports(ModelType $modelType): bool;
+
+    /**
+     * Compute diff between proposed structure and current items' slots.
+     * Does NOT persist anything.
+     */
+    public function preview(ModelType $modelType, array $newStructure): SyncPreviewResult;
+
+    /**
+     * Apply sync: compare current skeleton requirements (already persisted)
+     * with items' slots and add/remove as needed.
+     */
+    public function execute(ModelType $modelType, SyncConfirmation $confirmation): SyncExecutionResult;
+}