feat: enhance SEO for listing and specialty pages, fix search autocomplete issue

2026-07-20 10:26:03 +03:30
parent 9011b230b3
commit 30c3fe8637
14 changed files with 460 additions and 69 deletions
@@ -0,0 +1,251 @@
+# اصلاحات Nobat724: رفع خطای جستجوی پزشک + بهینه‌سازی SEO صفحات لیست و تخصص
+
+## پروژه
+
+`nobat724_front`
+
+> این پرامپت جایگزین `fix-search-autocomplete-doctor-name.md` است (تسک ۱ همان باگ را پوشش می‌دهد) و چهار تسک SEO را هم اضافه می‌کند. هر تسک مستقل است؛ می‌توانی جدا کامیت کنی.
+
+## زمینه
+
+سایت عمومی نوبت‌دهی چند-دامنه‌ای (هر شهر یک دامنه، مثل `yasuj-nobat.ir`، و دامنهٔ ریشه `nobat724.com`). پنج اصلاح لازم است: یک باگ جستجوی UI و چهار مورد بهینه‌سازی SEO روی صفحات لیست پزشکان و صفحات فرود تخصص.
+
+---
+
+## تسک ۱ — رفع خطای `getOptionLabel` در جستجوی نام پزشک
+
+### مشکل
+
+در صفحهٔ اصلی، تایپ «دکتر مهدیه» در باکس جستجو این ارور را می‌دهد:
+
+```
+MUI: The `getOptionLabel` method of Autocomplete returned undefined instead of a string for "دکتر مهدیه".
+```
+
+علت: `Autocomplete` با `freeSolo` رندر شده و `options={specialtiesData}` (اشیاء تخصص با فیلد `name`). وقتی کاربر متنی تایپ می‌کند که در options نیست، MUI مقدار تایپ‌شده را به‌صورت **رشته** به `getOptionLabel` می‌دهد؛ `"دکتر مهدیه".name` می‌شود `undefined`. دیتای `specialties.json` سالم است (هر ۹۳ آیتم `name` دارند) — منشأ ارور رشتهٔ freeSolo است، نه آیتم بدون name.
+
+### فایل
+
+`components/searchHead/smSearch/AutoCompleteSearch.js`
+
+### وضعیت فعلی
+
+```jsx
+getOptionLabel={(option) => option.name}          // خط ۲۷ — روی رشته می‌شکند
+...
+onChange={(_, newValue) => {
+  setSelectedOption && setSelectedOption(newValue);
+  handleSearch(newValue ? newValue.name : "");    // خط ۳۶ — newValue می‌تواند رشته باشد
+}}
+```
+
+### راه‌حل
+
+هر دو نقطه را برای رشتهٔ freeSolo امن کن؛ همیشه string برگردان:
+
+```jsx
+getOptionLabel={(option) =>
+  typeof option === "string" ? option : option?.name ?? ""
+}
+...
+onChange={(_, newValue) => {
+  setSelectedOption && setSelectedOption(newValue);
+  const label =
+    typeof newValue === "string" ? newValue : newValue?.name ?? "";
+  handleSearch(label);
+}}
+```
+
+`renderOption` (خط ۳۹–۴۳) فقط برای options واقعی صدا زده می‌شود؛ دست نزن.
+
+### تست
+
+- تایپ «دکتر مهدیه» → بدون ارور؛ کلیک جستجو → هدایت به `/doctors?...name=دکتر مهدیه` (منطق redirect در `components/home/search/RedirectLink.js` از قبل درست است: match نشدن با تخصص → `filters.name`).
+- انتخاب یک تخصص از لیست (مثل «داخلی») → `/doctors?...specialty=داخلی`.
+- خالی‌کردن ورودی → بدون ارور.
+
+---
+
+## تسک ۲ — `noindex, follow` برای همهٔ صفحات جستجوی `/doctors?...`
+
+### هدف
+
+هر `/doctors` که **کوئری‌پارامتر داشته باشد** (`?specialty=`, `?city=`, `?state=`, `?name=`, یا هر ترکیبی) باید `robots: noindex, follow` بگیرد. فقط `/doctors` بدونِ کوئری باید ایندکس شود. دلیل: صفحات جستجو داینامیک و Duplicate/Thin هستند؛ صفحهٔ فرود قابل‌ایندکسِ تخصص باید `/specialties/[slug]` باشد (تسک ۳)، نه `/doctors?specialty=`.
+
+### فایل
+
+`lib/listingRobots.js` (توسط `app/doctors/page.js` خط ۲۵ و صفحهٔ `/clinics` مصرف می‌شود).
+
+### وضعیت فعلی
+
+```js
+const USER_FILTER_KEYS = ["specialty", "gender", "degree", "active", "sort"];
+
+export function listingRobots(params, { matchedCity, matchedState } = {}) {
+  if (params?.name) return { robots: { index: false, follow: true } };
+  const activeFilters = USER_FILTER_KEYS.filter((key) => params?.[key]);
+  if (params?.city && params.city !== matchedCity?.name) activeFilters.push("city");
+  if (params?.state && params.state !== matchedState?.name) activeFilters.push("state");
+  if (activeFilters.length >= 2) return { robots: { index: false, follow: true } };
+  return {};
+}
+```
+
+منطق فعلی عمداً «تک‌فیلتر specialty» و «city/state تزریق‌شده از دامنه» را ایندکس‌پذیر نگه می‌داشت. طبق خواستهٔ جدید این رفتار باید عوض شود: **هر کوئری‌پارامتر واقعی → noindex**.
+
+### راه‌حل
+
+منطق را ساده و سخت‌گیرانه کن: اگر بعد از حذف کلیدهای خالی، هیچ پارامتری نمانده → `{}` (ایندکس)؛ در غیر این صورت → `noindex, follow`.
+
+```js
+// هر جستجوی /doctors با کوئری واقعی noindex,follow می‌شود؛ فقط /doctors خام ایندکس.
+export function listingRobots(params) {
+  const hasQuery =
+    params &&
+    Object.entries(params).some(
+      ([, v]) => v !== undefined && v !== null && v !== ""
+    );
+  return hasQuery ? { robots: { index: false, follow: true } } : {};
+}
+```
+
+### نکتهٔ حیاتی — مرز URL vs. فیلترِ سرور
+
+در `app/doctors/page.js` روی دامنهٔ شهری، `city`/`state` **در URL نیستند**؛ سرور آن‌ها را فقط داخل fetch تزریق می‌کند (`newSearchParams`)، ولی `generateMetadata` تابع را با `awaitedParams = await searchParams` (پارامترهای واقعی URL) صدا می‌زند. پس `/doctors` خام روی `yasuj-nobat.ir` همچنان بدون کوئری و **ایندکس‌پذیر** می‌ماند. ✅ قبل از پیاده‌سازی این را در همان فایل تأیید کن (خط ۹–۲۵) که `listingRobots` با پارامترهای خام URL صدا زده می‌شود، نه با `newSearchParams`.
+
+بعد از تغییر امضا (حذف آرگومان دوم)، فراخوان در `app/doctors/page.js` و هر مصرف‌کنندهٔ دیگر (`/clinics`) را هم‌راستا کن — `grep -rn "listingRobots" app` بگیر و همه را بررسی کن.
+
+---
+
+## تسک ۳ — قابل‌ایندکس‌بودن `/specialties` و صفحات تخصص
+
+### وضعیت فعلی (اکثراً درست)
+
+- `app/specialties/page.js` — هیچ override روباتی ندارد → ایندکس‌پذیر. ✅ نیازی به تغییر نیست.
+- `app/specialties/[slug]/page.js` — فقط وقتی `total === 0` است `noindex,follow` می‌دهد (thin content)، وگرنه ایندکس. ✅
+
+فقط قانون تسک ۴ باید به `[slug]` اضافه شود. کاری اضافه در این تسک لازم نیست جز اطمینان از اینکه بعد از تسک ۲، صفحات `/specialties/[child-slug]` (مثل `endourology`, `gastroenterology`) ایندکس‌پذیر می‌مانند.
+
+---
+
+## تسک ۴ — فقط تخصص‌های **فرزند** ایندکس شوند (والدها noindex)
+
+### هدف
+
+تخصص‌های والد (`parent_id === null`، مثل «داخلی») صفحاتشان دسته‌بندی کلی و کم‌محتوا است و با فرزندان در نتایج گوگل رقابت می‌کنند. باید:
+
+- `/specialties/internal-medicine` (والد، `parent_id: null`) → `noindex, follow`
+- `/specialties/gastroenterology` (فرزند، `parent_id: 2`) → `index`
+
+### فایل
+
+`app/specialties/[slug]/page.js` — تابع `generateMetadata` (خط ۴۳–۶۹).
+
+### وضعیت فعلی
+
+```js
+const { total } = await getDoctors(specialty.id, isRoot ? null : matchedCity?.id);
+
+return {
+  title,
+  description,
+  ...(total === 0 && { robots: { index: false, follow: true } }),
+  openGraph: { title, description, images: [image] },
+  twitter: { card: "summary_large_image", title, description, images: [image] },
+};
+```
+
+`specialty` از `findSpecialty(slug)` می‌آید و شیء کامل `specialties.json` است، پس `specialty.parent_id` در دسترس است.
+
+### راه‌حل
+
+والد (`parent_id === null`) را هم به شرط noindex اضافه کن. توجه: `parent_id` ممکن است `null` باشد — از مقایسهٔ صریح استفاده کن.
+
+```js
+const isParentCategory = specialty.parent_id == null; // والد یا بدون parent
+const noindex = isParentCategory || total === 0;
+
+return {
+  title,
+  description,
+  ...(noindex && { robots: { index: false, follow: true } }),
+  openGraph: { title, description, images: [image] },
+  twitter: { card: "summary_large_image", title, description, images: [image] },
+};
+```
+
+### نکته
+
+- اگر `sitemap.js` صفحات تخصص را لیست می‌کند، مطمئن شو والدها آنجا هم حذف/فیلتر می‌شوند تا با `noindex` هم‌خوان باشد. `grep -rn "specialties" app/sitemap.js` و در صورت وجود، والدها (`parent_id == null`) را از خروجی sitemap کنار بگذار.
+
+---
+
+## تسک ۵ — اصلاح نگارشی متن SEO سوالات متداول تخصص + برند روی دامنهٔ ریشه
+
+### فایل
+
+`lib/specialtyContent.js` — تابع `buildSpecialtyFaq` (خط ۹۸–۱۲۰). مصرف‌کننده: `app/specialties/[slug]/page.js` خط ۸۶.
+
+### وضعیت فعلی
+
+```js
+export function buildSpecialtyFaq(specialtyName, cityName, doctorCount = 0) {
+  return [
+    {
+      question: `چطور از متخصص ${specialtyName} در ${cityName} نوبت بگیرم؟`,
+      ...
+```
+
+روی دامنهٔ ریشه `cityName` برابر `"ایران"` است (از `resolveCityDisplayName` → `ROOT_DISPLAY_NAME`)، پس سوال می‌شود: «چطور از متخصص اینترونشنال کاردیولوژی در **ایران** نوبت بگیرم؟».
+
+### خواسته
+
+۱. جملهٔ سوال به شکل نگارشیِ روان‌تر تغییر کند: «چطور از … نوبت **بگیرم؟**» → «چطور **می‌توان** از … نوبت **گرفت؟**».
+۲. روی دامنهٔ ریشه، به‌جای «ایران» برند «**نوبت724**» استفاده شود (تقویت برند + طبیعی‌تر). روی دامنهٔ شهری همان نام شهر بماند.
+
+### راه‌حل
+
+بدون تغییر `ROOT_DISPLAY_NAME` سراسری (که در Titleها استفاده می‌شود و «متخصص X در ایران» آنجا درست است)، فقط داخل FAQ برند را جایگزین کن. یک آرگومان اختیاری `isRoot` به تابع اضافه کن:
+
+```js
+export function buildSpecialtyFaq(specialtyName, cityName, doctorCount = 0, { isRoot = false } = {}) {
+  const loc = isRoot ? "نوبت724" : cityName;
+  return [
+    {
+      question: `چطور می‌توان از متخصص ${specialtyName} در ${loc} نوبت گرفت؟`,
+      answer: `از فهرست همین صفحه پزشک موردنظرتان را انتخاب کنید، وارد پروفایل او شوید و از تقویم نوبت‌های خالی، تاریخ و ساعت دلخواه را ثبت کنید. رزرو در همان لحظه قطعی می‌شود و تأییدیه برایتان پیامک می‌شود.`,
+    },
+    {
+      question: `چند پزشک ${specialtyName} در ${loc} در دسترس است؟`,
+      answer:
+        doctorCount > 0
+          ? `در حال حاضر ${doctorCount} پزشک ${specialtyName} در ${loc} در این سامانه ثبت شده‌اند. این عدد با افزوده‌شدن پزشکان جدید به‌روزرسانی می‌شود.`
+          : `فهرست پزشکان ${specialtyName} در ${loc} در حال تکمیل است و به‌مرور پزشکان جدید به آن افزوده می‌شوند.`,
+    },
+    // بقیهٔ سوالات (هزینه ویزیت / لغو نوبت) بدون تغییر
+    ...
+  ];
+}
+```
+
+سپس در `app/specialties/[slug]/page.js` خط ۸۶، `isRoot` را پاس بده:
+
+```js
+const faq = buildSpecialtyFaq(specialty.name, cityName, total, { isRoot });
+```
+
+(`isRoot` از قبل در همان تابع از `getStateInfo()` گرفته شده — خط ۷۶.)
+
+### نکات
+
+- **فقط FAQ** برند را عوض کند؛ `buildSpecialtyIntro` و Titleها دست‌نخورده بمانند (روی ریشه همچنان «در ایران»). این عمدی است تا فقط متن سوالِ موردِ اشارهٔ کاربر اصلاح شود.
+- این متن هم در بلوک بصری صفحه و هم در `FAQPage` JSON-LD استفاده می‌شود (منبع مشترک) — پس اصلاح یک‌جا هر دو را می‌پوشاند.
+
+---
+
+## نکات کلی پروژه
+
+- App Router / Next.js 15؛ همیشه `await params` و `await searchParams`.
+- بعد از تغییرِ `listingRobots`، `robots.js`/`sitemap.js` را برای ناسازگاری بررسی کن (صفحات noindex نباید در sitemap باشند).
+- RTL فارسی، MUI v5 + Tailwind، فونت Vazir؛ استایل جدید اضافه نکن.
+- بعد از اتمام: `graphify update .` برای به‌روز نگه‌داشتن گراف (بعد از کامیت).