sara-dashboards/PRD_بهینه_سازی_موتور_جستجو.md

8.6 KiB
Raw Blame History

PRD سند جامع بازطراحی موتور جستجوی اکیپا (Search Engine Optimization & UX)

  • سند: مشخصات نیازمندی‌های محصول (PRD)
  • عنوان پروژه: بهینه‌سازی موتور جستجو، اصلاح منطق سرچ، رتبه‌بندی، غلط‌یابی و اقلام منقضی‌شده
  • مسئول محصول (PM): سارا محمودزاده
  • تیم فنی اجرا: آرمین زاهدی (بک‌اند) / مرتضی صادقی (فرانت‌اند)
  • وضعیت: آماده پیاده‌سازی (Ready for Dev)

۱. بیان مسئله و وضع موجود (Problem Statement)

موتور جستجوی فعلی اکیپا در مواجهه با جستجوی کاربران دچار ۳ آسیب اساسی در نرخ تبدیل (Conversion Rate) و تجربه کاربری (UX) است:

  1. عدم انطباق با غلط‌های املایی و تایپی (عدم وجود Fuzzy Search / Typo-Tolerance): با کوچک‌ترین اشتباه تایپی کاربر (مثلاً «سفالگری» به جای «سفالگری» یا جابجایی حروف کیبورد)، هیچ نتیجه‌ای برنمی‌گردد و صفحه سفید/خالی منجر به ریزش کاربر (Drop-off) می‌شود.
  2. عدم اولویت‌بندی معنایی و دسته‌بندی موضوعی (Semantic Relevance): وقتی کاربر یک عبارت کلی مثل «سفالگری» یا «سینما ترس» را جستجو می‌کند، به جای تجمیع و اولویت‌دهی به تمام کارگاه‌ها و آیتم‌های مرتبط، نتایج نامربوط یا پراکنده می‌آیند.
  3. بلاتکلیفی آیتم‌های منقضی‌شده یا غیرفعال (Expired / Inactive Items): در حال حاضر یا آیتم‌های منقضی به طور کامل مخفی شده که به سئو و هدایت کاربر لطمه می‌زند، یا بدون هیچ نشانه‌ای وسط آیتم‌های فعال نمایش می‌یابند. کاربر روی آن‌ها کلیک کرده و با سانس بسته مواجه می‌شود و سرخورده برمی‌گردد.

۲. اهداف اصلی پروژه (Product Objectives)

  • حذف صفحه صفر نتیجه (Zero-Results Rate): با استفاده از الگوریتم‌های شباهت متنی، هیچ سرچ متداولی نباید به نتیجه صفر برسد.
  • نمایش هدفمند آیتم‌های متوقف/منقضی: برگرداندن آیتم‌های منقضی‌شده در انتهای لیست نتایج با لیبل بصری واضح «توقف موقت» (جهت حفظ ترافیک سئو و عدم فریب کاربر).
  • بهبود دقت و رتبه‌بندی نتایج (Relevance Ranking): بازی‌ها و کارگاه‌های فعال و قابل رزرو بالاتر از همه‌چیز قرار گیرند.

۳. منطق جدید موتور جستجو (Search Logic & Engine Architecture)

۳.۱. پالایش و نرمال‌سازی متن ورودی (Text Normalization)

تمام عبارات ورودی کاربر پیش از جستجو در دیتابیس باید نرمال‌سازی شوند:

  • یکپارچه‌سازی «ی» و «ک» عربی و فارسی (ي -> ی ، ك -> ک).
  • حذف نیم‌فاصله‌ها و تبدیل به فاصله استاندارد در فاز جستجوی چندگانه.
  • حذف اعراب و نشانه‌های نگارشی غیرضروری.

۳.۲. جستجوی تقریبی و پذیرش غلط املایی (Fuzzy Search & Levenshtein Distance)

  • پیاده‌سازی فاصله لونشتاین (حداکثر ویرایش مجاز: ۲ کاراکتر برای واژگان بیش از ۴ حرف).
  • پیاده‌سازی پیشنهاد جایگزین: «آیا منظورتان ... بود؟» (Did you mean?)
    • در صورتی که نتیجه سرچ دقیق زیر ۲ مورد باشد، جستجوی نزدیک‌ترین کلمه معتبر لود شده و پیام به کاربر نمایش داده شود.

۳.۳. منطق پوشش دسته‌بندی و تگ‌ها (Tag & Category Expansion)

  • جستجو باید روی فیلدهای زیر با وزن‌دهی (Weighting) انجام شود:
    1. عنوان اتاق/کارگاه (Name): ضریب وزن ۵x
    2. دسته‌بندی و زیردسته (Category/Type): ضریب وزن ۴x (مثلاً زدن «سفالگری» باید تمام آیتم‌های دسته‌بندی کارگاه سفالگری را بیاورد)
    3. تگ‌های موضوعی (Tags): ضریب وزن ۳x
    4. نام مجموعه/برگزارکننده (Provider): ضریب وزن ۲x
    5. متن توضیحات (Description): ضریب وزن ۱x

۴. رفتار اقلام منقضی‌شده / توقف موقت (Expired & Inactive Items)

۴.۱. نحوه رتبه‌بندی (Sorting Order):

نتایج جستجو همیشه باید دارای دو بخش مجزا باشند:

  1. بخش اول (نتایج فعال و قابل رزرو): بالاترین اولویت براساس مرتبط‌ترین نتایج و سانس‌های باز امروز و روزهای آتی.
  2. بخش دوم (نتایج دارای توقف موقت / منقضی): دقیقاً در پایین‌ترین ردیف‌های لیست (ته لیست) چیده شوند تا مانع دیده‌شدن آیتم‌های آماده فروش نشوند.

۴.۲. الزامات UI/UX کارت‌های منقضی:

  • روی تصویر کارت، یک بنر یا نشان تیره (Badge/Overlay) با متن: «توقف موقت» درج شود.
  • کارت باید کمی شفافیت (Opacity 70%) یا حالت غیرفعال ملایم بگیرد تا تمایز آن با کارت‌های فعال در یک نگاه مشخص باشد.
  • ورود به صفحه مانعی ندارد، اما دکمه «رزرو سانس» غیرفعال شده و دکمه «به من اطلاع بده» یا «مشاهده اتاق‌های مشابه فعال» جایگزین آن گردد.

۵. تفکیک وظایف تیم فنی (Work Breakdown)

۵.۱. بک‌اند (آرمین زاهدی)

  1. اصلاح اندپوینت جستجو (/v2/site/search):
    • افزودن قابلیت سرچ بر اساس فیلدهای name, category, tags, provider_name.
    • فعال‌سازی Fuzzy Search (با افزونه pg_trgm در PostgreSQL یا الگوریتم شباهت similarity() > 0.3).
  2. سورتینگ ترکیبی (Custom Order Query):
    • سورت اصلی: ORDER BY is_active DESC, has_open_slots DESC, relevance_score DESC.
    • آیتم‌های غیرفعال یا بدون سانس معتبر نباید از خروجی حذف شوند؛ بلکه با فلگ is_paused: true در انتهای لیست قرار گیرند.
  3. اضافه کردن آبجکت پیشنهادات (suggested_query):
    • در صورت اصلاح غلط تایپی، کلمه پیشنهادی درست در کلید did_you_mean به فرانت پاس داده شود.

۵.۲. فرانت‌اند (مرتضی صادقی)

  1. طراحی وضعیت «توقف موقت» در کامپوننت کارت:
    • اضافه کردن نشان متنی شفاف «توقف موقت» روی کارت‌های با is_paused: true.
    • استایل خاکستری ملایم (Muted / Opacity) برای کارت‌های منقضی.
  2. باکس «آیا منظورتان ... بود؟»:
    • در صورت وجود did_you_mean در ریسپانس، بالای نتایج نمایش داده شود با امکان کلیک روی کلمه اصلاح‌شده.
  3. تفکیک بصری یا سکشن‌بندی نتایج منقضی:
    • نمایش یک جداکننده نرم قبل از نتایج منقضی: «سایر مواردی که در حال حاضر متوقف هستند».

۶. معیارهای پذیرش (Acceptance Criteria)

  1. با سرچ «سفالگری»، تمام اتاق‌ها و کارگاه‌هایی که تگ یا دسته‌بندی سفالگری دارند در نتایج ظاهر شوند.
  2. با سرچ واژه‌ای با ۱ یا ۲ حرف اشتباه، نتایج مرتبط یا پیام «آیا منظورتان ... بود» لود شود و کاربر با صفحه خالی مواجه نگردد.
  3. آیتم‌های منقضی‌شده و بدون سانس از نتایج حذف نمی‌شوند، اما ۱۰۰٪ در انتهای لیست قرار گرفته و بج «توقف موقت» دارند.