# تعليمات تحديث نظام سواعد إلى 1.30

## قبل التحديث

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

## إعدادات ملف البيئة

```env
OPENAI_API_KEY=ضع_المفتاح_على_الخادم_فقط
OPENAI_MODEL=gpt-5.6-terra
AI_ENABLED=true
```

لا ترسل المفتاح في المحادثات، ولا تضفه إلى GitHub أو JavaScript أو ملفات الحزمة.

## خطوات التحديث

1. ارفع محتويات `sawaed-erp-update-1.30.0.zip` فوق ملفات النظام الحالية.
2. سجل الدخول بحساب المدير العام وافتح `public/upgrade.php`.
3. اضغط «تنفيذ ترقية 1.30 الآن».
4. افتح `public/system-check.php` وتأكد من نجاح جداول المساعد ومفتاح OpenAI وHTTPS الصادر.
5. من إعدادات النظام اضبط الحد اليومي وطول الإجابة عند الحاجة.
6. افتح «مساعد سواعد الذكي» واختبر: «اشرح إنشاء أمر شراء»، ثم «لخص المشاريع النشطة».
7. اختبر بحساب محدود الصلاحيات للتأكد من رفض بيانات الأقسام غير المسموحة.
8. احذف `public/upgrade.php` و`public/system-check.php` بعد نجاح الفحص.

## ملاحظات الأمان

- المساعد للقراءة والتحليل فقط.
- لا يمكنه اعتماد طلب أو تعديل سجل أو تنفيذ دفعة أو قيد.
- تعرض بيانات النظام حسب الصلاحيات الحالية، وتُسجل الأسئلة والاستهلاك في سجل التدقيق.