مكتبة سير عمل قابلة للبحث وواجهة API للتوثيق
كان المرجع الخاص بـ 2,053 سير عمل مؤتمت ملف HTML واحدًا بحجم 71 ميغابايت. كان يحتاج عشر ثوانٍ ليفتح، فتوقف الفريق عن استخدامه.
- الدور
- تصميم البنية والتطوير
- الأدوات
- Python، FastAPI، SQLite FTS5، Mermaid
- المحتوى
- 2,053 سير عمل، 365 تكاملًا، 29,445 عقدة
- النتيجة
- من 71 ميغابايت في 10 ثوانٍ إلى أقل من 100 كيلوبايت في أقل من ثانية
مرجع بحجم 71 ميغابايت
كانت المجموعة ذات قيمة بالفعل: 2,053 سير عمل في n8n، و365 تكاملًا مختلفًا، و29,445 عقدة إجمالًا. سنوات من أنماط الأتمتة المتراكمة، كل منها مثال عملي لشيء احتاج أحدهم إلى إنجازه.
كانت تُسلَّم كملف HTML ثابت واحد. واحد وسبعون ميغابايت. كل سير عمل، وكل عقدة، وكل إعداد، في مستند واحد يُرسل إلى المتصفح دفعة واحدة.
- عشر ثوانٍ أو أكثر قبل أن يظهر أي شيء على الشاشة.
- نحو 2 غيغابايت من الذاكرة بعد اكتمال التحميل.
- البحث كان
Ctrl+Fعلى الصفحة كلها. - على الهاتف، كانت الصفحة تتوقف ببساطة.
فتوقف الناس عن فتحها. المحتوى كان جيدًا. المشكلة كانت في الوصول إليه، ولم يتعامل أحد معها كمشكلة.
ما الذي بنيته
أداة فهرسة وواجهة API صغيرة أمامها. تبقى ملفات سير العمل في مكانها على القرص، وكل ما هو مكلف في قراءتها يحدث مرة واحدة، عند الفهرسة، في SQLite.
بحث في النص الكامل
فهرس النص الكامل FTS5 في SQLite يقوم بالعمل. تُقسَّم الأسماء والأوصاف وقوائم التكاملات مرة واحدة، فيعود الاستعلام في ألفي سير عمل خلال أقل من عُشر ثانية على حاسوب محمول، دون أي خدمة أخرى غير هذه العملية. وتعمل عوامل التصفية على الفهرس نفسه: نوع المُحفِّز (webhook، أو مجدول، أو يدوي، أو مُستدعى) ودرجة التعقيد المحسوبة من عدد العقد.
أسماء يقرؤها الإنسان
كانت أسماء الملفات مولّدة آليًا وصعبة القراءة: 2051_Telegram_Webhook_Automation_Webhook.json. تستخرج أداة الفهرسة عنوانًا مقروءًا عند التحليل («Telegram Webhook Automation») وتحدد التكاملات من أنواع العقد، لأن أسماء الملفات غير موثوقة. إنه عمل روتيني على النصوص، وهو السبب الأكبر في أن القائمة صارت قابلة للتصفح.
مخططات مولّدة
يُحوَّل مخطط العقد في كل سير عمل إلى مخطط Mermaid عند الطلب، من الروابط الموجودة أصلًا في ملف JSON. لا أحد مضطر إلى صيانة هذه المخططات: إن تغير سير العمل، تغيرت الصورة معه. ويمكن عرض ملف JSON الأصلي وتنزيله من الصفحة نفسها، لأن معظم الزوار ينتهي بهم الأمر إلى استيراد سير عمل في n8n الخاص بهم.
النقطة التي يحق لكم الاعتراض عليها
SQLite ليس محرك بحث، وإن تضاعف حجم هذه المجموعة عشر مرات، فالإجابة الصحيحة تصبح Postgres مع بحث نصي كامل حقيقي، أو Meilisearch، أو أداة أخرى صُممت لهذا الغرض.
- المكسب: لا تشغيل ولا صيانة. ملف واحد، ولا خادم يجب تشغيله، ولا عنقود خوادم يجب إبقاؤه حيًا، ولا فاتورة شهرية. يمكن لأي شخص نسخ المستودع وتشغيل كل شيء بـ
pip installوأمر واحد. وعنقود بحث سيُفقدنا ذلك. - الفهرس قابل للاستبدال. يُعاد بناؤه من الملفات على القرص في ثوانٍ، وهناك نقطة وصول
/api/reindexلحالات عدم التطابق. لا شيء ذا قيمة يعيش في قاعدة البيانات، فلا شيء ذا قيمة يضيع بحذفها.
ما الذي يفعله
- بحث نصي كامل في 2,053 سير عمل و365 تكاملًا
- <100msبحث نصي كامل في 2,053 سير عمل و365 تكاملًا
- حمولة أصغر: 71 ميغابايت من HTML صارت أقل من 100 كيلوبايت
- 700×حمولة أصغر: 71 ميغابايت من HTML صارت أقل من 100 كيلوبايت
- ذاكرة مستخدمة، مقابل نحو 2 غيغابايت للصفحة التي حلّ محلها
- <50MBذاكرة مستخدمة، مقابل نحو 2 غيغابايت للصفحة التي حلّ محلها
ما لم أحله بعد: ما زال البحث يطابق اسم سير العمل والخدمات التي يتعامل معها. من يبحث عن «أعلمني عند فشل عملية دفع» عليه أن يعرف مسبقًا أنه مبني على Stripe وSlack. البحث الدلالي في مخططات العقد هو الخطوة التالية البديهية، ولم أجد بعد نسخة منه تتفوق على التسمية الجيدة.