البريد الإلكترونيEmail (SMTP/IMAP)

VERIFIED_APIمزود بريد المكتبمتطلب وارد في الملفات

بريد صادر بنطاق المكتب B40 الهوية الخاصة وملف المكتب، وصندوق وارد لقارئ الإشعارات B28 قارئ الإشعارات الحكومية، وملخص مسائي بجلسات الغد (دليل المطور ص18). بروتوكولات قياسية يدعمها Frappe.

1ما المنصة، ومن الجهة المالكة، وما اختصاصها؟

بريد.

2ما الإجراء الذي ينفذه المحامي فيها؟

—

3متى يحتاج إليها المحامي؟

يوميًا.

4ميزات ERPOS المرتبطة بها

B28 قارئ الإشعارات الحكومية، B44 الإشعارات والتذكيرات.

5الخدمة المحددة المطلوبة من المنصة

إرسال واستقبال.

6نوع الحاجة: قراءة أو إرسال أو مزامنة أو إشعارات

إرسال وقراءة.

7البيانات الداخلة والخارجة وحساسيتها ومصدرها

قد يحوي بيانات قضايا: TLS.

8هل يوجد API رسمي موثق لهذه الخدمة تحديدًا؟

SMTP/IMAP قياسيان؛ حساب البريد في Frappe Email Account.

9المصدر الرسمي وتاريخ التحقق

المصدر	الرابط	ما تحقّقنا منه	تاريخ التحقق
توثيق Frappe	https://docs.frappe.io	تفتح بوابة توثيق تطبيقات Frappe (ERPNext والإطار). لم نفتح صفحة Email Account تحديدًا	2026-11-04

10حالة التحقق

VERIFIED_API

VERIFIED_API (بروتوكولات قياسية).

11ما الذي يثبته المصدر الرسمي وما الذي لا يثبته؟

—

12التسجيل والاعتماد والتفويض والمصادقة وبيئة الاختبار

حساب بريد للمكتب.

13خطوات الربط من جهة ERPOS

إعداد Email Account.

14تصميم Adapter مستقل للمنصة

واجهة XAdapter مستقلة في legal_erp/integrations/x.py ترث النمط الموحد نمط موصل التكامل بعمليات: fetch. تنفيذان: يدوي (يفتح نموذج إدخال للموظف ويسجل المصدر «يدوي») ورسمي (لا يُكتب قبل استلام توثيق رسمي وموافقة)، ويُختار من الإعداد لكل مكتب اقتراح هندسي.

15تدفق البيانات ومخطط التسلسل

—

16نموذج الطلب والاستجابة

—

17انتهاء المهلة وانقطاع الخدمة والرفض وتضارب الحالة

انتهاء المهلة ← فشل مؤقت ← إعادة أسية في الطابور.
انقطاع الخدمة أو أخطاء متتالية ← إيقاف الموصل وتنبيه المدير B43 طبقة التكامل المركزية.
رفض (صلاحية، تفويض) ← فشل دائم يظهر للمسؤول بلا إعادة.
تضارب الحالة مع البيانات المحلية ← سجل فرق يقرره إنسان؛ لا كتابة صامتة ولا حذف محلي عند استجابة فارغة.

18منع التكرار وإعادة المحاولة الآمنة

كل عملية صادرة بمفتاح عدم تكرار يُحفظ مع السجل؛ إعادة المحاولة ترسل المفتاح نفسه، وكل حدث وارد يُتجاهل إن تكرر معرّفه أو بصمته B43 طبقة التكامل المركزية.

19حفظ المصدر ووقت الجلب وإيصال الجهة وسجل التدقيق

يُحفظ مع كل قيمة: data_source (يدوي/الجهة)، وقت الجلب، معرّف الاستدعاء أو رقم الإيصال من الجهة إن وُجد، والمستخدم أو المهمة المجدولة. سجل الاستدعاء لا يحفظ جسم الاستجابة ولا بيانات شخصية (خطة ناجز ص14).

20المسار اليدوي المصرح به

—

21اختبارات التكامل والفشل والتفويض والتكرار والعزل

المعرّف	النوع	السيناريو	النتيجة المتوقعة
`INT-EML-01`	تكامل	بيئة وهمية تعيد نجاحًا	تُحفظ القيمة بمصدرها ووقتها.
`INT-EML-02`	فشل	مهلة ثم نجاح	إعادة واحدة بلا تكرار.
`INT-EML-03`	تفويض	مفتاح أو تفويض غير صالح	فشل دائم وتنبيه، لا إعادة.
`INT-EML-04`	تكرار	إرسال الحدث نفسه مرتين	يُعالج مرة.
`INT-EML-05`	عزل	مكتبان على الخادم نفسه	لا يرى أحدهما بيانات الآخر ولا مفتاحه.

22المخاطر والقرارات التي تحتاج موافقة الجهة

موقع خوادم البريد (داخل المملكة؟) يحتاج اعتمادًا قانونيًا.