feat: enhance doctor import process with source profile ID for improved idempotency and deduplication

src/Doctor/Entity/Doctor.php

@@ -20,6 +20,7 @@ use Symfony\Component\Uid\Uuid;
 #[ORM\Table(name: 'doctors')]
 #[ORM\UniqueConstraint(name: 'idx_doctors_user', columns: ['user_id'])]
 #[ORM\UniqueConstraint(name: 'uniq_doctors_source_code', columns: ['source', 'medical_system_code'])]
+#[ORM\UniqueConstraint(name: 'uniq_doctors_source_profile', columns: ['source', 'source_profile_id'])]
 #[ORM\Index(columns: ['active_doctor_appointment'], name: 'idx_doctors_active')]
 #[ORM\Index(columns: ['owner_status'], name: 'idx_doctors_owner')]
 class Doctor
@@ -94,6 +95,11 @@ class Doctor
     #[ORM\Column(name: 'source_ref', type: 'string', length: 100, nullable: true)]
     private ?string $sourceRef = null;
 
+    // شناسهٔ پایدارِ پروفایل مبدأ (UUID داخل source_ref) — شناسهٔ authoritative نظام
+    // پزشکی و کلید اصلی idempotency: یک پروفایل هرگز دو رکورد نمی‌سازد حتی اگر کدش عوض شود.
+    #[ORM\Column(name: 'source_profile_id', type: 'string', length: 36, nullable: true)]
+    private ?string $sourceProfileId = null;
+
     // شناسه کاربری که این پروفایلِ بدون‌مالک را وارد/مدیریت کرده (مثلاً کاربر سیستمی)
     #[ORM\Column(name: 'managed_by', type: 'integer', nullable: true)]
     private ?int $managedBy = null;
@@ -238,6 +244,10 @@ class Doctor
     {
         return $this->sourceRef;
     }
+    public function getSourceProfileId(): ?string
+    {
+        return $this->sourceProfileId;
+    }
     public function getManagedBy(): ?int
     {
         return $this->managedBy;
@@ -377,6 +387,12 @@ class Doctor
         $this->touch();
         return $this;
     }
+    public function setSourceProfileId(?string $v): self
+    {
+        $this->sourceProfileId = $v;
+        $this->touch();
+        return $this;
+    }
     public function setManagedBy(?int $v): self
     {
         $this->managedBy = $v;