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

89 lines
8.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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. آیتم‌های منقضی‌شده و بدون سانس از نتایج حذف نمی‌شوند، اما ۱۰۰٪ در انتهای لیست قرار گرفته و بج «توقف موقت» دارند.