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

عند فتح الصفحة، ستجد في الأعلى:
- زر + جديد لإنشاء وكالة شحن جديدة
- زر 📥 تصدير اكسل لتصدير البيانات كملف Excel
- زر 🔽 تصنيف لفلترة البيانات
وفي الأسفل جدول وكلاء الشحن الذي يعرض جميع الوكالات المسجلة.
فلتر البحث:

| الفلتر | الوصف |
|---|---|
| ID | البحث بمعرف وكالة الشحن (ID) |
| معرف مميز | البحث بالمعرف المميز (UUID) للمالك |
بعد إدخال البيانات، اضغط على زر 🔍 بحث لعرض النتائج، أو زر 🔄 تفريغ لمسح الفلتر.
الإجراءات:
| الإجراء | الوصف |
|---|---|
| تحويل الراتب لوكالة شحن موثوقة | مفتاح تبديل (ON/OFF) للتحكم في تحويل الراتب تلقائياً لوكالة الشحن الموثوقة |
ملاحظة
- عند تفعيل تحويل الراتب لوكالة شحن موثوقة (اللون الأخضر)، سيتم تحويل الراتب تلقائياً.
- عند تعطيله، لن يتم التحويل التلقائي للراتب.
جدول وكلاء الشحن:
| العمود | الوصف |
|---|---|
| المعرف | رقم معرف وكالة الشحن (ID) |
| الوكالة | اسم الوكالة مع صورتها، علم الدولة، و ID |
| المالك | صاحب الوكالة: صورته، اسمه، UID، علم الدولة، ورقم الهاتف |
| وكالة شحن موثوقة | حالة التوثيق — yes (أخضر) وكالة موثوقة، no (أحمر) غير موثوقة |
| ظهور وكلاء الشحن | التحكم في ظهور الوكالة — yes ظاهرة، no مخفية |
| تجميد الشحن | حالة تجميد الشحن — no الشحن مفعل، yes الشحن مجمد |
| المنشئ | من أنشأ الوكالة: صورته، اسمه، و UID |
| عمليات | قائمة العمليات المتاحة |
إنشاء وكالة شحن جديدة:
لإنشاء وكالة شحن جديدة، اضغط على زر + جديد في أعلى الصفحة.

حقول الإنشاء:
| الحقل | الوصف | مطلوب |
|---|---|---|
| ID | معرف وكالة الشحن | لا |
| معرف مالك الوكالة في التطبيق | اختيار مالك الوكالة من القائمة المنسدلة (UUID) | ✅ نعم |
| الاسم | اسم وكالة الشحن | ✅ نعم |
| الحالة | تفعيل أو تعطيل الوكالة (ON/OFF) | لا |
| رقم واتساب الوكالة | رقم واتساب الوكالة مع رمز الدولة | لا |
| الرابط | رابط خاص بوكالة الشحن | لا |
خطوات الإنشاء:
- اضغط على زر + جديد
- أدخل ID الخاص بالوكالة (اختياري)
- اختر معرف مالك الوكالة من القائمة المنسدلة
- أدخل اسم الوكالة
- اختر الحالة (ON للتفعيل أو OFF للتعطيل)
- أدخل رقم واتساب الوكالة مع رمز الدولة (اختياري)
- أدخل الرابط الخاص بالوكالة (اختياري)
- اضغط على زر إرسال لحفظ وكالة الشحن
العمليات المتاحة:
من عمود عمليات في الجدول، اضغط على أيقونة ⋮ لعرض القائمة:
| العملية | الوصف |
|---|---|
| تعديل | تعديل بيانات وكالة الشحن |
| عرض | عرض تفاصيل وكالة الشحن والإجراءات المتاحة |
| حذف | حذف وكالة الشحن نهائياً |
عرض وكالة الشاحن:
عند الضغط على عرض من قائمة العمليات، يتم فتح صفحة تفاصيل وكالة الشحن التي تعرض جميع المعلومات والمعاملات المتعلقة بالوكالة.

في أعلى الصفحة يوجد زر ← العودة للرجوع للقائمة وزر تصدير لتصدير البيانات.
1. معلومات الوكالة:
القسم الأول يعرض معلومات وكالة الشحن الأساسية على خلفية داكنة:
| البيان | الوصف |
|---|---|
| صورة الوكالة | الصورة الرمزية لوكالة الشحن |
| اسم الوكالة | اسم وكالة الشحن |
| المعرف | رقم معرف الوكالة (ID) |
| رقم الهاتف | رقم هاتف الوكالة |
| المالك | اسم المالك، صورته، و UUID |
2. محفظة وكالة الشحن (COIN SHIPPING AGENCY WALLET):
بطاقة تعرض معلومات محفظة العملات الخاصة بوكالة الشحن:
| البيان | الوصف |
|---|---|
| اسم التطبيق | اسم التطبيق المرتبط |
| المعرف | معرف المحفظة |
| اسم المالك | اسم مالك المحفظة |
| الرصيد | الرصيد الحالي في المحفظة (بالعملات) |
4. التبويبات:
صفحة العرض تحتوي على ثلاثة تبويبات:
| التبويب | الوصف |
|---|---|
| المعاملات المرسلة | جميع المعاملات المرسلة من وكالة الشحن |
| المعاملات المستلمة | جميع المعاملات المستلمة لوكالة الشحن |
| سجل عملات | سجل عمليات العملات |
📤 تبويب المعاملات المرسلة:

يعرض جميع المعاملات المرسلة من وكالة الشحن مع إمكانية الفلترة.
الفلاتر:
| الفلتر | الوصف |
|---|---|
| اختر التصنيف | فلترة حسب نوع المعاملة |
| Search | البحث بالنص |
أعمدة الجدول:
| العمود | الوصف |
|---|---|
| # | رقم التسلسل |
| المعرّف | رقم معرف المعاملة (ID) |
| المستلم | صورة المستلم، اسمه، و UUID |
| المبلغ | مبلغ المعاملة بالدولار ($) |
| النقاط | عدد النقاط (العملات) المرسلة |
| التاريخ | تاريخ ووقت المعاملة |
📥 تبويب المعاملات المستلمة:

يعرض جميع المعاملات المستلمة لوكالة الشحن مع إمكانية الفلترة.
الفلاتر:
| الفلتر | الوصف |
|---|---|
| اختر التصنيف | فلترة حسب نوع المعاملة |
| Search | البحث بالنص |
أعمدة الجدول:
| العمود | الوصف |
|---|---|
| # | رقم التسلسل |
| المعرّف | رقم معرف المعاملة (ID) |
| المرسل | صورة المرسل، اسمه، و UUID |
| المبلغ | مبلغ المعاملة بالدولار ($) |
| النقاط | عدد النقاط (العملات) المستلمة |
| التاريخ | تاريخ ووقت المعاملة |
ملخص سريع:
| الإجراء | الخطوات |
|---|---|
| عرض جميع وكلاء الشحن | نظام الوكالات ← وكالات الشحن ← وكلاء الشحن |
| البحث عن وكالة شحن | أدخل ID أو UUID ← بحث |
| إنشاء وكالة شحن جديدة | اضغط + جديد ← املأ البيانات ← إرسال |
| تعديل وكالة شحن | اضغط ⋮ في عمود العمليات ← تعديل |
| عرض تفاصيل وكالة شحن | اضغط ⋮ في عمود العمليات ← عرض |
| حذف وكالة شحن | اضغط ⋮ في عمود العمليات ← حذف |
| تصدير البيانات | اضغط زر 📥 تصدير اكسل |