# تعليمات إضافة QR للفواتير الضريبية والمستخلصات

## قبل الرفع

1. خذ نسخة احتياطية من ملفات النظام وقاعدة البيانات.
2. لا تستبدل ملف `.env` ولا مجلد `storage/uploads`.

## إعداد مفتاح روابط التحقق

أضف إلى `.env` مفتاحًا عشوائيًا طويلًا وثابتًا (64 حرفًا ست عشريًا مثلًا):

```env
DOCUMENT_QR_KEY=ضع_هنا_مفتاحا_عشوائيا_طويلا_خاصا_بالخادم
```

يجب الاحتفاظ بالقيمة نفسها بعد كل تحديث؛ تغييرها يبطل روابط التحقق المطبوعة سابقًا. يقوم معالج التثبيت الجديد بإنشائها تلقائيًا.

## التحديث والاختبار

1. ارفع محتويات حزمة التحديث فوق ملفات النسخة 1.30 الحالية.
2. افتح فاتورة ضريبية واضغط «طباعة»، ثم امسح QR وتأكد من ظهور حقول البائع والرقم الضريبي والتاريخ والإجمالي والضريبة.
3. افتح مستخلص عميل ومستخلص مقاول باطن من العقود واضغط زر الطباعة بجانب كل مستخلص.
4. امسح رمز المستخلص من هاتف خارج جلسة النظام وتأكد من فتح صفحة التحقق الصحيحة.
5. اختبر الطباعة والحفظ PDF وتأكد من وضوح الرمز.

## نطاق التوافق

- رمز الفاتورة يتضمن حقول ZATCA الأساسية الخمسة بصيغة TLV/Base64.
- لا تعني هذه الإضافة وحدها اكتمال الربط مع منصة فاتورة أو متطلبات المرحلة الثانية والتوقيع التشفيري والإرسال إلى ZATCA.
- فواتير الموردين الواردة لا يُنشأ لها رمز باسم شركة سواعد؛ يجب حفظ رمز المورد الأصلي عليها.