AZVYRAمركز التوثيق
EN ع
الملاحق·42

قواعد تشغيل ملزمة

قواعد لا بد من تثبيتها قبل التطوير: الفصل بين الحالات، الدفع، الصلاحيات، والتتبع.

3 دقيقة قراءة آخر تحديث 3 نوفمبر 2026 لمنالأدمن · المدرب الرئيسيمالك المنصة التقنية

1. حالات الطلب والاشتراك منفصلة#

لا تُمثّل حالة الحساب وحالة طلب التسجيل وحالة الاشتراك بحقل واحد. لكل منها دورة حياة مستقلة:

  • الحساب: نشط، غير موثّق، موقوف، محذوف/مجدول للحذف.
  • الطلب: مسودة، ينتظر الاستبيان، ينتظر المراجعة، يحتاج معلومات، مقبول، مرفوض.
  • الاشتراك: ينتظر الدفع، فعّال، قريب الانتهاء، مجمّد، منتهٍ، ملغى، مسترد جزئيًا/كليًا.

    2. الدفع لا يفعّل الاشتراك بمجرد العودة من صفحة البوابة#

    تفعيل الاشتراك يتم بعد التحقق من Webhook موقّع من مزود الدفع، مع منع تكرار معالجة نفس العملية (Idempotency)، ومطابقة المبلغ والعملة والطلب. صفحة العودة للمتصفح ليست مصدر إثبات الدفع.

    3. صلاحيات Google Sheets#

  • لا تُنشأ روابط عامة لملفات تحتوي بيانات صحية أو قياسات.
  • المشاركة تكون على حسابات محددة، مع إمكانية إلغاء الصلاحية.
  • المتدرب يحصل افتراضيًا على Viewer، ولا يحصل على Editor إلا بقرار واضح.
  • تسجّل عمليات إنشاء الملف والمشاركة والإلغاء والمزامنة.
  • فشل المزامنة لا يوقف المنصة ولا يغيّر بيانات قاعدة البيانات.

    4. التتبع والتحليلات#

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

    5. المساعد الذكي#

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

    6. تعريف مؤشرات الأداء#

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

    7. معايير قبول تفصيلية#

  • لا يستطيع المتدرب الوصول إلى ملف متدرب آخر بتغيير ID في الرابط أو API.
  • لا يستطيع المدرب المساعد رؤية متدرب غير معيّن له.
  • لا يستطيع أخصائي التغذية تعديل برنامج التمارين إلا بصلاحية صريحة.
  • لا يُفعّل اشتراك دون إثبات دفع صحيح أو تسجيل دفع يدوي موثق.
  • كل تعديل على خطة منشورة يحفظ نسخة سابقة واسم من عدّل ووقت التعديل.
  • كل صورة تقدم أو ملف صحي خاص لا يمكن الوصول إليه برابط عام.
  • يمكن إعادة إرسال الإشعار دون إنشاء دفعة أو فاتورة مكررة.
  • يمكن استعادة نسخة احتياطية في بيئة اختبار والتحقق من سلامة الملفات وقاعدة البيانات.
  • تعمل الواجهات الأساسية بالعربية RTL والإنجليزية LTR وعلى أحجام الجوال والكمبيوتر.
  • تُختبر الرحلات الأساسية آليًا: التسجيل، الموافقة، الدفع، التفعيل، تسجيل التمرين، تسجيل الوجبات، التقييم الأسبوعي، التجديد والانتهاء.

    8. إدارة التغيير#

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