الفصل 7

شركات التوصيل والعقود

يغطي هذا الفصل شاشتي شركات التوصيل والعقود. الشركة هي المنصة التي يعمل المناديب عليها، والعقد يتبع شركة واحدة ويحمل الاسم الذي يرد في ملف الأداء اليومي.
يحتاجه الموظف عند بدء التعامل مع شركة جديدة، أو إضافة عقد، أو إيقاف التعامل مع شركة أو عقد دون فقدان السجلات السابقة.

19 قسماً9 دقيقة قراءة

7.1 شركات التوصيل

المكان في القائمة: الأداء ← شركات التوصيل
الرابط: /admin/companies
الصلاحية المطلوبة: عرض ضمن شركات التوصيل. ولكل من الإضافة والتعديل والحذف والتفعيل والتعطيل صلاحيته الخاصة.

الغرض

تسجيل الشركات التي يعمل المناديب على منصّاتها. العقود والمناديب وسجلات الأداء كلها مرتبطة بالشركة، لذلك فهي أول ما يُضاف قبل العقود.

ما تراه في الشاشة

بطاقات الإحصاء

البطاقة	المعنى
إجمالي الشركات	عدد كل الشركات
مفعّلة	الشركات المفعّلة
معطّلة	الشركات المعطّلة. تتلوّن بالأصفر عند وجود أي شركة
العقود	عدد كل العقود المسجلة
المناديب المرتبطون	عدد المناديب المرتبطين بأي شركة

أعمدة الجدول

العمود	المحتوى
الشركة	اسم الشركة، وتحته رقمها في النظام
بريد الشركة	البريد، وتحته معرّف المؤسسة: {id} إن وُجد
العقود	عدد عقود الشركة
المناديب	عدد المناديب المرتبطين بها
الحالة	مفعّلة بالأخضر أو معطّلة بالرمادي
أُضيفت في	تاريخ ووقت الإضافة
إجراءات	عرض، تعديل، تعطيل أو تفعيل، حذف

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

الإجراءات

إضافة شركة

الرابط: /admin/companies/new

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

تعديل شركة

الرابط: /admin/companies/{رقم الشركة}/edit

اضغط أيقونة تعديل في الصف، أو زر تعديل في صفحة الشركة.
عدّل الاسم أو البريد أو معرّف المؤسسة.
اضغط حفظ. تعود إلى صفحة الشركة وتظهر الرسالة حُفظت التعديلات..

شاشة التعديل لا تحتوي خانة التفعيل. التفعيل والتعطيل إجراءان مستقلان بصلاحيتين مستقلتين.

عرض شركة

الرابط: /admin/companies/{رقم الشركة}. اضغط على الصف أو على أيقونة عرض. تعرض الصفحة:

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

إضافة عقد من صفحة الشركة

في بطاقة عقود هذه الشركة اضغط إضافة عقد.
يفتح نموذج العقد الجديد وقد اختيرت فيه هذه الشركة.
أكمل كما في القسم 7.2.

تعطيل شركة

اضغط أيقونة تعطيل في الصف، أو زر تعطيل أعلى صفحة الشركة.
يظهر سؤال التأكيد في مكان الزر. اضغط تعطيل للتأكيد أو إلغاء للتراجع.
تظهر الرسالة عُطِّلت الشركة، ولم تتغيّر سجلاتها..

تفعيل شركة

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

حذف شركة

اضغط أيقونة حذف في الصف، أو حذف في البطاقة الأخيرة من صفحة الشركة.
أكّد الإجراء.
تظهر الرسالة حُذفت الشركة..

الحذف نهائي ولا يمكن التراجع عنه.

الحقول

الحقل	إلزامي	الوصف والقيم المسموحة
اسم الشركة	نعم	بين حرفين و100 حرف. لا يتكرر بين شركتين. يُكتب كما يرد في ملف الأداء اليومي
بريد الشركة	لا	عنوان بريد صحيح، حتى 150 حرفاً. هو العنوان الذي يستقبل مراسلات المناديب
معرّف المؤسسة لدى الشركة	لا	الرقم الذي تعرف به الشركة منشأتك، حتى 50 حرفاً
مفعّلة	لا	خانة اختيار في شاشة الإضافة فقط. محدّدة مبدئياً

الحالات ومعانيها

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

ماذا يحدث عند التعطيل والحذف

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

تعطيل الشركة لا يعطّل عقودها تلقائياً. العقود المفعّلة تحت شركة معطّلة تُعدّ في بطاقة خاصة بشاشة العقود (القسم 7.2).

الاستيراد والتصدير

لا يوجد استيراد في هذه الشاشة.
تصدير CSV متاح لكل من يملك صلاحية العرض. الملف يحتوي الصفوف المطابقة للتصفية الحالية.
أعمدة الملف: المعرّف، الشركة، مفعّلة، العقود، المناديب، أُضيفت في.

قواعد وتنبيهات

اسم قصير أو طويل: اسم الشركة يجب أن يكون بين حرفين و100 حرف..
اسم مكرر: يوجد شركة بهذا الاسم بالفعل..
بريد غير صحيح: بريد الشركة غير صحيح..
كل إضافة وتعديل وتفعيل وتعطيل وحذف يُسجَّل في سجل النشاط. عند تغيير الاسم يُسجَّل الاسم القديم والجديد معاً.

7.2 العقود

المكان في القائمة: الأداء ← العقود
الرابط: /admin/contracts
الصلاحية المطلوبة: عرض ضمن العقود. ولكل من الإضافة والتعديل والحذف والتفعيل والتعطيل صلاحيته الخاصة.

الغرض

تسجيل عقود شركات التوصيل. كل عقد يتبع شركة واحدة فقط، واسمه يجب أن يطابق ما يرد في ملف الأداء اليومي حتى ينجح الاستيراد في التعرف عليه.

ما تراه في الشاشة

بطاقات الإحصاء

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

أعمدة الجدول

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

عوامل التصفية: الشركة والحالة. خانة البحث تبحث باسم العقد أو الشركة أو الوصف. عند الوصول إلى الشاشة من صفحة شركة تكون القائمة مصفّاة على تلك الشركة.

الإجراءات

إضافة عقد

الرابط: /admin/contracts/new

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

زر الإضافة معطّل إذا لم توجد أي شركة مفعّلة.

تعديل عقد

الرابط: /admin/contracts/{رقم العقد}/edit

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

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

عرض عقد

الرابط: /admin/contracts/{رقم العقد}. تعرض الصفحة:

اسم العقد وشارة حالته.
تحذير أصفر شركة هذا العقد معطّلة عند انطباقه.
بطاقتان: سجلات الأداء والحالة.
تفاصيل العقد: الشركة (رابط إلى صفحتها لمن يملك صلاحية عرض الشركات)، العقد، الوصف، الحالة، سجلات الأداء.
نسخة العقد وملفاته: ارفع هنا النسخة الموقّعة وأي ملحق، صورة أو PDF. يمكن إضافة ملاحظة مع كل ملف، ومعاينة الملفات وتنزيلها وحذفها بحسب صلاحيات المرفقات. الأنواع المسموحة: JPG و PNG و WEBP و GIF و PDF.
بطاقة حذف لمن يملك صلاحية الحذف.

تعطيل عقد وتفعيله

اضغط أيقونة تعطيل أو تفعيل في الصف، أو الزر المقابل أعلى صفحة العقد.
أكّد الإجراء.
تظهر الرسالة عُطِّل العقد، ولم تتغيّر سجلات الأداء السابقة. أو فُعِّل العقد..

حذف عقد

اضغط أيقونة حذف في الصف، أو حذف في البطاقة الأخيرة من صفحة العقد.
أكّد الإجراء.
تظهر الرسالة حُذف العقد..

الحقول

الحقل	إلزامي	الوصف والقيم المسموحة
الشركة	نعم	شركة واحدة فقط لكل عقد
اسم العقد	نعم	بين حرفين و255 حرفاً. لا يتكرر تحت الشركة نفسها، ويجوز تكراره تحت شركتين مختلفتين
الوصف	لا	حتى 500 حرف

ماذا يحدث عند التعطيل والحذف

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

الاستيراد والتصدير

لا يوجد استيراد في هذه الشاشة.
تصدير CSV متاح لكل من يملك صلاحية العرض.
أعمدة الملف: المعرّف، العقد، الشركة، الوصف، مفعّل، سجلات الأداء.

قواعد وتنبيهات

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

7.3 ربط المناديب بالشركة والعقد

الربط لا يتم من شاشتي هذا الفصل، بل من بيانات المندوب نفسه.

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

قواعد الربط:

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

أسئلة شائعة

ما الفرق بين تعطيل الشركة وحذفها؟

التعطيل يخفي الشركة من قوائم الاختيار ويُبقي كل سجلاتها، ويمكن التراجع عنه في أي وقت. الحذف يزيل الشركة نهائياً، ولا يُسمح به إلا إذا لم يرتبط بها أي عقد أو مندوب أو سجل أداء.

لماذا لا أرى زر الحذف بجانب شركة أو عقد؟

إما أنك لا تملك صلاحية الحذف، أو أن السجل مرتبط بغيره. الشركة يمنع حذفها وجود عقد أو مندوب أو سجل أداء، والعقد يمنع حذفه وجود سجلات أداء. استخدم التعطيل بدلاً من ذلك.

عطّلت شركة. هل تعطّلت عقودها؟

لا. العقود تبقى على حالتها. تظهر العقود المفعّلة تحت شركة معطّلة في بطاقة عقود تحت شركة معطّلة بشاشة العقود، ويمكنك تعطيلها واحداً واحداً.

حاولت تفعيل عقد فرُفض الطلب. ما السبب؟

شركة العقد معطّلة. فعّل الشركة أولاً ثم فعّل العقد.

لماذا يجب أن يطابق اسم العقد ما في ملف الأداء؟

لأن استيراد ملف الأداء اليومي يتعرف على العقد باسمه. انسخ الاسم كما يرد في عمود Contract Name دون تغيير.

لا تظهر شركة معيّنة عند إضافة عقد جديد. لماذا؟

قائمة الشركات في نموذج العقد الجديد تعرض الشركات المفعّلة فقط. فعّل الشركة من شاشة شركات التوصيل ثم أعد المحاولة.