# نظام تنبيهات الشيكات البسيط

## 🎯 الفكرة

عند تسجيل الدخول، يظهر popup يعرض الشيكات المستحقة أو القريبة من الاستحقاق.

## 📋 البيانات المعروضة

كل شيك يظهر فيه:
- **رقم الشيك** - من `cheque_number`
- **اسم العميل/الجهة** - من `contact_name`
- **المبلغ** - من `amount`
- **تاريخ الاستحقاق** - يحسب من `transaction_date` + `pay_term_number` و `pay_term_type`
- **الساعات المتبقية** - الفرق بين الآن والاستحقاق

## ⚙️ الإعدادات

الذهاب إلى: **الإعدادات → تاب الدفع → تنبيهات الشيكات**

حدد عدد الساعات (مثلاً: 48 ساعة)

## 🔧 كيف يعمل

### 1️⃣ عند إنشاء شيك جديد:
- يتم تسجيل الشيك في جدول `transaction_payments`
- مع تحديد `method = 'cheque'` و `cheque_number`
- ربط الشيك بـ transaction يحتوي على:
  - `transaction_date` - تاريخ العملية
  - `pay_term_number` - عدد الأيام/الأشهر
  - `pay_term_type` - نوع الفترة (days/months)

### 2️⃣ عند تسجيل الدخول:
```
الـ Middleware: CheckPendingCheques
    ↓
جلب جميع الشيكات: TransactionPayment (method='cheque')
    ↓
لكل شيك: حساب due_date = transaction_date + pay_term_number/type
    ↓
مقارنة: hours_until_due مع reminder_hours
    ↓
إذا كان الشيك مستحقاً → إظهار Popup
```

### 3️⃣ حساب الأجل:
```php
// مثال:
transaction_date = 2026-08-16
pay_term_number = 30
pay_term_type = 'days'

due_date = 2026-08-16 + 30 days = 2026-09-15
```

## 📊 ألوان التحذير

| اللون | الحالة | الوصف |
|------|-------|--------|
| 🔴 أحمر | متأخر | الشيك تجاوز موعد الاستحقاق |
| 🟡 أصفر | قريب جداً | أقل من 24 ساعة |
| 🔵 أزرق | عادي | أكثر من 24 ساعة |

## 📁 الملفات

### مضافة:
- `app/Http/Middleware/CheckPendingCheques.php` - Middleware للفحص

### معدلة:
- `app/Http/Kernel.php` - تسجيل Middleware
- `routes/web.php` - إضافة Middleware في Routes
- `resources/views/layouts/app.blade.php` - إضافة Popup
- `resources/views/business/partials/settings_payment.blade.php` - الإعدادات
- `resources/views/components/cheque_reminder_popup.blade.php` - الـ Popup

### محذوفة:
- `app/ChequeReminder.php` - Model قديم غير مستخدم
- `app/Console/Commands/CheckChequeReminders.php` - Command قديم
- `app/Listeners/CreateChequeReminderOnPaymentAdded.php` - Listener قديم

## 🎯 مثال عملي:

```
User: أحمد
Login Time: 2026-09-14 20:00

Cheques in system:
1. Cheque #123 - Customer: "شركة النيل" - Amount: 5000
   Transaction Date: 2026-08-15
   Pay Terms: 30 days
   Due Date: 2026-09-14
   Hours Until Due: 4 hours ← ⚠️ قريب جداً!

2. Cheque #456 - Customer: "محمد علي" - Amount: 2000
   Transaction Date: 2026-07-01
   Pay Terms: 45 days
   Due Date: 2026-08-15
   Hours Until Due: -29 days ← 🔴 متأخر!

Popup Result:
✓ يظهر popup مع الشيكة رقم 123 و 456
✓ الشيكة 123 بخلفية صفراء (قريب)
✓ الشيكة 456 بخلفية حمراء (متأخر)
```

---

**النظام بسيط وفعال ويقرأ الاجل من transaction_date والـ payment terms!** 🎉

