═══════════════════════════════════════════════════════════════════════════════
  مرجع سريع: تصنيف الحسابات في تقارير مراكز التكلفة
═══════════════════════════════════════════════════════════════════════════════

📌 الحسابات المستخدمة
───────────────────────────────────────────────────────────────────────────────

┌─────────────────────────────────────────────────────────────────────────────┐
│ رقم الحساب │ الاسم                          │ التصنيف في التقرير          │
├────────────┼────────────────────────────────┼──────────────────────────────┤
│ 50101      │ تكلفة مواد مباشرة              │ ✓ تكاليف المواد             │
│ 50102      │ تكلفة أجور مباشرة              │ ✓ تكاليف العمالة            │
│ 50103      │ تكلفة معدات للموقع             │ ✓ تكاليف المعدات            │
│ 50104+     │ أي حسابات تكاليف أخرى          │ ✓ مصروفات عامة              │
└────────────┴────────────────────────────────┴──────────────────────────────┘

───────────────────────────────────────────────────────────────────────────────
🔄 كيفية عمل التصنيف
───────────────────────────────────────────────────────────────────────────────

عند معالجة قيد محاسبي:
  1. يتم قراءة رقم حساب الحركة
  2. يتم مقارنة الرقم مع القائمة أعلاه
  3. يتم إضافة المبلغ إلى التصنيف المناسب

مثال:
  قيد: 1,000 ريال من الحساب 50101
  ▶ يُضاف 1,000 إلى "تكاليف المواد"

───────────────────────────────────────────────────────────────────────────────
📊 التقارير المتأثرة
───────────────────────────────────────────────────────────────────────────────

✓ التكاليف الإجمالية حسب المشروع
  /reports/cost-summary-by-project

✓ تحليل المصروفات حسب نوع الحساب
  /reports/expense-analysis

───────────────────────────────────────────────────────────────────────────────
🔧 الدوال المعدلة
───────────────────────────────────────────────────────────────────────────────

✓ calculateCostsByType($centerId, $dateFrom, $dateTo)
  ▸ تصنف التكاليف لمركز تكلفة واحد

✓ calculateCostsByTypeForCenterAndChildren($centerId, $dateFrom, $dateTo)
  ▸ تصنف التكاليف لمركز وأطفاله

✓ calculateExpenseByType($type, $dateFrom, $dateTo)
  ▸ تحسب المصروفات حسب النوع (تم تطبيقها)

───────────────────────────────────────────────────────────────────────────────
💡 أمثلة عملية
───────────────────────────────────────────────────────────────────────────────

مثال 1: مشروع بسيط
  ┌──────────────────────────┐
  │ قيود محاسبية:           │
  │ • 10,000 من 50101 (مواد)  │
  │ • 5,000 من 50102 (أجور)   │
  │ • 3,000 من 50103 (معدات)  │
  │ • 2,000 من 50104 (باطن)   │
  └──────────────────────────┘

  التقرير يعرض:
  ┌──────────────────────────┐
  │ المواد:        10,000    │
  │ العمالة:       5,000     │
  │ المعدات:       3,000     │
  │ مصروفات عامة:  2,000     │
  │ ─────────────────────────│
  │ الإجمالي:      20,000    │
  └──────────────────────────┘

───────────────────────────────────────────────────────────────────────────────
⚡ النقاط المهمة
───────────────────────────────────────────────────────────────────────────────

✓ المقارنة دقيقة: === بدلاً من البحث عن أسماء
✓ أداء محسّن: لا تحميل حقول غير مستخدمة
✓ موثوق: يعتمد على الأرقام الفعلية
✓ مرن: أي حساب إضافي يُصنف كمصروفات عامة

───────────────────────────────────────────────────────────────────────────────
🧪 اختبار سريع
───────────────────────────────────────────────────────────────────────────────

1. فتح التقرير: /reports/cost-summary-by-project
2. التحقق من الأعمدة الأربع
3. التحقق من أن المجموع صحيح
4. التحقق من أن النسب = 100% (في تقرير المصروفات)

───────────────────────────────────────────────────────────────────────────────
❌ الأخطاء الشائعة
───────────────────────────────────────────────────────────────────────────────

1. "لا توجد بيانات"
   ▸ تحقق من وجود قيود بحالة "approved"
   ▸ تحقق من وجود حسابات 50101، 50102، 50103

2. "الأرقام خاطئة"
   ▸ مسح الـ cache: php artisan cache:clear
   ▸ تحديث الصفحة: Ctrl+Shift+R

3. "أداء بطيئة"
   ▸ استخدم تصفية التاريخ
   ▸ قلل عدد المشاريع

───────────────────────────────────────────────────────────────────────────────
📚 قراءة إضافية
───────────────────────────────────────────────────────────────────────────────

COST_REPORT_ACCOUNT_CLASSIFICATION_FIX.md   ← شرح تفصيلي
TEST_COST_REPORT_CLASSIFICATION.md          ← دليل الاختبار
COST_REPORT_CLASSIFICATION_SUMMARY.txt      ← ملخص سريع

═══════════════════════════════════════════════════════════════════════════════
