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