ASP.NET Core Transactional Outbox for Odoo Leads

Resumo

Pixel shares a pattern for delivering website inquiries to Odoo without losing leads when either system is unavailable. It saves each inquiry and its outbox message in one SQL transaction, then uses Hangfire workers, temporary leases, retries, and status tracking to deliver messages reliably.

DEV Community

⁧إرسال العملاء المحتملين إلى Odoo دون أن يضيع أحد: صندوق صادر معاملاتي في ASP.NET Core⁩

⁧عميل محتمل يصل إلى الموقع ولا يصل إلى فريق المبيعات أسوأ من ألا يكون هناك موقع أصلًا. سيتوقف نظام إدارة العملاء أحيانًا، والمهم أن ينتظر العميل المحتمل بدل أن يختفي.⁩ ⁧كتابتان، وإحداهما ستفشل⁩ ⁧أن تحفظ العميل المحتمل ثم تتصل بـOdoo يبدو سليمًا حتى يفشل الاتصال بعد الحفظ: العميل في قاعدة بياناتك، ولا أثر له عند المبيعات. وأن تتصل بـOdoo أولًا يفشل بالعكس، حين ينكسر الحفظ بعد أن صار السجل في النظام. وإعادة المحاولة داخل الطلب لا تفعل إلا أن تُبطئ الصفحة ما دام النظام متوقفًا.⁩ ⁧الصندوق الصادر يُخرج الكتابة الثانية من الطلب. السجل نفسه ورسالة تصفه يُحفظان في المعاملة نفسها، فإما أن يوجدا معًا أو لا يوجد أي منهما. وتسليم الرسالة يصير مهمة منفصلة تأخذ ما يحتاجه النظام من وقت.⁩ ⁧حفظ واحد، ومعاملة SQL واحدة⁩ // The enquiry and its outbox row commit together, or not at all.
db.Inquiries.Add(inquiry);
db.OutboxMessages.Add(new OutboxMessage
{
Type = "InquiryCreated",
AggregateId = inquiry.Id,
PayloadJson = JsonSerializer.Serialize(InquiryPayload.From(inquiry)),
OccurredUtc = now,
Status = OutboxStatus.Pending,
NextAttemptUtc = now,
});
await db.SaveChangesAsync(ct);
⁧ماذا تحمل الرسالة⁩ ⁧اجعل السجل مملًّا وكاملًا. لا يجب أن يخمّن المُرسِل أبدًا ما هي الرسالة، ولمن هي، ولماذا فشلت آخر مرة.⁩ ⁧النوع. ما الذي حدث: استفسار جديد، أو مورد اعتُمد، أو بريد يجب إرساله.⁩ ⁧السجل والحمولة. معرّف السجل الذي تخصه، ولقطة JSON بما يحتاجه الطرف الآخر.⁩ ⁧الحالة. معلّقة، أو قيد المعالجة، أو مُعالَجة، أو ميتة. لا شيء بينها.⁩ ⁧المحاولات. كم محاولة حتى الآن، ومتى موعد التالية.⁩ ⁧عقد الإيجار. أي عامل يمسك الرسالة، وحتى متى.⁩ ⁧آخر خطأ. رمز وسبب قصير، لا الحمولة ولا تتبع أخطاء مليء ببيانات شخصية.⁩ ⁧استلم كل رسالة بعقد إيجار مؤقت⁩ ⁧مهمة متكررة في Hangfire تعمل كل 30 ثانية وتمر على الرسائل المستحقة، الأقدم أولًا، لمدة 20 ثانية أو 500 رسالة على الأكثر. وتستلم سجلًا واحدًا في كل مرة بتحديث مشروط: لا ينتقل إلى قيد المعالجة إلا سجل معلّق حان موعده، أو سجل قيد المعالجة انتهى عقده، مع عقد مدته خمس دقائق ومعرّف العامل.⁩ ⁧إن لم يلمس التحديث أي سجل فقد سبقه عامل آخر، فينتقل إلى غيره. ولا يمكن وضع علامة النجاح أو الفشل إلا ما دام العامل يمسك العقد، فلا يكتب عامل تأخر بعد انتهاء عقده فوق عمل من استلم بعده. ورسالة عامل تعطّل تعود وحدها حين ينتهي العقد.⁩ ⁧استلم، أو انتقل إلى غيرها⁩ var claimed = await db.OutboxMessages
.Where(m => m.Id == id &&
((m.Status == OutboxStatus.Pending && m.NextAttemptUtc <= now) ||
(m.Status == OutboxStatus.Processing && m.LeaseExpiresUtc < now)))
.ExecuteUpdateAsync(s => s
.SetProperty(m => m.Status, OutboxStatus.Processing)
.SetProperty(m => m.LeaseExpiresUtc, now.AddMinutes(5))
.SetProperty(m => m.LockedBy, workerId), ct);

if (claimed == 0) continue; // someone else has it
⁧اجعل الكتابة في النظام آمنة إذا تكررت⁩ ⁧قد تُسلَّم الرسالة ثم يتعطل العامل قبل أن يسجل ذلك. المحاولة التالية يجب ألا تنشئ عميلًا محتملًا ثانيًا. لذلك يُكتب معرّف GUID الخاص بالسجل في حقل مخصص على العميل في Odoo، وكل تسليم يبحث به أولًا: يحدّث إن وجده، وينشئ إن لم يجده. وجدول للتسليمات بمفتاح فريد لكل مزوّد وعملية وسجل يُبقي صفًّا واحدًا لكل إرسال منطقي.⁩ ⁧لكن البحث ثم الإنشاء ما زالا اتصالين. إن جرت رسالتان للسجل نفسه في الوقت نفسه، قد لا تجد أي منهما شيئًا فتنشئ كلتاهما. عالج رسائل السجل الواحد بالترتيب، أو ضع قيدًا فريدًا على ذلك الحقل في Odoo؛ الحقل وحده لا يجعل العملية ذرية.⁩ ⁧أعد محاولة ما يمكن أن يُشفى، وأمِت ما لا يُشفى⁩ ⁧كل فشل يأتي من عميل Odoo يُصنَّف مرة واحدة في مكان حدوثه، فلا يحتاج المُرسِل إلا إلى قراءة الجواب.⁩ ⁧أضف تفاوتًا عشوائيًا إلى فترات الانتظار، حتى لا تعيد دفعة من الإخفاقات المحاولة في الدقيقة نفسها.⁩ ⁧عامِل 408 و429 كأخطاء عابرة، واحترم Retry-After. من السهل تصنيفهما دائمين بالخطأ.⁩ ⁧اجعل إعادة المحاولة اليدوية تصفّر عدد المحاولات، وإلا نالت الرسالة الميتة محاولة واحدة ثم ماتت من جديد.⁩ ⁧أنواع الفشل، وما يفعله المُرسِل⁩ ⁧ما يحدث⁩ ⁧النوع⁩ ⁧الفشل⁩ ⁧إعادة بعد دقيقة، ثم 5 و15 و60 و360⁩ ⁧عابر⁩ ⁧انتهاء المهلة، خطأ شبكة، 5xx⁩ ⁧رسالة ميتة فورًا، ويظهر على العميل أن مزامنته فشلت⁩ ⁧دائم⁩ ⁧401 و403 وأي 4xx آخر⁩ ⁧رسالة ميتة فورًا⁩ ⁧دائم⁩ ⁧حمولة لا يمكن تحويلها⁩ ⁧رسالة ميتة، وتنبيه للم...
ASP.NET Core Transactional Outbox for Odoo Leads
Powered by Readybot.io

As últimas novidades de Pixel

Incident Response: Look Beyond the Red Alert

Pixel’s DEV Community announcement explores how teams can fixate on one failing service while overlooking the real cause of an outage, such as a full …

Sach: AI Fact-Checks WhatsApp Forwards in India

Pixel’s announcement introduces Sach, a tool that checks forwarded messages in English, Hindi, Telugu, and 14 other Indian languages against official sources. It gives cited …

Java 25 Removes SecurityManager: What to Fix

Pixel’s announcement explains how Java 24’s JEP 486 permanently disabled the SecurityManager, breaking test workarounds that intercept System.exit. It recommends returning exit codes or throwing …