# ترقية سواعد المتكامل إلى 1.8

## قبل الترقية

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

## تنفيذ الترقية

1. افتح `/public/upgrade.php` بحساب المدير العام واضغط **تنفيذ الترقية الآن** مرة واحدة.
2. افتح `/public/system-check.php` وتأكد أن عدد حالات الفشل يساوي صفرًا.
3. أنشئ فترة مالية واختبر قيدًا متوازنًا ثم ترحيله وعكسه.
4. لا تُقفل الفترة قبل معالجة جميع القيود المسودة داخلها.
5. احتسب إقرار VAT، وأضف أي تعديلات موثقة، ثم اعتمده بمستخدم مختلف عن مُعدّه.
6. سجل مرجع تقديم الإقرار بعد تقديمه فعليًا لدى الهيئة.
7. اختبر الاستقطاع وفحص جاهزية فواتير العملاء محليًا.
8. بعد نجاح الفحص احذف `public/upgrade.php` و`public/system-check.php` من الخادم.

## تنبيه مهم

فحص ZATCA في 1.8 فحص محلي للبيانات والحسابات والبصمة فقط. لا يرسل الفواتير إلى بيئة الهيئة الإنتاجية ولا يُعد بديلًا عن الربط المعتمد وشهادات التوقيع الخاصة بالمنشأة.