حُفظ طلب شراء داخل معاملة، وأُرسل إشعاره قبل اكتمالها، ثم فشل تحديث المخزون فتراجعت المعاملة. يرى المستلم إشعارًا عن طلب غير موجود. إحدى أدوات Django لمعالجة ترتيب الخطوات هي on_commit، لكن استخدامها يحتاج فهمًا لما يحدث عندما يفشل الإشعار بعد نجاح الحفظ.
الحد بين البيانات والإجراء اللاحق
في Django 5.2، تسجل on_commit دالة تُنفّذ بعد نجاح اعتماد المعاملة. إذا تراجعت المعاملة يُلغى callback المرتبط بها. خارج atomic ومع تشغيل autocommit، قد ينفذ callback مباشرة. وفشل الدالة بعد الاعتماد لا يعيد بيانات المعاملة إلى الوراء لأنها ليست جزءًا منها.
صمّم مثالًا بلا إرسال حقيقي
استخدم في الاختبار قائمة محلية تسجل المعرفات بدل إرسال رسائل خارجية. أنشئ سجلًا افتراضيًا داخل atomic وسجل دالة تضيف معرفه إلى القائمة عند الاعتماد. الهدف الأول معرفة هل نُفّذ الإجراء في الوقت الصحيح، قبل ربط خدمة بريد أو طابور حقيقي.
- حالة النجاح: يظهر السجل بعد الاعتماد ويظهر معرفه مرة واحدة في قائمة الإجراءات.
- حالة التراجع: ارفع خطأ مقصودًا داخل المعاملة؛ ينبغي ألا يظهر السجل وألا يسجل callback أثرًا.
- حالة فشل callback: اجعل الدالة ترفع خطأ بعد الاعتماد؛ تحقق من بقاء السجل ومن ظهور فشل الإجراء في مسار مراقبة مفهوم.
لماذا لا يعمل callback في بعض الاختبارات؟
تغلف TestCase الاختبار بمعاملة تتراجع في النهاية، فلا يحدث الاعتماد المعتاد. توفر captureOnCommitCallbacks وسيلة لفحص الدوال المسجلة أو محاكاة تنفيذها. أما TransactionTestCase فيسمح باختبار الاعتماد الفعلي مع تكلفة عزل مختلفة. اختر الأداة بحسب السؤال: هل تختبر تسجيل الإجراء أم سلوك قاعدة البيانات عند commit؟
لا تجعل فشل الإشعار يختفي
في نظام افتراضي، يمكن أن يصبح طلب الشراء معتمدًا بينما إشعاره ينتظر إعادة المحاولة. اعرض الحالتين منفصلتين وسجل رقم العملية وسبب الفشل. لا تجعل المستخدم يعيد إنشاء الطلب كي يحاول إرسال الإشعار مرة أخرى، فهذا قد يكرر العمل التجاري نفسه.
وللإجراءات التي يجب ألا تضيع إذا توقفت العملية بين الاعتماد والإرسال، ناقش سجلًا دائمًا للمهام ضمن تصميم التطبيق بدل الاعتماد على callback في الذاكرة وحده. هذه نقطة مراجعة مع الفريق وليست خاصية ضمان تضيفها on_commit تلقائيًا. سلّم نتائج الحالات الثلاث وأداة الاختبار المستخدمة كي لا يُفهم نجاح المحاكاة بوصفه اختبارًا لاتصال خارجي فعلي.
المراجع والخطوة التالية
يمكن تطبيق هذه المراجعة ضمن أنظمة إدارة الشركات ومقارنة سلوك afterCommit في Laravel. الأمثلة تعليمية، والصورة مشهد تقني توضيحي مولد بالذكاء الاصطناعي وليست لقطة من مشروع عميل.




