feat: unify doctor title handling and enhance specialty selection

- Implemented a helper function `displayDoctorName` to prepend "دکتر" to doctor names for consistent display across the application.
- Updated various components (InviteDoctorModal, DashboardPage, DoctorDetailPage, DoctorsPage, etc.) to utilize the new helper for rendering doctor names.
- Modified the DoctorFormPage to automatically add the "دکتر" title in the UI without requiring user input.
- Fixed the EditSpecialtyPicker component to allow multiple specialty selections, resolving a UI bug where only one specialty could be selected at a time.
- Ensured that the backend strips the "دکتر" title from the name during pre-registration and doctor creation processes.
- Added tests for the new functionality, including checks for title handling and specialty selection logic.
- Updated API documentation to reflect changes in name handling and display logic.

src/Auth/Controller/PreRegistrationController.php

@@ -12,6 +12,7 @@ use App\Doctor\Entity\Doctor;
 use App\Doctor\Repository\DoctorRepository;
 use App\Shared\Captcha\CaptchaGuard;
 use App\Shared\Constant\ErrorCodes;
+use App\Shared\Util\PersianText;
 use App\Shared\Controller\BaseController;
 use App\Sms\Service\SmsService;
 use Doctrine\ORM\EntityManagerInterface;
@@ -46,7 +47,9 @@ class PreRegistrationController extends BaseController
 
         $data   = json_decode($request->getContent(), true) ?? [];
         $type   = trim($data['type']   ?? '');
-        $name   = trim($data['name']   ?? '');
+        // نام هرگز عنوان «دکتر» را در خود ندارد؛ لایهٔ نمایش آن را می‌افزاید. اینجا تمیز
+        // می‌شود تا realName، پزشک و کلینیکِ ساخته‌شده از این درخواست همگی سازگار باشند.
+        $name   = PersianText::stripDoctorTitle(trim($data['name'] ?? ''));
         $mobile = trim($data['mobile'] ?? '');
         $info   = trim($data['info']   ?? '') ?: null;
 

src/Doctor/Entity/Doctor.php

@@ -8,6 +8,7 @@ use App\DoctorService\Entity\DoctorService;
 use App\Location\Entity\City;
 use App\Location\Entity\Province;
 use App\Shared\Util\DisplayName;
+use App\Shared\Util\PersianText;
 use App\Specialty\Entity\Specialty;
 use Doctrine\Common\Collections\ArrayCollection;
 use Doctrine\Common\Collections\Collection;
@@ -553,6 +554,8 @@ class Doctor
             'id'            => (string) $this->id,
             'uuid'          => $this->uuid,
             'name'          => $this->name,
+            // نامِ آمادهٔ نمایش با عنوان «دکتر»؛ name خام می‌ماند (برای فرم ویرایش).
+            'display_name'  => PersianText::withDoctorTitle($this->name),
             'gender'        => $this->gender,
             'degree'        => $this->degree,
             'img'           => $this->images ?? [],
@@ -582,6 +585,8 @@ class Doctor
             'id'                  => (string) $this->id,
             'uuid'                => $this->uuid,
             'name'                => $this->name,
+            // نامِ آمادهٔ نمایش با عنوان «دکتر»؛ name خام می‌ماند (برای فرم ویرایش).
+            'display_name'        => PersianText::withDoctorTitle($this->name),
             'gender'              => $this->gender,
             'experience'          => $this->getExperience(),
             'activity_time'       => $this->activityTime !== null ? (string) $this->activityTime : null,

src/Shared/Util/PersianText.php

@@ -63,4 +63,16 @@ final class PersianText
         // پیشوندهای متوالی «دکتر دکتر …» را هم کامل حذف می‌کند.
         return trim(preg_replace('/^(?:دکتر\s+)+/u', '', $normalized) ?? $normalized);
     }
+
+    /**
+     * نامِ نمایشیِ پزشک با عنوان «دکتر» — تنها نقطهٔ افزودن عنوان در بک‌اند تا همهٔ
+     * مصرف‌کننده‌ها (سایت عمومی، پنل، اپ) یکسان و بدون «دکتر دکتر …» ببینند.
+     * name در دیتابیس خام می‌ماند؛ این فقط برای serialization است.
+     */
+    public static function withDoctorTitle(?string $name): string
+    {
+        $clean = self::stripDoctorTitle((string) ($name ?? ''));
+
+        return $clean === '' ? '' : 'دکتر ' . $clean;
+    }
 }