# 🚀 نظام الخزائن - دليل سريع

## ⚡ البداية السريعة

### 1. إنشاء الخزائن الأولية
```bash
php artisan db:seed --class=VaultSeeder
```
✅ ينشئ 3 خزائن لكل فرع: نقدي، فودافون، إنستاباي

### 2. إضافة معاملة مالية
1. اذهب إلى المصروفات/الإيرادات/مدفوعات الطلاب
2. انقر "إنشاء جديد"
3. **اختر الخزينة** من القائمة المنسدلة
4. أكمل البيانات واحفظ

### 3. عرض أرصدة الخزائن
📍 **الموقع:** لوحة التحكم الرئيسية (Dashboard)
- يعرض رصيد كل خزينة مباشرة
- تحديث تلقائي عند كل معاملة
- تنبيه أحمر للرصيد السالب

### 4. تقرير معاملات الخزائن
📍 **الموقع:** `/admin/vaults/transactions`
- عرض جميع المعاملات لكل الخزائن
- فلتر حسب الخزينة/النوع/التاريخ
- الرصيد بعد كل عملية

### 5. تقرير الحركة اليومية
📍 **الموقع:** Widget في Dashboard
- حركة كل خزينة في يوم محدد
- اختيار التاريخ
- جدول تفصيلي بالوارد والمصروف

### 6. عمل تسوية
📍 **الموقع:** `/admin/vault-reconciliations`
1. انقر "إنشاء جديد"
2. اختر الخزينة والتاريخ
3. أدخل الرصيد الفعلي
4. النظام يحسب الفرق تلقائياً
5. اعتمد أو ارفض

---

## 🎯 الاختصارات

| الوظيفة | الموقع | الاختصار |
|---------|--------|-----------|
| أرصدة الخزائن | Dashboard | Widget علوي |
| إدارة الخزائن | `/admin/vaults` | قائمة المالية |
| تقرير المعاملات | `/admin/vaults/transactions` | صفحة مخصصة |
| التسويات | `/admin/vault-reconciliations` | قائمة المالية |

---

## 🔍 الفلاتر السريعة

### في جداول المعاملات:
```
1. فلتر الخزينة: اختر خزينة محددة
2. فلتر النوع: إيراد/مصروف/دفعة
3. فلتر التاريخ: من - إلى
```

---

## ⚠️ تنبيهات مهمة

### ✅ افعل:
- اختر الخزينة في كل معاملة مالية
- راجع الرصيد يومياً
- اعمل تسوية أسبوعية مع السكرتيرة

### ❌ لا تفعل:
- لا تترك حقل الخزينة فارغاً
- لا تخلط بين الخزائن
- لا تحذف خزينة بها معاملات

---

## 🆘 حل سريع للمشاكل

### رصيد خاطئ؟
```
1. تحقق من الرصيد الافتتاحي
2. راجع جميع المعاملات
3. اعمل تسوية لتأكيد الرصيد
```

### لا تظهر الخزائن؟
```bash
php artisan db:seed --class=VaultSeeder
php artisan cache:clear
```

### تنبيه رصيد سالب؟
```
1. راجع المصروفات الأخيرة
2. تأكد من تسجيل جميع الإيرادات
3. اعمل تسوية لتوثيق الحالة
```

---

## 📊 معادلات مهمة

```
الرصيد الحالي = رصيد افتتاحي + إيرادات + مدفوعات طلاب - مصروفات

الفرق في التسوية = الرصيد الفعلي - رصيد النظام

صافي الحركة اليومية = إجمالي الوارد - المصروفات
```

---

## 🎨 الرموز والألوان

### الأيقونات:
- 💵 نقدي
- 📱 فودافون كاش
- 💳 إنستاباي
- 💰 الإجمالي
- ⚠️ تحذير

### الألوان:
- 🟢 **أخضر**: موجب/معتمد
- 🔴 **أحمر**: سالب/مرفوض
- 🟡 **أصفر**: قيد المراجعة
- 🔵 **أزرق**: مدفوعات طلاب

---

## 📱 أوامر سريعة

```bash
# إنشاء الخزائن
php artisan db:seed --class=VaultSeeder

# مسح الكاش
php artisan cache:clear
php artisan config:clear

# عرض حالة الـ Migrations
php artisan migrate:status | grep vault

# تشغيل Migration جديدة
php artisan migrate
```

---

**💡 نصيحة:** احفظ هذا الملف كمرجع سريع للوصول السريع للوظائف الأساسية!
