# 🔧 دليل حل المشاكل - CryptoPulse Analytics

## المشاكل الشائعة وحلولها

### 🚫 خطأ 403 Forbidden

**السبب:** مشكلة في صلاحيات الملفات أو إعدادات .htaccess

**الحل:**
1. تأكد من رفع جميع الملفات إلى `public_html`
2. تأكد من وجود ملف `index.php` في المجلد الجذر
3. تحقق من صلاحيات الملفات (755 للمجلدات، 644 للملفات)

```bash
# في Hostinger File Manager، اضبط الصلاحيات:
# المجلدات: 755
# الملفات: 644
```

### 🗄️ مشاكل قاعدة البيانات

**الأعراض:** خطأ في الاتصال بقاعدة البيانات

**الحل:**
1. تحقق من بيانات قاعدة البيانات في `.env`:
```env
DB_HOST=localhost
DB_DATABASE=u984847094_CryptoPulse
DB_USERNAME=u984847094_CryptoPulse
DB_PASSWORD=SeiT0e746
```

2. تأكد من إنشاء قاعدة البيانات في phpMyAdmin
3. استورد ملف `cryptopulse_database.sql`

### 🔑 مشاكل مفاتيح API

**الأعراض:** البيانات لا تظهر أو أخطاء API

**الحل:**
1. احصل على مفاتيح مجانية:
   - **Clerk**: https://clerk.com (للمصادقة)
   - **CoinGecko**: https://coingecko.com/api (لبيانات العملات)
   - **NewsAPI**: https://newsapi.org (للأخبار)

2. أضف المفاتيح إلى ملف `.env`

### 📁 مشاكل الملفات المفقودة

**الأعراض:** خطأ "File not found" أو صفحات فارغة

**الحل:**
1. تأكد من رفع جميع المجلدات:
   - `src/`
   - `public/`
   - `config/`
   - `storage/`

2. تحقق من وجود الملفات الأساسية:
   - `index.php`
   - `autoload.php`
   - `.env`
   - `.htaccess`

### 🔄 إعادة تشغيل الإعداد

إذا واجهت مشاكل، يمكنك إعادة تشغيل الإعداد:

1. احذف جميع الملفات من `public_html`
2. ارفع ملف `cryptopulse_deployment.zip` مرة أخرى
3. استخرج الملفات
4. اذهب إلى: `https://cryptopulse.aizetecc.com/setup.php`

### 📞 الحصول على المساعدة

إذا استمرت المشاكل:

1. تحقق من سجلات الأخطاء في Hostinger
2. تأكد من أن PHP 7.4+ مفعل
3. تحقق من إعدادات MySQL
4. راجع ملف `DEPLOYMENT_README.md` للتفاصيل الكاملة

### ✅ اختبار سريع

للتأكد من أن كل شيء يعمل:

1. اذهب إلى: `https://cryptopulse.aizetecc.com`
2. يجب أن ترى صفحة ترحيب
3. اذهب إلى: `https://cryptopulse.aizetecc.com/setup.php`
4. يجب أن ترى صفحة الإعداد

### 🔒 الأمان

بعد الانتهاء من الإعداد:
- احذف ملف `setup.php`
- تأكد من أن ملف `.env` محمي
- فعّل HTTPS في Hostinger