تسجيل الدخول والدعوات
الهدف
الوصول إلى المنشأة الصحيحة بعضوية نشطة، أو إنشاء شركتك الأولى.
لمن
كل من دُعي إلى منشأة BOS. إنشاء شركة جديدة يتم عبر التسجيل الذاتي. دعوة الزملاء تحتاج member.manage. التبديل إلى مساحة أخرى يحتاج عضوية قائمة في تلك المنشأة.
المتطلبات
- تعرف عنوان تطبيق الموظفين لمؤسستك.
- للمدعوين: أضافك المسؤول مسبقاً في الأعضاء، أو سجّلت بنفسك.
- يجب أن تكون العضوية نشطة؛ المنشأة الموقوفة تحجب مسارات بيانات الأعمال (قد تبقى مسارات المصادقة و
/meودورة الاشتراك متاحة).
الخطوات — تسجيل الدخول
- افتح تطبيق الموظفين. الزيارات غير المسجّلة تُحوَّل إلى الحسابات (
accounts-dev.bluemtx.com/accounts.bluemtx.com). - سجّل الدخول بالبريد الإلكتروني وكلمة المرور، أو بمفتاح مرور (بصمة / Face ID / Windows Hello)، أو برابط سحري بالبريد، أو عبر جوجل/مايكروسوفت/آبل إن كانت مُعدَّة.
- إذا كانت سياسة MFA تطلب ذلك وقد سجّلت تطبيق مصادقة، يطلب الدخول بكلمة المرور/الاجتماعي/الرابط السحري رمزاً قبل التسليم. مفاتيح المرور تُعدّ MFA. الإعداد من الجلسات والأجهزة.
- بعد النجاح تُسلَّم جلسة لمرة واحدة إلى ERP أو POS أو Ops أو لوحة التاجر (
/auth/enter?code=…&next=…) دون وضع رمز الجلسة في عنوان الصفحة. يُستبدل الرمز في موجّه ERP وPOS وOps وتُفتح الصفحة المطلوبة مباشرة، مع شريط تقدّم رفيع أثناء الانتظار ودون شاشة وسيطة. لوحة التاجر تكمل خطوة الدخول الخاصة بها. إذا كان الرمز مفقوداً أو منتهي الصلاحية أو مستخدماً أو مرفوضاً، أو تعذّر بدء الجلسة، تمسح هذه التطبيقات حالة الدخول الناقصة وتزيل الرمز من شريط العنوان وتعرض العودة لتسجيل الدخول. هذا الإجراء يحتفظ بوجهة داخلية آمنة ولا يعيد استخدام الرمز.
الخطوات — إنشاء المنشأة الأولى
- من شاشة الدخول اختر إنشاء حساب (
/signup). - املأ اسمك واسم الشركة والبريد وكلمة المرور.
- اختر إنشاء حساب. التسجيل يوفّر منشأةً وعضوية مالك عبر
TenantProvisionerثم يُسجّلك دخولاً.
الخطوات — قبول دعوة
- يفتح المسؤول الأعضاء (
member.viewللعرض؛member.manageللدعوة) ويختار إضافة عضو. - يصلك بريد تمت إضافتك إلى {tenant}. المستخدمون الجدد يحصلون على زر تعيين كلمة المرور إلى الحسابات (
/reset-password?email=…&token=…)؛ المستخدمون الحاليون يحصلون على تسجيل الدخول إلى بلو ماتريكس. - سجّل الدخول (أو عيّن كلمة المرور عبر مسار إعادة التعيين الموضّح في الدعوة)، ثم افتح تلك المساحة من المبدّل إن كنت تنتمي لأكثر من واحدة.
الخطوات — تبديل مساحة العمل
- في الشريط العلوي افتح مبدّل المساحة (تبديل مساحة العمل).
- اختر عضوية أخرى (
{name} · {role}). - يستدعي العميل
POST /auth/switch-tenantمعtenant_id، يستلم رمزاً جديداً، يحدّث/me، ويعيد تعيين التبويبات. - إن كانت لديك
tenant.manageتظهر أيضاً منشأة جديدة (تفتح الإعداد).
النتيجة
ترى فقط التنقّل والوحدات التي يسمح بها دورك وenabled_modules. تظهر المساعدة واللغة وعملي في الشريط العلوي.
توقفات صارمة
- بريد/كلمة مرور خاطئة → 422؛ الواجهة تعرض بريد إلكتروني أو كلمة مرور غير صحيحة.
- دعوة بريد عضو مسبقاً → مرفوضة.
- دعوة مستخدم لديه حساب BlueMatrix مسبقاً عندما
allow_invite_existing_usersمعطّل → 422. يُضبط من إعداد الأعضاء. - التبديل إلى منشأة لا تنتمي إليها → 422.
- منشأة موقوفة → مسارات الأعمال 403.
- «فتح المنشأة» من Ops يستخدم
/auth/enter?code=(تسليم لمرة واحدة دون وضع الرمز في العنوان). تفتح ERP وPOS وOps الوجهة مباشرة. الرمز غير الصالح أو المستخدم يعرض العودة لتسجيل الدخول دون إعادة المحاولة.