# دليل التثبيت - موديول POS 📦

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

### مشكلة HTTP 500 Error

**السبب:** استخدام `db_prefix()` قبل تحميل CodeIgniter

**الحل:** ✅ تم إصلاح ملف `install.php` باستخدام `$CI->db->dbprefix` بدلاً من `db_prefix()`

---

## خطوات التثبيت الصحيحة 📋

### 1. رفع الملفات
```
/modules/pos/
├── pos.php
├── install.php
├── controllers/
├── models/
├── views/
├── language/
└── assets/
```

### 2. التأكد من الصلاحيات
```bash
chmod -R 755 modules/pos
chown -R www-data:www-data modules/pos
```

### 3. تفعيل الموديول
- اذهب إلى `الإعدادات > الموديولات`
- ابحث عن "POS - Point of Sale"
- اضغط على زر التفعيل

### 4. التحقق من قاعدة البيانات
بعد التفعيل، تأكد من إنشاء الجداول التالية:
```sql
SELECT table_name 
FROM information_schema.tables 
WHERE table_schema = 'your_database' 
AND table_name LIKE '%pos_%';
```

يجب أن ترى:
- `tblpos_branches`
- `tblpos_registers`
- `tblpos_sessions`
- `tblpos_sales`
- `tblpos_sale_items`
- `tblpos_cash_movements`

---

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

### إذا ظهر خطأ 500:

1. **تحقق من ملف error_log:**
```bash
tail -f application/logs/error_log.php
# أو
tail -f /home/username/public_html/system/application/logs/error_log.php
```

2. **تحقق من PHP Version:**
```bash
php -v
```
يجب أن يكون PHP 7.4 أو أحدث

3. **تحقق من extensions المطلوبة:**
```bash
php -m | grep -E 'mysqli|pdo|mbstring'
```

### إذا لم تظهر القوائم:

1. **نظف الكاش:**
```bash
rm -rf application/cache/*
```

2. **تحقق من الصلاحيات:**
افتح `الإعدادات > الصلاحيات > دور المستخدم`
تأكد من تفعيل صلاحيات POS

### إذا لم تُنشأ الجداول:

قم بتشغيل SQL يدوياً:
```sql
-- راجع ملف install.php ونفذ الأوامر يدوياً
```

---

## التحقق من نجاح التثبيت ✅

1. ✅ القائمة الرئيسية تحتوي على "POS"
2. ✅ يمكن الوصول إلى `/admin/pos/dashboard`
3. ✅ جداول قاعدة البيانات موجودة
4. ✅ لا توجد أخطاء في error_log

---

## الخطوات التالية 🚀

1. إضافة فرع من `POS > الفروع`
2. إضافة كاشير من `POS > الكاشيرات`
3. فتح جلسة من `POS > فتح جلسة`
4. البدء بالبيع من `POS > شاشة البيع`

---

## الدعم الفني 💬

إذا استمرت المشاكل:
1. تحقق من error_log
2. تأكد من صلاحيات الملفات
3. تأكد من إصدار PHP
4. تأكد من تفعيل mysqli extension

---

**ملاحظة:** تم إصلاح جميع المشاكل المعروفة في هذا الإصدار ✅
