MAINHACK

Viewing / Editing File: INSTALLATION.md

# دليل التثبيت والإعداد
# Installation and Setup Guide

## متطلبات التشغيل

### المتطلبات الأساسية
- **خادم ويب:** Apache 2.4+ أو Nginx 1.18+
- **PHP:** الإصدار 7.4 أو أحدث (يُفضل PHP 8.0+)
- **MySQL:** الإصدار 5.7 أو أحدث (يُفضل MySQL 8.0+)
- **مساحة تخزين:** 50 ميجابايت على الأقل

### PHP Extensions المطلوبة
تأكد من تفعيل الإضافات التالية في ملف `php.ini`:
```
extension=pdo_mysql
extension=mysqli
extension=curl
extension=mbstring
extension=json
extension=openssl
```

---

## خطوات التثبيت

### الخطوة 1: تحميل الملفات

1. قم بتحميل جميع ملفات المشروع إلى مجلد الخادم:
   - **XAMPP:** `C:\xampp\htdocs\hesabat_arabia\`
   - **WAMP:** `C:\wamp64\www\hesabat_arabia\`
   - **Linux:** `/var/www/html/hesabat_arabia/`

2. تأكد من أن جميع المجلدات والملفات قابلة للقراءة من قبل خادم الويب

---

### الخطوة 2: إنشاء قاعدة البيانات

#### باستخدام phpMyAdmin:

1. افتح phpMyAdmin من المتصفح (عادةً `http://localhost/phpmyadmin`)
2. اضغط على **Import** (استيراد)
3. اختر ملف `database.sql` من مجلد المشروع
4. اضغط على **Go** لاستيراد قاعدة البيانات

#### باستخدام سطر الأوامر:

```bash
mysql -u root -p < database.sql
```

---

### الخطوة 3: تعديل إعدادات الاتصال

افتح ملف `config/database.php` وعدّل البيانات التالية:

```php
define('DB_HOST', 'localhost');        // عنوان السيرفر
define('DB_USER', 'root');             // اسم مستخدم MySQL
define('DB_PASS', '');                 // كلمة مرور MySQL
define('DB_NAME', 'hesabat_arabia');   // اسم قاعدة البيانات
```

**ملاحظة:** إذا كنت تستخدم استضافة مشتركة، استخدم البيانات المقدمة من شركة الاستضافة.

---

### الخطوة 4: تعديل الرابط الأساسي

افتح ملف `config/config.php` وعدّل الرابط الأساسي:

```php
define('BASE_URL', 'http://localhost/hesabat_arabia');
```

**أمثلة:**
- تطوير محلي: `http://localhost/hesabat_arabia`
- استضافة على الإنترنت: `https://yourdomain.com`
- دومين فرعي: `https://hesabat.yourdomain.com`

---

### الخطوة 5: ضبط الصلاحيات (Linux فقط)

```bash
cd /var/www/html/hesabat_arabia
chmod -R 755 .
chown -R www-data:www-data .
```

---

### الخطوة 6: التحقق من التثبيت

1. افتح المتصفح واذهب إلى:
   ```
   http://localhost/hesabat_arabia
   ```

2. يجب أن تظهر صفحة تسجيل الدخول

3. استخدم الحساب الافتراضي للدخول:
   - **رقم الهاتف:** `+201000000000`
   - **كلمة المرور:** `admin123`

⚠️ **مهم جداً:** قم بتغيير كلمة المرور فوراً بعد أول تسجيل دخول!

---

## الإعدادات الإضافية

### إعداد واتساب (اختياري)

لتفعيل إرسال رسائل واتساب التلقائية:

1. سجل دخول كمدير
2. اذهب إلى **الإعدادات** > **إعدادات واتساب**
3. أدخل:
   - **رابط WhatsApp API:** رابط خدمة واتساب API الخاصة بك
   - **API Token:** رمز المصادقة الخاص بالخدمة
4. احفظ الإعدادات

### خدمات واتساب API الموصى بها:
- Twilio WhatsApp API
- MessageBird
- Vonage (Nexmo)
- Any custom WhatsApp Business API

---

## استكشاف الأخطاء

### خطأ: "Connection failed"

**الحل:**
1. تأكد من تشغيل MySQL
2. تحقق من بيانات الاتصال في `config/database.php`
3. تأكد من إنشاء قاعدة البيانات

### خطأ: "Page not found" أو لا تظهر الأنماط

**الحل:**
1. تحقق من `BASE_URL` في `config/config.php`
2. تأكد من رفع مجلد `assets` بالكامل
3. تحقق من صلاحيات المجلدات

### خطأ: "Call to undefined function"

**الحل:**
- تأكد من تفعيل جميع PHP Extensions المطلوبة
- أعد تشغيل Apache/Nginx بعد تعديل `php.ini`

### واتساب لا يرسل الرسائل

**الحل:**
1. تحقق من تفعيل `curl` extension في PHP
2. تأكد من صحة رابط API ورمز Token
3. راجع ملف `logs/php_error.log` للأخطاء

---

## الأمان والحماية

### تغيير كلمة المرور الافتراضية

1. سجل دخول بالحساب الافتراضي
2. اذهب إلى **الإعدادات** > **إدارة المستخدمين**
3. عدّل بيانات المدير وغيّر كلمة المرور

### تفعيل HTTPS (موصى به للإنتاج)

1. احصل على شهادة SSL (يمكن استخدام Let's Encrypt مجاناً)
2. فعّل SSL في إعدادات Apache/Nginx
3. عدّل `BASE_URL` ليبدأ بـ `https://`

### النسخ الاحتياطي

**النسخ الاحتياطي لقاعدة البيانات:**
```bash
mysqldump -u root -p hesabat_arabia > backup_$(date +%Y%m%d).sql
```

**النسخ الاحتياطي للملفات:**
```bash
tar -czf backup_files_$(date +%Y%m%d).tar.gz /var/www/html/hesabat_arabia
```

**يُنصح بإجراء نسخة احتياطية:**
- يومياً لقاعدة البيانات
- أسبوعياً للملفات

---

## التحديثات والصيانة

### تحديث النظام

1. احتفظ بنسخة احتياطية كاملة
2. استبدل الملفات القديمة بالجديدة (عدا `config/`)
3. استورد أي ملفات SQL جديدة إن وُجدت
4. امسح الكاش:
```bash
rm -rf tmp/cache/*
```

### تحسين الأداء

**تفعيل OPcache في `php.ini`:**
```ini
opcache.enable=1
opcache.memory_consumption=128
opcache.max_accelerated_files=10000
```

**تحسين MySQL:**
```sql
ALTER TABLE invoices ADD INDEX idx_customer_created (customer_id, created_at);
ALTER TABLE payments ADD INDEX idx_customer_created (customer_id, created_at);
```

---

## الدعم والمساعدة

### سجل الأخطاء

عرض آخر 50 سطر من سجل الأخطاء:
```bash
tail -50 logs/php_error.log
```

### التحقق من حالة النظام

افتح: `http://yourdomain.com/health_check.php`
(قم بإنشاء هذا الملف إذا لزم الأمر)

---

## الأسئلة الشائعة

**س: هل يمكن استخدام PostgreSQL بدلاً من MySQL؟**
ج: لا، النظام مصمم خصيصاً لـ MySQL. يمكن تعديله لكن يحتاج تغييرات كبيرة.

**س: هل يدعم النظام عدة شركات؟**
ج: لا، هو مصمم لشركة واحدة. لدعم عدة شركات يحتاج تعديلات.

**س: كيف أضيف مستخدم جديد؟**
ج: من لوحة التحكم > الإعدادات > إدارة المستخدمين > إضافة مستخدم جديد

**س: هل يمكن تغيير اللغة للإنجليزية؟**
ج: النظام مصمم بالكامل للعربية. تغيير اللغة يحتاج تعديل جميع الملفات.

---

Cancel / Back

[ MAINHACK ]

Viewing / Editing File: INSTALLATION.md

Server Info

System Features

User Info