═══════════════════════════════════════════════════════════════════════════════
  تطبيق QR Code متوافق مع ZATCA - 3 خطوات بسيطة جداً
═══════════════════════════════════════════════════════════════════════════════

✅ تم بالفعل: تحديث ملف QRCodeGeneratorService.php

الخطوات الثلاث المتبقية:
═══════════════════════════════════════════════════════════════════════════════

[1️⃣] تحديث app/Http/Controllers/CustomerInvoiceController.php
────────────────────────────────────────────────────────────────────────────────

  البحث عن دالة show واستبدال محتواها بـ:
  
  public function show(CustomerInvoice $invoice)
  {
      $this->authorize('view', $invoice);
      $invoice->load(["customer", "contract", "items.item", "items.itemUnit.unit", "payments"]);
      $items = $invoice->items;
      $payments = $invoice->payments;
      
      try {
          $qrCodeService = new QRCodeGeneratorService();
          $compliance = $qrCodeService->validateQRCompliance($invoice);
          $qrData = $qrCodeService->generateZatcaQRCode($invoice);
          $qrImage = $qrCodeService->generateQRImage($qrData, 'svg');
          $qrCode = $qrImage;
      } catch (\Exception $e) {
          Log::error('QR Code Generation Error', ['error' => $e->getMessage()]);
          $qrCode = null;
          $compliance = ['valid' => false, 'errors' => [$e->getMessage()]];
      }
      
      return view("customer-invoices.show", compact("invoice", "items", "payments", "qrCode", "compliance"));
  }

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

[2️⃣] تحديث resources/views/customer-invoices/show.blade.php
────────────────────────────────────────────────────────────────────────────────

  أضف هذا قبل @endsection (قبل نهاية الملف):
  
  <!-- قسم QR Code متوافق مع ZATCA -->
  @if($qrCode)
  <div class="row mt-4">
      <div class="col-md-12">
          <div class="card bg-light border-success">
              <div class="card-header bg-success text-white">
                  <h5 class="card-title mb-0">
                      <i class="fas fa-qrcode"></i>
                      ZATCA QR Code
                  </h5>
              </div>
              <div class="card-body text-center">
                  {!! $qrCode !!}
                  @if($compliance['valid'])
                      <div class="alert alert-success mt-3">
                          <i class="fas fa-check-circle"></i>
                          <strong>✅ ZATCA Compliant</strong>
                      </div>
                  @else
                      <div class="alert alert-warning mt-3">
                          <i class="fas fa-exclamation-triangle"></i>
                          <strong>Compliance Issues:</strong>
                          @foreach($compliance['errors'] ?? [] as $error)
                              <li>{{ $error }}</li>
                          @endforeach
                      </div>
                  @endif
              </div>
          </div>
      </div>
  </div>
  @endif

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

[3️⃣] تحديث .env
────────────────────────────────────────────────────────────────────────────────

  أضف أو عدّل:
  
  ZATCA_SANDBOX_MODE=true
  ZATCA_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
  ZATCA_CERTIFICATES_PATH=zatca/certificates

  إذا لم يكن لديك مفتاح:
  - اترك ZATCA_PRIVATE_KEY فارغاً
  - ضع الملف في: zatca/certificates/private_key.pem
  
  أو للاختبار (توليد مفتاح مؤقت):
    openssl genrsa -out zatca/certificates/private_key.pem 2048

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

✅ بعد الانتهاء: اختبر النتيجة
────────────────────────────────────────────────────────────────────────────────

1. افتح أي فاتورة: http://localhost:8000/customer-invoices/{id}
2. يجب أن ترى QR Code أسفل الفاتورة
3. يجب أن يظهر "✅ ZATCA Compliant" إذا كانت البيانات صحيحة

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

📁 الملفات المحدثة:
  ✅ app/Services/QRCodeGeneratorService.php (موجود)
  📝 app/Http/Controllers/CustomerInvoiceController.php (خطوة 1)
  📝 resources/views/customer-invoices/show.blade.php (خطوة 2)
  📝 .env (خطوة 3)

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

📖 للمزيد من التفاصيل: اقرأ ZATCA_QR_CODE_IMPLEMENTATION.md

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