طريقة البحث في مساحة عملك

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

يمر هذا الدرس على كل طريق إلى ذلك البحث: اختصار /، والاقتراحات الفورية الحية، والقفز عبر مفتاح التذكرة، وصفحة النتائج الكاملة بمرشّحاتها، والحدود الصريحة التي ينبغي أن تعرفها قبل أن تعتمد عليه. المشروع التجريبي في كل مكان هنا هو WEB، وأعمدته قائمة الانتظار / للتنفيذ / قيد التنفيذ / قيد المراجعة / منجزة، بتذاكر مثل "Timeline + Summary tab". كل ما يلي هو ما يحدث فعلًا في المنتج. وحيث لا يعمل شيء بالطريقة التي قد تأملها، أقول ذلك.

لماذا حقل بحث واحد يتفوق على التنقل بين اللوحات

هذا هو الوضع الحقيقي. يمكن أن تقيم المهمة في أي مشروع تصل إليه. ربما تكون في WEB. وربما في مشروع اسمه PLATFORM أنشأه زميل الأسبوع الماضي. وربما في مشروع مقيّد الوصول أُضفت إليه ونسيته نصف نسيان. البحث داخل مشروع واحد يعني أنك مضطر أصلًا إلى معرفة اللوحة التي ستفتحها، ولو كنت تعرفها لما احتجت إلى البحث.

حقل الشريط العلوي، المعنون "‏Search everything"، يستعلم من كل مشروع تملك صلاحية الوصول إليه دفعةً واحدة. هذه هي الغاية كلها، وهذا معنى "البحث في المهام عبر المشاريع" عمليًا: استعلام واحد، لوحاتك كلها، مرتبةً معًا. لا تختار مشروعًا أولًا. تكتب، ويبحث Taskfolk في كل مكان يُسمح لك بالنظر فيه.

هذا الحد على الوصول مفروض، لا شكلي. النتائج معزولة حسب الدور:

• المالك والمشرف يريان كل مشروع غير مؤرشف في مساحة العمل.
• العضو والمشاهد يريان المشاريع غير المقيّدة، إضافةً إلى أي مشروع مقيّد ينتميان إليه.
• الضيوف يرون فقط المشاريع المحددة التي أُضيفوا إليها صراحةً.

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

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

اضغط / وابدأ الكتابة: أسرع مدخل

أسرع مدخل هو مفتاح الشرطة المائلة. اضغط / في أي مكان داخل مساحة العمل فيأخذ حقل الشريط العلوي التركيز، جاهزًا للكتابة. لا فأرة، ولا بحث عن الصندوق. حين يكون الحقل فارغًا يعرض تلميحًا صغيرًا / على اليمين، ويقرأ النص البديل "‏Search everything"، فتعرف ما يفعله وكيف تصل إليه معًا.

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

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

GET /api/search?workspace=taskfolk&q=timeline

يعود الرد في ثلاث مجموعات، مقيّدة أصلًا بالمشاريع التي تصل إليها. مختصرًا إلى الحقول المهمة:

{
  "ok": true,
  "hits": [
    {
      "issueKey": "WEB-12",
      "title": "Timeline + Summary tab",
      "type": "task",
      "status": "in_progress",
      "priority": "high",
      "projectName": "Web",
      "href": "/w/taskfolk/p/web/WEB-12"
    }
  ],
  "docs": [
    {
      "title": "Onboarding flow",
      "projectSlug": null,
      "href": "/w/taskfolk/knowledge?doc=..."
    }
  ],
  "feedback": []
}

تبدو الرحلة كاملةً هكذا:

sequenceDiagram
  participant Y as You
  participant B as Browser
  participant S as Taskfolk server
  participant T as Typesense
  Y->>B: press / and type
  B->>B: debounce about 150 ms
  B->>S: GET /api/search
  S->>S: resolve projects you can reach
  S->>T: query with project filter
  T-->>S: ranked hits
  S-->>B: issues, pages, feedback

مثال ملموس. أنت تحدّق في لوحة WEB. اضغط /، واكتب timeline. خلال لحظة تمتلئ القائمة المنسدلة، وتذكرة "Timeline + Summary tab" هناك مباشرةً، مع أنك لم تفتح مشروعها قط.

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

قراءة الاقتراحات الفورية: المهام، والصفحات، والملاحظات

القائمة المنسدلة مجمّعة، والتجميع يعني شيئًا. اقرأها من الأعلى إلى الأسفل.

نتائج المهام تأتي أولًا، لأنها ما تريده في الغالب الأعم. يعرض كل صف مهمة مفتاح التذكرة بخط أحادي المسافة (ليصطف WEB-12 بنظافة ويُقرأ معرّفًا لا نصًّا)، وشارة نوع صغيرة (ملحمة، قصة، مهمة، خطأ، مهمة فرعية)، وعنوان المهمة، وشارة حالة. هذا يكفي للتمييز بين تذكرتين متشابهتي العنوان بنظرة واحدة دون فتح أي منهما.

تحت المهام تحصل على مجموعة الصفحات. تلك نتائج من قاعدة المعرفة والمستندات لديك. يحمل كل صف صفحات أيقونة مستند ووسمًا يعرض إما مشروعه أو "‏Knowledge" إن كان يقيم على مستوى مساحة العمل. هكذا يُظهر بحث عن "onboarding" ملحمة الإعداد والمستند الداخلي الذي يشرح سير الإعداد معًا، في قائمة منسدلة واحدة، مفصولين بوضوح لتعرف أيهما أيهما.

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

يمكنك قيادة القائمة المنسدلة كلها من لوحة المفاتيح، وهذا هو مغزى تصميم يبدأ بـ /:

• ‏ArrowDown وArrowUp يحرّكان التمييز عبر الصفوف، وهما يلتفّان: اضغط السهم لأعلى من الصف الأول فتصل إلى الأخير.
• ‏Enter يفتح أي صف مميّز.
• ‏Escape يغلق القائمة المنسدلة ويترك نصك في الحقل.
• التمرير فوق صف بالفأرة يميّزه أيضًا، فيبقى المفتاح والفأرة متزامنين ولا ترى شيئين يبدوان مختارين في آنٍ واحد.

في القاع تمامًا يجلس تذييل: ‏See all results for "‏" مع سهم. هذا مخرجك إلى الصفحة الكاملة حين لا تكفي الشريحة العليا من القائمة المنسدلة. المزيد عن تلك الصفحة قريبًا.

اقفز مباشرةً إلى مهمة بكتابة مفتاحها (‏WEB-12)

هذه هي الحيلة التي تسدّد ثمنها يوميًا. اكتب مفتاح تذكرة مجردًا، مثل WEB-12، واضغط Enter لتذهب مباشرةً إلى تلك التذكرة.

صيغة المفتاح حرف يتبعه من واحد إلى خمسة محارف أبجدية رقمية، ثم شرطة، ثم رقم: WEB-12، PLATFORM-7، API2-341. وهو غير حساس لحالة الأحرف، فـ web-12 يعمل تمامًا مثل WEB-12. عند Enter يكون التوجيه بسيطًا:

flowchart LR
  A[Type the key, press Enter] --> B{Exact match already loaded in the typeahead?}
  B -->|Yes| C[Straight to the issue]
  B -->|No| D[Results page resolves the key]
  D --> C

في كلتا الحالتين تنتهي على التذكرة.

الآن التصحيح، لأن هذا يوقع الناس. إنه WEB-12، لا #WEB-12. لا تكتب الرمز #. صيغة #KEY-NUM (بالرمز # في المقدمة) ميزة مختلفة تمامًا: إنها صيغة رقاقة الإشارة التي تستعملها داخل التعليقات وأوصاف Markdown لربط مهمة بأخرى. داخل تعليق، يصير #WEB-12 رقاقة قابلة للنقر. أما في صندوق البحث، فـ #WEB-12 مجرد ضجيج. اكتب المفتاح المجرد.

حيث يتألق هذا: يترك زميل "‏can you look at WEB-12؟" في رسالة Slack. انسخ المفتاح، واضغط /، والصق، واضغط Enter. تكون على التذكرة قبل أن تنهي قراءة بقية رسالته. لا فتح المشروع، ولا تمرير اللوحة، ولا تساؤل عن أي مشاريعك فيه تذكرة رقم 12.

صفحة النتائج الكاملة: ابحث في كل مشروع دفعةً واحدة

حين لا تكفي شريحة القائمة المنسدلة، تريد الصفحة الكاملة. ثلاثة طرق إليها: انقر تذييل "‏See all results for"، أو اضغط Enter دون تمييز أي صف، أو انتقل مباشرةً إلى /w/<slug>/search. للصفحة صندوق بحث كبير خاص بها (يأخذ التركيز تلقائيًا، فتستطيع الكتابة لحظة تحميلها) وزر إرسال "‏Search"؛ الإرسال يعيد تحميل الصفحة نفسها باستعلامك بوصفه ?q=.

تصحيح مسار واحد، كي لا تبحث عن شيء غير موجود: البحث صفحة على مستوى مساحة العمل. يقيم في /w/<slug>/search، مثل /w/taskfolk/search?q=timeline. لا توجد صفحة بحث مقيّدة بمشروع. مسار مثل /w/taskfolk/p/web/search ليس موجودًا. البحث دائمًا عبر مساحة العمل كلها بحكم التصميم، وهذا هو السبب الكامل لقدرته على سحب تذاكر من كل لوحة دفعةً واحدة.

ما تحصل عليه في الصفحة هو الجوهر: نتائج متسامحة مع الأخطاء الإملائية مدعومة بـ Typesense، مرتبةً حسب وزن الحقل.

الحقل	الوزن
العنوان	4
مفتاح التذكرة	4
الوسوم	3
الوصف	2

فكلمة في عنوان تذكرة تتفوق على الكلمة نفسها مدفونةً في وصفها، وهذا عادةً ما تريده. يعرض كل صف نتيجة شارة نوع، ومفتاح التذكرة، ورقاقة باسم المشروع (هذا هو مردود العمل عبر المشاريع: ترى بنظرة أن نتيجةً في WEB والتالية في PLATFORM)، والمصطلحات المطابِقة مظللةً بالأصفر لتعرف لماذا عاد الصف، وشارتي حالة وأولوية، وطابعًا زمنيًا نسبيًا مثل "‏3 days ago".

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

ضيّقها بمرشّحات النوع والحالة والأولوية

الاستعلام الواسع يعيد الكثير. تمنحك الصفحة الكاملة شريطًا جانبيًا للمُصنِّفات على اليسار لتقليصه، ويعمل بالكامل عبر الرابط، فأي عرض مرشَّح رابط قابل للمشاركة.

هناك ثلاث مجموعات مُصنِّفات، كل منها مربوطة بمعامل رابط:

مجموعة المُصنِّف	القيم	معامل الرابط
النوع	ملحمة، قصة، مهمة، خطأ، مهمة فرعية	type
الحالة	قائمة الانتظار، للتنفيذ، قيد التنفيذ، قيد المراجعة، منجزة، فاشلة، ملغاة	status
الأولوية	حرجة، الأعلى، عالية، متوسطة، منخفضة، الأدنى	priority

يعرض كل صف عدًّا حيًّا لعدد النتائج المطابِقة له، فقبل أن تنقر أصلًا تقرأ "‏14 tasks, 3 bugs" وتقرر أين تصوّب. تأشير صف يبدّل معامل رابطه ويعيد تشغيل العرض؛ القيم المتعددة في مجموعة واحدة تُوصَل بفواصل. لكل مجموعة زر "‏Clear" خاص بها، وهناك "‏Clear all filters" لإعادة ضبط كل شيء. تُقرأ الروابط تمامًا كما ستخمّن:

GET /w/taskfolk/search?q=board
GET /w/taskfolk/search?q=board&type=bug
GET /w/taskfolk/search?q=board&type=bug&status=in_progress&sort=updated

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

مثال مطبَّق. ابحث q=board، فيعيد مهامًّا كثيرة عبر عدة مشاريع. يقرأ سطر الملخّص شيئًا مثل "‏18 of 42 results" بمجرد أن تبدأ الترشيح، ويتحدّث كلما تقدمت. أشّر النوع = خطأ فتنكمش القائمة إلى الأخطاء وحدها، وتتكيّف الأعداد على المُصنِّفات الأخرى، ويُعاد حساب الملخّص. أضف الحالة = قيد التنفيذ فتنظر الآن إلى أخطاء اللوحة الجارية بالضبط عبر كل مشروع، في عرض واحد، بوصفه رابطًا تستطيع لصقه لزميل.

للتعمق أكثر في الترشيح والترتيب، ولحفظ عرض مرشَّح كي لا تعيد بناءه في كل مرة، هذان هما القراءتان التاليتان الصحيحتان: طريقة ترشيح المهام وفرزها وطريقة حفظ العروض ومشاركتها.

التسامح مع الأخطاء الإملائية والمطابقة الجزئية التي تساعد فعلًا

يؤدي Typesense عملًا حقيقيًا هنا، وهو يغيّر كيف تبحث. لست مضطرًا إلى تذكّر الصياغة الدقيقة لتذكرة.

• اكتب wizrd فيجد wizard. التسامح مع الأخطاء الإملائية يسمح بخطأين محرفيين على الأكثر، فتُحلّ الأخطاء الحقيقية إلى الكلمة الصحيحة بدل ألا تعيد شيئًا.
• اكتب auth فيطابق authentication، لأن مطابقة البادئة تعني أن بداية الكلمة تكفي.
• اكتب agic فيجد magic، لأن هناك أيضًا مطابقة داخلية على العناوين، فيصيب جزءٌ مدفون في وسط كلمة الهدف.

يومًا بيوم، هذا هو الفرق بين إيجاد "Timeline + Summary tab" بكتابة "summ" والاستسلام لأنك تذكّرتها خطأً بوصفها "overview".

لكن كن دقيقًا في ما يُبحَث فيه، لأن هنا تخيب التوقعات.

مفهرَس	غير مفهرَس
عنوان المهمة	التعليقات
مفتاح التذكرة	محتويات المرفقات
الوسوم
الوصف (بعد تجريد Markdown، نحو أول 4000 محرف)

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

عمليات البحث الأخيرة واختصارات القفز

افتح صفحة البحث الكاملة بلا استعلام فتصل إلى حالة فارغة مفيدة بدل فراغ خالٍ. يقرأ العنوان "‏Find anything"، وتحته دعوة "‏Search this workspace".

إن كنت قد بحثت من قبل، تظهر مصطلحاتك الأخيرة رقاقات. انقر واحدة لتعيد تشغيلها فورًا. لكل رقاقة X صغير لإزالة ذلك المصطلح وحده، وتقدّم الحالة الفارغة "‏Clear" لمسح القائمة كلها. عمليات البحث الأخيرة مشتركة بين القائمة المنسدلة في الشريط العلوي والصفحة الكاملة: كلتاهما تسحبان من قائمة واحدة لكل مساحة عمل، محفوظة بالأحدث أولًا، منزوعة التكرار، محدودة بـ 8. فالبحث الذي شغّلته من الشريط العلوي هذا الصباح موجود هناك رقاقةً حين تفتح الصفحة الكاملة بعد الظهر.

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

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

حدود تستحق المعرفة قبل أن تثق بالنتائج

تثق بالنتائج أكثر إن عرفت أين تتوقف. هذه هي القائمة الصريحة.

البحث عبر Typesense فقط. لم يعد هناك احتياطي MariaDB؛ أُزيل مسار FULLTEXT/LIKE القديم (في الهجرة 0040) لأنه كان يمسح عشرات الثواني على مساحات العمل الكبيرة. المكسب هو السرعة. والمقايضة أنه إذا تعذّر الوصول إلى فهرس البحث أو لم يُهيّأ، يعيد البحث نتيجة فارغة بدل أن يتعثّر على احتياطي بطيء. فلا تفترض أن النتائج تعود دائمًا. حين يكون الفهرس متوقفًا، كل مسار فارغ.

هناك إشعاران متمايزان لنمطي فشل متمايزين، والتمييز بينهما يساعد حين يبدو شيء خاطئًا:

flowchart TD
  A[Search runs] --> B{Typesense configured?}
  B -->|No| C[Search is being set up]
  B -->|Yes| D{Doc query fails at runtime?}
  D -->|Yes| E[Page results temporarily unavailable, issue results still accurate]
  D -->|No| F[Full results]

الإشعار الأول يعني أن الصندوق لم يُوصَّل بعد. والثاني مطمئن بطريقة محددة: نتائج مهامك سليمة، والذي تعثّر هو قسم الصفحات فقط.

النتائج محدودة، لا شاملة:

• الصفحة الكاملة تعيد حتى 50 نتيجة مهمة وحتى 25 نتيجة مستند.
• الاقتراحات الفورية تعيد حتى 50 نتيجة مهمة، و25 مستندًا، وحتى 8 عناصر ملاحظات.
• أعداد المُصنِّفات في الشريط الجانبي تأتي من مرور مقيّد بالمستأجر محدود بـ 50، فعلى مجموعات النتائج الكبيرة جدًا تكون تلك الأعداد تقريبية لا مجاميع دقيقة. إن قرأ عدد "50" فقد يعني جيدًا "50 على الأقل".

على مساحة عمل كبيرة، يعني ذلك أنك ترى أفضل المطابقات، لا كل مطابقة. ضيّق استعلامك بدل الوثوق بالذيل.

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

ولا تخلط هذا بلوحة الأوامر. Cmd/Ctrl+K يفتح مكوّنًا منفصلًا للتنقّل والإجراءات السريعة (اقفز إلى صفحة، شغّل أمرًا). يصادف أنه يعيد استعمال واجهة البحث نفسها خلف الكواليس، لكنه ليس شريط البحث الذي يبدأ بـ / الذي يدور حوله هذا الدرس. أداتان مختلفتان، مفتاحان مختلفان.

إن كنت توثّق مشروعًا كي يجد البحث الصفحات الصحيحة لاحقًا، فـطريقة كتابة مستندات المشروع تستحق النظر، وإن كنت لا تزال تعدّ التذاكر نفسها، فابدأ بـطريقة إنشاء مهمة.

افتح مساحة عملك، واضغط /، وابحث عن تذكرة تعرف أنها تقيم في مكان كنت ستضطر لولا ذلك إلى مطاردتها فيه.