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