مطابق مفاتيح ما قبل وبعد الدمج مع حارس الفرع الفارغ

كيف يعمل

1. 1.Manual Trigger يشغل عقدة code تُخرج عناصر خيالية بحقل id فريد وbranch اختياري
2. 2.العينة تتفرع إلى عقدتي manifest موازيتين؛ كل عقدة ترشّح فرعها (A صريح، وكل ما ليس A ضمن B) وتفصل العناصر التالفة (id غير نصي أو فارغ) في invalid_count
3. 3.كل عقدة تلحق branch_manifest بأول عنصر عابر فقط، وتُرسل عنصر حارس manifest_only إذا لم يوجد أي عنصر صالح للفرع
4. 4.Merge بوضع append يجمع المخرجين؛ الحارس يضمن مدخلًا غير فارغًا دائمًا فلا يتعلق التنفيذ
5. 5.عقدة تسوية runOnceForAllItems تنتج تقريرًا واحدًا: أعداد pre/post وempty_branch (received_count=0) وall_items_invalid وinvalid_count والمفاتيح المفقودة تحديدًا
6. 6.IF على ok يمرر عبر Set تضيف outcome=reconciliation_passed أو outcome=keys_lost_alert مع missing_keys_detail ثم noOp لكل مسار

حالات الاستخدام

• التحقق من اكتمال دمج مسارات شرطية في n8n دون تعليق عند فراغ فرع
• كشف الفقدان الصامت للعناصر بين التفرع والدمج
• تمييز الفروع الفارغة عن الفروع ذات العناصر التالفة في تقارير المطابقة

المتطلبات قبل التشغيل

• n8n 2.44.4 أو أحدث مع executionOrder=v1
• لا بيانات اعتماد ولا استدعاءات خارجية
• للإنتاج: استبدل عقدة العينة بمدخل حقيقي؛ كل عنصر يحتاج id نصيًا فريدًا، وحقل branch بقيمة A أو B اختياري (غيابه يُحتسب ضمن B)، ولا تستخدم حقل drop خارج الاختبار

الإعداد والاختبار في n8n

1. استورد الـJSON وشغّل Manual Trigger: يتوقع مسار keys_lost_alert يكشف B-202 مع missing_keys_detail='B: B-202' وinvalid_count للفرع B = 1
2. احذف drop:true من B-202 وشغّل: يتوقع ok=true ومسار reconciliation_passed
3. احذف كل عناصر الفرع A من عقدة العينة وشغّل: يتوقع إتمام التدفق مع empty_branches=['A'] وok=true عبر مسار reconciliation_passed (الحارس يمنع التعليق)
4. اجعل كل عناصر الفرع A بلا id صالح وشغّل: يتوقع empty_branch=false وall_items_invalid=true مع invalid_count=3

ماذا يقدّم كخدمة؟

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