# SEO پیشرفته صفحه پزشک: Schema کامل، Sitelinks، Knowledge Panel، Local SEO

## پروژه

`nobat724_front` — این پرامپت برای فعال‌سازی Sitelinks و Knowledge Panel گوگل برای صفحه‌ی هر پزشک است (هدف: نتیجه‌ی جستجوی نام پزشک شبیه نتایج Zocdoc/Healthgrades با Knowledge Panel، عکس، شبکه‌های اجتماعی، آدرس، ساعات کاری، امتیاز).

**وابستگی cross-repo:** فیلد `socialMedia` پزشک هنوز در backend وجود ندارد — پرامپت همتا در `clinicpro/.claude/prompt/doctor-social-media-field.md` این فیلد را اضافه می‌کند. **آن پرامپت را اول اجرا کن**، سپس این یکی را، چون بخش‌های `sameAs` JSON-LD و کارت شبکه‌های اجتماعی در UI به آن فیلد نیاز دارند. اگر هنوز اجرا نشده، آن بخش‌ها را با حالت "اگر `doctor.socialMedia` وجود داشت" مشروط بنویس تا بدون خطا گریسفول fallback شود.

## زمینه

بررسی کد واقعی نشان داد:
- `app/doctor/[slug]/page.js` فعلاً فقط schema `Physician` ساده (نام، تخصص، عکس، آدرس متنی) و یک `BreadcrumbList` دارد.
- داده‌ی واقعی API (`docs/api/doctor.md`) شامل: `point`/`satisfaction` (امتیاز و رضایت، می‌تواند `AggregateRating` شود)، چندین `address[]` با `clinics[]` (هرکدام `name`/`address`/`telephone`)، اما این آرایه مستقیماً در `getDoctor()` فعلی fetch نمی‌شود (endpoint جدا: `GET /api/v1/clinic-pro/doctor-addresses/{doctorId}` که `map.latitude`/`map.longitude` هم دارد).
- نظرات از `GET /api/v1/comments/{uuid}` می‌آید (`comments` در کامپوننت `Doctor()`) — می‌تواند منبع `Review` schema باشد.
- مقالات/پرسش‌و‌پاسخ پزشک در حال حاضر در هیچ‌جای کد دیده نشد — این پروژه فعلاً **مقاله یا FAQ مرتبط به پزشک خاص ندارد** (فقط `app/blogs`/`app/blog/[slug]` عمومی است، بدون ارتباط به یک پزشک مشخص). بخش‌های مرتبط با Article/FAQPage در این پرامپت را فقط برای ساختار سایت عمومی (نه per-doctor) طراحی کن، مگر اینکه در حین اجرا API برای FAQ پزشک پیدا شود.

## مشکل / هدف

برای `app/doctor/[slug]/page.js` (و در حد لازم `app/doctors/page.js`, `app/clinics/page.js`, `app/sitemap.js`, `app/robots.js`, `app/layout.js`) موارد زیر اضافه/تکمیل شود:
1. Schema.org کامل‌تر برای پزشک (Physician + AggregateRating + Review + LocalBusiness برای هر مطب + ImageObject + sameAs)
2. Sitemap تفکیک‌شده (پزشکان، شهرها، تخصص‌ها، مقالات) به‌جای فایل واحد فعلی
3. ساختار URL/Internal Linking برای افزایش شانس Sitelinks
4. متادیتای دقیق‌تر هماهنگ با Knowledge Panel

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

| فایل | نقش فعلی | تغییر لازم |
|------|----------|------------|
| `app/doctor/[slug]/page.js` | `getDoctor()` با `cache()`، schema `Physician` ساده، breadcrumb | افزودن AggregateRating, Review, LocalBusiness(×N مطب), ImageObject, sameAs؛ fetch کردن آدرس‌های مطب |
| `components/doctor/index.js` | رندر breadcrumb بصری (تخصص > نام) - قبلاً به Link تبدیل شده | بدون تغییر مگر اضافه‌کردن نمایش شبکه‌های اجتماعی اگر `doctor.socialMedia` وجود داشت |
| `app/sitemap.js` | یک فایل واحد، `getDoctorUrls`/`getClinicUrls`/`getBlogUrls` با `fetch` + `revalidate: 3600` | تفکیک به چند sitemap با `app/sitemap/[id]/route.js` یا multi-sitemap pattern رسمی Next.js 15 (`generateSitemaps`) |
| `app/robots.js` | `disallow: '/dashboard'` فقط؛ از `DEV_MODE` می‌خواند | اضافه‌کردن `/panel` به disallow؛ بدون تغییر در منطق DEV_MODE |
| `app/layout.js` | JSON-LD سراسری `Organization` + `WebSite` با `SearchAction` | بررسی کن `sameAs` سازمانی (لینک شبکه‌های اجتماعی نوبت724، نه پزشک) باید اینجا اضافه شود اگر `data/city.json` چنین داده‌ای دارد |
| `clinicpro/docs/api/doctor.md` | مرجع شکل دقیق پاسخ API | فقط مرجع خوانده شود، تغییر ندهید (این فایل پروژه backend است) |

## وضعیت فعلی

### `app/doctor/[slug]/page.js` — schema فعلی (ناقص)

```js
const jsonLd = doctor
  ? {
      "@context": "https://schema.org",
      "@type": "Physician",
      name: `دکتر ${doctor.name}`,
      ...(specialtyNames && { medicalSpecialty: specialtyNames }),
      ...(doctor.img && { image: doctor.img }),
      ...(doctor.address && {
        address: {
          "@type": "PostalAddress",
          streetAddress: doctor.address,
        },
      }),
    }
  : null;
```

مشکلات این بلوک:
- `image` باید `ImageObject` کامل (با `url`, `width`, `height`) باشد، نه رشته‌ی خام.
- `address` فقط یک متن ساده است؛ مطب‌های واقعی پزشک (با مختصات جغرافیایی) اصلاً fetch نمی‌شوند در این صفحه.
- بدون `aggregateRating`، بدون `review`، بدون `sameAs`، بدون `telephone`.
- `doctor.point`/`doctor.satisfaction` (که در پاسخ API موجود است طبق `docs/api/doctor.md`) استفاده نمی‌شوند.

### `app/sitemap.js` — فعلاً یک فایل واحد

```js
export default async function sitemap() {
    try {
        const domain = getCurrentDomain();
        const baseUrl = getBaseUrl(domain);
        const [staticPages, doctorUrls, clinicUrls, blogUrls] = await Promise.all([
            Promise.resolve(getStaticPages(baseUrl)),
            getDoctorUrls(baseUrl),
            getClinicUrls(baseUrl),
            getBlogUrls(baseUrl),
        ]);
        const allUrls = [...staticPages, ...doctorUrls, ...clinicUrls, ...blogUrls];
        return allUrls.filter(/* dedupe */);
    } catch { return []; }
}
```

این تابع همه‌چیز را در یک فایل XML واحد می‌ریزد (`getDoctorUrls` با `limit=500`). اگر تعداد پزشکان از ۵۰هزار بیشتر شود (محدودیت گوگل برای یک sitemap)، باید چندتایی شود — Next.js 15 از `generateSitemaps()` پشتیبانی می‌کند.

## وظایف

### ۱. Schema.org کامل برای صفحه پزشک

در `app/doctor/[slug]/page.js`، fetch آدرس‌های مطب را اضافه کن (مشابه الگوی موجود `getDoctor`):

```js
const getDoctorAddresses = cache(async (doctorId) => {
  try {
    const res = await fetch(`${API_URL}/api/v1/clinic-pro/doctor-addresses/${doctorId}`, {
      next: { revalidate: 3600, tags: [`doctor-addresses-${doctorId}`] },
    });
    if (!res.ok) return [];
    const json = await res.json();
    return json?.data ?? [];
  } catch {
    return [];
  }
});
```

سپس در کامپوننت `Doctor()`، schema را به این شکل بازنویسی کن:

```js
const addresses = doctor ? await getDoctorAddresses(doctor.id) : [];

const jsonLd = doctor
  ? {
      "@context": "https://schema.org",
      "@type": "Physician",
      "@id": `https://www.nobat724.com/doctor/${doctor.uuid}#physician`,
      name: `دکتر ${doctor.name}`,
      url: `https://www.nobat724.com/doctor/${doctor.uuid}`,
      ...(specialtyNames && { medicalSpecialty: specialtyNames }),
      ...(doctor.img && {
        image: {
          "@type": "ImageObject",
          url: imageUrl(doctor.img),
        },
      }),
      ...(doctor.point && Number(doctor.point) > 0 && {
        aggregateRating: {
          "@type": "AggregateRating",
          ratingValue: doctor.point,
          bestRating: "5",
          ratingCount: comments?.length || 1,
        },
      }),
      ...(comments?.length > 0 && {
        review: comments.slice(0, 5).map((c) => ({
          "@type": "Review",
          author: { "@type": "Person", name: c.author || "بیمار" },
          reviewBody: c.text || c.body,
          ...(c.rate && {
            reviewRating: { "@type": "Rating", ratingValue: c.rate, bestRating: "5" },
          }),
        })),
      }),
      ...(doctor.socialMedia && {
        sameAs: Object.values(doctor.socialMedia).filter(Boolean),
      }),
      ...(addresses.length > 0 && {
        workLocation: addresses.map((addr) => ({
          "@type": "MedicalClinic",
          name: addr.clinic_name || addr.name || `مطب دکتر ${doctor.name}`,
          address: {
            "@type": "PostalAddress",
            streetAddress: addr.address,
          },
          ...(addr.telephone && { telephone: addr.telephone }),
          ...(addr.map?.latitude && addr.map?.longitude && {
            geo: {
              "@type": "GeoCoordinates",
              latitude: addr.map.latitude,
              longitude: addr.map.longitude,
            },
          }),
        })),
      }),
    }
  : null;
```

**نکته مهم:** بررسی کن فیلد دقیق rate در `comments[]` (نام فیلد امتیاز هر نظر) چیست — در `docs/api/doctor.md` این جزئیات مشخص نشده، باید با `console.log` یا بررسی `docs/api/rating.md` (اگر در backend وجود دارد) دقیق کنی، فرضیات بالا (`c.rate`, `c.text`, `c.author`) را verify کن قبل از commit.

### ۲. Sitemap تفکیک‌شده

`app/sitemap.js` فعلی را به ساختار چندتایی Next.js 15 تبدیل کن. ساختار پیشنهادی:

```
app/
  sitemap.js                  # index — فقط static pages (home, about, contact, specialties)
  doctor/sitemap.js           # generateSitemaps() برای پزشکان، یکی به ازای هر 1000 پزشک
  clinic/sitemap.js           # همین الگو برای کلینیک‌ها
  blog/sitemap.js             # همین الگو برای مقالات
```

نمونه برای `app/doctor/sitemap.js` (الگوی رسمی Next.js 15 برای sitemap چندتایی):

```js
export async function generateSitemaps() {
  // اگر تعداد پزشکان مشخص نیست، یک تخمین اولیه برگردان (مثلاً بر اساس count از API)
  const res = await fetch(`${process.env.NEXT_PUBLIC_API_URL}/api/v1/doctors?page=1&limit=1`, {
    next: { revalidate: 86400 },
  });
  const json = await res.json();
  const total = json?.meta?.totalRecords || 0;
  const pageCount = Math.ceil(total / 1000);
  return Array.from({ length: pageCount }, (_, i) => ({ id: i }));
}

export default async function sitemap({ id }) {
  const API_URL = process.env.NEXT_PUBLIC_API_URL;
  const res = await fetch(`${API_URL}/api/v1/doctors?page=${id + 1}&limit=1000`, {
    next: { revalidate: 3600 },
  });
  if (!res.ok) return [];
  const json = await res.json();
  const doctors = json?.data || [];
  return doctors
    .filter((d) => d?.uuid)
    .map((d) => ({
      url: `https://www.nobat724.com/doctor/${d.uuid}`,
      lastModified: new Date(),
      changeFrequency: "weekly",
      priority: 0.8,
    }));
}
```

همین الگو را برای `clinic` و `blog` تکرار کن. `app/sitemap.js` اصلی فقط صفحات ایستا (`/`, `/about-us`, `/contact-us`, `/specialties`, `/doctors`, `/clinics`, `/blogs`) را برمی‌گرداند — منطق `getStaticPages()` موجود قابل reuse است، فقط `getDoctorUrls`/`getClinicUrls`/`getBlogUrls` از این فایل حذف و به فایل‌های جدید منتقل می‌شوند.

**نکته مهم:** صفحات تخصص (`?specialty=`) و شهر (subdomain) در حال حاضر URL مجزا با path ندارند (فیلتر با query param است) — اضافه‌کردن این‌ها به sitemap به‌صورت URL جدا (`/doctors?specialty=X`) ارزش SEO کمی دارد چون گوگل query-param URLها را با اولویت پایین‌تر می‌بیند. اگر می‌خواهی این بخش (URL Structure برای تخصص/شهر به‌صورت path-based مثل `/doctors/tehran/cardiology`) را هم پیاده‌سازی کنی، این یک تغییر بزرگ‌تر در routing است که باید جدا و با تأیید قبلی انجام شود — در این پرامپت فقط طراحی پیشنهادی را در بخش «نکات مهم» مستند کن، کد routing را عوض نکن مگر کاربر صریحاً بخواهد.

### ۳. به‌روزرسانی `robots.js`

```js
return {
    rules: {
        userAgent: '*',
        allow: '/',
        disallow: ['/dashboard', '/panel'],
    },
    sitemap: `${baseUrl}/sitemap.xml`,
};
```

### ۴. کارت شبکه‌های اجتماعی در UI (مشروط به وجود فیلد backend)

در `components/doctor/detailDoctor/` (بررسی فایل‌های موجود مثل `Share.js`) یک بخش کوچک برای نمایش آیکون‌های شبکه‌اجتماعی پزشک اضافه کن، فقط اگر `doctor.socialMedia` مقدار غیر-null داشت:

```jsx
{doctor?.socialMedia && Object.entries(doctor.socialMedia).some(([, v]) => v) && (
  <div className="flex items-center gap-2">
    {doctor.socialMedia.instagram && (
      <a href={doctor.socialMedia.instagram} target="_blank" rel="noopener noreferrer">
        <InstagramIcon />
      </a>
    )}
    {/* تکرار برای telegram, aparat, youtube, linkedin */}
  </div>
)}
```

آیکون‌های لازم را در `components/icons/` بررسی کن — اگر آیکون اینستاگرام/تلگرام/آپارات/یوتیوب از قبل وجود ندارد، SVG ساده اضافه کن (الگوی فایل‌های موجود در همان پوشه را دنبال کن).

## نکات مهم

- **هیچ تغییری در `services/api.js`/`services/response.js` (مسیر axios سمت کلاینت) ندهی** مگر برای `socialMedia` که نیاز به submit از فرم ادمین دارد (آن فرم در `clinicpro` است، نه اینجا).
- چون پروژه فعلاً مقاله/FAQ مرتبط به پزشک خاص ندارد، schema‌های `FAQPage` و `Article`/`BlogPosting` per-doctor را در این مرحله پیاده‌سازی نکن — فقط طراحی پیشنهادی (در صورت افزودن این قابلیت در آینده) را در پایان فایل توضیح بده، کد واقعی برایش ننویس.
- صفحه `app/clinic/[slug]/page.js` می‌تواند schema مشابه (`MedicalClinic` با `aggregateRating`/`geo`) بگیرد — اگر وقت بود همان الگوی schema پزشک را برای کلینیک هم تکرار کن، اما اولویت اول صفحه پزشک است.
- بعد از هر تغییر در `app/doctor/[slug]/page.js`، تست کن خروجی JSON-LD نهایی valid باشد — از Google Rich Results Test (به‌صورت دستی، نه خودکار در این session) یا حداقل `JSON.parse(JSON.stringify(jsonLd))` بدون خطا.
- پس از تغییرات، حتماً `npm run build` را اجرا کن — مسیرهای جدید sitemap (`app/doctor/sitemap.js` و غیره) باید بدون خطا کامپایل شوند و در خروجی build به‌عنوان route مجزا دیده شوند.
- اگر در حین اجرا متوجه شدی پرامپت backend (`doctor-social-media-field.md`) هنوز اجرا نشده، بخش‌های `sameAs`/کارت شبکه‌های اجتماعی را با گارد `doctor?.socialMedia &&` (که در کد بالا هم رعایت شده) بدون خطا skip کن — منتظر آن پرامپت نمان.
