# فصل تعاملات الأقساط عن المبيعات والمشتريات في التقارير المالية

## نظرة عامة

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

## الميزات المضافة

### 1. فلتر نوع الحركات

تم إضافة فلتر في **تقرير الخزينة العامة** يتيح عرض:
- **جميع الحركات**: عرض كامل لجميع الإيرادات والمصروفات
- **أقساط فقط**: عرض المدفوعات المرتبطة بعقود الأقساط فقط
- **مبيعات ومشتريات فقط**: عرض المعاملات النقدية من البيع والشراء

### 2. تصنيف الإيرادات

تم تقسيم الإيرادات إلى:

#### أقساط (Installment Payments)
- المدفوعات المرتبطة بعقود الأقساط
- تظهر مع رقم العقد واسم العميل

#### مبيعات نقدية (Cash Sales)
- فواتير البيع المدفوعة نقداً
- تظهر مع رقم الفاتورة واسم العميل

#### دفعات عملاء أخرى (Other Customer Payments)
- المدفوعات غير المرتبطة بعقود أو فواتير محددة
- دفعات مباشرة من العملاء

#### إيداعات الشركاء (Partner Deposits)
- تظهر في جميع الأحوال (لا تتأثر بالفلتر)

### 3. تصنيف المصروفات

تم تقسيم المصروفات إلى:

#### فواتير الشراء (Purchase Invoices)
- المدفوعات لفواتير الشراء من الموردين
- تظهر مع رقم الفاتورة واسم المورد

#### مصروفات عامة (General Expenses)
- المصروفات التشغيلية العامة
- تظهر في جميع الأحوال (لا تتأثر بالفلتر)

#### مسحوبات الشركاء (Partner Withdrawals)
- تظهر في جميع الأحوال (لا تتأثر بالفلتر)

### 4. ملخص تفصيلي

تم إضافة بطاقات ملخص تعرض:

**الإيرادات:**
- إجمالي الأقساط المسددة
- إجمالي المبيعات النقدية
- إجمالي دفعات العملاء الأخرى
- إجمالي إيداعات الشركاء

**المصروفات:**
- إجمالي فواتير الشراء
- إجمالي المصروفات العامة
- إجمالي مسحوبات الشركاء

## الملفات المعدلة

### Backend
1. **app/Filament/Pages/GeneralTreasuryReport.php**
   - إضافة property `transaction_type`
   - تعديل `getFormSchema()` لإضافة فلتر نوع الحركات
   - تعديل `getRevenues()` لفصل أنواع الإيرادات
   - تعديل `getExpenses()` لفصل أنواع المصروفات
   - تعديل `calculateOpeningBalance()` لتضمين فواتير المبيعات
   - إضافة حسابات تفصيلية في `generateReport()`

### Frontend
2. **resources/views/filament/pages/general-treasury-report.blade.php**
   - إضافة عرض نوع الفلتر المطبق
   - إضافة بطاقات الملخص التفصيلي
   - تحسين عرض الجداول

### Translations
3. **lang/ar/general_treasury_report.php**
   - إضافة ترجمة 'cash_sale'
   - إضافة ترجمة 'purchase'

4. **lang/en/general_treasury_report.php**
   - إضافة ترجمة 'cash_sale'
   - إضافة ترجمة 'purchase'

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

### الوصول للتقرير
1. اذهب إلى: **التقارير المالية > تقرير الخزينة العامة**

### تطبيق الفلتر
1. اختر الخزينة (أو اترك "جميع الخزائن")
2. اختر **نوع الحركات**:
   - جميع الحركات
   - أقساط فقط
   - مبيعات ومشتريات فقط
3. حدد الفترة الزمنية
4. اضغط "عرض التقرير"

### قراءة النتائج

**الملخص العلوي:**
- يعرض الرصيد الافتتاحي والختامي
- إجمالي الإيرادات والمصروفات

**الملخص التفصيلي:**
- بطاقتان توضحان توزيع الإيرادات والمصروفات حسب النوع

**الجداول التفصيلية:**
- جدول الإيرادات: يعرض كل حركة مع تصنيفها
- جدول المصروفات: يعرض كل حركة مع تصنيفها

## فوائد الميزة

1. **وضوح أفضل**: فصل واضح بين الأقساط والمعاملات النقدية
2. **تحليل دقيق**: إمكانية تحليل كل نوع معاملات بشكل مستقل
3. **مرونة في العرض**: فلتر سهل للتبديل بين أنماط العرض
4. **تقارير متخصصة**: إمكانية طباعة تقرير للأقساط فقط أو المبيعات فقط

## ملاحظات تقنية

- **الفلتر لا يؤثر على حساب الرصيد**: الرصيد الافتتاحي والختامي يشمل جميع المعاملات
- **إيداعات ومسحوبات الشركاء**: تظهر دائماً في فلتر "جميع الحركات" فقط
- **المصروفات العامة**: تظهر دائماً في فلتر "جميع الحركات" فقط
- **التحويلات بين الخزائن**: تظهر فقط عند اختيار خزينة محددة

## التوافق

- متوافق مع Laravel 11
- متوافق مع Filament 4.0
- يدعم الترجمة الكاملة (عربي/إنجليزي/فرنسي)
- يدعم الطباعة والتصدير PDF

## التطوير المستقبلي المقترح

1. إضافة تقارير رسومية (Charts) لمقارنة الأقساط بالمبيعات
2. إضافة فلتر حسب طريقة الدفع
3. إضافة إمكانية تصدير Excel مع تفصيل كامل
4. إضافة تقرير مقارنة شهري بين الأقساط والمبيعات

---

**تاريخ التطوير**: مارس 2026
**الحالة**: مكتمل ✅