بوابات العملاء والموردين
الهدف
فهم بوابات BlueMatrix الخارجية: كيف يسجّل العملاء والموردون الدخول، وما يمكنهم رؤيته، وكيف يدعو الموظفون ويضبطون الوصول — بمعزل عن نظام الموظفين وعن واجهة متجر Commerce.
لمن
- مستخدمو البوابة (جهات اتصال العملاء أو الموردين) الذين يعرضون مستنداتهم وطلباتهم.
- الموظفون الذين يدعون جهات الاتصال (
portal.invite/portal.manage) ويضبطون خيارات البوابة (customer_portal.admin/supplier_portal.admin).
ما هي البوابات
البوابات سطح BlueMatrix مقيّد بالطرف على /portal. مستخدمو البوابة هم PortalUser بصلاحية Sanctum portal:{tenant_id}:{party_id} — وليسوا موظفين بصلاحيات RBAC. يرون فقط ما يخص طرفهم.
| البوابة | الوحدة | المحتوى النموذجي |
|---|---|---|
| بوابة العملاء | customer_portal | فواتير المبيعات والإشعارات الدائنة المرحّلة، أوامر البيع، العروض (إن فُعّلت المبيعات)، كشف الذمم المدينة، واختياريًا المشاريع / التذاكر / مقالات المساعدة / قسائم الراتب |
| بوابة الموردين | supplier_portal | فواتير المشتريات والإشعارات المدينة المرحّلة، كشف الذمم الدائنة |
جهة اتصال مدعوة لكلا الدورين قد ترى عنوان بوابة الحساب.
كيف يعمل الوصول
- يفتح الموظف مركز الطرف (عميل/مورد) ← وصول البوابة.
- الدعوة بصلاحية
portal.invite(البريد). يقبل الضيف على/portal/acceptويعيّن كلمة مرور (صلاحية الدعوة ~14 يومًا). - تسجيل الدخول على
/portal/loginبـ المنشأة (معرّفها) والبريد وكلمة المرور. تتوفر نسيت / إعادة تعيين كلمة المرور. - يمكن للموظف تعطيل الوصول (
portal.manage). المعطَّل لا يستخدم واجهات البوابة (403).
يجب تفعيل وحدتي customer_portal / supplier_portal. الميزات الاختيارية للعميل تحتاج وحداتها (sales، projects، support، knowledge_base، payroll_integration).
إعداد الموظفين (ليس غلاف البوابة)
- نظرة عامة ← إعداد بوابة العملاء (
customer_portal.admin). - نظرة عامة ← إعداد بوابة الموردين (
supplier_portal.admin).
نقاط التوقف
- منشأة / بريد / كلمة مرور خاطئة ← خطأ تسجيل الدخول.
- وحدة معطّلة ← 422.
- ميزة مخفية في إعدادات البوابة ← 422 (
feature_disabled). - منشأة معلّقة ← حظر مسارات بيانات البوابة.
- مستندات طرف آخر لا تظهر أبدًا.
ليست هذه الواجهة
- مستندات التجارة في نظام الموظفين تُنشأ في التطبيق الرئيسي — البوابات غالبًا قراءة للمستندات المرحّلة.
- لوحة تاجر Commerce والمتجر العام هما تطبيق التجارة الإلكترونية — انظر التجارة.