# POS - نظام نقاط البيع المتكامل 🛒

## نظرة عامة

نظام POS متكامل مع إدارة الفروع، الكاشيرات، الجلسات، والمبيعات. مصمم ليكون سهل الاستخدام للكاشيرين مع حماية قوية ضد الدخول المتعدد.

## المميزات الرئيسية ✨

### 1. إدارة الفروع 🏢
- إضافة وتعديل وحذف الفروع
- تفعيل/تعطيل الفروع
- ربط الفروع بالمخازن (اختياري)
- معلومات كاملة: العنوان، الهاتف، البريد، المدينة

### 2. إدارة الكاشيرات 💻
- إضافة عدد غير محدود من الكاشيرات لكل فرع
- كل كاشير مرتبط بفرع واحد فقط
- تفعيل/تعطيل الكاشيرات
- لكل كاشير كود فريد ووصف

### 3. نظام الجلسات الذكي 🔒
**الميزة الأهم: منع الدخول المتعدد**
- ✅ المستخدم لا يستطيع فتح أكثر من جلسة واحدة في نفس الوقت
- ✅ الكاشير لا يمكن فتح جلسة عليه إذا كان مستخدم آخر يعمل عليه
- ✅ يجب إغلاق الجلسة الحالية قبل فتح جلسة جديدة
- رصيد افتتاح وإقفال مع حساب الفرق
- تتبع جميع المبيعات والحركات النقدية
- ملاحظات الفتح والإقفال

### 4. شاشة البيع (POS Screen) 🛒
**واجهة سهلة وسريعة للكاشير:**
- بحث سريع عن المنتجات
- إضافة منتجات للسلة بنقرة واحدة
- تعديل الكميات مباشرة
- حساب تلقائي للضريبة (15%)
- خيارات دفع متعددة: نقدي، بطاقة، مختلط
- حساب تلقائي للباقي
- طباعة الفاتورة

### 5. إدارة المبيعات 💰
- سجل كامل لجميع المبيعات
- تفاصيل كل عملية بيع
- ربط كل بيع بالجلسة والكاشير والفرع
- أرقام تسلسلية تلقائية
- طباعة الفواتير

### 6. التقارير 📊
- تقارير يومية للمبيعات
- تقارير أداء الكاشيرين
- تقارير أداء الفروع
- إحصائيات لوحة التحكم

## الجداول المستخدمة 🗄️

1. **pos_branches** - الفروع
2. **pos_registers** - الكاشيرات
3. **pos_sessions** - الجلسات (مع نظام الحماية)
4. **pos_sales** - المبيعات
5. **pos_sale_items** - تفاصيل المبيعات
6. **pos_cash_movements** - الحركات النقدية

## التثبيت 📥

1. رفع مجلد `pos` إلى `modules/`
2. تفعيل الموديول من لوحة التحكم
3. سيتم إنشاء الجداول تلقائياً
4. إضافة الصلاحيات للمستخدمين

## الاستخدام 🎯

### للمدير:
1. إضافة الفروع من `POS > الفروع`
2. إضافة الكاشيرات لكل فرع من `POS > الكاشيرات`
3. منح الصلاحيات للكاشيرين

### للكاشير:
1. فتح جلسة من `POS > فتح جلسة`
   - اختيار الكاشير
   - إدخال رصيد الافتتاح
2. الدخول على `POS > شاشة البيع`
3. إضافة المنتجات للسلة
4. إتمام عملية البيع
5. إغلاق الجلسة عند نهاية الوردية

## نظام الحماية 🔐

### منع الدخول المتعدد:
```php
// في Model
public function user_has_active_session($user_id)
{
    $this->db->where('user_id', $user_id);
    $this->db->where('status', 'open');
    $session = $this->db->get(db_prefix() . 'pos_sessions')->row();
    return !empty($session) ? $session : false;
}
```

### منع فتح جلسة على كاشير مستخدم:
```php
// في Model
public function get_active_session($register_id)
{
    $this->db->where('register_id', $register_id);
    $this->db->where('status', 'open');
    return $this->db->get(db_prefix() . 'pos_sessions')->row();
}
```

## اللغات المدعومة 🌍

- ✅ العربية (كاملة)
- ✅ الإنجليزية (كاملة)
- 160+ نص مترجم بالكامل

## الملفات الرئيسية 📁

```
modules/pos/
├── pos.php                    # الملف الرئيسي
├── install.php                # التثبيت وقاعدة البيانات
├── controllers/
│   └── Pos.php               # Controller الرئيسي
├── models/
│   └── Pos_model.php         # Model مع جميع العمليات
├── views/
│   ├── dashboard.php         # لوحة التحكم
│   ├── branches/             # صفحات الفروع
│   ├── registers/            # صفحات الكاشيرات
│   ├── sessions/             # صفحات الجلسات
│   ├── sales/                # صفحات المبيعات
│   └── screen/
│       └── pos.php          # شاشة البيع الرئيسية ⭐
├── language/
│   ├── arabic/
│   │   └── pos_lang.php     # اللغة العربية
│   └── english/
│       └── pos_lang.php     # اللغة الإنجليزية
└── assets/
    ├── css/
    │   └── pos.css          # الأنماط
    └── js/
        └── pos.js           # JavaScript
```

## الصلاحيات 🔑

- `view` - عرض
- `create` - إنشاء
- `edit` - تعديل
- `delete` - حذف

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

للاستفسارات أو المشاكل، يرجى التواصل مع فريق التطوير.

## الإصدار 📌

**Version:** 1.0.0
**Date:** November 2025
**Author:** Global Webs

---

## ملاحظات مهمة ⚠️

1. **نظام الجلسات محمي بالكامل** - لا يمكن للمستخدم فتح جلستين
2. **الكاشير يُقفل** عند فتح جلسة عليه حتى يتم إغلاقها
3. **أرقام تسلسلية تلقائية** لكل من الجلسات والمبيعات
4. **حساب تلقائي** للضريبة والإجماليات
5. **تكامل جاهز** مع موديول المخزون

## خطط مستقبلية 🚀

- [ ] تكامل كامل مع الفواتير
- [ ] تقارير متقدمة مع رسوم بيانية
- [ ] دعم الخصومات والعروض
- [ ] طباعة فواتير حرارية
- [ ] تطبيق موبايل للكاشير

---

**🎉 النظام جاهز للاستخدام الفوري!**
