# ⚡ دليل التثبيت السريع - POS Professional

## 🎯 الخطوات (5 دقائق فقط!)

### 1️⃣ تحديث قاعدة البيانات
```sql
-- افتح phpMyAdmin
-- اختر قاعدة البيانات: theglobalwebs_systempro
-- اذهب لـ SQL
-- الصق محتوى ملف: modules/pos/database_upgrade.sql
-- اضغط "تنفيذ" (Go)
```

**ماذا سيحدث؟**
- ✅ إضافة 8 حقول جديدة لجدول `tblpos_branches`
- ✅ إضافة 5 حقول لجدول `tblpos_sales`
- ✅ إضافة 3 حقول لجدول `tblpos_sale_items`
- ✅ إنشاء جدول `tblpos_settings`
- ✅ إنشاء جدول `tblpos_inventory_log`

---

### 2️⃣ إعداد الفرع
1. اذهب إلى: **Admin Panel → POS → الفروع**
2. اضغط على أيقونة **⚙️ الإعدادات** بجانب أي فرع
3. املأ:
   - **المخزن**: اختر المخزن (مثال: المخزن الرئيسي)
   - فعّل: **✅ إنشاء فاتورة تلقائياً**
   - فعّل: **✅ تحديث المخزون تلقائياً**
   - فعّل: **✅ طباعة تلقائية** (اختياري)
4. **احفظ**

---

### 3️⃣ التجربة
1. اذهب إلى: **POS → الجلسات → فتح جلسة**
2. اختر كاشير
3. أدخل رصيد البداية (مثال: 1000)
4. **افتح الجلسة**
5. ستفتح **شاشة POS الاحترافية** 🎉

---

## 🚀 الواجهة الجديدة

### ما ستراه:
- **شريط علوي أزرق**: معلومات الجلسة + أزرار التحكم
- **يسار**: شبكة المنتجات مع صورها
- **يمين**: السلة التفاعلية
- **بحث**: في الأعلى + فلترة بالفئات
- **ألوان متدرجة**: تصميم تجاري حديث

### كيفية البيع:
1. **ابحث** أو **اضغط على منتج**
2. سيضاف للسلة مع صورته
3. **تحكم بالكمية**: + و -
4. اضغط **الدفع**
5. اختر طريقة الدفع
6. **إتمام البيع**
7. **تلقائياً**:
   - ✅ يفتح الفاتورة الحرارية
   - ✅ ينشئ فاتورة في النظام
   - ✅ يخصم من المخزون

---

## 🧾 الفاتورة الحرارية

### المميزات:
- 📏 مقاس: **80mm** (للطابعات الحرارية)
- 🏢 شعار الشركة + البيانات
- 📋 جدول المنتجات منسّق
- 💰 مجموع + ضريبة + إجمالي
- 📱 **QR Code** للتحقق
- 🖨️ **زر طباعة** + طباعة تلقائية

---

## ✅ التحقق من النجاح

### اختبر هذه:
1. **صور المنتجات تظهر؟** → نعم ✅
2. **الكميات المتاحة صحيحة؟** → نعم ✅
3. **بعد البيع، خُصمت الكمية؟** → نعم ✅
4. **تم إنشاء فاتورة؟** → نعم ✅
5. **الفاتورة فيها QR Code؟** → نعم ✅

---

## 🔧 استكشاف الأخطاء السريع

| المشكلة | الحل |
|---------|------|
| لا تظهر المنتجات | تأكد من وجود منتجات فعّالة في `tblitems` |
| الصور لا تظهر | ارفع صور للمنتجات في قسم Items |
| لا يتم خصم المخزون | فعّل "تحديث المخزون" في إعدادات الفرع |
| لا تُنشأ فاتورة | فعّل "إنشاء فاتورة" في إعدادات الفرع |
| خطأ في database_upgrade.sql | قد تكون الحقول موجودة، اتصل بي |

---

## 📌 ملاحظات مهمة

### الملفات المهمة:
```
modules/pos/
├── database_upgrade.sql ← نفّذه أولاً
├── controllers/Pos.php ← محدّث
├── models/Pos_model.php ← محدّث
├── views/screen/pos_professional.php ← الواجهة الجديدة
├── views/receipt/thermal.php ← الفاتورة الحرارية
├── views/branches/settings.php ← إعدادات الفروع
└── language/arabic/pos_lang.php ← الترجمات
```

### الملف القديم:
- `views/screen/pos.php` ← **لم يُحذف** (احتياطي)
- النظام يستخدم الآن: `pos_professional.php`

---

## 🎉 كل شيء جاهز!

الآن لديك:
- ✅ نظام POS احترافي مثل المحلات العالمية
- ✅ ربط كامل مع المخزون والفواتير
- ✅ فاتورة حرارية بـ QR Code
- ✅ تصميم حديث وسريع

**استمتع!** 🚀
