كيفية إضافة البحث إلى تطبيقك: من الفلاتر البسيطة إلى البحث في النص الكامل

لإضافة البحث إلى تطبيقك، ابدأ بأبسط حل يعمل: مربع بحث يستدعي مساراً على الخادم، فيصفّي صفوف قاعدة بياناتك بمطابقة الاستعلام مع بضعة أعمدة، إضافة إلى فلاتر لأشياء مثل الفئة أو السعر. وعندما لا يكفي ذلك، أي عندما تحتاج إلى ترتيب حسب الصلة، أو اجتزاء الكلمات (stemming)، أو عدد كبير من السجلات، فانتقل إلى البحث النصي الكامل في قاعدة بياناتك، ولا تنتقل إلى محرك بحث مستضاف إلا إذا احتجت إلى تحمّل قوي للأخطاء الإملائية أو نتائج فورية على بيانات ضخمة جداً. وأياً كان ما تختاره، يجب أن يحترم البحث الصلاحيات: لا ينبغي للمستخدمين أبداً أن يجدوا سجلات لا يحق لهم رؤيتها.

ماذا يعني "البحث" لتطبيقك

يغطي البحث عدة أشياء مختلفة، ومعظم التطبيقات تحتاج إلى أكثر من واحدة منها:

• البحث بالكلمات المفتاحية: مربع نص، مثل "ابحث عن الإعلانات التي تذكر 'حديقة'".
• الفلاتر: خيارات منظمة، مثل الفئة، والمدينة، ونطاق السعر، والتاريخ، والحالة.
• الترتيب: الأحدث، أو الأرخص، أو الأكثر صلة.
• الإكمال التلقائي: اقتراحات أثناء الكتابة.
• تحمّل الأخطاء الإملائية: "restuarant" ما زالت تجد "restaurant".

بالنسبة لدليل أو لوحة وظائف أو متجر، تكون الفلاتر في الغالب أهم من مربع النص. حدد أيّ هذه الأشياء تحتاجها فعلاً قبل اختيار الأداة.

خياراتك

إذا كانت بياناتك موجودة بالفعل في Postgres، فإن البحث النصي الكامل المدمج فيه خيار وسط قوي. يقسّم النص إلى كلمات، ويردّها إلى جذورها (بحيث تطابق "running" كلمة "run")، ويتجاهل الكلمات الشائعة، ويستطيع ترتيب النتائج بحسب مدى تطابقها. ومع الفهرس المناسب يبقى سريعاً على الجداول الكبيرة.

مطالبات أمثلة

بداية بسيطة:

أضف مربع بحث وفلاتر إلى صفحة الإعلانات. يجب أن يطابق البحث الاستعلام مع العنوان والوصف، دون حساسية لحالة الأحرف. الفلاتر: الفئة (قائمة منسدلة)، والمدينة (قائمة منسدلة)، وأعلى سعر. نفّذ البحث على الخادم عبر مسار واجهة برمجية مقسّم إلى صفحات، بـ 20 نتيجة في الصفحة. احتفظ بالبحث والفلاتر في الرابط حتى يمكن مشاركة النتائج ويعمل زر الرجوع. اعرض حالة فارغة ودية عندما لا يطابق شيء.

الترقية إلى البحث النصي الكامل:

حوّل بحث الإعلانات إلى البحث النصي الكامل في Postgres على العنوان (بوزن أعلى) والوصف. أضف الفهرس المناسب، ورتّب النتائج حسب الصلة، واحتفظ بالفلاتر والتقسيم إلى صفحات الحاليين. لا تغيّر أي بيانات موجودة.

إضافة تحمّل للأخطاء الإملائية في الأسماء:

أضف مطابقة تقريبية على اسم النشاط التجاري حتى تجد الأخطاء الإملائية البسيطة نتائج. استخدم تشابه الثلاثيات إن كان متاحاً، مع فهرس، واعتمد البحث الحالي كاحتياط إذا لم يكن متاحاً.

خطوة بخطوة

1. اكتب ما يبحث عنه الناس. ما الحقول (العنوان، والوصف، والوسوم، والاسم)؟ وما الفلاتر؟ اسأل بعض المستخدمين الحقيقيين إن استطعت.
2. ابدأ من الخادم. أضف مساراً في الواجهة البرمجية يستقبل الاستعلام والفلاتر، ويعيد صفحة واحدة من النتائج. لا تحمّل كل شيء في المتصفح.
3. طبّق الصلاحيات في الاستعلام. إذا كان المستخدمون يرون سجلاتهم فقط، أو المنشورة فقط، فهذا الشرط يجب أن يكون في الاستعلام نفسه الذي يحوي البحث.
4. أضف التقسيم إلى صفحات من اليوم الأول: أرقام صفحات أو زر "تحميل المزيد".
5. ضع حالة البحث في الرابط (مثلاً ?q=garden&city=leeds). تتيح الروابط القابلة للمشاركة، ويعمل زر الرجوع، ويستطيع محركو البحث زحف الصفحات المفلترة إذا أردت ذلك.
6. أخّر البحث أثناء الكتابة (debounce). انتظر بضع مئات من الميلي ثانية بعد توقف الكتابة قبل الاستعلام، حتى لا ترسل طلباً مع كل ضغطة مفتاح.
7. أضف الفهارس بعد أن تعرف الأعمدة التي تفلتر عليها وتبحث فيها.
8. رقِّ الحل إلى البحث النصي الكامل، ثم المطابقة التقريبية، ثم محرك مستضاف، ولكن فقط عندما تفشل الخطوة الأبسط أمام مستخدمين حقيقيين.
9. اختبر ببيانات واقعية: مئات أو آلاف الصفوف، ورموز غريبة، واستعلامات فارغة، واستعلامات طويلة جداً، ولغات أخرى إذا كنت تدعمها.

أخطاء شائعة

• تحميل الجدول كاملاً في المتصفح. مقبول لـ 50 عنصراً، ومؤلم لـ 50,000، وهو يكشف كل سجل، بما فيها تلك التي لا يجب أن يراها المستخدم.
• بحث يتجاهل الصلاحيات. البحث مصدر تسريب شائع: يظهر سجل خاص أو مسودة لأن استعلام البحث نسي شرط "الخاص بي فقط" أو "المنشور فقط".
• بناء SQL من مدخلات المستخدم الخام. استخدم دائماً الاستعلامات المعلمة (parameterised). ومنشئ التطبيقات بالذكاء الاصطناعي يفعل ذلك عادةً، لكن تحقق إذا رأيت سلاسل نصية تُلصق ببعضها.
• عدم وجود حالة فارغة. رسالة "لا توجد نتائج" مع اقتراح (امسح الفلاتر، وتحقق من الإملاء) تمنع الناس من المغادرة.
• عدم وجود فهارس. يبدو البحث جيداً مع البيانات التجريبية ويبطؤ مع نمو البيانات الحقيقية.
• القفز مباشرة إلى خدمة بحث. ستحتاج عندها إلى نسخة ثانية من بياناتك تبقى متزامنة، والتعامل مع الحذف، وتأمين مجموعة أخرى من المفاتيح، غالباً دون مكسب ظاهر.
• نسيان الهاتف. يجب أن تتسع الفلاتر على شاشة الهاتف؛ ولوحة فلاتر قابلة للطي تعمل غالباً أفضل من الشريط الجانبي.

قائمة التحقق

• تعرف الحقول التي يُبحث فيها والفلاتر الموجودة
• يعمل البحث على الخادم ويعيد نتائج مقسّمة إلى صفحات
• يفرض الاستعلام نفس الصلاحيات المطبقة في بقية التطبيق
• تُمرَّر مدخلات المستخدم كمعاملات، ولا تُلصق أبداً في SQL
• حالة البحث موجودة في الرابط
• الكتابة مؤخرة (debounced)
• الأعمدة المبحوث فيها والمفلترة مفهرسة
• حالات الفراغ، وعدم وجود نتائج، والخطأ واضحة
• مُختبر بأحجام بيانات واقعية ومدخلات فوضوية

إضافة البحث باستخدام Mythex

في تطبيق مبني على Mythex، تعيش البيانات عادةً في قاعدة بيانات Postgres الخاصة بالمشروع، لذا يمكنك البدء بالمطالبات أعلاه: مطابقة النمط أولاً، ثم البحث النصي الكامل في Postgres عندما تحتاج إلى الترتيب. إذا أردت محرك بحث مستضافاً، فاستخدم حسابك ومفتاحك الخاصين، واحفظه كسر للمشروع، واطلب من الوكيل الفهرسة والاستعلام من الخادم، كما هو موضح في دمج أي واجهة برمجية.

البحث هو قلب كثير من التطبيقات: انظر كيفية بناء موقع دليل وكيفية بناء لوحة وظائف وكيفية بناء سوق إلكتروني لمعرفة كيف يتناسب البحث مع بقية المنتج.

الأسئلة