البحث العام والتقارير المجمّعةGlobal search and aggregated reports

B36الجوال والبوابةمتطلب وارد في الملفات اقتراح هندسي

بحث واحد في الملفات والأطراف والمستندات (بنصوصها) يحترم صلاحيات المستخدم، وتقارير مجمعة: الجلسات، الأحكام، المهل، الربحية. البحث والعدادات من أشهر نقاط التسرب (دليل الميزة 1 ص15).

بطاقة الميزة

البند	القيمة
1. اسم الميزة	البحث العام والتقارير المجمّعة — Global search and aggregated reports
2. المعرّف (Feature ID)	`B36`
3. مصدر المتطلب	دليل الميزة 1 ص15 (نقاط التسرب)، دليل المطور ص39 (التقارير المجمّعة)
4. تصنيف المحتوى	متطلب وارد في الملفات التقارير المجمعة للشريك والموكّل، واحترام الصلاحيات في البحث والعدّادات. اقتراح هندسي فهرس البحث الموحد.
الوحدة	الجوال والبوابة
الأدوار المعنية	شريك، محامٍ، محاسب
درجة الخطورة	متوسطة
حالة الاعتماد	معتمد في الوثائق
المنصات المرتبطة	لا توجد

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

الوصول السريع دون كشف ما لا يحق للمستخدم.

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

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

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

كل المستخدمين بحسب صلاحياتهم.

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

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

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

البحث يمر بشرط الصلاحية قبل الترتيب.
النتائج بأنواعها مع مقتطف.
التقارير من Query Reports بشرط الصلاحية.

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

الرقم الوطني: يُبحث ببصمته B02 الموكّلون والأطراف والعلاقات.

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

لا حقول إدخال خاصة بهذه الميزة؛ تستخدم حقول الكيانات المشار إليها في نموذج البيانات.

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

تقارير الشريك الأسبوعية، ملخص الموكّل الدوري (دليل المطور ص39).

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

قواعد

RULE B36.1  every search/report applies permission_query_conditions
RULE B36.2  counts and charts computed with the same conditions
RULE B36.3  id search via HMAC only

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

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

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

فهرس نصي على الحقول والنص المستخرج مع matter و confidentiality.

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

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

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

شريط بحث علوي. صفحة تقارير.

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

legal_erp.search.query.

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

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

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

إعادة الفهرسة عند تغيّر السجلات.

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

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

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

اختبارات التسرب الست (دليل الميزة 1 ص15).

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

المعرّف	النوع	السيناريو	النتيجة المتوقعة
`B36-T01`	صلاحيات	بحث بعنوان ملف لا يملكه	لا نتيجة.
`B36-T02`	صلاحيات	عداد الملفات المفتوحة	يحسب ملفاته فقط.

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

لا تسرب في البحث والعدادات.

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

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

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

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