================================================================================
                    الأسئلة الشائعة حول فواتير العملاء (FAQ)
================================================================================

س: عندما أضغط "حفظ الفاتورة" لا شيء يحدث؟
ج: قد تكون المشكلة في:
   1. المتصفح قد يكون مشغولاً - حاول تحديث الصفحة
   2. قد يكون هناك خطأ صامت - افتح كونسول المتصفح (F12)
   3. قد لا تكون هناك بنود مضافة - أضف بند واحد على الأقل

================================================================================

س: ظهرت رسالة "يجب إضافة بند واحد على الأقل"؟
ج: الحل:
   1. انقر الزر "إضافة بند جديد"
   2. ملء بيانات البند:
      - الوصف: أدخل اسم المنتج/الخدمة
      - الكمية: أدخل الكمية (أكبر من 0)
      - السعر: أدخل سعر الوحدة
      - الضريبة: أدخل نسبة الضريبة (0-100)
      - الخصم: اترك فارغاً إذا لم يكن هناك خصم
   3. أضف بند آخر إذا لزم
   4. جرب الحفظ

================================================================================

س: ما هي الحقول المطلوبة في الفاتورة؟
ج: الحقول المطلوبة:
   ✓ العميل: يجب اختيار عميل من القائمة
   ✓ تاريخ الفاتورة: يجب إدخال التاريخ
   ✓ البنود: يجب إضافة بند واحد على الأقل

   الحقول الاختيارية:
   ○ العقد: يمكن اختياره أو تركه فارغاً
   ○ تاريخ الاستحقاق: يمكن تركه فارغاً

================================================================================

س: كيف أختار عميل إذا لم يكن في القائمة؟
ج: قد لا يكون العميل مضافاً أو قد تكون حالته غير نشطة:
   1. اذهب إلى: إدارة العملاء
   2. تحقق من وجود العميل
   3. تأكد من أن حالة العميل "نشطة"
   4. إذا لم يكن موجوداً، أضفه (اختر "إضافة عميل جديد")
   5. تأكد من ربط العميل بحساب محاسبي

================================================================================

س: ما الفرق بين الخصم النسبي والمبلغ الثابت؟
ج: نوعا الخصم:
   1. النسبي (Percentage): خصم بنسبة معينة من السعر
      مثال: 10% = خصم 10% من السعر الأصلي
   
   2. المبلغ الثابت (Amount): خصم بمبلغ معين
      مثال: 100 ريال = خصم مبلغ 100 ريال من السعر

   في نموذج الفاتورة، تم تعيين الخصم كنسبة مئوية بشكل افتراضي
   إذا أردت خصم ثابت، أخبر المسؤول بذلك

================================================================================

س: هل يمكن إضافة أكثر من ضريبة واحدة على البند؟
ج: نعم، يمكن إضافة ضريبتين:
   - الضريبة الأولى (tax_rate): نسبة الضريبة الأساسية
   - الضريبة الثانية (tax_rate_2): ضريبة إضافية على الضريبة الأولى + السعر
   
   الحساب:
   المبلغ الضريبي الأول = (السعر - الخصم) × الضريبة الأولى
   المبلغ الضريبي الثاني = (السعر - الخصم + الضريبة الأولى) × الضريبة الثانية
   الإجمالي = السعر - الخصم + الضريبة الأولى + الضريبة الثانية

================================================================================

س: عندما أحفظ، تظهر رسالة "لا توجد سنة مالية نشطة"؟
ج: المشكلة: لم يتم إنشاء سنة مالية أو فترة محاسبية
   الحل:
   1. اذهب إلى: الإعدادات → الحسابات → السنوات المالية
   2. اضغط "إضافة سنة مالية جديدة"
   3. ملء البيانات:
      - التاريخ من: 2025-01-01
      - التاريخ إلى: 2025-12-31
      - الحالة: نشطة / active
   4. احفظ
   5. أضف فترة محاسبية بحالة "مفتوحة"
   6. حاول الحفظ مرة أخرى

================================================================================

س: عندما أحفظ، تظهر رسالة "العميل غير مرتبط بحساب"؟
ج: المشكلة: العميل لم يتم ربطه بحساب محاسبي
   الحل:
   1. اذهب إلى: إدارة العملاء
   2. اختر العميل المراد ربطه
   3. ابحث عن حقل "الحساب المحاسبي" أو "Chart of Account"
   4. اختر حساب من دليل الحسابات (يجب أن تكون حسابات العملاء موجودة)
   5. احفظ
   6. حاول إنشاء الفاتورة مرة أخرى

================================================================================

س: عندما أحفظ، تظهر رسالة "حساب المبيعات غير موجود"؟
ج: المشكلة: حساب المبيعات (4100) غير موجود في دليل الحسابات
   الحل:
   1. اذهب إلى: الإعدادات → الحسابات → دليل الحسابات
   2. اضغط "إضافة حساب جديد"
   3. ملء البيانات:
      - الرمز: 4100
      - الاسم: المبيعات
      - نوع الحساب: Revenue (إيراد)
      - نوع الرصيد: Credit (دائن)
   4. احفظ
   5. حاول إنشاء الفاتورة مرة أخرى

================================================================================

س: عندما أحفظ، تظهر رسالة "حساب الضريبة غير موجود"؟
ج: المشكلة: حساب الضريبة (217001) غير موجود
   الحل:
   1. اذهب إلى: الإعدادات → الحسابات → دليل الحسابات
   2. اضغط "إضافة حساب جديد"
   3. ملء البيانات:
      - الرمز: 217001
      - الاسم: ضريبة القيمة المضافة المحصلة
      - نوع الحساب: Liability (التزام)
      - نوع الرصيد: Credit (دائن)
   4. احفظ
   5. حاول إنشاء الفاتورة مرة أخرى

================================================================================

س: هل يمكن تعديل رقم الفاتورة؟
ج: لا، رقم الفاتورة يتم توليده تلقائياً
   - الصيغة: INV-YYYYMM-XXXX (مثال: INV-202511-0001)
   - يتم التوليد بناءً على تاريخ الفاتورة
   - كل شهر يبدأ الرقم التسلسلي من 0001
   - لا يمكن تعديل الرقم يدوياً

================================================================================

س: هل يمكن حذف فاتورة؟
ج: نعم، يمكن حذف الفاتورة ولكن:
   - يجب أن تكون الفاتورة بحالة "draft" (مسودة)
   - إذا تم ترحيل القيد اليومي، لا يمكن حذفها
   - الخطوات:
     1. افتح الفاتورة
     2. اضغط الزر "حذف"
     3. أكد الحذف
     4. سيتم حذف البنود والقيد اليومي تلقائياً

================================================================================

س: هل يمكن تعديل فاتورة بعد حفظها؟
ج: نعم، يمكن تعديلها ولكن:
   - يجب أن تكون الفاتورة بحالة "draft"
   - إذا تم ترحيل القيد اليومي، لا يمكن تعديلها
   - الخطوات:
     1. افتح قائمة الفواتير
     2. اختر الفاتورة
     3. اضغط الزر "تعديل"
     4. غيّر البيانات
     5. اضغط "تحديث"

================================================================================

س: كم عدد البنود التي يمكن إضافتها؟
ج: يمكن إضافة أي عدد من البنود:
   - لا يوجد حد أدنى: بند واحد على الأقل
   - لا يوجد حد أقصى: أضف ما تشاء
   - الخطوات:
     1. اضغط "إضافة بند جديد" للبند الأول
     2. اضغط الزر مرة أخرى للبند الثاني
     3. استمر حسب الحاجة
     4. الحذف: اضغط الزر "حذف" في كل صف

================================================================================

س: هل يتم حساب الإجماليات تلقائياً؟
ج: نعم، يتم حسابها تلقائياً:
   - الحساب يتم على الفور عند تغيير أي قيمة
   - الحقول المحسوبة:
     - الإجمالي لكل بند
     - المبلغ الفرعي (مجموع البنود)
     - إجمالي الخصم
     - إجمالي الضريبة
     - المبلغ الإجمالي
   - تظهر الإجماليات في الملخص المالي

================================================================================

س: هل يمكن طباعة الفاتورة؟
ج: نعم، بعد حفظ الفاتورة:
   1. افتح الفاتورة
   2. اضغط الزر "طباعة"
   3. تظهر الفاتورة بتنسيق جاهز للطباعة
   4. استخدم الطابعة أو احفظها كـ PDF

================================================================================

س: هل يتم إنشاء قيد يومية تلقائياً؟
ج: نعم، عند حفظ الفاتورة:
   - يتم إنشاء قيد يومية تلقائياً
   - القيد يحتوي على:
     - مدين: حساب العميل
     - دائن: حساب المبيعات
     - دائن: حساب الضريبة
   - حالة القيد: مسودة (draft)
   - يجب ترحيله يدوياً من صفحة القيود اليومية

================================================================================

س: ماذا إذا لم أجد الحل في هذا الملف؟
ج: خطوات إضافية:
   1. افتح ملف السجل: storage/logs/laravel.log
   2. ابحث عن أحدث خطأ
   3. انسخ رسالة الخطأ
   4. ابحث عن الخطأ في ملف ERROR_REPORT.txt
   5. إذا لم تجد الحل، اتصل بمسؤول النظام

================================================================================

س: كيف أرسل الفاتورة للعميل؟
ج: يمكنك:
   1. طباعة الفاتورة
   2. تصديرها إلى PDF
   3. إرسالها عبر البريد الإلكتروني (إذا كانت هذه الميزة متوفرة)

   لاحظ: هذه الميزات قد تكون قيد التطوير

================================================================================

س: هل يمكن استرجاع فاتورة محذوفة؟
ج: ربما، إذا كانت الحذف ناعماً (soft delete):
   1. اتصل بمسؤول النظام
   2. قد يتمكن من استرجاع الفاتورة
   3. الحذف النهائي لا يمكن استرجاعه

================================================================================

س: ما هي الفرق بين حالات الفاتورة؟
ج: حالات الفاتورة:
   - Draft (مسودة): الفاتورة قيد الإعداد، يمكن تعديلها
   - Sent (مرسلة): الفاتورة تم إرسالها للعميل
   - Paid (مدفوعة): الفاتورة تم دفعها بالكامل
   - Partially Paid (مدفوعة جزئياً): تم دفع جزء من الفاتورة
   - Overdue (متأخرة): الفاتورة تجاوزت تاريخ الاستحقاق
   - Cancelled (ملغاة): الفاتورة تم إلغاؤها

================================================================================

س: كم يستغرق وقت الحفظ؟
ج: عادة:
   - الفاتورة البسيطة: 1-2 ثانية
   - الفاتورة المعقدة (بنود كثيرة): 5-10 ثواني
   - إذا استغرق أكثر من ذلك، قد توجد مشكلة في الخادم

================================================================================

س: هل يمكن إنشاء فاتورة لعملاء متعددين؟
ج: لا، كل فاتورة مرتبطة بعميل واحد فقط
   - إذا أردت فاتورة لعميلين، أنشئ فاتورة لكل عميل على حدة

================================================================================

س: هل يمكن تطبيق خصم على الفاتورة كاملة؟
ج: نعم، يمكن تطبيق خصم على كل بند
   - الخصم الكلي = مجموع الخصومات على جميع البنود
   - يمكن تطبيق خصم مختلف على كل بند

================================================================================

                            نهاية الأسئلة الشائعة
================================================================================
