الزوار والاستقبال والمواعيدVisitors, reception and appointments

كل من يحجز أو يدخل المكتب يُسجل: من، لماذا، مع من، الدخول والخروج. والقاعدة: لا يجلس عميل محتمل مع محامٍ قبل B16 فحص تعارض المصالح. والزيارة المقبولة تتحول بضغطة إلى موكّل وملف ومسودة عقد أتعاب.

بطاقة الميزة

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

الاستشارة الأولى قد تكشف أسرارًا لمحامٍ لا يجوز له تمثيل العميل؛ لذلك الفحص قبل الجلوس (دليل المطور ص28-29).

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

جمع أقل قدر من البيانات عند الحجز (الاسم، الجوال، نوع المسألة في سطر، أسماء الأطراف الأخرى) مع إشعار الخصوصية والموافقة B39 الامتثال لنظام حماية البيانات الشخصية. الهويات عند فتح الملف فقط (دليل المطور ص28-29).

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

الاستقبال يدير الحجوزات والدخول. المحامي المضيف يتلقى الإشعار ويكتب التوصية. الشريك يرى المؤشرات.

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

Appointment Slot لكل محامٍ. جهاز استقبال مسجل Kiosk Device. B16 فحص تعارض المصالح.

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

1. الحجز عبر البوابة أو واتساب أو الهاتف بالحد الأدنى مع الموافقة.
2. فحص تعارض أولي آلي بالأسماء.
3. تأكيد برمز QR والموقع أو رابط عن بعد.
4. الوصول: مسح QR على جهاز الاستقبال يسجل الدخول ويُشعر المحامي.
5. الاستشارة: ملاحظات وتوصية (قبول/اعتذار/يحتاج معلومات) والمؤقت يحسب الوقت B19 تسجيل الوقت الفعلي والمتتبع المعلن.
6. الخروج.
7. المقبولة تتحول إلى موكّل وملف ومسودة عقد أتعاب B22 العقود الإلكترونية واتفاقيات الأتعاب والتوقيع دون إعادة إدخال.

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

الاعتذار بسبب تعارض: رسالة مهذبة لا تذكر السبب. عدم الحضور: يُسجل. تجاوز الفحص: للشريك بسبب مسجل.

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

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

مؤشرات: الزيارات يوميًا، متوسط الانتظار، نسبة التحويل، أسباب الاعتذار، المصدر (دليل المطور ص28-29). تذكير قبل الموعد.

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

RULE B17.1  visit_type "استشارة عميل جديد": check-in to consultation blocked until conflict_check decided OR partner override logged
RULE B17.2  booking form never asks for national id
RULE B17.3  kiosk screen shows: name, time, host lawyer — never purpose or parties
RULE B17.4  decline due to conflict -> neutral template, no reason
RULE B17.5  convert -> Customer + Legal Matter(status مفتوح) + Legal Contract draft, prefilled
RULE B17.6  non-client visitor data purged after office retention; keep conflict minimum (names, parties, date, decision) [legal]

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

محجوزة ← وصل ← في الاستشارة ← خرج ← (محوّلة / معتذر / يحتاج معلومات)؛ أو لم يحضر.

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

Office Visit n → 1 Legal Party؛ 1 ↔ 1 Conflict Check؛ ربط Lead في ERPNext. Appointment Slot لكل محامٍ.

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

• Office Visit، Appointment Slot (lawyer, weekday, from_time, to_time, slot_minutes, mode)، Kiosk Device (device_name, branch, token) (دليل المطور ص28-29).

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

تقويم الاستقبال، شاشة جهاز الاستقبال بمسح QR، بطاقة الزيارة للمحامي مع زر «تحويل إلى ملف».

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

legal_erp.intake.book، check_in(token, qr)، convert(visit)، purge_non_clients يومي.

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

POST /api/method/legal_erp.api.v1.intake.check_in

مسح QR من جهاز الاستقبال.

الصلاحية: رمز جهاز الاستقبال فقط.

{
  "kiosk_token": "<من خزنة الجهاز>",
  "qr": "VIS-2026-0102.sig"
}

{
  "visitor_display": "م. التجريبي",
  "host": "المحامي أ",
  "time": "10:30"
}

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

تذكير قبل الموعد B44 الإشعارات والتذكيرات. حذف بيانات غير الموكلين بعد المدة B38 الاحتفاظ والإتلاف والتجميد القانوني.

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

منصة واتساب للأعمال للحجز والتأكيد (روبوت خدمة لا روبوت عام) B30 السكرتير الذكي (وكيل خدمة العملاء). مزود الرسائل النصية المحلي بديل.

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

رمز جهاز الاستقبال مقيد بوظيفة الدخول. QR موقّع ومؤقت اقتراح هندسي.

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

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

• معايير الميزة 3 ناجحة (دليل المطور ص28-29).

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

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

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

مدة حفظ بيانات الزوار غير الموكلين يحتاج اعتمادًا قانونيًا.