# دليل استخدام نظام المانيفست (Manifest)

## ما هو المانيفست؟

المانيفست هو **محضر تسليم** يحتوي على قائمة بجميع الطلبات التي سيتم تسليمها لشركة الشحن أو المندوب. يستخدم لـ:
- تنظيم عملية الشحن
- حساب المبالغ المستحقة
- توثيق التسليم والاستلام
- المتابعة والمحاسبة

---

## كيفية إنشاء مانيفست

### الخطوة 1: الدخول لصفحة إنشاء المانيفست
```
backend/admin/shipping/create-manifest.php
```

### الخطوة 2: ملء معلومات المانيفست
- **شركة الشحن**: اختر الشركة التي ستسلم لها الطلبات
- **اسم المندوب**: اسم المندوب الذي سيستلم الطلبات
- **ملاحظات**: أي ملاحظات إضافية (اختياري)

### الخطوة 3: اختيار الطلبات
- ستظهر لك قائمة بجميع الطلبات الجاهزة للشحن
- حدد الطلبات التي تريد إضافتها للمانيفست
- يمكنك استخدام "تحديد الكل" لتحديد جميع الطلبات

### الخطوة 4: إنشاء وطباعة
- اضغط على "إنشاء المانيفست وطباعته"
- سيتم إنشاء المانيفست تلقائياً
- ستفتح صفحة الطباعة مباشرة

---

## محتويات المانيفست المطبوع

### 1. معلومات عامة
- رقم المانيفست (مثال: MAN-20251115-1234)
- التاريخ والوقت
- شركة الشحن واسم المندوب

### 2. جدول الطلبات
يحتوي على:
- رقم الطلب
- اسم العميل
- رقم الهاتف
- العنوان والمدينة
- المبلغ المطلوب تحصيله
- خانة للتوقيع عند التسليم

### 3. الإجماليات
- عدد الطلبات الكلي
- إجمالي المبالغ المحصلة
- تكلفة الشحن (30 ر.س للطلب)
- **الصافي المستحق** (المبلغ - تكلفة الشحن)

### 4. التواقيع
- توقيع المندوب
- توقيع المحاسب
- توقيع المدير

---

## عرض المانيفستات السابقة

### الدخول لقائمة المانيفستات
```
backend/admin/shipping/list-manifests.php
```

### الإحصائيات المتاحة
- إجمالي عدد المانيفستات
- إجمالي الطلبات المشحونة
- إجمالي المبالغ
- الصافي الكلي

### إعادة طباعة مانيفست
- اضغط على زر "طباعة" بجانب أي مانيفست
- سيفتح المانيفست في نافذة جديدة جاهز للطباعة

---

## الحسابات التلقائية

### تكلفة الشحن
```
تكلفة الشحن = عدد الطلبات × 30 ر.س
```

### الصافي المستحق
```
الصافي = إجمالي المبالغ - تكلفة الشحن
```

### مثال
- عدد الطلبات: 10
- إجمالي المبالغ: 5,000 ر.س
- تكلفة الشحن: 10 × 30 = 300 ر.س
- **الصافي المستحق: 4,700 ر.س**

---

## تحديث حالة الطلبات

عند إنشاء المانيفست:
1. يتم تغيير حالة الطلبات من `pending` أو `processing` إلى `shipped`
2. يتم ربط الطلبات بالمانيفست
3. لا يمكن إضافة نفس الطلب لأكثر من مانيفست

---

## نصائح مهمة

### ✅ أفضل الممارسات
- راجع الطلبات جيداً قبل إنشاء المانيفست
- تأكد من صحة أرقام الهواتف والعناوين
- احتفظ بنسخة مطبوعة من كل مانيفست
- اطلب توقيع المندوب عند التسليم

### ⚠️ تحذيرات
- لا يمكن تعديل المانيفست بعد إنشائه
- تأكد من اختيار الطلبات الصحيحة
- راجع الإجماليات قبل الطباعة

---

## الملفات المستخدمة

```
backend/admin/shipping/
├── create-manifest.php      # إنشاء مانيفست جديد
├── print-manifest.php       # طباعة المانيفست
├── list-manifests.php       # قائمة المانيفستات
└── MANIFEST-GUIDE.md        # هذا الدليل
```

---

## قاعدة البيانات

### جدول shipping_manifests
```sql
- id: رقم المانيفست
- manifest_number: رقم المانيفست الفريد
- shipping_company_id: شركة الشحن
- delegate_name: اسم المندوب
- total_orders: عدد الطلبات
- total_amount: إجمالي المبالغ
- shipping_cost: تكلفة الشحن
- net_amount: الصافي
- notes: ملاحظات
- created_at: تاريخ الإنشاء
```

### جدول manifest_orders
```sql
- id: المعرف
- manifest_id: رقم المانيفست
- order_id: رقم الطلب
```

---

## الدعم

إذا واجهت أي مشكلة:
1. تأكد من وجود طلبات جاهزة للشحن
2. تحقق من إنشاء جداول قاعدة البيانات
3. راجع ملف الأخطاء في السيرفر

---

**تم التحديث:** 15 نوفمبر 2025