الإشعارات والتذكيراتNotifications and reminders

B44التكاملاتمتطلب وارد في الملفات اقتراح هندسي

محرك واحد للتذكيرات (جلسات، مهل، وكالات، تقارير، فواتير) بقواعد Reminder Rule (الحدث، الإزاحة، القناة، القالب)، ورسائل من قوالب معتمدة، وإشعارات جوال بنص عام.

بطاقة الميزة

البند	القيمة
1. اسم الميزة	الإشعارات والتذكيرات — Notifications and reminders
2. المعرّف (Feature ID)	`B44`
3. مصدر المتطلب	دليل المطور ص12، 20، 27، 41
4. تصنيف المحتوى	متطلب وارد في الملفات قواعد التذكير بفترات قابلة للتعديل، القوالب المعتمدة، الإشعارات بلا أسرار. اقتراح هندسي قناة احتياطية وتسجيل التسليم.
الوحدة	التكاملات
الأدوار المعنية	محامٍ، موكّل، شريك
درجة الخطورة	عالية
حالة الاعتماد	معتمد في الوثائق
المنصات المرتبطة	منصة واتساب للأعمال، مزود الرسائل النصية المحلي، إشعارات الجوال (FCM/APNs)، البريد الإلكتروني

5الهدف التجاري والمشكلة التي تعالجها

التذكير الذي لا يصل كأنه لم يكن؛ والرسالة التي تحمل سرًا خارج المملكة تسرّب.

6المجال القانوني المرتبط للمطوّر غير المتخصص

التسويق بموافقة فقط B39 الامتثال لنظام حماية البيانات الشخصية.

7المستخدمون والأدوار والصلاحيات

المستلمون بحسب الحدث.

8شروط البدء والاعتماديات

القنوات مفعّلة، والقوالب معتمدة منصة واتساب للأعمال.

9السيناريو الأساسي خطوة بخطوة

الحدث يُجدول التذكيرات بحسب القواعد.
عند الموعد: تكوين الرسالة من القالب ببيانات لا تكشف خارج القناة الآمنة.
الإرسال عبر طبقة التكامل B43 طبقة التكامل المركزية.
تسجيل التسليم؛ الفشل يجرب القناة الاحتياطية اقتراح هندسي.

10السيناريوهات البديلة والاستثناءات

تغيّر الحدث (موعد جلسة): إعادة جدولة (دليل المطور ص39). مهلة: 7 و3 و1 يوم وصباح آخر يوم، وتصعيد للشريك (دليل المطور ص41).

11المدخلات والحقول

الاسم العربي	الاسم البرمجي	النوع	إلزامي	التحقق	القيمة الافتراضية	مصدر البيانات
الحدث	`event`	Select	نعم	—	—	(دليل المطور ص27)
الإزاحة	`offset`	Duration	نعم	—	—	المكتب
القناة	`channel`	Select	نعم	واتساب / SMS / بريد / جوال / داخلي	—	—
القالب	`template`	Link → Message Template	نعم	معتمد	—	—

12المخرجات والإشعارات والسجلات والتقارير

سجل التسليم.

13قواعد العمل بصيغة قابلة للتحويل إلى كود

قواعد

RULE B44.1  push/SMS text generic (no names, case numbers, content)
RULE B44.2  WhatsApp outside 24h -> approved template only
RULE B44.3  reschedule on source change; cancel on source cancel
RULE B44.4  dedupe: (event, record, offset, recipient) sent once

التفاصيل في جدولة التذكيرات وإعادة المحاولة.

14حالات السجل وانتقالاتها وشروطها

مجدول ← مرسل ← مسلّم / فشل.

15نموذج البيانات والعلاقات والقيود والفهارس

Reminder Rule، Message Template (دليل المطور ص27)، Notification Delivery اقتراح هندسي.

16DocTypes المطلوبة في Frappe

الثلاثة المذكورة.

17الشاشات والعناصر والأزرار ورسائل الخطأ

إعداد القواعد. سجل التسليم.

18خدمات Backend ومسؤولية كل خدمة

legal_erp.notify.schedule، deliver.

19واجهات API الداخلية

لا توجد واجهة API خاصة بهذه الميزة.

20الأحداث والمهام الخلفية والجدولة وإعادة المحاولة

كل دقيقة افتراض تنفيذي: المستحق.

21التكاملات المرتبطة بالميزة وحدودها

منصة واتساب للأعمال، مزود الرسائل النصية المحلي، إشعارات الجوال (FCM/APNs)، البريد الإلكتروني.

22الأمن والخصوصية والتدقيق والاحتفاظ والحذف

لا أسرار في القنوات غير الآمنة.

23حالات الاختبار

المعرّف	النوع	السيناريو	النتيجة المتوقعة
`B44-T01`	طبيعي	تذكير جلسة	يصل في موعده.
`B44-T02`	أمني	نص الإشعار	عام.
`B44-T03`	حدّي	تغيير موعد الجلسة	إعادة جدولة دون تكرار.

24معايير القبول

التذكيرات تصل ولا تتكرر.

25تعريف الاكتمال (Definition of Done)

كل قواعد العمل في هذه الصفحة منفذة في الخادم (Controller أو Service)، لا في الواجهة وحدها.
حالات الاختبار المذكورة هنا مكتوبة اختباراتٍ آلية في إطار اختبار Frappe، وتنجح مع كل دفعة كود.
اختبارات الصلاحيات تثبت أن مستخدمًا خارج فريق الملف لا يرى السجل في القائمة ولا برابطه المباشر ولا في البحث العام ولا في العدّادات.
الحقول المخصصة والأدوار ومسارات الاعتماد مُصدَّرة في Fixtures التطبيق، وتظهر بعد تثبيت نظيف على موقع فارغ دون إعداد يدوي.
لا تعديل في ملفات Frappe أو ERPNext.
كل قيمة قانونية (مدة، نسبة، مبلغ، قائمة) محفوظة في إعداد قابل للتعديل، وموسومة بحالة اعتمادها.
نصوص الواجهة ورسائل الخطأ بالعربية، وتخبر المستخدم بما يفعله.
معايير القبول في هذه الصفحة مُتحقق منها ومسجلة في مصفوفة التتبع.

26القرارات المفتوحة والمخاطر والاعتمادات المطلوبة

لا ينطبق على هذه الميزة.