التجارة بالأحداث: تتبّع طلبًا من الوعد إلى دليل النتيجة

تسجل مراجعة الاثنين 1,900 عملية أعمال مؤهلة. يؤكد مستهلك محدد تطبيق 1,412 ، وتبقى 488:480 تنتظر التعافي و 8 معلقة للتحقيق. هذه مجموعة تعليمية لا حادثة عميل. المهم أي عمل ما زال مستحقًا ولماذا ينتظر ومن يحله، لا أن الشاشة تقول «متزامن».

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

طلب وحقيقة واستجابة

الأمر يطلب من المالك حجز سترتين أو استرداد دفعة، فيفحص الإذن والشروط ويستطيع الرفض. الحدث يصف وقوعًا مسجلًا مثل OrderAccepted أو PaymentCaptured ، والمستهلك يستجيب. الاسم لا يثبت صحة الرسالة أو مصدرها أو تفسيرها؛ تحقق من المصدر والعقد.

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

اتبع حالات السترات الفعلية

الطلب التعليمي 1042 يشتري سترتي JKT-M بسعر USD 40 لكل منهما، وشحن USD 5 وضريبة معتمدة من المالية USD 8:80+5+8=USD 93. تكلفة المخزون المعيّنة للمثال USD 22 للوحدة، USD 44 إجمالًا. العملة وتوقيت الضريبة والتقييم والتسليم والإيراد افتراضات صريحة لا قواعد تجزئة عامة.

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

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

الحقيقة أو الحالة	معنى المخزون والدفع	دليل مستقل مطلوب
OrderAccepted	مستودع 48 ؛ حجز 2 ؛ متاح 46	حجز صحيح وقبول دائم
PaymentCaptured	المزود حصّل USD 93	التسوية والبنك والأهلية المحاسبية
ShipmentDispatched	مستودع 46 ؛ حجز 0 ؛ نقل 2	تسليم فعلي وعدم تكرار تكلفة النقل
DeliveryConfirmed	النقل 0 بعد انتقال السيطرة هنا	إيفاء متحقق واعتراف معتمد

المالية تملك الاعتراف لا اسم التسليم

تفويض الدفع وتحصيله وتسوية المزود ووصول البنك والإيراد المكتسب حقائق مختلفة. يربط IFRS 15 الاعتراف بإيفاء الالتزامات ونقل السيطرة حيث ينطبق. تعتمد المالية السياسة والضريبة الفعليتين؛ لا يختارهما المطور لمجرد الاشتراك في ParcelDelivered.

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

عند التحصيل: مدين تسوية البطاقات 93 ودائن دفعات العملاء المقدمة 93. عند التسليم المؤهل: مدين الدفعات المقدمة 93 ودائن إيراد السلع 80 والشحن 5 والضريبة المستحقة 8. كذلك مدين تكلفة المبيعات 44 ودائن مخزون قيد النقل 44. مدين التسليم 93+44=137 ؛ ودائنه 80+5+8+44=137. يفرض المعالج التوازن ويختبره؛ وقد يتوازن القيد مع تاريخ أو حساب أو مبلغ أو سياسة خاطئة.

قيد تعليمي	مدين	دائن
التحصيل	تسوية البطاقات 93	دفعات العملاء المقدمة 93
تسليم مؤهل	دفعات العملاء المقدمة 93	سلع 80 + شحن 5 + ضريبة 8
تكلفة تسليم معيّنة	تكلفة المبيعات 44	مخزون قيد النقل 44

سجّل نية النشر مع التغيير المملوك

توجد فجوة إن ثبّتت القاعدة ثم ماتت العملية قبل الإرسال. والنشر أولًا قد يعلن تغييرًا يتراجع لاحقًا. يحفظ الصندوق الصادر المعاملاتي التغيير ونية نشره في معاملة محلية واحدة ثم ينشر المرحّل ما ثُبت. وقد يناسب تصميم التقاط تغيير آخر بدلالات صريحة.

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

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

اجعل منع التكرار يشمل الأثر نفسه

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

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

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

الترتيب والحمولة والإعادة لها حدود

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

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

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

للإعادة هدف. قد يتجاوز المفتاح نفسه حدثًا عولج سابقًا بحق، حتى لو عالجه كود معيب. إعادة بناء إسقاط آمن قد تستخدم معالجًا/إصدارًا منفصلًا مضبوطًا، والتصحيح المالي إصلاح مخول. لا تمسح كل سجل منع تكرار وتعد آثارًا حقيقية عشوائيًا. التكامل بالأحداث لا يفرض event sourcing ولا يضمن مخزن أحداث دائمًا لدى الوسيط.

اطلب دليل العمل المكتمل

إرشادات OWASP للتسجيل رفيق مفيد. أنشئ دليل عمل وتدقيق محميًا يربط الوقوع والمحاولة والقرار والنتيجة، بحدود للبيانات الحساسة والاحتفاظ. الرسالة المحذوفة بعد الإقرار ليست تدقيقًا كاملًا؛ والحدث المحفوظ لا يثبت تشغيل مستهلكه.

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

مجموعة الاثنين: 1,900=1,412 مؤكدة+480 تعافي+8 معلقة. تبقى 488 ظاهرة حتى المطابقة، لا تعني تلقائيًا 488 مبيعة مفقودة أو وعد قيد خلال دقائق. المرجع والمسؤول أنفع من شارة خضراء.

ابدأ بأثر يُقبل تأخره وحدد مالكه وعقده وأثبت التعافي قبل التوسع. لا عتبة سحرية لثلاثة مستمعين أو إلزام بترحيل المخزون أولًا. اطلب من StoreConsole أو غيره إظهار السلوك في النسخة والمسار الفعليين، لا استنتاج ضمانات كاملة من رسم وحدات.

مراجعة 5 نوفمبر 2026. Anichur Rahaman منشئ StoreConsole. الطلبات وأعداد المجموعة والمحاسبة والمخزون أمثلة تعليمية تحتاج سياسات عمل معتمدة.