افزودن فیلد شبکه‌های اجتماعی به Clinic

پروژه

clinicpro (Backend) — پیش‌نیاز پرامپت همتا در frontend: nobat724_front/.claude/prompt/clinic-seo-schema-knowledge-panel.md. آن پرامپت برای Knowledge Panel گوگل به sameAs در JSON-LD نیاز دارد که از همین فیلد جدید پر می‌شود.

این تغییر دقیقاً همان الگویی است که قبلاً برای Doctor entity پیاده‌سازی شده (clinicpro/.claude/prompt/doctor-social-media-field.md — قبلاً اجرا و merge شده). همان ساختار را برای Clinic تکرار کن.

زمینه

بررسی src/Clinic/Entity/Clinic.php و docs/api/clinic.md نشان داد کلینیک هیچ فیلد شبکه‌اجتماعی ندارد. کلینیک از قبل latitude/longitude/address/telephone/working_days/is247 مستقیم روی خودش دارد (برخلاف Doctor که این‌ها در یک entity جدا — DoctorAddress — هستند)، پس برای کلینیک نیازی به fetch جدا نیست؛ فقط socialMedia کم است.

مشکل / هدف

به Clinic entity یک فیلد JSON برای لینک شبکه‌های اجتماعی (اینستاگرام، تلگرام، آپارات، یوتیوب، لینکدین) اضافه شود، در پاسخ API برگردانده شود، و قابل ویرایش باشد.

فایل‌های مرتبط

فایل	نقش
`src/Clinic/Entity/Clinic.php`	فیلد `socialMedia` (JSON nullable) — دقیقاً کنار `imagesClinic` (خط ۷۱)
`src/Clinic/Controller/ClinicController.php`	متد `update()` (خط ۲۰۵) باید فیلد را بپذیرد و validate کند؛ `toDetailArray()`/`toListArray()` در entity باید آن را برگردانند
`migrations/`	migration جدید برای ستون `social_media` روی جدول `clinics`
`docs/api/clinic.md`	مستندسازی فیلد جدید

وضعیت فعلی

src/Clinic/Entity/Clinic.php الگوی دقیق برای فیلد JSON nullable از قبل دارد:

// خط ۷۱ — الگوی موجود
private ?array $imagesClinic = null;

// خط ۱۴۴
public function getImagesClinic(): ?array { return $this->imagesClinic; }

// خط ۱۷۶
public function setImagesClinic(?array $v): self { $this->imagesClinic = $v; $this->touch(); return $this; }

وظایف

۱. افزودن فیلد `socialMedia`

// src/Clinic/Entity/Clinic.php — کنار imagesClinic
#[ORM\Column(name: 'social_media', type: 'json', nullable: true)]
private ?array $socialMedia = null;

public function getSocialMedia(): ?array { return $this->socialMedia; }
public function setSocialMedia(?array $v): self { $this->socialMedia = $v; $this->touch(); return $this; }

ساختار JSON (دقیقاً مشابه Doctor):

{
  "instagram": "https://instagram.com/clinic.example",
  "telegram": "https://t.me/clinic_example",
  "aparat": null,
  "youtube": null,
  "linkedin": null
}

۲. اضافه‌کردن به خروجی `toDetailArray()` و `toListArray()`

در Clinic.php، هرجا images_clinic در آرایه‌ی خروجی است، social_media هم کنارش اضافه شود — هم در toDetailArray() (خط ۱۸۲) هم در toListArray() (خط ۲۲۴، اگر لیست هم باید نشانش بدهد؛ در غیر این صورت فقط در toDetailArray() کافی است چون JSON-LD فقط در صفحه‌ی تکی کلینیک لازم است).

۳. Migration

ddev exec php bin/console doctrine:migrations:diff --no-interaction
ddev exec php bin/console doctrine:migrations:migrate --no-interaction

۴. پذیرش در `ClinicController::update()`

در متد update() (خط ۲۰۵)، همان الگوی validation که در DoctorController::hydrateDoctor() برای social_media استفاده شد را تکرار کن (filter_var($value, FILTER_VALIDATE_URL) برای هر کلید، در غیر این صورت null):

if (array_key_exists('social_media', $data) && is_array($data['social_media'])) {
    $allowedKeys = ['instagram', 'telegram', 'aparat', 'youtube', 'linkedin'];
    $socialMedia = [];
    foreach ($allowedKeys as $key) {
        $value = $data['social_media'][$key] ?? null;
        $socialMedia[$key] = (is_string($value) && filter_var($value, FILTER_VALIDATE_URL))
            ? $value
            : null;
    }
    $clinic->setSocialMedia($socialMedia);
}

بررسی کن این منطق دقیقاً کجای متد update() باید قرار گیرد (کنار جایی که imagesClinic/فیلدهای دیگر از $data خوانده می‌شوند).

نکات مهم

این فیلد nullable کامل است — کلینیک‌هایی بدون شبکه‌اجتماعی نباید خطا بگیرند.
اگر در پنل ادمین (assets/admin/) فرم ویرایش کلینیک وجود دارد، در صورت وقت یک بخش مشابه فرم شبکه‌اجتماعی Doctor (در DoctorDetailPage.tsx) برایش اضافه کن؛ این بخش اختیاری است و در صورت نبود وقت می‌توان frontend عمومی (nobat724_front) را بدون این بخش هم اجرا کرد (فیلد در دیتابیس و API آماده می‌ماند، فقط فعلاً از پنل قابل تنظیم نیست).
بعد از تغییر، docs/api/clinic.md را در همان session به‌روزرسانی کن (نمونه‌ی JSON پاسخ + جدول فیلدهای قابل ویرایش در POST/PATCH).

5.6 KiB Raw Permalink Blame History Unescape Escape