IMMAR

المشكلة

كل معلّم يدير مساحة عمل معزولة لها دوراتها وفريقها وأكواد اشتراكها وإيراداتها، على قاعدة كود واحدة مشتركة وقاعدة بيانات واحدة، فلا بدّ أن يُغلق المرشّح المنسي الوصول بدل أن يكشف بيانات معلّم آخر.

يجب أن يتوقف تسرّب المحتوى: فيديو يُقدَّم بصيغة HLS مشفّرة خلف رموز تشغيل قصيرة العمر لكل مشاهد مع علامة مائية على الشاشة، وملفات PDF موسومة ببيانات الطالب، وكل حساب محدود بعدد قليل من الأجهزة المسجّلة.

يُباع الوصول على شكل أكواد مطبوعة تُستخدم مرة واحدة وتُفعَّل من الهاتف عبر شبكات جوال غير مستقرة، فلا يجوز أن يفتح الكود دورة مرتين ولا أن يضيع بسبب طلب مُعاد، وكل تفعيل مدفوع يجب أن يسجّل عملية بيع مع تجميد العمولة في تلك اللحظة.

الهوية برقم الهاتف فقط مع OTP، والمنتج بالعربية أولًا وبتخطيط من اليمين إلى اليسار والإنجليزية ثانيًا، والقواعد نفسها للامتحانات والأكواد والصلاحيات يجب أن تصمد عبر تطبيق Flutter ولوحة تحكم ويب يتحدثان إلى API واحدة.

الدور والمسؤوليات

قيادة الـ Backend في فريق من مهندسَين: المعمارية الأولية ومعظم الكود، 60 من 63 متحكّم API، و364 نقطة نهاية HTTP عبر 6 أسطح جمهور، و74 كيان نطاق مربوطة 1:1 بـ 74 جدول PostgreSQL، و20 من 24 ترحيل EF Core، ومراجعة 57 من 61 طلب دمج.

الهوية والوصول والعزل: تسجيل برقم الهاتف فقط مع OTP، وJWT بمطالبات صلاحيات مقيّدة بمساحة العمل وتدوير رموز التحديث مع كشف إعادة الاستخدام، وحدّ الأجهزة لكل طالب، و6 سياسات مسمّاة لحدّ المعدل، ونموذج RBAC يبدأ من الصلاحية بـ 60 مفتاحًا و8 أدوار نظام على 286 إجراء في المتحكّمات، ومرشّح EF Core عام يُغلق عند الفشل على كل كيان مقيّد بمساحة عمل.

تدفّقات المال والامتحانات: دفعات أكواد الاشتراك وتفعيل محصّن من حالات التسابق في معاملة واحدة مع تجميد العمولة على كل عملية بيع، ودورة حياة التسويات (مسودة، معتمدة، مدفوعة) مع تعديلات بالإلحاق فقط وإيصالات، ومحاولات امتحان على ساعة الخادم مع الحفظ التلقائي والتصحيح الآلي ومهمة كنس للمحاولات منتهية الصلاحية (أقسام الامتحان وتزامن التصحيح بُنيا بالاشتراك مع زميله)، و23 نوعًا من أحداث الإشعارات تُفرَّغ إلى FCM عبر مهام خلفية.

محوّلات المزوّدين والمهام والاختبارات: محوّلات Cloudflare Stream وS3 وFCM HTTP v1 والرسائل النصية مع بديل تطويري خلف كل منفذ (وسم PDF بالعلامة المائية من زميله)، ومنصة Hangfire بـ 17 مهمة مع سجل لتشغيلات المهام ومعالجة dead-letter، وحِزمة اختبارات التكامل على PostgreSQL، ومعظم دوال اختبار xUnit البالغ عددها 1,520، وCI وملف Dockerfile.

خارج الـ Backend: حزمة التصميم التأسيسية التي بنى الفريق عليها (SRS والمعمارية والاتفاقيات ودليل التشغيل)؛ وهيكل لوحة تحكم React 19 وطبقة API مُنمَّطة (37 كائن خدمة و270 دالة) وتوجيه يبدأ من الصلاحية ولوحة إدارة المنصة، مع النظام البصري وجداول البيانات ومنشئ التقييمات من زميله؛ وإشعارات الدفع والإعلانات وإصلاحات مشغّل الفيديو في تطبيق Flutter الذي يقوده زميله.

عزل لا يمكن نسيانه

يحصل كل كيان مقيّد بمساحة عمل على مرشّح EF Core عام واحد مركّب (الحذف الناعم ومساحة العمل) يُبنى عند بناء النموذج، ونطاق لكل طلب يُغلق على مساحة عمل فارغة عندما لا يُحَلّ شيء، ووضع للمهام الخلفية يرمي استثناءً بدل أن يعيد صفر صفوف بصمت عندما لا تعلن المهمة نطاقها؛ ويختم معترض SaveChanges مساحة العمل ويتحقق منها في كل كتابة. تنتقل صلاحيات المعلّم داخل الرمز كمطالبات مؤهَّلة بمساحة العمل، فلا يُحَلّ حق مُنح في مساحة عمل داخل أخرى أبدًا، وقراءة عبر مساحات العمل تُجاب بـ 404 لا 403. وبذلك يظهر المرشّح المفقود كصفحة فارغة أو استثناء في اختبارات التكامل الـ 91 على PostgreSQL، لا كبيانات معلّم آخر أبدًا.

كود الاشتراك حدث مالي

تفعيل الكود يجب أن يقلب حالة الكود، وينشئ التسجيل، ويسجّل عملية البيع مع تجميد نسبة العمولة عليها، ويزيد عدّاد الدورة، كوحدة واحدة، من هاتف قد يعيد المحاولة. يعمل ذلك في معاملة صريحة واحدة مع قفل صف على مسار التجديد، وفهرس فريد جزئي على (الطالب، الدورة) النشطين يرفض التكرارات المتزامنة، وأضاف زميله سياسة مخصصة لحدّ المعدل على نقطة التفعيل ومخزن Idempotency-Key كي تحصل المحاولة المُعادة بعد انتهاء المهلة على الاستجابة الأصلية بدل خطأ ملتبس بأن الطالب مسجّل أصلًا. تغييرات النسبة اللاحقة لا تعيد كتابة التاريخ أبدًا، لأن النسبة تعيش على عملية البيع لا على المعلّم.

فيديو يكلّف توقيعًا واحدًا لكل تشغيل

تُبثّ الدروس المحمية من Cloudflare Stream بصيغة HLS مشفّرة، لكن طلب رابط موقّع من API المزوّد عند كل تشغيل سيكون بطيئًا ومقيّد المعدل. يسكّ الـ Backend رمز التشغيل قصير العمر محليًا بصيغة المزوّد نفسها، مربوطًا بالطالب والجهاز والدرس والأصل وعنوان IP ومدقَّقًا عند كل إصدار، ويعيد نص العلامة المائية الخاص بالطالب إلى جانب الـ manifest ليعرضه التطبيق. أما اختيار الجودة، الذي لا يتيحه المزوّد، فيأتي من تحليل قائمة تشغيل HLS الرئيسية مرة واحدة وقت التحويل وإعادة توقيع كل نسخة جودة وقت التشغيل، ويُقرأ webhook التحويل كبايتات خام ويُتحقق منه بـ HMAC قبل أي ربط للنموذج.

النتيجة

Backend واحد يخدم التطبيقين: 63 متحكّمًا و364 نقطة نهاية فوق 74 جدولًا، و60 مفتاح صلاحية و8 أدوار نظام على 286 إجراء محكوم، و17 مهمة Hangfire مفهرسة، و5 محوّلات مزوّدين إنتاجية، و86 رمز خطأ ثابتًا بمدخلات كتالوج عربية وإنجليزية، مدعومة بـ 1,951 حالة اختبار وحدة ناجحة و91 اختبار تكامل على PostgreSQL. وحوله لوحة تحكم React 19 بـ 57 شاشة موجَّهة و3,343 مفتاح ترجمة بتطابق تام بين العربية والإنجليزية و679 اختبار Vitest، وتطبيق Flutter للطلاب على Android وiOS بـ 43 شاشة و711 مفتاح ترجمة لكل لغة، وصفحة هبوط عامة. مشروع عميل مستمر بناه مهندسان، قيد التطوير منذ يوليو 2026.

ماذا تعلّمت

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

في منتج يُباع بالأكواد، حدود المعاملة هي المنتج: التفعيل والتسجيل وعملية البيع وعمولتها المجمّدة يجب أن تُلتزم معًا، والمحاولة المُعادة من شبكة سيئة تحتاج إلى إجابة idempotent لا إلى خطأ.

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