WOLF TO DEV

~/projets $ ls

المشاريع

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

01 //

Corpus: اطرح سؤالًا على مستنداتك

عرض تجريبي مباشر v1.2.0 رخصة MIT Python · FastAPI · PostgreSQL
corpus-8jf9.onrender.com/demo
العرض التجريبي لـ Corpus: سؤال موجَّه إلى التوثيق، والإجابة تذكر مصدرها ورقم صفحته

منصة RAG متعددة المستأجرين. ترفع المؤسسات ملفات PDF، حتى الممسوحة ضوئيًا منها، وملفات Word أو HTML أو Markdown؛ وتتولّى workers فهرستها في الخلفية؛ ويتلقى كل سؤال إجابة متدفقة تستشهد بمصادرها مع رقم الصفحة بدقة.

تُدمج في أي موقع بوسم script واحد، وتجيب بعبارة «غير موجود في المستندات» بدلًا من أن تختلق إجابة.

استضافة مجانية: قد يستغرق الفتح الأول دقيقة.

من المستند المرفوع إلى الإجابة الموثّقة بمصدرها

architecture.md
بنية Corpus: الاستيعاب (الرفع، طابور متين، worker، PostgreSQL) ثم السؤال (إعادة الصياغة، البحث الهجين، إعادة الترتيب، الإجابة)

تحت الغطاء

  • تعدد المستأجرين تضمنه قاعدة البيانات: Row-Level Security في PostgreSQL، ومفاتيح أجنبية مركّبة؛ فالاستعلام الذي ينسى شرط التصفية لا يمكنه الخروج من نطاق عميله.
  • استيعاب متين: طابور مهام على PostgreSQL، وFOR UPDATE SKIP LOCKED، وleases وheartbeats، وحماية من workers الزومبي.
  • بحث هجين: بحث متجهي وبحث في النص الكامل بالتوازي، ودمج RRF، وإعادة ترتيب عبر cross-encoder.
  • جاهز للتشغيل: مقاييس Prometheus، وتتبّعات OpenTelemetry، ولوحة تحكم Grafana، وتخفيف الحمل بالرد 503 عند تجاوز السعة.

مقيس، لا مفترض

جودة البحث · 40 سؤالًا موسومًا، على CPU فقط
الاستراتيجيةRecall@1MRRp50
النص الكامل وحده0.7380.8697 ms
المتجهي وحده0.5500.71717 ms
هجين (RRF)0.8380.92919 ms
هجين + cross-encoder0.9000.958870 ms
40/sعملية بحث، 0% أخطاء، على 2 vCPU (اختبار حمل k6)
77 msزمن البحث عند p95 بمعدل 40 عملية بحث في الثانية
190اختبارًا: العزل، والتزامن، والاستئناف بعد الانهيار

كشف أول اختبار تحت الحمل الزائد عن جمود (deadlock) في مجمّع الاتصالات كان يُسقط الـ API بدلًا من أن يُخفّض أداءها تدريجيًا. وقد أُصلح، وأصبح مغطّى باختبار انحدار.

02 //

Flowline: عمليات تصمد أمام الانهيارات

عرض تجريبي مباشر v0.1.0 رخصة MIT TypeScript · Node.js · PostgreSQL
onboarding.ts
const onboarding = defineWorkflow({
  name: "onboarding",
  async run({ input, step }) {
    const account = await step.run("create-account",
      () => api.createAccount(input.userId));
    await step.run("send-welcome",
      () => mailer.send(account.email));
    // لا يُحجز أي worker طوال 14 يومًا
    await step.sleep("trial", 14 * DAY);
    const paid = await step.waitForEvent("payment",
      "billing.paid", { match: { userId: input.userId },
      timeoutMs: 3 * DAY });
    return paid ? "converted" : "churned";
  },
});

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

  • السجل أولًا: كل خطوة مكتملة تُكتب قبل أن يواصل الكود التنفيذ.
  • إعادة تشغيل حتمية: عند الاستئناف، تُعيد الخطوات المنجزة نتيجتها المسجّلة.
  • Leases وfencing: الـ worker الذي ينهار لا يُضيّع شيئًا، والـ worker الزومبي لا يُفسد شيئًا.

مُختبَر بقتل عمليات حقيقية

أربعة workers تنفّذ 60 سير عمل من ست خطوات؛ ويقتل الاختبار أحدها عشوائيًا بـ SIGKILL، اثنتي عشرة مرة، غالبًا في منتصف خطوة، ثم يستبدله.

60سير عمل من ست خطوات، أربعة workers
12إيقافًا مفاجئًا، غالبًا في منتصف خطوة
0نتيجة مفقودة؛ كل خطوة مسجّلة في السجل مرة واحدة فقط، وكل أثر جانبي موجود مرة واحدة فقط

الإنتاجية على حاسوب محمول، 4 أنوية

Workersتشغيلات/ثخطوات/ث
1155 إلى 215465 إلى 640
4535 إلى 8501,600 إلى 2,540
16545 إلى 8151,640 إلى 2,450

98 اختبارًا، ومجموعة اختبارات سلوكية واحدة تعمل على التخزين في الذاكرة وعلى PostgreSQL، وتكامل مستمر على Node 22 و24، وصورة Docker مُختبَرة.

محرر مرئي وعمليات تنفيذ مباشرة

flowline-demo.onrender.com
المحرر المرئي في Flowline: سير عمل لتتبّع طلب، خطوة بخطوة
runs · سجل عملية تنفيذ
لوحة تحكم Flowline: عمليتا تنفيذ مكتملتان وسجل إحداهما، خطوة بخطوة

هل تودّ أن نتحدّث؟

بنية تحتاج إلى إعادة نظر، أو مهمة، أو سؤال عن أحد هذه المشاريع.