8.6 KiB
8.6 KiB
PRD سند جامع بازطراحی موتور جستجوی اکیپا (Search Engine Optimization & UX)
- سند: مشخصات نیازمندیهای محصول (PRD)
- عنوان پروژه: بهینهسازی موتور جستجو، اصلاح منطق سرچ، رتبهبندی، غلطیابی و اقلام منقضیشده
- مسئول محصول (PM): سارا محمودزاده
- تیم فنی اجرا: آرمین زاهدی (بکاند) / مرتضی صادقی (فرانتاند)
- وضعیت: آماده پیادهسازی (Ready for Dev)
۱. بیان مسئله و وضع موجود (Problem Statement)
موتور جستجوی فعلی اکیپا در مواجهه با جستجوی کاربران دچار ۳ آسیب اساسی در نرخ تبدیل (Conversion Rate) و تجربه کاربری (UX) است:
- عدم انطباق با غلطهای املایی و تایپی (عدم وجود Fuzzy Search / Typo-Tolerance): با کوچکترین اشتباه تایپی کاربر (مثلاً «سفالگری» به جای «سفالگری» یا جابجایی حروف کیبورد)، هیچ نتیجهای برنمیگردد و صفحه سفید/خالی منجر به ریزش کاربر (Drop-off) میشود.
- عدم اولویتبندی معنایی و دستهبندی موضوعی (Semantic Relevance): وقتی کاربر یک عبارت کلی مثل «سفالگری» یا «سینما ترس» را جستجو میکند، به جای تجمیع و اولویتدهی به تمام کارگاهها و آیتمهای مرتبط، نتایج نامربوط یا پراکنده میآیند.
- بلاتکلیفی آیتمهای منقضیشده یا غیرفعال (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) انجام شود:
- عنوان اتاق/کارگاه (Name): ضریب وزن ۵x
- دستهبندی و زیردسته (Category/Type): ضریب وزن ۴x (مثلاً زدن «سفالگری» باید تمام آیتمهای دستهبندی کارگاه سفالگری را بیاورد)
- تگهای موضوعی (Tags): ضریب وزن ۳x
- نام مجموعه/برگزارکننده (Provider): ضریب وزن ۲x
- متن توضیحات (Description): ضریب وزن ۱x
۴. رفتار اقلام منقضیشده / توقف موقت (Expired & Inactive Items)
۴.۱. نحوه رتبهبندی (Sorting Order):
نتایج جستجو همیشه باید دارای دو بخش مجزا باشند:
- بخش اول (نتایج فعال و قابل رزرو): بالاترین اولویت براساس مرتبطترین نتایج و سانسهای باز امروز و روزهای آتی.
- بخش دوم (نتایج دارای توقف موقت / منقضی): دقیقاً در پایینترین ردیفهای لیست (ته لیست) چیده شوند تا مانع دیدهشدن آیتمهای آماده فروش نشوند.
۴.۲. الزامات UI/UX کارتهای منقضی:
- روی تصویر کارت، یک بنر یا نشان تیره (Badge/Overlay) با متن: «توقف موقت» درج شود.
- کارت باید کمی شفافیت (Opacity 70%) یا حالت غیرفعال ملایم بگیرد تا تمایز آن با کارتهای فعال در یک نگاه مشخص باشد.
- ورود به صفحه مانعی ندارد، اما دکمه «رزرو سانس» غیرفعال شده و دکمه «به من اطلاع بده» یا «مشاهده اتاقهای مشابه فعال» جایگزین آن گردد.
۵. تفکیک وظایف تیم فنی (Work Breakdown)
۵.۱. بکاند (آرمین زاهدی)
- اصلاح اندپوینت جستجو (
/v2/site/search):- افزودن قابلیت سرچ بر اساس فیلدهای
name,category,tags,provider_name. - فعالسازی Fuzzy Search (با افزونه
pg_trgmدر PostgreSQL یا الگوریتم شباهتsimilarity() > 0.3).
- افزودن قابلیت سرچ بر اساس فیلدهای
- سورتینگ ترکیبی (Custom Order Query):
- سورت اصلی:
ORDER BY is_active DESC, has_open_slots DESC, relevance_score DESC. - آیتمهای غیرفعال یا بدون سانس معتبر نباید از خروجی حذف شوند؛ بلکه با فلگ
is_paused: trueدر انتهای لیست قرار گیرند.
- سورت اصلی:
- اضافه کردن آبجکت پیشنهادات (
suggested_query):- در صورت اصلاح غلط تایپی، کلمه پیشنهادی درست در کلید
did_you_meanبه فرانت پاس داده شود.
- در صورت اصلاح غلط تایپی، کلمه پیشنهادی درست در کلید
۵.۲. فرانتاند (مرتضی صادقی)
- طراحی وضعیت «توقف موقت» در کامپوننت کارت:
- اضافه کردن نشان متنی شفاف «توقف موقت» روی کارتهای با
is_paused: true. - استایل خاکستری ملایم (Muted / Opacity) برای کارتهای منقضی.
- اضافه کردن نشان متنی شفاف «توقف موقت» روی کارتهای با
- باکس «آیا منظورتان ... بود؟»:
- در صورت وجود
did_you_meanدر ریسپانس، بالای نتایج نمایش داده شود با امکان کلیک روی کلمه اصلاحشده.
- در صورت وجود
- تفکیک بصری یا سکشنبندی نتایج منقضی:
- نمایش یک جداکننده نرم قبل از نتایج منقضی: «سایر مواردی که در حال حاضر متوقف هستند».
۶. معیارهای پذیرش (Acceptance Criteria)
- با سرچ «سفالگری»، تمام اتاقها و کارگاههایی که تگ یا دستهبندی سفالگری دارند در نتایج ظاهر شوند.
- با سرچ واژهای با ۱ یا ۲ حرف اشتباه، نتایج مرتبط یا پیام «آیا منظورتان ... بود» لود شود و کاربر با صفحه خالی مواجه نگردد.
- آیتمهای منقضیشده و بدون سانس از نتایج حذف نمیشوند، اما ۱۰۰٪ در انتهای لیست قرار گرفته و بج «توقف موقت» دارند.