مورد قطع غيار مصاعد يعرض ماكينة جر بسعر 500 ألف جنيه على المنصة. بقاعدة العمولة الأولى عندنا كانت المنصة ستكسب من هذا البند 1,000 جنيه فقط، أي 0.2%. ولو طبقنا نسبة 5% ثابتة كما تفعل منصات كثيرة، لأضفنا 25 ألف جنيه على سعر المشتري، وهو مبلغ يكفي ليتصل المشتري بالمورد مباشرة في الطلب القادم.
الإجابة المختصرة: احسب العمولة بالشرائح، بنفس منطق ضريبة الدخل. كل نسبة تُطبق فقط على الجزء من السعر الذي يقع داخل شريحتها، فتزيد العمولة مع حجم الطلب بينما تنخفض نسبتها الفعلية. سجّل العمولة كمستحقة عند تأكيد التسليم لا عند الدفع. ثم احفظها في دفتر يمنع كتابتين متزامنتين لنفس المورد، وإلا سيفسد الرصيد الجاري بصمت.
المشكلة التجارية: نسبة واحدة لا تناسب قطعة بألفين وماكينة بنصف مليون
أغلب الأسواق الإلكترونية تبدأ برقم واحد: "نأخذ 5%". هذا يصلح عندما تكون السلال متقاربة في الحجم. تجارة الشركات مختلفة. على منصة MONTRA، وهي سوقنا الإلكتروني لقطع غيار المصاعد في مصر، يبيع المورد نفسه كونتاكت باب بمئات الجنيهات وماكينة جر بمئات الآلاف.
النسبة الثابتة تفشل في الطرفين:
- في الطلبات الكبيرة تصبح مكلفة. 5% على قطعة بـ 300 ألف جنيه تساوي 15 ألف جنيه. عند هذا الحجم يجد المشتري والمورد كل الأسباب لإتمام الصفقة خارج المنصة.
- السقف يحل هذه المشكلة ويخلق غيرها. قاعدتنا الأولى كانت 3% بحد أقصى 1,000 جنيه. على الورق بدت معقولة. لكن السقف يُبلغ عند حوالي 33,300 جنيه، وبعده لا يضيف أي جنيه إضافي شيئًا للمنصة. أكبر الطلبات وأهمها كانت الأقل ربحًا، ولم يظهر ذلك في أي تقرير لأن كل رقم بمفرده كان "صحيحًا".
الخيارات المتاحة ومقارنتها
هذه الأشكال الثلاثة الشائعة مطبقة على نفس أسعار البنود. عمود الشرائح يستخدم الشرائح التي نعمل بها في MONTRA: 5% حتى 25 ألف جنيه، و3% من 25 ألفًا إلى 100 ألف، و1.5% فوق 100 ألف.
| سعر البند (جنيه) | نسبة ثابتة 5% | 3% بسقف 1,000 | شرائح 5 / 3 / 1.5% |
|---|---|---|---|
| 10,000 | 500 (5%) | 300 (3%) | 500 (5%) |
| 100,000 | 5,000 (5%) | 1,000 (1%) | 3,500 (3.5%) |
| 300,000 | 15,000 (5%) | 1,000 (0.33%) | 6,500 (2.17%) |
| 500,000 | 25,000 (5%) | 1,000 (0.2%) | 9,500 (1.9%) |
حساب بند بـ 300 ألف جنيه بالشرائح: أول 25 ألفًا بنسبة 5% تساوي 1,250. الـ 75 ألفًا التالية بنسبة 3% تساوي 2,250. الـ 200 ألف المتبقية بنسبة 1.5% تساوي 3,000. المجموع 6,500 جنيه، أي نسبة فعلية حوالي 2.17%.
ماذا يعني كل خيار لصاحب المنصة؟
- النسبة الثابتة: الأسهل في الشرح، ومناسبة لسلال المستهلكين المتقاربة. لكنها تدفع صفقات الشركات الكبيرة إلى خارج المنصة.
- النسبة مع سقف: تحمي المشتري الكبير، لكن الإيراد يتوقف عن النمو بعد نقطة السقف. إن كانت قيمة منصتك في الطلبات الكبيرة، فأنت تدعم أفضل عملائك من جيبك.
- الشرائح: العمولة تزيد دائمًا مع الطلب، فلا تكسب المنصة أقل من صفقة أكبر. والنسبة الفعلية تنخفض، فيحصل المشتري الكبير على سعر عادل. والجميع يفهم فكرة شرائح الضريبة، فيسهل شرحها للموردين.
ميزة أخرى: الشرائح لا تحتوي على "قفزات". تجاوز 25 ألف جنيه لا يعيد حساب البند كله بنسبة 3%؛ الجنيهات التي تزيد على 25 ألفًا فقط هي التي تأخذ النسبة الأقل. لذلك لا يستفيد أحد من تقسيم طلب أو دمجه للنزول إلى شريحة أرخص.
كيف بنيناها في MONTRA
في MONTRA يضع المورد سعره بنفسه. تُحسب عمولة المنصة على سعر المورد، بندًا بندًا، وتُضاف فوقه لتكوين السعر الذي يراه المشتري، مع حد أدنى للهامش حتى لا تبيع المنصة بسعر التكلفة. رقم المورد نفسه لا يُمس.
ثلاث قواعد تجارية حددت باقي التصميم:
- الشرائح إعداد وليست كودًا. تُحفظ الشرائح في إعدادات النظام كمصفوفة JSON صغيرة، ويعدلها المدير دون نشر نسخة جديدة، وتعرض لوحة الإدارة أمثلة للعمولة على أسعار نموذجية. المدقق يرفض الشرائح غير المرتبة، أو نسبة خارج المدى من 0 إلى 1، أو شريحة أخيرة لها حد أعلى.
- العمولة تُستحق عند التسليم. الطلب قد يُلغى أو يفشل تسليمه جزئيًا قبل وصول البضاعة. لذلك لا نسجل العمولة إلا عند تسليم الطلب الفرعي، وهذا مربوط في MONTRA بإذن التسليم.
- رصيد واحد لكل مورد في الاتجاهين. أحيانًا يحصّل المورد الثمن نقدًا عند التسليم، بما فيه حصة المنصة، فيصبح مدينًا للمنصة. وأحيانًا تحتفظ المنصة بمبلغ من الطلب، كعربون أو دفع مسبق، فتصبح هي المدينة للمورد. الحالتان تدخلان في رصيد جارٍ واحد بإشارة موجبة أو سالبة.
إذن التسليم هو نقطة البداية
كل طلب فرعي (حصة مورد واحد من طلب العميل) له إذن تسليم واحد فقط، وهذا مفروض بقيد فريد في قاعدة البيانات. الإذن يذكر الأصناف والكميات ولا يحتوي على أي أسعار، فيمكن تسليمه لمهندس الموقع أو مسؤول المبنى دون كشف الهوامش.
يُؤكد الإذن بأربع طرق: المورد يؤكد، أو العميل يقر بالاستلام، أو المدير يتدخل، أو تأكيد تلقائي بعد مهلة 48 ساعة. التأكيد هو ما يسجل العمولة.
أما المبالغ التي تحتفظ بها المنصة فننتظر فيها أكثر. يستطيع المورد أن يعلن تسليم طلبه بنفسه، لكن المبلغ المحتجز لا يُصرف له حتى يقر العميل بالاستلام، أو يؤكد المدير، أو تمر فترة احتجاز محددة في الإعدادات.
إذن تسليم لطلب فرعي: أسماء الأصناف والكميات بدون أسعار، وحالة التأكيد ومن قام به
فاتورة شهرية وحد ائتماني
تتجمع العمولات المستحقة في فاتورة عمولة شهرية لكل مورد، تصدر أول كل شهر بتوقيت القاهرة، وتوجد مهمة يومية تتابع الفواتير المتأخرة. ويمكن أن يكون للمورد حد ائتماني؛ إذا وصل رصيده المستحق إليه توقف إسناد طلبات جديدة له حتى ينخفض الرصيد، مع إشعار المورد والإدارة.
نسختنا الأولى كانت تتعامل مع الدفع عند الاستلام بطريقة مختلفة: عند تأكيد المورد استلام النقدية كان النظام يكتب سجلي دفع، الأول من العميل إلى المنصة والثاني من المنصة إلى المورد. كان هذا يصف حركة المال، لكنه لا يعبر عن حقيقة أن المورد يحمل حصة المنصة في يده. استبدلناه بالدفتر ذي الرصيد الموقّع، حيث يُسجل المبلغ المحتجز أولًا ثم المستحقات، فلا يظهر في كشف المورد أبدًا رصيد "مدين للمنصة" لم يحدث فعلًا.
صفحة رصيد المورد: الرصيد الجاري، قيود العمولة، قيود المبالغ المحتجزة، وفاتورة الشهر الحالي
من الداخل: دالة الشرائح
الحساب نفسه صغير، كل شريحة تحسب جزءها فقط:
function bandedCommission(price: number, bands: Band[]): number {
if (!Number.isFinite(price) || price <= 0) return 0;
let commission = 0;
let floor = 0;
for (const band of bands) {
const ceiling = band.upTo ?? Infinity; // last band is open-ended
const sliceEnd = Math.min(price, ceiling);
if (sliceEnd > floor) commission += (sliceEnd - floor) * band.rate;
if (price <= ceiling) break;
floor = ceiling;
}
return commission;
}
// bandedCommission(300_000, defaults) === 6_500
الصعوبة الحقيقية لم تكن في المعادلة، بل في إبقاء الدفتر صحيحًا.
من الداخل: سباق الكتابة في الدفتر على MySQL
دفتر العمولات في MONTRA يُضاف إليه فقط ولا يُعدل. كل قيد يخزن الرصيد قبله (balanceBefore) والرصيد بعده (balanceAfter)، وكل قيد جديد يبدأ من رصيد القيد السابق. هذه السلسلة هي ما يجعل الدفتر قابلًا للمراجعة: يمكنك إعادة حسابه من الصفر ويجب أن تتطابق كل خطوة. ومهمة يومية تفعل ذلك لكل مورد وتنبه الإدارة عند أي اختلاف.
المشكلة تظهر عندما تحدث كتابتان لنفس المورد في نفس اللحظة: تسليمان مؤكدان في نفس الثانية، أو تسليم وعكس قيد، أو سداد فاتورة وإعفاء:
T1 (delivery A) T2 (delivery B)
read latest entry -> balance 4,000
read latest entry -> balance 4,000
insert: 4,000 -> 4,500
insert: 4,000 -> 4,700
commit commit
Chain now: 4,000 -> 4,500, then 4,000 -> 4,700 (forked)
Stored balance: 5,200 (still right)
الرصيد المخزن للمورد كان يُحدث بزيادة ذرية، فبقي الإجمالي صحيحًا. أما السلسلة فانكسرت: قيدان يبدآن من نفس النقطة. إجمالي صحيح فوق تاريخ خاطئ هو أسوأ أنواع أخطاء المال، لأن شيئًا لا يتعطل حتى تأتي المراجعة.
الإصلاح الأول: كاتب واحد لكل مورد
كل مسار في الكود يكتب في دفتر مورد يقفل صف هذا المورد أولًا:
export async function lockTraderLedger(tx, traderId: string) {
await tx.$queryRaw`
SELECT id FROM trader_profiles WHERE id = ${traderId} FOR UPDATE`;
}
المعاملة الثانية تنتظر الآن حتى تنتهي الأولى. وثبتنا ترتيبًا للأقفال (صف الطلب الفرعي، ثم صف المورد، ثم سجلات العمولة) حتى لا تقع المسارات المختلفة في قفل متبادل.
الإصلاح الثاني: القفل وحده لم يكفِ
بعد إضافة القفل ظلت السلسلة تنكسر أحيانًا. السبب في طريقة القراءة في InnoDB تحت مستوى العزل الافتراضي REPEATABLE READ. توثيق MySQL واضح: كل القراءات العادية داخل المعاملة تقرأ اللقطة (snapshot) التي أنشأتها أول قراءة منها، والتغييرات التي تثبتها معاملات أخرى بعد ذلك لا تراها جمل SELECT العادية.
مسار تسجيل العمولة يقرأ الطلب الفرعي قبل الوصول إلى قفل المورد، وتلك القراءة الأولى تثبت اللقطة. ثم تنتظر المعاملة القفل بينما تضيف المعاملة الأخرى قيدها وتثبته. وعندما تحصل الأولى على القفل وتقرأ "آخر قيد" بقراءة عادية، تقرأ من لقطتها القديمة وتحصل على نفس القيد القديم. القفل رتّب الكتّاب، لكن الثاني كان ينظر إلى الماضي.
الحل هو قراءة آخر قيد بقراءة قافلة. ينص دليل MySQL على أن SELECT ... FOR UPDATE تقرأ أحدث بيانات متاحة وتضع أقفالًا حصرية على الصفوف التي تقرؤها:
const rows = await tx.$queryRaw`
SELECT balanceAfter, createdAt FROM commission_ledger_entries
WHERE traderId = ${traderId}
ORDER BY createdAt DESC, id DESC
LIMIT 1
FOR UPDATE`;
وطبقنا نفس القاعدة على علامة "هل سُجلت العمولة؟" في الطلب الفرعي، فهي تُقرأ أيضًا بـ FOR UPDATE، حتى لا يسجل تأكيد التسليم وإعادة المحاولة العمولة مرتين.
حالات أصغر عالجناها
- توقيتات متساوية: قيدان في نفس الملّي ثانية ليس لهما ترتيب محدد عند قراءتهما بـ
createdAt. لذلك يأخذ كل قيد جديد توقيتًا بعد القيد السابق بشكل صارم. - سداد الفاتورة: عند تسجيل سداد فاتورة يُخصم مبلغ الفاتورة من الرصيد، ولا يُستبدل الرصيد بقيمة محسوبة مسبقًا، لأن عمولة جديدة ربما سُجلت بين إصدار الفاتورة وسدادها. ولدينا اختبار انحدار لهذه الحالة بالتحديد.
- توقف الخادم بين خطوتين: حالة التسليم تُثبت أولًا، ثم يجري تسجيل العمولة في معاملة مستقلة. لو توقف الخادم بينهما، تبحث مهمة تسوية كل 30 دقيقة عن الطلبات المسلمة بلا عمولة وتعيد تشغيلها. ولأن التسجيل آمن عند التكرار (قفل الصف مع إعادة فحص العلامة)، فتشغيله مرتين لا يضر.
دفتر عمولات مورد في لوحة الإدارة: القيود مع الرصيد قبل وبعد، أنواع القيود، وحالة فحص التطابق
قائمة مراجعة لمن يصمم عمولة سوق إلكتروني
- جرّب كل شكل للعمولة على توزيع طلباتك الحقيقي. مرّر أكبر 10 طلبات عندك على كل خيار قبل أن تختار.
- إن استخدمت سقفًا، احسب حجم الطلب الذي يبدأ عنده، وكم من إيرادك يقع فوقه.
- فضّل الشرائح الحدية في تجارة الشركات، وتأكد أن الجزء الذي يتجاوز الحد فقط هو ما يأخذ النسبة الأقل.
- احفظ الشرائح كإعداد مُدقق، مع بديل آمن ومعروف إن حُفظت قيمة خاطئة.
- حدد الحدث الذي يجعل العمولة مستحقة (التسليم، أو القبول، أو انتهاء مهلة الإرجاع)، واجعله مستندًا مسجلًا لا مجرد حالة يغيرها أي شخص.
- استخدم رصيدًا واحدًا بإشارة لكل مورد في الاتجاهين، وسجّل المبالغ المحتجزة قبل المستحقات.
- اجعل كل من يكتب في الدفتر يقفل صف المورد قبل قراءة القيد السابق، واقرأ هذا القيد بقراءة قافلة إن كنت تعمل على MySQL بمستوى REPEATABLE READ.
- أعد حساب سلسلة الدفتر بشكل دوري ونبّه عند أي اختلاف.
لمزيد من التفاصيل عن بقية مكونات المنصة، راجع قائمة تحقق النسخة الأولى من سوق قطع الغيار، ولفهم ما يحدد ميزانية المشروع اقرأ تكلفة تطبيق سوق إلكتروني في مصر والسعودية.
الأسئلة الشائعة
ما هي العمولة بالشرائح في السوق الإلكتروني؟
هي عمولة تُطبق فيها نسب مختلفة على أجزاء مختلفة من السعر، مثل شرائح ضريبة الدخل. مثلًا 5% على أول 25 ألفًا، و3% على الـ 75 ألفًا التالية، و1.5% على ما بعدها. العمولة تزيد دائمًا مع قيمة الطلب، بينما تنخفض نسبتها الفعلية.
هل وضع حد أقصى للعمولة فكرة جيدة؟
السقف يحمي المشتري الكبير، لكن المنصة لا تكسب شيئًا إضافيًا بعد بلوغه. إن كانت الطلبات الكبيرة تمثل معظم حجم تعاملاتك، فقد تجد نفسك تكسب جزءًا من الواحد في المئة على أهم صفقاتك. الشرائح تعطي المشتري الكبير نسبة أقل دون أن يتوقف نمو الإيراد.
متى تُسجل عمولة المنصة كمستحقة؟
عند تسليم البضاعة وتأكيد التسليم، لا عند الدفع. قبل التسليم يمكن أن يُلغى الطلب أو يفشل. ربط العمولة بإذن تسليم يعطيك مستندًا ترجع إليه إن اعترض مورد على عمولة.
لماذا تهم SELECT FOR UPDATE في دفتر حسابات على MySQL؟
تحت مستوى العزل الافتراضي في InnoDB، القراءات العادية تستخدم لقطة أُخذت عند أول قراءة في المعاملة. معاملة انتظرت قفلًا قد تقرأ "آخر قيد" قديمًا من تلك اللقطة. القراءة القافلة تعيد أحدث صف مثبت، فيبدأ كل قيد جديد من الرصيد الحقيقي.
هل يبطئ قفل الصف المنصة؟
القفل خاص بكل مورد، ويستمر فقط أثناء الجمل القليلة التي تضيف قيدًا لدفتره. الكتابات لموردين مختلفين تجري بالتوازي. فقط العمليات المالية المتزامنة لنفس المورد تنتظر بعضها، وهي بالضبط التي يجب ألا تتداخل.
الخطوة التالية
إن كنت تدير سوقًا إلكترونيًا أو تخطط له، ابدأ بتمرير أكبر طلباتك الحقيقية على كل شكل للعمولة في جدول بسيط؛ الأرقام غالبًا تحسم القرار. وإن أردت بناء الدفتر وأذون التسليم والفوترة بشكل صحيح من اليوم الأول، أرسل لنا وصفًا مختصرًا لمشروعك وسنوضح لك ما يتطلبه في حالتك.