التدقيق واختبار الضغط

تدقيق نسخة الويب واختبار ضغطها

مراجعة كاملة لنسخة الويب في سبتمبر ٢٠٢٦؛ الأمن والصحة والأداء، مع الإصلاحات التي نتجت عنها والأرقام التي قاستها.

الخلاصة

رُوجعت نسخة الويب من طرف إلى طرف في ٥ سبتمبر ٢٠٢٦: مراجعة أمنية على مستوى الشيفرة، ومراجعة للصحة مقابل قواعد تطبيق الجوال، واختبار ضغط بأكاديمية من ٢٬٠٠٠ متدرب وحتى ١٠٠ مستخدم متزامن. لم يُعثر على أي خلل في سلامة البيانات أو الأمن. أنتجت المراجعة تسعة تحسينات (مذكورة أدناه) دُمجت كلها، ومجموعة حدود مقاسة يعكسها دليل النشر الآن.

النطاق والمنهج

• مراجعة الشيفرة لكل وحدة في الخادم: المصادقة، إدارة الجلسات، حماية الطلبات، إجراءات النماذج، تقديم الملفات، استيراد/تصدير النسخ الاحتياطي، طبقة SQLite وصورة Docker.
• مقارنة قاعدة بقاعدة مع مواصفات تطبيق الجوال (معادلة الرصيد، الثابت الذهبي لـ final_amount، استهلاك رصيد الجلسات، سلاسل الأرشفة، مفاتيح إزالة تكرار التنبيهات، حدود الإحالة، غلاف النسخ الاحتياطي).
• فحوصات آلية: ٣٧ اختبار وحدة بـ Vitest على قاعدة بيانات مؤقتة، واختبار دخان HTTP من ٢٠ خطوة يقود كل شاشة عبر إجراءات النماذج نفسها التي يستخدمها المتصفح، وsvelte-check، وnpm audit.
• اختبار الضغط: أكاديمية من ٢٬٠٠٠ متدرب مُلئت عبر HTTP، ثم مزيج موزون من تحميلات صفحات حقيقية وعمليات كتابة من ٢٥ و٥٠ و١٠٠ مستخدم افتراضي، ٣٠ ثانية لكل منها، على حاسوب محمول واحد شغّل مولد الحمل أيضًا (لذا كل الأرقام أدناه متحفظة).

المراجعة الأمنية

ملاحظات متبقية: يوجد دور مدير واحد (لا أذونات لكل مستخدم)، ولا تسجيل دخول بعاملين، ولا TLS مدمج (يُنهى HTTPS عند الوكيل، وهو ما يفعله Coolify).

مراجعة الصحة

تُتُبِّعت كل قاعدة في تطبيق الجوال إلى شيفرة الويب وغُطيت باختبار:

• الرصيد = Σالفواتير − Σالخصومات − Σالإحالة − Σالدفعات + Σالتسويات − Σالمسترد؛ الصفوف الملغاة تُحتسب صفرًا؛ لكل عملة.
• enrollment.final_amount يساوي دائمًا الدفتر الحي لذلك التسجيل؛ يُعاد حسابه بعد كل إدراج وتعديل وإلغاء واستعادة؛ والتسجيل الذي أُلغيت كل صفوفه يُعاد حسابه إلى الصفر.
• الخصم اليدوي لا يتجاوز الرسوم أبدًا (النموذج والمستودع).
• الحاضر والمتأخر يستهلكان رصيد جلسة؛ الغائب والمعذور لا؛ تغيير الحالة يعيد الرصيد أو يخصمه.
• إلغاء التسجيل يلغي الفاتورة والخصم ورصيد الإحالة ويُبقي الدفعات، فيصبح المتدرب دائنًا.
• سلاسل الأرشفة تسم الأبناء؛ الاستعادة تعيد أولئك فقط؛ استعادة صف تستعيد فصله المؤرشف.
• الحذف النهائي يتطلب سجلًا مؤرشفًا ويكتب الأرصدة النهائية في سجل التدقيق؛ حذف الفصل والصف يلغي صفوف الدفتر ويفصلها.
• حدود الإحالة تقيّد الرصيد بالمبلغ المستحق ولا تُستهلك عندما لا يمكن منح شيء؛ تُرفض الإحالات الذاتية والدائرية.
• تُزال تكرارات التنبيهات بالمفتاح؛ تنبيهات الرصيد المنخفض مفتاحها العدد المتبقي.
• النسخ الاحتياطية تذهب وتعود بايتًا ببايت مع تنسيق الجوال؛ تُرفض كلمات المرور الخاطئة والبايتات المعدَّلة.

قرار تصميمي واحد بقي دون تغيير وموثَّق: نوع الصف refund يقلّل الرصيد كالدفعة ولا تنشئه أي شاشة.

التحسينات المنجزة خلال التدقيق

1. سياسة أمن المحتوى بـ nonce (script-src 'self').
2. تقسيم قائمة المتدربين إلى صفحات (٦٠ في الصفحة) مع عدّ كامل؛ وتقسيم الإشعارات (٥٠ في الصفحة).
3. تقييد قوائم لوحة التحكم بما يُعرض؛ وإعادة كتابة مرشح المدين من استعلام فرعي مترابط إلى تمريرة مجمَّعة واحدة على الدفتر.
4. عدّ متدربي قائمة صفوف الحضور في استعلام مجمَّع واحد بدلًا من استعلام لكل صف.
5. صفحات الصف والفصل والإحالات تحمّل فقط أسماء المتدربين التي تعرضها.
6. تخزين الإعدادات في الذاكرة لثانية (١٤ استعلامًا أقل لكل طلب).
7. ترويسة X-Response-Time على كل استجابة للعمليات.
8. وضع متعدد العمليات اختياري (WORKERS=n|auto)؛ يعمل المجدوِل في عملية واحدة فقط.
9. علامة Secure لملف تعريف الارتباط تتبع بروتوكول الطلب؛ والتشغيل المحلي يشتق ORIGIN تلقائيًا.

اختبار الضغط

مجموعة البيانات

استغرق ملء ٢٬٠٠٠ متدرب وتسجيلاتهم ودفعاتهم و٤٨٠ كشف حضور عبر HTTP ٢٧ ثانية.

زمن الخادم لطلب واحد (وسيط ٥ محاولات)

الحمل المتزامن، ٣٠ ثانية لكل تشغيل

كان المزيج ٢٠٪ لوحة تحكم، ٢٠٪ قائمة متدربين بمرشحات وبحث، ٢٥٪ تبويبات ملف، ٨٪ صفوف وفصول، ١٠٪ كشوف حضور، ٥٪ إشعارات، ١٢٪ كتابة (ملاحظات ودفعات). ذاكرة العملية الواحدة: ١٩٩ ميغابايت قبل التشغيل، ٣٣٠ ميغابايت بعده. صفر أخطاء من جهة الخادم في كل تشغيل.

قراءة الأرقام

• بعملية واحدة يجيب الخادم نفسه في نحو ١٥ ملّي ثانية وسيطًا؛ والكمون من جهة العميل عند ١٠٠ مستخدم هو اصطفاف أمام نواة واحدة. أربعون صفحة في الثانية تعني نحو ٢٬٤٠٠ مشاهدة في الدقيقة، وهو أبعد بكثير من حركة أكاديمية واحدة.
• أربع عمليات على الحاسوب نفسه ضاعفت الإنتاجية ثلاث مرات إلى ١٢٧ صفحة/ث بينما كان مولد الحمل ينافس على المعالج نفسه. على مضيف مخصص، اضبط WORKERS=auto.
• تعامل SQLite في وضع WAL مع مزيج الكتابة (ملاحظات، دفعات، حضور) دون أخطاء انشغال.

التوصيات

• انشر خلف HTTPS (وكيل Coolify) واضبط ORIGIN؛ وأبقِ TZ صحيحة ليتوافق النسخ اليومي و«اليوم» مع ساعتك.
• اضبط WORKERS=auto على المضيفات ذات أكثر من نواة.
• خذ النسخ الاحتياطية المشفّرة للتطبيق بانتظام والتقط لقطة لحجم /data؛ واختبر استعادة مرة واحدة.
• احفظ كلمة مرور المدير في مدير كلمات مرور؛ وبدّلها من الإعدادات → الحساب عند تغيّر الموظفين.