نظرة عامة على المنصة: الأدوار واللوحات

الغرض#

منصة Delivery Syria منصة واحدة يعمل عليها أكثر من طرف، ولكل طرف مكان عمل وقوائم مختلفة. تشرح هذه الصفحة من هم هؤلاء الأطراف، وأين يعمل كل منهم، وكيف يرتبط عمله بالآخرين، لتعرف أي دليل تقرأ بعدها.

من هو من؟#

كيف ترتبط الأدوار ببعضها#

1. السوبر أدمن ينشئ شركة التوصيل. وينشأ معها دومين فرعي وحساب أدمن أول لها، وتأتي صلاحيات هذا الحساب من وحدات باقة الشركة. ويمكن للشركة أيضاً أن تسجّل نفسها من صفحة تسجيل الشركات في الدومين الرئيسي، ويُؤكَّد الحساب برمز تحقق لمرة واحدة (OTP).
2. الشركة تبني فريقها. يضيف موظفو الشركة المناديب والتجار. ويستطيع التاجر أيضاً أن يسجّل بنفسه من موقع الشركة عبر صفحة تسجيل التجار.
3. التاجر المستقل ينضم مباشرة. يسجّل من الصفحة /join في الدومين الرئيسي ثم يُحوَّل ليختار باقة التجار ويدفعها. هذا النوع من الحسابات هو VIRTUAL_MERCHANT ويملك شركة توصيل داخلية، ولذلك يظهر في قائمته قسم «شركتي للتوصيل» بمناديبه وتوزيعه الخاص.
4. رحلة الطرد عبر الأدوار. ينشئه التاجر، وتوزّعه الشركة على مندوب، ويحدّث المندوب حالته من التطبيق، ويتابعه المستلم من صفحة التتبع العامة التي يفتحها رمز QR المطبوع على بوليصة لوحة التاجر.
5. السوبر أدمن يدير المستودعات. خدمة المستودعات معطّلة حتى يشغّلها السوبر أدمن من قائمة «خدمة المستودعات». وينشئ السوبر أدمن المستودعات، ويحجز الطبليات للتجار، وينشئ حسابات المشرفين. ولا يرى التاجر المستقل قائمة «المستودعات» إلا إذا فُعّلت الخدمة له (وقد يعتمد ذلك على باقة التاجر) أو كان لديه حجز طبليات فعّال. ويسجّل المشرفون دخول البضاعة وخروج الطرود.

تسجيل الدخول ومعرفة لوحتك#

1. افتح صفحة تسجيل الدخول

   السوبر أدمن يسجّل الدخول من الدومين الرئيسي فقط. وبقية المستخدمين يمكنهم الدخول من هناك أيضاً: بعد كلمة سر صحيحة ينقلهم النظام إلى دومين شركتهم، عادةً برابط يُستخدم مرة واحدة وصالح لمدة دقيقتين.

2. تحقّق من الصفحة التي وصلت إليها

   كل الأدوار التي تعمل على الويب تفتح /dashboard ويوجّهها النظام إلى صفحتها. السوبر أدمن يرى لوحة المنصة. والتاجر المستقل يرى صفحته الرئيسية، أو صفحة الباقات إذا لم تكن لديه باقة تجار فعّالة؛ أما التاجر التابع لشركة توصيل فيُعتمد اشتراك شركته بدلاً من باقة التجار. ومشرف المستودع يذهب إلى /warehouse-panel. وموظفو الشركة الذين ليس لشركتهم اشتراك فعّال يُحوَّلون إلى صفحة باقات الشركة. وفيما عدا ذلك يرى أدمن الشركة وحساب المسؤول (In-charge) لوحة الشركة، أما بقية موظفي الشركة، مثل حسابات الفروع (الهب)، فيرون لوحة الشركة الكلاسيكية.

3. استخدم القائمة التي تظهر لك

   أغلب عناصر قائمة الشركة لا تظهر إلا إذا كان لحسابك الصلاحية المطابقة لها، وفتح رابط مباشر لصفحة محمية يعيدك إلى الصفحة الرئيسية. قائمة التاجر لا تعتمد على الصلاحيات، لكن التاجر التابع لشركة توصيل لا يرى «كشف الحساب» ولا رابط صفحة الباقة ولا قسم «الربط» (ربط المتاجر والـ API والويب هوك).

أخطاء شائعة#

• تسجيل دخول السوبر أدمن من عنوان شركة. يُرفض تسجيل الدخول، وعندما تكون كلمة السر صحيحة تقول الرسالة إن السوبر أدمن يدخل من الدومين الرئيسي فقط.
• البحث عن قوائم الشركة في الدومين الرئيسي. صفحات الشركة الكلاسيكية للطرود والمناديب والرواتب لا تعمل إلا على دومينات الشركات. أما الدومين الرئيسي ففيه مجموعة أقل مثل التجار والفروع والمستخدمين والباقات والشركات.
• توقّع وجود لوحة ويب للمندوب. لا توجد للمندوب لوحة ويب: يعمل من تطبيق جوال يتصل بواجهة الـ API الخاصة بالمندوب (/api/v10)، والتطبيق نفسه برنامج مستقل وليس جزءاً من الشيفرة البرمجية للمنصة. وعلى الويب يدير المناديب موظفو الشركة والتجار الذين يملكون شركة توصيل داخلية (قسم «شركتي للتوصيل»).
• ظهور صفحة الباقات بدل اللوحة. التاجر المستقل الذي ليست لديه باقة تجار فعّالة يُحوَّل إليها. أما موظفو شركة ليس لها اشتراك فعّال فيُحوَّلون إلى صفحة باقات الشركة بدلاً منها.
• حساب موقوف. عند تسجيل الدخول مباشرة من دومين الشركة بكلمة سر صحيحة تظهر رسالة أن الحساب موقوف. أما إذا سجّل الدخول بحساب موقوف من الدومين الرئيسي فيُحوَّل أولاً ثم يفشل الدخول برسالة تفيد بانتهاء صلاحية رابط الدخول. وطلبات الـ API التي تستخدم رمز الوصول (التوكن) الخاص بالحساب تعيد HTTP 401 على المسارات المحمية بفحص نوع الحساب (مثل مسارات المندوب)، والمندوب الموقوف يحصل على HTTP 403 عند تسجيل دخوله.

الحدود والصلاحيات#

• تحتاج الشركة إلى اشتراك فعّال، باستثناء الشركات التابعة للمنصة والشركات المملوكة لتاجر.
• بالنسبة للتجار المستقلين يعتمد «استيراد من Excel» و«ربط المتاجر» على ميزتَي الاستيراد وربط المتاجر في باقة التاجر (تُطبَّق هذه الميزات عندما تكون في المنصة باقات تجار فعّالة). أما التاجر التابع لشركة توصيل فلا تُطبَّق عليه ميزات باقة التاجر، فيستطيع الاستيراد من Excel. لكن «ربط المتاجر» (مثل الـ API والويب هوك) للتجار المستقلين فقط: لا يظهر للتاجر التابع لشركة توصيل في القائمة، وإذا فتح رابط صفحته مباشرة يُعاد إلى لوحة التحكم مع تنبيه.
• قواعد نوع الحساب تُطبَّق على الخادم. يُسمح للسوبر أدمن دائماً، وأي حساب آخر يجب أن يطابق نوع المسار، وإلا يعيد الـ API رمز الحالة HTTP 403 مع رسالة تذكر الأدوار المسموح لها.
• لوحة المستودع لحسابات مشرفي المستودعات المرتبطة بمستودع فقط، وغيرها يحصل على صفحة 403.
• معظم طلبات واجهة الـ API الخاصة بالمندوب (تسجيل الدخول والطرود والتسليم ولوحة التحكم) يجب أن ترسل أيضاً ترويسة apiKey، وإلا ترد الواجهة بالرسالة Invalid Api Key (HTTP 400). أما استدعاءات التتبع المباشر (التبديل بين متصل وغير متصل، وإرسال الموقع، وإعدادات التتبع) وتحديث موقع الطرد فلا تحتاج إلى هذه الترويسة، ويكفيها رمز الوصول الخاص بالمندوب.
• صفحة التتبع العامة لا تحتاج تسجيل دخول، ومحدودة بـ 60 طلباً في الدقيقة، وتُخفي جزءاً من اسم المستلم ورقم هاتفه، وتطلب من محركات البحث عدم فهرستها.