# 📚 دليل المستخدم الشامل - نظام Adly ERP (Comprehensive User Guide)

## 🎉 مرحباً بك في نظام Adly ERP الحديث!

**نظام إدارة موارد المؤسسات (ERP) متكامل** تم تطويره بأحدث تقنيات Laravel 12 و Filament v4 لتوفير تجربة استخدام احترافية، سريعة، وآمنة.

### 🌟 ما هو نظام Adly؟

نظام Adly هو حل ERP شامل يغطي جميع جوانب إدارة الأعمال التجارية:
- 📊 **إدارة المخزون الذكية** مع تتبع الصلاحيات والدفعات
- 💰 **المحاسبة المزدوجة** (Double Entry Accounting) - قيد التطوير
- 📱 **التكامل مع WhatsApp** لإرسال الرسائل والكشوفات
- 🏢 **Multi-Tenancy** - دعم متعدد المؤسسات
- 📈 **التقارير المتقدمة** مع تصدير Excel و PDF
- 🔒 **الصلاحيات والأدوار** المتقدمة
- 🌍 **متعدد اللغات** (عربي، إنجليزي، فرنسي)

### 🎯 الفئات المستهدفة:

| المستخدم | الوصف | الميزات المتاحة |
|---------|-------|-----------------|
| 👤 **المدير العام** | صاحب الشركة / المدير التنفيذي | جميع الصلاحيات، التقارير الإدارية، لوحة التحكم |
| 💼 **المحاسب** | مسؤول الحسابات والمالية | الفواتير، المدفوعات، التقارير المالية |
| 📦 **مدير المخزون** | مسؤول المشتريات والمخازن | المخزون، المشتريات، حركة الأصناف |
| 🛒 **موظف المبيعات** | مسؤول البيع وخدمة العملاء | المبيعات، العملاء، كشوف الحسابات |
| 👨‍💻 **مسؤول النظام** | إدارة المستخدمين والإعدادات | المستخدمين، الأدوار، النسخ الاحتياطي |

---

## � الميزات الأساسية للنظام

### 📊 إدارة المبيعات (Sales Management)
- ✅ إنشاء فواتير مبيعات احترافية
- ✅ دعم الخصومات (نسبة مئوية أو قيمة ثابتة)
- ✅ حساب الضرائب تلقائياً
- ✅ مرتجعات المبيعات الكاملة
- ✅ متابعة حالة الدفع (مدفوع / جزئي / غير مدفوع)
- ✅ طباعة الفواتير بتصميم احترافي
- ✅ إرسال الفواتير عبر WhatsApp

### 🛒 إدارة المشتريات (Purchases Management)
- ✅ تسجيل فواتير المشتريات
- ✅ ربط المشتريات بالموردين
- ✅ مرتجعات المشتريات
- ✅ متابعة السداد للموردين
- ✅ تحديث المخزون تلقائياً

### 👥 إدارة العملاء والموردين
- ✅ بطاقة كاملة لكل عميل (الاسم، الهاتف، العنوان، البريد)
- ✅ متابعة الرصيد الحالي لكل عميل
- ✅ حد ائتمان قابل للتخصيص
- ✅ كشف حساب تفصيلي
- ✅ إرسال كشوف الحساب عبر WhatsApp
- ✅ سجل كامل بجميع التعاملات
- ✅ نفس الميزات للموردين

### 📦 إدارة المخزون المتقدمة
- ✅ تتبع الأصناف مع الوحدات المتعددة
- ✅ **نظام تتبع الصلاحيات** (Expiry Date Tracking)
- ✅ **FEFO (First Expire First Out)** - بيع الأقدم صلاحية أولاً
- ✅ الأرصدة الافتتاحية
- ✅ حركة المخزون التلقائية
- ✅ تقارير حركة الأصناف
- ✅ تقييم المخزون
- ✅ تنبيهات نقص المخزون

### 💰 إدارة المدفوعات
- ✅ سندات قبض للعملاء (Receipt Vouchers)
- ✅ سندات صرف للموردين (Payment Vouchers)
- ✅ أرقام تلقائية للسندات (CPR-2026-XXXXX)
- ✅ ربط المدفوعات بالفواتير
- ✅ إدارة الخزائن المتعددة
- ✅ تقارير حركة الخزائن

### 📊 التقارير الشاملة (13+ تقرير)

#### تقارير العملاء والموردين:
1. **كشف حساب عميل** - تفصيلي مع الرصيد الافتتاحي والختامي
2. **كشف حساب جميع العملاء** - نظرة شاملة
3. **كشف حساب مورد** - متابعة المستحقات
4. **كشف حساب جميع الموردين**

#### تقارير المخزون:
5. **حركة صنف** - تتبع دقيق لكل منتج
6. **حركة جميع الأصناف** - نظرة عامة على المخزون
7. **تقييم المخزون** - القيمة الإجمالية
8. **تقرير دفعات الصلاحية** - متابعة المنتجات القريبة من الانتهاء

#### تقارير الخزائن:
9. **حركة خزينة** - تفصيلي بكل العمليات
10. **جميع الخزائن** - مقارنة الأرصدة

#### التقارير المالية:
11. **تحليل المصروفات** - تصنيف وتحليل
12. **تحليل الإيرادات** - مصادر الدخل
13. **تقرير الأرباح** - صافي الربح والخسارة

**جميع التقارير تدعم:**
- 📥 تصدير Excel
- 📄 تصدير PDF
- 🖨️ الطباعة المباشرة
- 🎨 تنسيق احترافي يدعم العربية

### 📱 التكامل مع WhatsApp

#### النظام الأول: Twilio (احترافي مدفوع)
- ✅ إرسال رسائل نصية للعملاء
- ✅ إرسال كشوف حسابات PDF
- ✅ موثوقية عالية
- ✅ دعم فني 24/7

#### النظام الثاني: WhatsApp Gateway (مجاني - رقمك الشخصي)
- ✅ استخدام رقمك الشخصي مجاناً
- ✅ ربط عبر QR Code فقط
- ✅ إرسال رسائل نصية وملفات
- ✅ **رسائل سريعة** (Quick Messages) بدون نافذة
- ✅ قوالب رسائل قابلة للتخصيص
- ✅ متغيرات ذكية ({name}, {balance}, {credit_limit})

#### أنواع الرسائل السريعة:
- 🎉 **رسالة ترحيب** - للعملاء الجدد
- 📢 **رسالة تذكير بالسداد** - للأرصدة المستحقة
- 🙏 **رسالة شكر** - بعد الدفع
- 🎁 **رسالة عرض** - للترويج
- 📞 **رسالة متابعة** - للتواصل

### 📈 لوحة التحكم التحليلية (Analytics Dashboard)

#### ويدجت الإحصائيات (Stats Widgets):
- 💰 **إحصائيات الإيرادات** - إجمالي المبيعات، عدد العملاء، الموردين
- 💳 **إحصائيات المدفوعات** - المدفوع، المتبقي، الفواتير
- 📦 **إحصائيات المخزون** - عدد الأصناف، نقص المخزون، القيمة

#### الرسوم البيانية (Charts):
- 📊 **مخطط المبيعات** - اتجاه المبيعات لآخر 12 شهر
- 📈 **مخطط المشتريات** - تحليل المشتريات الشهرية

### 🔒 نظام الصلاحيات المتقدم
- ✅ أدوار مخصصة لكل مستخدم (Roles)
- ✅ صلاحيات دقيقة (Permissions) على مستوى الموارد
- ✅ Shield Plugin - إدارة احترافية للصلاحيات
- ✅ Super Admin - صلاحيات كاملة
- ✅ تسجيل جميع الأنشطة (Activity Log)

### 🏢 Multi-Tenancy (متعدد المؤسسات)
- ✅ عزل كامل للبيانات بين المؤسسات
- ✅ نطاقات مخصصة لكل مؤسسة
- ✅ نظام اشتراكات مدمج (Subscription Plans)
- ✅ حدود استخدام قابلة للتخصيص
- ✅ علامة تجارية مخصصة (Custom Branding)
- ✅ تبديل سهل بين المؤسسات

### 🌍 الدعم متعدد اللغات
- 🇸🇦 **العربية** - الدعم الكامل مع RTL
- 🇬🇧 **الإنجليزية** - واجهة احترافية
- 🇫🇷 **الفرنسية** - ترجمة شاملة
- ✅ تبديل اللغة بضغطة واحدة
- ✅ جميع الشاشات والتقارير مترجمة

---

## �📑 فهرس الملفات التوثيقية

## 📑 فهرس الملفات التوثيقية

### 📘 أدلة البدء السريع

### 1️⃣ **[QUICK_START.md](QUICK_START.md)** - البدء السريع ⭐ (ابدأ من هنا)
**الوصف:** دليل سريع لتقارير الحسابات ونظام صلاحيات المنتجات
- ✅ كيفية الوصول لكشوف الحسابات
- ✅ شرح سريع لنظام FEFO
- ✅ خطوات البدء الأولى (5 دقائق)
- ✅ أسئلة شائعة وحلولها
- ⏱️ **وقت القراءة:** 15 دقيقة

### 2️⃣ **[README.md](README.md)** - نظرة عامة على المشروع
**الوصف:** نظرة عامة شاملة على النظام والميزات المتاحة
- ✅ الميزات الرئيسية للنظام
- ✅ معلومات التثبيت والإعداد
- ✅ روابط سريعة لجميع الملفات
- ⏱️ **وقت القراءة:** 10 دقائق

---

### 📗 أدلة المخزون والصلاحيات

### 3️⃣ **[EXPIRY_TRACKING_GUIDE.md](EXPIRY_TRACKING_GUIDE.md)** - دليل نظام الصلاحيات الكامل
**الوصف:** شرح شامل وتفصيلي لكل جوانب نظام تتبع الصلاحيات
- ✅ تفعيل الصلاحية على المنتجات
- ✅ شرح مفصّل لـ FEFO مع أمثلة عملية
- ✅ استخدام جميع أنواع الفواتير
- ✅ قراءة وتفسير تقرير الصلاحيات
- ✅ حالات واقعية وكيفية التعامل معها
- ✅ أفضل الممارسات والنصائح
- ⏱️ **وقت القراءة:** 45 دقيقة

### 4️⃣ **[EXPIRY_SYSTEM_UPDATES.md](EXPIRY_SYSTEM_UPDATES.md)** - التحديثات التقنية
**الوصف:** ملخص تقني لكل التحسينات والتغييرات في نظام الصلاحيات
- ✅ قائمة كاملة بالمشاكل التي تم حلها
- ✅ الميزات الجديدة بالتفصيل
- ✅ التغييرات في قاعدة البيانات والنماذج
- ✅ التحسينات على الأداء والأمان
- ✅ ملاحظات مهمة وتحذيرات
- ⏱️ **وقت القراءة:** 30 دقيقة (للمطورين)

---

### 📙 أدلة التقارير

### 5️⃣ **[REPORTS_IMPLEMENTATION.md](REPORTS_IMPLEMENTATION.md)** - شرح التقارير المتقدمة
**الوصف:** تفاصيل شاملة عن تقارير النظام وكيفية استخدامها
- ✅ جميع التقارير المتاحة (13+ تقرير)
- ✅ كيفية الوصول لكل تقرير
- ✅ شرح الفلاتر والخيارات
- ✅ كيفية تصدير البيانات (Excel, PDF)
- ⏱️ **وقت القراءة:** 20 دقيقة

### 6️⃣ **[REPORTS_SETUP.md](REPORTS_SETUP.md)** - إعداد التقارير
**الوصف:** دليل إعداد وتخصيص التقارير
- ✅ كشوف حسابات العملاء والموردين
- ✅ التقارير المالية والمخزنية
- ✅ الألوان والتنسيقات
- ⏱️ **وقت القراءة:** 15 دقيقة

### 7️⃣ **[EXPORT_SYSTEM_COMPLETE.md](EXPORT_SYSTEM_COMPLETE.md)** - نظام التصدير
**الوصف:** شرح كامل لنظام تصدير التقارير
- ✅ تصدير Excel بتنسيق احترافي
- ✅ تصدير PDF مع دعم العربية
- ✅ الطباعة المباشرة
- ✅ أمثلة عملية لكل تقرير
- ⏱️ **وقت القراءة:** 25 دقيقة

### 8️⃣ **[ITEM_MOVEMENT_REPORT.md](ITEM_MOVEMENT_REPORT.md)** - تقرير حركة الصنف
**الوصف:** دليل تفصيلي لتقرير حركة الأصناف
- ✅ فهم الرصيد الافتتاحي والختامي
- ✅ تتبع الوارد والصادر
- ✅ الملخص الإحصائي
- ⏱️ **وقت القراءة:** 10 دقائق

### 9️⃣ **[CASHBOX_MOVEMENT_REPORT.md](CASHBOX_MOVEMENT_REPORT.md)** - تقرير حركة الخزينة
**الوصف:** دليل تفصيلي لتقرير حركة الخزائن
- ✅ الإيرادات والمصروفات
- ✅ الرصيد الجاري
- ✅ الملخص حسب نوع العملية
- ⏱️ **وقت القراءة:** 10 دقائق

---

### 📕 أدلة WhatsApp

### 🔟 **[WHATSAPP_INTEGRATION_GUIDE.md](WHATSAPP_INTEGRATION_GUIDE.md)** - تكامل Twilio
**الوصف:** دليل كامل لإعداد واستخدام Twilio WhatsApp
- ✅ التسجيل في Twilio
- ✅ الإعدادات والتكوين
- ✅ إرسال الرسائل والملفات
- ✅ استكشاف الأخطاء
- ⏱️ **وقت القراءة:** 30 دقيقة

### 1️⃣1️⃣ **[WHATSAPP_GATEWAY_GUIDE.md](WHATSAPP_GATEWAY_GUIDE.md)** - WhatsApp Gateway (رقمك الشخصي)
**الوصف:** دليل شامل لاستخدام رقمك الشخصي لإرسال رسائل WhatsApp
- ✅ تثبيت Evolution API / WAHA / WPPConnect
- ✅ ربط الهاتف عبر QR Code
- ✅ إرسال الرسائل والملفات
- ✅ الرسائل السريعة (Quick Messages)
- ⏱️ **وقت القراءة:** 35 دقيقة

### 1️⃣2️⃣ **[WHATSAPP_QUICK_MESSAGES_GUIDE.md](WHATSAPP_QUICK_MESSAGES_GUIDE.md)** - الرسائل السريعة
**الوصف:** دليل استخدام نظام الرسائل السريعة
- ✅ إرسال رسائل بضغطة واحدة
- ✅ قوالب الرسائل القابلة للتخصيص
- ✅ المتغيرات الذكية
- ✅ صفحة الإعدادات
- ⏱️ **وقت القراءة:** 20 دقيقة

### 1️⃣3️⃣ **[WHATSAPP_QUICKSTART.md](WHATSAPP_QUICKSTART.md)** - بدء سريع WhatsApp
**الوصف:** دليل سريع للبدء مع WhatsApp خلال 5 دقائق
- ✅ أسرع طريقة للتشغيل
- ✅ الإعدادات الأساسية فقط
- ⏱️ **وقت القراءة:** 5 دقائق

### 1️⃣4️⃣ **[WHATSAPP_COMPARISON.md](WHATSAPP_COMPARISON.md)** - المقارنة بين الأنظمة
**الوصف:** مقارنة شاملة بين Twilio و Gateway
- ✅ الميزات والتكلفة
- ✅ متى تستخدم كل نظام
- ✅ الإيجابيات والسلبيات
- ⏱️ **وقت القراءة:** 10 دقائق

---

### 📓 أدلة المحاسبة (قيد التطوير)

### 1️⃣5️⃣ **[DOUBLE_ENTRY_ACCOUNTING_PLAN.md](DOUBLE_ENTRY_ACCOUNTING_PLAN.md)** - خطة المحاسبة المزدوجة
**الوصف:** خطة تفصيلية لتطبيق نظام المحاسبة المزدوجة
- ✅ شجرة الحسابات متعددة المستويات
- ✅ القيود اليومية (يدوية وتلقائية)
- ✅ التقارير المالية (ميزان المراجعة، قائمة الدخل، الميزانية)
- ✅ ربط الفواتير بالقيود المحاسبية
- ⏱️ **وقت القراءة:** 60 دقيقة

### 1️⃣6️⃣ **[DOUBLE_ENTRY_IMPLEMENTATION.md](DOUBLE_ENTRY_IMPLEMENTATION.md)** - تنفيذ المحاسبة
**الوصف:** خطوات التنفيذ العملية للمحاسبة المزدوجة
- ✅ الجداول والنماذج المطلوبة
- ✅ الخدمات والمراقبات
- ✅ واجهات Filament
- ⏱️ **وقت القراءة:** 45 دقيقة

### 1️⃣7️⃣ **[DOUBLE_ENTRY_PRACTICAL_EXAMPLE.md](DOUBLE_ENTRY_PRACTICAL_EXAMPLE.md)** - أمثلة عملية
**الوصف:** سيناريوهات واقعية للمحاسبة المزدوجة
- ✅ أمثلة شاملة لجميع أنواع القيود
- ✅ حالات دراسية كاملة
- ⏱️ **وقت القراءة:** 40 دقيقة

### 1️⃣8️⃣ **[JOURNAL_MAPPINGS_GUIDE.md](JOURNAL_MAPPINGS_GUIDE.md)** - دليل ربط القيود
**الوصف:** كيفية ربط العمليات بالحسابات المحاسبية
- ✅ إعدادات الربط
- ✅ القيود التلقائية
- ⏱️ **وقت القراءة:** 25 دقيقة

---

### 📔 أدلة Multi-Tenancy

### 1️⃣9️⃣ **[MULTI_TENANCY_COMPLETE_GUIDE.md](MULTI_TENANCY_COMPLETE_GUIDE.md)** - دليل Multi-Tenancy الشامل
**الوصف:** دليل كامل لنظام تعدد المؤسسات
- ✅ البنية الأساسية للنظام
- ✅ نظام الاشتراكات والخطط
- ✅ العلامة التجارية المخصصة
- ✅ حدود الاستخدام
- ✅ النطاقات المخصصة
- ⏱️ **وقت القراءة:** 90 دقيقة

### 2️⃣0️⃣ **[TENANT_ROLES_IMPLEMENTATION.md](TENANT_ROLES_IMPLEMENTATION.md)** - أدوار المؤسسات
**الوصف:** نظام الأدوار على مستوى المؤسسات
- ✅ الصلاحيات حسب المؤسسة
- ✅ Super Admin عبر المؤسسات
- ⏱️ **وقت القراءة:** 20 دقيقة

---

### 📖 أدلة إضافية

### 2️⃣1️⃣ **[PROJECT_COMPLETION.md](PROJECT_COMPLETION.md)** - ملخص المشروع
**الوصف:** ملخص شامل لجميع مراحل تطوير النظام
- ✅ Phase 1: إدارة المرتجعات
- ✅ Phase 2: نظام المدفوعات
- ✅ Phase 3: لوحة التحكم
- ✅ Phase 4: التقارير الاحترافية
- ⏱️ **وقت القراءة:** 30 دقيقة

### 2️⃣2️⃣ **[IMPLEMENTATION_CHECKLIST.md](IMPLEMENTATION_CHECKLIST.md)** - قائمة التحقق
**الوصف:** قائمة شاملة بجميع المكونات المنفذة
- ✅ الملفات المنشأة
- ✅ الميزات المكتملة
- ✅ التحقق من الجودة
- ⏱️ **وقت القراءة:** 15 دقيقة

### 2️⃣3️⃣ **[TRANSLATION_AUDIT_REPORT.md](TRANSLATION_AUDIT_REPORT.md)** - تقرير الترجمات
**الوصف:** مراجعة شاملة لجميع الترجمات
- ✅ ملفات الترجمة المكتملة
- ✅ التغطية اللغوية
- ⏱️ **وقت القراءة:** 10 دقائق

### 2️⃣4️⃣ **[PRODUCTION_CHECKLIST.md](PRODUCTION_CHECKLIST.md)** - قائمة الإنتاج
**الوصف:** قائمة التحقق قبل نشر النظام
- ✅ الإعدادات الأمنية
- ✅ تحسين الأداء
- ✅ النسخ الاحتياطي
- ⏱️ **وقت القراءة:** 20 دقيقة

### 2️⃣5️⃣ **[SHORTCUTS.md](SHORTCUTS.md)** - الاختصارات
**الوصف:** اختصارات لوحة المفاتيح والروابط السريعة
- ✅ اختصارات النظام
- ✅ نصائح الإنتاجية
- ⏱️ **وقت القراءة:** 5 دقائق

---

## 🎯 أي ملف يجب أن أقرأ؟

### 👤 للمستخدم العادي:
```
1. ابدأ بـ: QUICK_START.md (5-15 دقيقة)
   ↓
2. إذا أردت معرفة أكثر: EXPIRY_TRACKING_GUIDE.md (45 دقيقة)
   ↓
3. للتقارير المتقدمة: REPORTS_IMPLEMENTATION.md (20 دقيقة)
```

### 👨‍💻 للمطور:
```
1. ابدأ بـ: EXPIRY_SYSTEM_UPDATES.md (30 دقيقة)
   ↓
2. للتفاصيل الكاملة: EXPIRY_TRACKING_GUIDE.md (45 دقيقة)
   ↓
3. للقاعدة البيانات: README.md (10 دقائق)
```

### 👨‍⚙️ لمسؤول النظام:
```
1. ابدأ بـ: README.md (10 دقائق)
   ↓
2. للتقارير: REPORTS_IMPLEMENTATION.md (20 دقيقة)
   ↓
3. للتحديثات: EXPIRY_SYSTEM_UPDATES.md (30 دقيقة)
```

---

## �️ هيكل قوائم النظام (Navigation Structure)

يتم تنظيم النظام في مجموعات منطقية لسهولة الوصول:

### 📊 لوحة التحكم (Dashboard)
- **الوصول:** الصفحة الرئيسية
- **المحتوى:**
  - 💰 إحصائيات الإيرادات (إجمالي المبيعات، العملاء، الموردين)
  - 💳 إحصائيات المدفوعات (الفواتير المدفوعة، غير المدفوعة)
  - 📦 إحصائيات المخزون (عدد الأصناف، نقص المخزون، القيمة)
  - 📈 مخطط المبيعات (آخر 12 شهر)
  - 📊 مخطط المشتريات (آخر 12 شهر)

### 📁 البيانات الأساسية (Master Data)
- 🏪 **المنتجات** (Products) - إدارة الأصناف والوحدات
- 🏷️ **الفئات** (Categories) - تصنيف المنتجات
- 👥 **العملاء** (Customers) - بطاقات العملاء
- 🏢 **الموردون** (Suppliers) - بطاقات الموردين
- 🏭 **المخازن** (Warehouses) - إدارة المخازن
- 📏 **الوحدات** (Units) - وحدات القياس
- 💰 **الخزائن** (Cashboxes) - خزائن المال
- 🌾 **الحسابات الفرعيه** (Farms) - إدارة الحسابات الفرعيه (إن وجدت)
- 🔄 **دورات الانشطه الفرعيه** (Breeding Cycles) - للحسابات الفرعيه

### 🛒 المبيعات (Sales)
- 📝 **فواتير المبيعات** (Sales) - إنشاء وإدارة الفواتير
- 🔙 **مرتجعات المبيعات** (Sale Returns) - إدارة المرتجعات
- 💳 **مدفوعات العملاء** (Customer Payments) - سندات القبض

### 📦 المشتريات (Purchases)
- 📝 **فواتير المشتريات** (Purchases) - تسجيل المشتريات
- 🔙 **مرتجعات المشتريات** (Purchase Returns) - إرجاع للموردين
- 💸 **مدفوعات الموردين** (Supplier Payments) - سندات الصرف

### 📊 المخزون (Inventory)
- 📦 **الأرصدة الافتتاحية** (Opening Balances) - الرصيد الأولي
- 🔄 **حركة المخزون** (Stock Movements) - نقل بين المخازن

### 📈 التقارير (Reports)
- 👥 **كشف حساب عميل** (Customer Statement)
- 👥 **كشف جميع العملاء** (All Customers Statement)
- 🏢 **كشف حساب مورد** (Supplier Statement)
- 🏢 **كشف جميع الموردين** (All Suppliers Statement)
- 📦 **حركة صنف** (Item Movement)
- 📦 **حركة جميع الأصناف** (All Items Movement)
- 💰 **حركة خزينة** (Cashbox Movement)
- 💰 **جميع الخزائن** (All Cashboxes)
- 🌾 **كشف حساب فرعي** (Farm Statement)
- 📊 **تقييم المخزون** (Inventory Valuation)
- 📅 **تقرير دفعات الصلاحية** (Expiry Batches)
- 💸 **تحليل المصروفات** (Expense Analysis)
- 💰 **تحليل الإيرادات** (Income Analysis)
- 📈 **تقرير الأرباح** (Profit Report)

### 📄 الإيصالات (Vouchers)
- 📄 **سند قبض** (Receipt Voucher) - إيصالات الاستلام
- 📄 **سند صرف** (Payment Voucher) - إيصالات الدفع

### 💼 المحاسبة (Accounting) - قيد التطوير
- 📒 **شجرة الحسابات** (Chart of Accounts)
- 📝 **القيود اليومية** (Journal Entries)
- ⚙️ **ربط القيود** (Journal Mappings)
- 📊 **ميزان المراجعة** (Trial Balance)
- 📈 **قائمة الدخل** (Income Statement)
- 📋 **الميزانية العمومية** (Balance Sheet)

### 👤 الإدارة (Administration)
- 👥 **المستخدمون** (Users) - إدارة المستخدمين
- 🔐 **الأدوار** (Roles) - صلاحيات المستخدمين
- 🔒 **الصلاحيات** (Permissions) - تفاصيل الصلاحيات
- 📝 **سجل الأنشطة** (Activity Log) - تتبع العمليات

### ⚙️ الإعدادات (Settings)
- 🌍 **الإعدادات العامة** (General Settings)
- 🏢 **المؤسسات** (Tenants) - إدارة المؤسسات
- 📱 **إعدادات WhatsApp** (WhatsApp Settings)
- 📧 **الرسائل السريعة** (Quick Messages)

---

## 🎯 أي ملف يجب أن أقرأ؟

### 👤 للمستخدم العادي (موظف مبيعات / محاسب):
```
1. ابدأ بـ: QUICK_START.md (15 دقيقة)
   ↓ فهم أساسيات النظام
   
2. إذا تعمل مع منتجات لها صلاحية: EXPIRY_TRACKING_GUIDE.md (45 دقيقة)
   ↓ فهم FEFO وكيفية التعامل مع الصلاحيات
   
3. للتقارير اليومية: REPORTS_IMPLEMENTATION.md (20 دقيقة)
   ↓ استخراج التقارير المطلوبة
   
4. للتواصل مع العملاء: WHATSAPP_GATEWAY_GUIDE.md (35 دقيقة)
   ↓ إرسال رسائل وكشوف حسابات

📚 **إجمالي وقت التدريب:** ~2 ساعة
```

### 👨‍💼 لمدير الشركة / مالك النشاط:
```
1. ابدأ بـ: README.md (10 دقائق)
   ↓ نظرة عامة على كل الميزات
   
2. ثم: PROJECT_COMPLETION.md (30 دقيقة)
   ↓ فهم ما تم إنجازه
   
3. للتقارير الإدارية: REPORTS_IMPLEMENTATION.md (20 دقيقة)
   ↓ متابعة الأداء المالي
   
4. للمحاسبة المتقدمة: DOUBLE_ENTRY_ACCOUNTING_PLAN.md (60 دقيقة)
   ↓ فهم النظام المحاسبي المستقبلي
   
5. لإدارة عدة فروع: MULTI_TENANCY_COMPLETE_GUIDE.md (90 دقيقة)
   ↓ إدارة مؤسسات متعددة

📚 **إجمالي وقت التدريب:** ~3.5 ساعة
```

### 👨‍💻 للمطور / الدعم الفني:
```
1. ابدأ بـ: README.md (10 دقائق)
   ↓ التقنيات المستخدمة
   
2. ثم: EXPIRY_SYSTEM_UPDATES.md (30 دقيقة)
   ↓ التحديثات التقنية
   
3. للمحاسبة: DOUBLE_ENTRY_IMPLEMENTATION.md (45 دقيقة)
   ↓ البنية التقنية
   
4. للتوثيق الشامل: جميع ملفات MD
   ↓ فهم كامل للنظام
   
5. قبل النشر: PRODUCTION_CHECKLIST.md (20 دقيقة)
   ↓ التحقق من الجاهزية

📚 **إجمالي وقت التدريب:** ~4 ساعات
```

### 👨‍⚙️ لمسؤول النظام (System Administrator):
```
1. ابدأ بـ: README.md (10 دقائق)
   ↓ معلومات التثبيت
   
2. للمستخدمين: TENANT_ROLES_IMPLEMENTATION.md (20 دقيقة)
   ↓ إدارة الصلاحيات
   
3. للواتساب: WHATSAPP_INTEGRATION_GUIDE.md (30 دقيقة)
   ↓ إعداد Twilio أو Gateway
   
4. للتقارير: EXPORT_SYSTEM_COMPLETE.md (25 دقيقة)
   ↓ نظام التصدير
   
5. قبل الإنتاج: PRODUCTION_CHECKLIST.md (20 دقيقة)
   ↓ الأمان والنسخ الاحتياطي

📚 **إجمالي وقت التدريب:** ~2 ساعة
```

---

## 🔑 المصطلحات والمفاهيم الأساسية

### 📅 نظام الصلاحيات (Expiry Date System)
يتتبع تاريخ انتهاء صلاحية المنتجات عبر جميع العمليات (مشتريات، مبيعات، مرتجعات، أرصدة)

### 📦 FEFO (First Expire First Out)
**نظام إجباري** يضمن بيع الدفعات الأقدم صلاحية أولاً - معيار عالمي للجودة والسلامة
- ✅ التحقق من جانب العميل (Client-side)
- ✅ التحقق من جانب الخادم (Server-side)
- ❌ لا يمكن تجاوزه إطلاقاً

### 📊 دفعات الصلاحية (Expiry Batches)
تجميع المنتجات حسب تاريخ الصلاحية مع الكمية المتاحة لكل دفعة

### 🟢 🟠 🔴 دليل الألوان في التقارير
- 🟢 **أخضر** = منتج صالح (أكثر من 30 يوم)
- 🟠 **برتقالي** = قريب الانتهاء (30 يوم أو أقل)
- 🔴 **أحمر** = منتهي الصلاحية (تجاوز التاريخ)

### 💰 الرصيد الافتتاحي (Opening Balance)
الرصيد قبل فترة التقرير - يُحسب تلقائياً من جميع العمليات السابقة

### 💵 الرصيد الختامي (Closing Balance)
الرصيد في نهاية فترة التقرير = الافتتاحي + الوارد - الصادر

### 📝 الرصيد الجاري (Running Balance)
الرصيد المتغير بعد كل عملية - يظهر في تقارير الحركة

### 💳 حالة الدفع (Payment Status)
- ✅ **مدفوع** (Paid) - تم السداد كاملاً
- ⏳ **جزئي** (Partial) - دفع جزء من المبلغ
- ❌ **غير مدفوع** (Unpaid) - لم يتم الدفع

### 📱 WhatsApp Gateway
نظام يتيح إرسال رسائل WhatsApp من رقمك الشخصي مجاناً بدون Twilio

### 📨 الرسائل السريعة (Quick Messages)
قوالب رسائل جاهزة يمكن إرسالها بضغطة واحدة مع متغيرات ذكية

### 🏢 Tenant (المؤسسة)
في نظام Multi-Tenancy، كل مؤسسة (شركة/فرع) لها بيانات معزولة تماماً

### 🔐 Role (الدور)
مجموعة صلاحيات محددة (مثل: مدير، محاسب، موظف مبيعات)

### ✅ Permission (الصلاحية)
إمكانية محددة (مثل: عرض، إنشاء، تعديل، حذف) على مورد معين

---

## 📖 دليل استخدام الشاشات الرئيسية

### 0️⃣ شاشة لوحة التحكم (Dashboard)

**الوصول:** الصفحة الرئيسية بعد تسجيل الدخول مباشرة

**الغرض الرئيسي:** عرض ملخص شامل وسريع لأداء العمل والمؤشرات الهامة

#### محتوى لوحة التحكم:

**1️⃣ بطاقات الإحصائيات الرئيسية (KPI Cards):**

- 💰 **إجمالي المبيعات (آخر 30 يوم)**
  - القيمة الإجمالية لجميع الفواتير المباعة
  - نسبة التغيير مع الفترة السابقة
  
- 💳 **إجمالي المدفوعات**
  - ما تم تحصيله فعلياً من العملاء
  - نسبة التحصيل من المبيعات
  
- 💸 **المتبقي على العملاء**
  - إجمالي الأرصدة المدينة
  - عدد الفواتير غير المدفوعة
  
- 📦 **قيمة المخزون**
  - القيمة الإجمالية للمخزون الموجود
  - عدد الأصناف الكلي
  
- 👥 **عدد العملاء**
  - إجمالي المسجلين
  - عدد الجدد هذا الشهر

**2️⃣ الرسوم البيانية:**

- 📈 مخطط المبيعات (آخر 12 شهر)
- 📊 مخطط المشتريات
- 🎯 توزيع المبيعات حسب العملاء

**استخدام يومي:** تحقق من الأرقام كل صباح للكشف عن أي مشاكل

---

### 1️⃣ شاشة المنتجات (Products)

**الوصول:** القائمة الرئيسية → البيانات الأساسية → المنتجات

#### إنشاء منتج جديد:
1. اضغط **"إنشاء"** (Create)
2. **القسم الأول - المعلومات الأساسية:**
   - الاسم بالعربية (إجباري)
   - الاسم بالإنجليزية
   - كود المنتج (SKU)
   - الفئة
   - ✅ **هل يتطلب تاريخ صلاحية؟** ← فعّل هذا للمنتجات القابلة للتلف
3. **القسم الثاني - التسعير:**
   - سعر الشراء
   - سعر البيع
   - الوحدة الرئيسية
4. **القسم الثالث - المخزون:**
   - الحد الأدنى للمخزون (للتنبيهات)
5. احفظ

**ملاحظة مهمة:** بمجرد تفعيل "يتطلب تاريخ صلاحية"، سيصبح حقل الصلاحية **إجباري** في جميع العمليات (مشتريات، مبيعات، أرصدة).

---

### 2️⃣ شاشة العملاء (Customers)

**الوصول:** القائمة الرئيسية → البيانات الأساسية → العملاء

**الغرض:** إدارة بيانات العملاء ومتابعة أرصدتهم

#### إنشاء عميل جديد:
1. اضغط **"إنشاء"**
2. **المعلومات الأساسية:**
   - الاسم (إجباري)
   - رقم الهاتف (مهم جداً لـ WhatsApp)
   - البريد الإلكتروني
   - العنوان
3. **المعلومات المالية:**
   - الرصيد الحالي (إن وجد)
   - حد الائتمان (الحد الأقصى للشراء بدون دفع)
4. احفظ

#### الإجراءات على كل عميل:
- 📊 **عرض كشف الحساب** - لعرض جميع المعاملات التفصيلية
- 💬 **إرسال واتساب (Twilio)** - رسالة مخصصة
- 📱 **إرسال واتساب (رقمك الشخصي)** - عبر Gateway شخصي
- 🎉 **رسالة ترحيب سريعة** - قالب جاهز بضغطة واحدة
- 📢 **رسالة تذكير سريعة** - للعملاء المتأخرين
- ✏️ **تعديل البيانات** - تحديث المعلومات
- 🗑️ **حذف** - إزالة العميل (فقط بدون فواتير)

**💡 نصيحة:** احفظ رقم الهاتف الصحيح - ستحتاجه للتواصل عبر WhatsApp

---

### 3️⃣ شاشة المبيعات (Sales)

**الوصول:** القائمة الرئيسية → المبيعات → فواتير المبيعات

**الغرض الرئيسي:** تسجيل عمليات البيع، حساب الفواتير، وتقليل المخزون تلقائياً

#### إنشاء فاتورة مبيعات مفصلة:

**الخطوة 1: معلومات الفاتورة الأساسية**
```
- رقم الفاتورة: يملأ تلقائياً (INV-2026-00001)
- التاريخ: تاريخ البيع
- العميل: اختر من قائمة العملاء المسجلين
  💡 إذا كان عميل جديد، يمكنك إضافته مباشرة
- المخزن: اختر المخزن الذي تبيع منه
- الخزينة: حيث سيُودع المبلغ المدفوع
```

**الخطوة 2: إضافة المنتجات**
```
الطريقة:
1. اضغط زر "إضافة صنف"
2. اختر المنتج من القائمة (حقل البحث يعمل بسرعة)
3. إذا كان المنتج له صلاحية (مثل أغذية):
   ⭐ النظام يعرض الكميات لكل تاريخ صلاحية
   ⭐ النظام يختار تلقائياً الأقدم (FEFO) 
   ⭐ يُمنع اختيار دفعة أحدث إذا كانت أقدم متاحة
4. أدخل الكمية المطلوبة
5. السعر: يملأ تلقائياً من السعر المحفوظ
6. يمكنك تعديل السعر يدوياً إذا لزم الأمر

النتيجة التلقائية:
- الإجمالي = الكمية × السعر
```

**الخطوة 3: معالجة الخصومات والضرائب**
```
الخصم (Discount):
- نسبة مئوية: مثل 10% (يحسب من الإجمالي)
- قيمة ثابتة: مثل 50 جنيه
- ينطبق على كل الفاتورة

الضريبة (Tax):
- نسبة الضريبة: عادة 14% (حسب التشريعات)
- تُحسب على الإجمالي بعد الخصم

الإجمالي = (مجموع الأصناف - الخصم) + الضريبة
```

**الخطوة 4: تسجيل الدفع**
```
ثلاث حالات شائعة:

✅ حالة 1: دفع كامل
   - المبلغ المدفوع = الإجمالي
   - المتبقي: 0
   - الحالة: "Paid" (مكتمل)
   
✅ حالة 2: دفع جزئي
   - المبلغ المدفوع: جزء من الإجمالي
   - المتبقي: الباقي
   - الحالة: "Partial" (جزئي)
   
✅ حالة 3: بدون دفع (آجل)
   - المبلغ المدفوع: 0
   - المتبقي: الإجمالي
   - الحالة: "Unpaid" (غير مدفوع)
```

**الخطوة 5: الحفظ والإجراءات**
```
بعد الضغط على "Save":
- تسجيل الفاتورة برقم فريد
- خصم الكميات من المخزون تلقائياً
- إضافة المبلغ المدفوع للخزينة
- تحديث رصيد العميل

الإجراءات المتاحة:
- 🖨️ طباعة الفاتورة
- 📱 إرسال عبر WhatsApp
- 📧 إرسال بالبريد
- 🔄 إنشاء نسخة
```

**النتيجة:**
- ✅ تُنشأ الفاتورة
- ✅ يُخصم المخزون تلقائياً
- ✅ يُسجل المبلغ في الخزينة
- ✅ يُحدّث رصيد العميل
- ✅ تُطبع الفاتورة أو تُرسل عبر WhatsApp

---

### 4️⃣ شاشة المشتريات (Purchases)

**الوصول:** القائمة الرئيسية → المشتريات → فواتير المشتريات

**الغرض الرئيسي:** تسجيل المشتريات، تحديث المخزون، وإدارة الرصيد مع الموردين

#### إنشاء فاتورة مشتريات:
1. اضغط **"إنشاء"**
2. **معلومات الفاتورة:**
   - رقم الفاتورة (تلقائي)
   - التاريخ
   - المورد (إجباري) - اختر من قائمة الموردين
   - المخزن - حيث سيُضاف المنتج
   - الخزينة - الخزينة الخاصة بالصرف
3. **إضافة المنتجات:**
   - اضغط "إضافة صنف"
   - اختر المنتج
   - **إذا كان المنتج له صلاحية:**
     - أدخل تاريخ الصلاحية (إجباري)
     - النظام سيتتبع هذه الدفعة بالتاريخ المُدخل
   - أدخل الكمية
   - سعر الشراء (قد يختلف عن سعر البيع)
4. **الخصومات والضرائب:** (نفس المبيعات)
5. **الدفع:**
   - دفع كامل: الخزينة تنخفض، المورد بدون رصيد
   - دفع جزئي: الخزينة تنخفض، المورد مديون بالباقي
   - بدون دفع: المورد مديون بالكامل
6. احفظ

**النتيجة:**
- ✅ تُنشأ الفاتورة
- ✅ يُضاف للمخزون تلقائياً
- ✅ يُخصم من الخزينة (إن تم الدفع)
- ✅ يُحدّث رصيد المورد

---

### 5️⃣ شاشة مدفوعات العملاء (Customer Payments)

**الوصول:** القائمة الرئيسية → المبيعات → مدفوعات العملاء

**الغرض الرئيسي:** تسجيل استلام الأموال من العملاء وتقليل أرصدتهم

#### تسجيل دفعة من عميل:

**متى تستخدمها؟**
- بعد عملية بيع آجلة (لم يدفع العميل)
- عميل جاء يسدد جزء من رصيده
- عميل جاء يسدد رصيده كاملاً
- استلام دفعات متأخرة

**الخطوات:**
1. اضغط **"إنشاء"**
2. **معلومات السند:**
   - رقم السند (تلقائي: CPR-2026-XXXXX) - سند قبض
   - التاريخ - تاريخ استلام الدفعة
   - العميل (إجباري) - اختر العميل الذي يدفع
     * النظام يعرض رصيده الحالي (كم مديون)
   - الخزينة - حيث سيُضاف المبلغ المستلم
3. **تفاصيل الدفع:**
   - المبلغ المدفوع - المبلغ المستلم
   - طريقة الدفع:
     * نقد (Cash) - مباشر
     * شيك (Check) - مع رقم الشيك وتاريخ الاستحقاق
     * تحويل بنكي (Bank Transfer) - مع رقم التحويل
   - ملاحظات (اختياري)
4. احفظ

**النتيجة:**
- ✅ يُنشأ سند قبض برقم فريد (CPR-2026-00001)
- ✅ يُضاف المبلغ للخزينة
- ✅ يُخصم من رصيد العميل بنفس المبلغ
- ✅ يمكن طباعة السند وتسليمه للعميل

**مثال عملي:**
```
عميل "أحمد محمد" رصيده 500 جنيه (مديون)
يأتي ويدفع 300 جنيه نقداً

بعد التسجيل:
- رصيد العميل: 500 - 300 = 200 جنيه (متبقي)
- الخزينة: +300 جنيه
- سند قبض: CPR-2026-00015
```

---

### 6️⃣ شاشة الأرصدة الافتتاحية (Opening Balances)

**الوصول:** القائمة الرئيسية → المخزون → الأرصدة الافتتاحية

**الغرض الرئيسي:** إدخال الكميات الموجودة في المخزن بداية الفترة (عند البدء أو نهاية سنة مالية)

**متى تستخدمها؟**
- 📅 عند بدء استخدام النظام لأول مرة
- 📅 عند بدء سنة مالية جديدة
- 📅 عند فتح مخزن جديد
- ✅ لمعايرة النظام مع الواقع الفعلي للمخزون

#### إنشاء رصيد افتتاحي:

**الخطوات:**
1. اضغط **"إنشاء"**
2. **المعلومات الأساسية:**
   - المنتج (اختر المنتج المطلوب)
   - المخزن (المخزن الذي تُدخل الرصيد فيه)
   - الكمية (الكمية الموجودة فعلياً)
   - التكلفة/السعر (اختياري - يُستخدم لحساب قيمة المخزون)
3. **للمنتجات ذات الصلاحية (الأغذية والأدوية):**
   - تاريخ الصلاحية (إجباري)
   - يمكن إدخال نفس المنتج عدة مرات بتواريخ مختلفة
4. احفظ

**أمثلة عملية:**
```
مثال 1: منتج بدون صلاحية
- المنتج: "قماش أبيض"
- المخزن: "مخزن المقر الرئيسي"
- الكمية: 100 متر
- السعر: 50 جنيه للمتر
- تحفظ والمتبقي = 100

مثال 2: منتج بصلاحيات مختلفة
- المنتج: "حليب طازج"
- المخزن: "مخزن الثلاجة"
- الكمية: 50، الصلاحية: 2026-03-10 ✓ حفظ
- الكمية: 30، الصلاحية: 2026-04-15 ✓ حفظ
- الكمية: 20، الصلاحية: 2026-05-20 ✓ حفظ
- إجمالي: 100 لتر موزع على 3 دفعات
```

**ملاحظات مهمة:**
- 🎯 هذا يُدخل البيانات الأولية للنظام فقط
- 🎯 لا يؤثر على الفواتير بعده
- 🎯 من المهم إدخال البيانات الدقيقة (الكميات الفعلية)
- 🎯 إذا كان الرصيد مشروطاً في نهاية السنة المالية، سيُستخدم في حساب الربح

**العلاقة بالتقارير:**
عند إنشاء تقرير "حركة صنف" من نفس التاريخ، سيظهر الرصيد الافتتاحي كأول سطر في التقرير

---

### 7️⃣ شاشة كشف حساب العميل (Customer Statement Report)

**الوصول:** القائمة الرئيسية → التقارير → كشف حساب عميل

**الغرض الرئيسي:** عرض تفصيلي لجميع معاملات عميل معين خلال فترة زمنية

**المستخدمون الرئيسيون:**
- المحاسب: للمتابعة المالية
- العميل: لفهم حسابه لديك
- المدير: للتحليل والمراجعة

#### إنشاء التقرير:

**الخطوات:**
1. افتح الشاشة
2. **اختر الفلاتر:**
   - العميل (إجباري) - اختر العميل المطلوب
   - من تاريخ (اختياري) - بداية الفترة
   - إلى تاريخ (اختياري) - نهاية الفترة
   - اضغط "View Report" أو "عرض التقرير"
3. التقرير يُعرض تلقائياً

#### محتوى التقرير بالتفصيل:

**الرأس (Header):**
```
اسم الشركة
كشف حساب العميل
================
بيانات العميل:
- الاسم: أحمد محمد
- الهاتف: 05512345678
- البريد: ahmed@example.com
- العنوان: شارع النيل، القاهرة

الفترة الزمنية:
- من: 01/01/2026
- إلى: 31/01/2026
```

**الرصيد الافتتاحي:**
- يعرض رصيد العميل في بداية الفترة (من العمليات السابقة)

**الجدول الرئيسي (transactions):**
```
التاريخ | رقم الفاتورة | البيان | الإجمالي | الخصم | الضريبة | المجموع | المدفوع | المتبقي | الرصيد
2026-01-05 | INV-2026-001 | مبيعات | 1000 | 100 | 140 | 1040 | 1040 | 0 | 1040
2026-01-10 | INV-2026-005 | مبيعات | 500 | 0 | 70 | 570 | 200 | 370 | 1410
...
```

**بنود الفاتورة المُفصلة (Item Details):**
```
تحت كل فاتورة:

فاتورة INV-2026-001:
├── المنتج 1: قماش أحمر
│   ├── الكمية: 10 متر
│   ├── السعر: 80 جنيه
│   └── الإجمالي: 800 جنيه
├── المنتج 2: أزرار
│   ├── الكمية: 200 حبة
│   ├── السعر: 1 جنيه
│   └── الإجمالي: 200 جنيه
```

**الذيل (Footer/Summary):**
```
الرصيد الختامي (في آخر الفترة): 1410 جنيه
إجمالي المبيعات: 1570 جنيه
إجمالي المدفوع: 1240 جنيه
إجمالي المتبقي: 330 جنيه
```

#### الإجراءات المتاحة بعد إنشاء التقرير:

- 📥 **تصدير Excel** - لملف Excel جاهز للمعالجة
- 📄 **تصدير PDF** - لملف PDF احترافي وقابل للطباعة
- 🖨️ **طباعة** - طباعة مباشرة من المتصفح
- 📧 **إرسال بالبريد** - إرسال PDF بالبريد الإلكتروني
- 📱 **إرسال WhatsApp** - إرسال الكشف مباشرة للعميل عبر WhatsApp

**استخدام شائع:**
```
💼 في نهاية الشهر:
1. اطبع الكشف
2. قارنه مع رصيد دفاتر العميل
3. إذا اختلفا، حقق في الفرق

👥 قبل استدعاء العميل:
1. اطبع الكشف
2. تحقق من الفاتورات المتبقية
3. اتصل به برقم محدد للسداد

📱 للعملاء الدوليين:
1. أرسل الكشف عبر WhatsApp
2. يمكنك تخصيص الرسالة المرسلة معه
```

---

### 8️⃣ شاشة تقرير دفعات الصلاحية (Expiry Batches Report)

**الوصول:** القائمة الرئيسية → التقارير → تقرير دفعات الصلاحية

**الغرض:** متابعة المنتجات القريبة من انتهاء الصلاحية أو المنتهية

#### استخدام التقرير:
1. **اختر الفلاتر:**
   - المنتج (اختياري - لمنتج محدد)
   - المخزن (اختياري)
   - من تاريخ الصلاحية (اختياري)
   - إلى تاريخ الصلاحية (اختياري)
2. التقرير يُعرض تلقائياً

#### بطاقات الملخص:
- 🔴 **منتهي الصلاحية** - عدد الدفعات المنتهية
- 🟠 **قريب الانتهاء** - دفعات ستنتهي خلال 30 يوم
- 🟢 **صالح** - دفعات سليمة (أكثر من 30 يوم)
- 📊 **إجمالي الدفعات**

#### جدول الدفعات:
- المنتج
- المخزن
- تاريخ الصلاحية
- الكمية المتاحة
- **الحالة** (ملونة):
  - 🔴 Expired
  - 🟠 Near Expiry
  - 🟢 Good

#### الإجراءات:
- 📥 **تصدير Excel** - لمتابعة خارجية
- فلترة سريعة حسب الحالة

**أفضل ممارسة:** راجع هذا التقرير أسبوعياً لتجنب خسائر المخزون

---

### 9️⃣ شاشة حركة الصنف (Item Movement Report)

**الوصول:** القائمة الرئيسية → التقارير → حركة صنف

**الغرض:** تتبع دقيق لكل حركات منتج معين (وارد / صادر)

#### استخدام التقرير:
1. **اختر الفلاتر:**
   - المنتج (إجباري)
   - المخزن (إجباري)
   - من تاريخ (اختياري)
   - إلى تاريخ (اختياري)
2. التقرير يُعرض تلقائياً

#### المعلومات المعروضة:
- **الرصيد الافتتاحي** بالوحدات الكبرى والصغرى
- **جدول الحركات:**
  - التاريخ
  - رقم المرجع
  - نوع العملية (شراء، بيع، مرتجع...)
  - البيان
  - الكمية
  - الوحدة
  - الوارد (+)
  - الصادر (-)
  - **الرصيد الجاري** (بعد كل عملية)
- **الرصيد الختامي**
- **الملخص:**
  - إجمالي الوارد
  - إجمالي الصادر
  - صافي التغيير
  - عدد العمليات

**استخدام شائع:** لمعرفة سبب نقص أو زيادة في مخزون منتج معين

---

### 🔟 شاشة حركة الخزينة (Cashbox Movement Report)

**الوصول:** القائمة الرئيسية → التقارير → حركة خزينة

**الغرض:** تتبع جميع المبالغ الداخلة والخارجة من خزينة معينة

#### استخدام التقرير:
1. **اختر الفلاتر:**
   - الخزينة (إجباري)
   - من تاريخ (اختياري)
   - إلى تاريخ (اختياري)
2. التقرير يُعرض تلقائياً

#### المعلومات المعروضة:
- **الرصيد الافتتاحي**
- **جدول الحركات:**
  - التاريخ
  - رقم المرجع
  - نوع العملية
  - البيان
  - المبلغ
  - الإيرادات (+)
  - المصروفات (-)
  - **الرصيد الجاري**
- **الرصيد الختامي**
- **ملخص عام:**
  - إجمالي الإيرادات
  - إجمالي المصروفات
  - صافي التغيير
- **ملخص تفصيلي** حسب نوع العملية:
  - مبيعات: XXX جنيه (X عملية)
  - مشتريات: XXX جنيه (X عملية)
  - سداد عملاء: XXX جنيه (X عملية)
  - دفع موردين: XXX جنيه (X عملية)
  - ... إلخ

**استخدام يومي:** في نهاية اليوم لمطابقة الرصيد مع الأموال الفعلية

---

### 1️⃣1️⃣ شاشة إعدادات الرسائل السريعة (WhatsApp Quick Messages)

**الوصول:** القائمة الرئيسية → الإعدادات → الرسائل السريعة

**الغرض:** تخصيص قوالب الرسائل الجاهزة

#### تعديل القوالب:
1. ستجد قائمة بالقوالب الافتراضية:
   - رسالة ترحيب (Greeting)
   - رسالة متابعة (Follow Up)
   - رسالة تذكير (Reminder)
   - رسالة شكر (Thank You)
   - رسالة عرض (Offer)
2. لكل قالب:
   - **العنوان** - اسم القالب
   - **الرسالة** - محتوى الرسالة

#### المتغيرات المتاحة:
استخدم هذه المتغيرات وسيتم استبدالها تلقائياً:
- `{name}` → اسم العميل
- `{balance}` → الرصيد الحالي
- `{credit_limit}` → حد الائتمان
- `{phone}` → رقم الهاتف

**مثال:**
```
مرحباً {name} 👋

نشكرك على تعاملك معنا!
رصيدك الحالي: {balance} جنيه

فريق الدعم
```

3. احفظ التغييرات

**النتيجة:** عند الضغط على زر الرسالة السريعة في قائمة العملاء، ستُرسل الرسالة المخصصة تلقائياً

---

## 💡 سيناريوهات عملية شائعة

---

## 💡 سيناريوهات عملية شائعة

### 📌 السيناريو 1: بدء استخدام النظام لأول مرة

**الخطوات:**
```
1. إنشاء المستخدمين وتوزيع الصلاحيات
   ↓
2. إدخال الفئات (اختياري لكن مفيد)
   ↓
3. إدخال المنتجات (مع تفعيل الصلاحية حسب الحاجة)
   ↓
4. إدخال العملاء والموردين
   ↓
5. إدخال المخازن والخزائن
   ↓
6. إدخال الأرصدة الافتتاحية للمخزون
   ↓
7. البدء في تسجيل المبيعات والمشتريات
```

⏱️ **الوقت المقدر:** 2-4 ساعات للإعداد الكامل

---

### 📌 السيناريو 2: تسجيل عملية بيع عادية

**الموقف:** عميل جاء واشترى 3 منتجات، دفع نصف المبلغ

**الخطوات:**
```
1. افتح: المبيعات → إنشاء
2. اختر العميل من القائمة
3. أضف المنتجات واحداً تلو الآخر
4. أدخل الكميات والأسعار
5. (اختياري) أضف خصم أو ضريبة
6. في قسم الدفع:
   - المبلغ الإجمالي: 1000 جنيه (تلقائي)
   - المبلغ المدفوع: 500 جنيه
   - المتبقي: 500 جنيه (تلقائي)
   - الحالة: جزئي (تلقائي)
7. احفظ
8. اطبع الفاتورة أو أرسلها عبر WhatsApp
```

✅ **النتيجة:**
- الفاتورة محفوظة
- المخزون مُحدّث
- 500 جنيه في الخزينة
- 500 جنيه في رصيد العميل

---

### 📌 السيناريو 3: استقبال دفعة من عميل

**الموقف:** عميل جاء ليسدد جزء من رصيده المتبقي

**الخطوات:**
```
1. افتح: المبيعات → مدفوعات العملاء → إنشاء
2. اختر العميل
3. أدخل المبلغ المدفوع
4. اختر طريقة الدفع
5. احفظ
6. اطبع سند القبض وسلمه للعميل
```

✅ **النتيجة:**
- سند قبض برقم CPR-2026-00001
- 500 جنيه مُضافة للخزينة
- رصيد العميل انخفض من 500 إلى 0

---

### 📌 السيناريو 4: منتج قارب على انتهاء الصلاحية

**الموقف:** لديك "حليب طازج" في المخزن صلاحيته تنتهي خلال 5 أيام

**الخطوات:**
```
1. افتح: التقارير → تقرير دفعات الصلاحية
2. اترك الفلاتر فارغة (لعرض كل المنتجات)
3. ابحث عن المنتجات المميزة بـ 🟠 (قريب الانتهاء)
4. لاحظ الكمية والتاريخ
5. اتخذ إجراء:
   - عرض تخفيضات سريعة
   - إبلاغ فريق المبيعات
   - تنبيه العملاء عبر WhatsApp
```

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

---

### 📌 السيناريو 5: عميل يريد شراء منتج له صلاحية

**الموقف:** عميل يريد شراء "عصير برتقال" - المنتج له دفعتين:
- الدفعة 1: صلاحية 2026-03-15 (الكمية: 100)
- الدفعة 2: صلاحية 2026-06-30 (الكمية: 50)

**ماذا سيحدث؟**
```
1. تفتح فاتورة مبيعات
2. تضيف "عصير برتقال" - الكمية 30
3. النظام تلقائياً:
   ✅ يختار الدفعة 1 (الأقدم)
   ✅ يعرض لك: "2026-03-15 - الكمية المتاحة: 100"
   ❌ لا يسمح لك باختيار الدفعة 2
4. تحفظ الفاتورة
5. النتيجة:
   - الدفعة 1 أصبحت: 70 وحدة
   - الدفعة 2 لم تُمس: 50 وحدة
```

🎯 **الفائدة:** لن تنتهي صلاحية المنتجات في المخزن أبداً!

---

### 📌 السيناريو 6: إرسال كشف حساب لعميل عبر WhatsApp

**الموقف:** عميل يريد كشف حساب كامل لجميع تعاملاته

**الطريقة 1 - من قائمة العملاء:**
```
1. افتح: العملاء → قائمة العملاء
2. ابحث عن العميل
3. اضغط على زر "📱 إرسال واتساب (رقمك الشخصي)"
4. اكتب رسالة مخصصة
5. إرسال
```

**الطريقة 2 - من صفحة التقرير:**
```
1. افتح: التقارير → كشف حساب عميل
2. اختر العميل
3. حدد الفترة الزمنية
4. اضغط "إرسال WhatsApp Gateway"
5. أدخل رسالة مرفقة
6. إرسال
```

✅ **النتيجة:** العميل يستلم رسالة واتساب مع ملف PDF للكشف كامل

---

### 📌 السيناريو 7: إرسال رسالة تذكير جماعية

**الموقف:** نهاية الشهر وتريد تذكير جميع العملاء المتأخرين بالسداد

**الخطوات:**
```
1. افتح: العملاء → قائمة العملاء
2. استخدم الفلاتر:
   - الرصيد > 0 (العملاء المدينون)
3. لكل عميل:
   - اضغط زر "📢 رسالة تذكير سريعة"
   - الرسالة تُرسل فوراً بدون نافذة
4. يمكنك تخصيص نص الرسالة من:
   الإعدادات → الرسائل السريعة
```

⚡ **ميزة:** إرسال سريع جداً - دون الحاجة لنوافذ أو كتابة

---

### 📌 السيناريو 8: مراجعة أداء الشهر

**الموقف:** نهاية الشهر، المدير يريد معرفة الأداء المالي

**الخطوات:**
```
1. افتح: لوحة التحكم (Dashboard)
2. راجع الويدجتات:
   ✅ إجمالي المبيعات
   ✅ عدد العملاء الجدد
   ✅ المبالغ المحصّلة
   ✅ المخزون
3. راجع المخططات:
   📈 مخطط المبيعات (اتجاه 12 شهر)
   📊 مخطط المشتريات
4. للتفاصيل، افتح التقارير:
   - تقرير الأرباح
   - تحليل الإيرادات
   - تحليل المصروفات
5. صدّر التقارير كـ Excel للمراجعة
```

📊 **النتيجة:** فهم شامل للأداء المالي في دقائق

---

### 📌 السيناريو 9: عميل يرجع منتج

**الموقف:** عميل اشترى منتج بالأمس ويريد إرجاعه

**الخطوات:**
```
1. افتح: المبيعات → مرتجعات المبيعات → إنشاء
2. اختر فاتورة المبيعات الأصلية
3. النظام تلقائياً:
   ✅ يحمّل جميع المنتجات
   ✅ يحمّل الكميات والأسعار
   ✅ يحمّل تواريخ الصلاحية (إن وجدت)
4. عدّل الكميات المرتجعة (إذا كان جزئي)
5. احفظ
```

✅ **النتيجة:**
- المنتج عاد للمخزون (بنفس دفعة الصلاحية)
- المبلغ خُصم من الخزينة
- رصيد العميل تم تعديله

---

### 📌 السيناريو 10: مقارنة أداء فرعين

**الموقف:** لديك فرعين (مؤسستين) وتريد مقارنة الأداء

**الخطوات (Multi-Tenancy):**
```
1. سجل الدخول كـ Super Admin
2. بدّل بين المؤسسات:
   ⚙️ أيقونة الإعدادات → تبديل المؤسسة
3. افتح: لوحة التحكم
4. سجل الأرقام:
   - الفرع 1: مبيعات 50,000 جنيه
   - الفرع 2: مبيعات 35,000 جنيه
5. راجع التقارير لكل فرع على حدة
6. صدّر لـ Excel للمقارنة التفصيلية
```

🏢 **الفائدة:** عزل كامل للبيانات مع إمكانية المقارنة

---

## ⚡ الخطوات الأساسية الـ 5

### 1️⃣ تفعيل الصلاحية على المنتج
```
Products → اختر المنتج → علّم "Expiry Date Required" → احفظ
```

### 2️⃣ إدخال رصيد افتتاحي
```
Opening Balances → أنشئ جديد → أدخل الكمية + الصلاحية → احفظ
```

### 3️⃣ إدخال مشتريات
```
Purchases → أنشئ فاتورة → أدخل الصلاحية لكل منتج → احفظ
```

### 4️⃣ بيع المنتج (FEFO يعمل)
```
Sales → أنشئ فاتورة → اختر المنتج → النظام يختار الأقدم تلقائياً → احفظ
```

### 5️⃣ مراقبة الصلاحيات
```
Pages → Expiry Batches Report → اختر الفلاتر → شاهد الحالة
```

---

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

### إذا واجهت مشكلة:

| المشكلة | الحل | الملف المرجعي |
|--------|------|----------------|
| لا أعرف كيف أبدأ | اقرأ QUICK_START.md | [رابط](QUICK_START.md) |
| لا أفهم FEFO | اقرأ قسم FEFO في EXPIRY_TRACKING_GUIDE.md | [رابط](EXPIRY_TRACKING_GUIDE.md#%D9%81%D9%87%D9%85-fefo) |
| التقرير لا يعرض البيانات | اقرأ قسم الفلاتر | [رابط](REPORTS_IMPLEMENTATION.md) |
| النظام لا يسمح بالبيع | اقرأ عن FEFO | [رابط](QUICK_START.md) |
| أريد معلومات تقنية | اقرأ EXPIRY_SYSTEM_UPDATES.md | [رابط](EXPIRY_SYSTEM_UPDATES.md) |

---

## ⚡ الخطوات الأساسية للبدء (5 دقائق)

### 1️⃣ تفعيل الصلاحية على المنتجات (للمنتجات القابلة للتلف)
```
Products → اختر المنتج → علّم "Expiry Date Required" → احفظ
```

### 2️⃣ إدخال رصيد افتتاحي
```
Opening Balances → أنشئ جديد → أدخل الكمية + الصلاحية → احفظ
```

### 3️⃣ إدخال مشتريات
```
Purchases → أنشئ فاتورة → أدخل الصلاحية لكل منتج → احفظ
```

### 4️⃣ بيع المنتج (FEFO يعمل تلقائياً)
```
Sales → أنشئ فاتورة → اختر المنتج → النظام يختار الأقدم تلقائياً → احفظ
```

### 5️⃣ مراقبة الصلاحيات
```
Pages → Expiry Batches Report → اختر الفلاتر → شاهد الحالة
```

---

## 📊 إحصائيات النظام الشاملة

### 📁 الملفات والمكونات

| المكون | العدد | الوصف |
|--------|-------|-------|
| **📄 ملفات التوثيق** | 25+ ملف | أدلة شاملة بالعربية |
| **📊 التقارير** | 13+ تقرير | تقارير متقدمة مع تصدير |
| **🗂️ الموارد (Resources)** | 20+ مورد | شاشات إدارة البيانات |
| **📈 الصفحات (Pages)** | 15+ صفحة | تقارير ولوحات تحكم |
| **🌍 اللغات** | 3 لغات | عربي، إنجليزي، فرنسي |
| **📝 مفاتيح الترجمة** | 500+ مفتاح | تغطية كاملة |

### ⚙️ التقنيات المستخدمة

| التقنية | الإصدار | الاستخدام |
|---------|---------|-----------|
| **Laravel** | 12.x | إطار العمل الأساسي |
| **Filament** | v4.4 | لوحة الإدارة |
| **PHP** | 8.2+ | لغة البرمجة |
| **MySQL** | 8.0+ | قاعدة البيانات |
| **Livewire** | v3 | التفاعل الحي |
| **Alpine.js** | v3 | التفاعل من العميل |
| **Tailwind CSS** | v3 | التصميم |
| **mPDF** | 8.2.7 | تصدير PDF |
| **Maatwebsite Excel** | ✅ | تصدير Excel |
| **Twilio SDK** | 8.3 | WhatsApp API |

### 🎯 مؤشرات الأداء

| المؤشر | القيمة |
|--------|--------|
| **سرعة التحميل** | < 2 ثانية |
| **دعم المتصفحات** | جميع المتصفحات الحديثة |
| **التوافق مع الموبايل** | ✅ Responsive |
| **دعم RTL** | ✅ كامل للعربية |
| **الأمان** | Laravel Security + Shield |
| **قابلية التوسع** | Multi-Tenancy |

### 📈 مراحل التطوير المكتملة

| المرحلة | الوصف | الحالة |
|---------|-------|--------|
| **Phase 1** | إدارة المرتجعات | ✅ مكتمل |
| **Phase 2** | نظام المدفوعات | ✅ مكتمل |
| **Phase 3** | لوحة التحكم التحليلية | ✅ مكتمل |
| **Phase 4** | التقارير الاحترافية | ✅ مكتمل |
| **Phase 5** | نظام الصلاحيات FEFO | ✅ مكتمل |
| **Phase 6** | نظام التصدير | ✅ مكتمل |
| **Phase 7** | تكامل WhatsApp | ✅ مكتمل |
| **Phase 8** | Multi-Tenancy | ✅ مكتمل |
| **Phase 9** | المحاسبة المزدوجة | 🚧 قيد التطوير |

---

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

### 🔍 استكشاف المشاكل الشائعة

| المشكلة | السبب المحتمل | الحل | المرجع |
|--------|---------------|------|--------|
| **لا أعرف كيف أبدأ** | عدم الإلمام بالنظام | اقرأ QUICK_START.md | [📖](QUICK_START.md) |
| **لا أفهم FEFO** | مفهوم جديد | اقرأ قسم FEFO المفصل | [📖](EXPIRY_TRACKING_GUIDE.md) |
| **النظام لا يسمح بالبيع** | FEFO enforcement | تحقق من وجود دفعات أقدم | [📖](QUICK_START.md) |
| **التقرير فارغ** | فلاتر خاطئة | راجع الفلاتر المختارة | [📖](REPORTS_IMPLEMENTATION.md) |
| **لا يمكن التصدير** | مشكلة تقنية | تحقق من الصلاحيات | [📖](EXPORT_SYSTEM_COMPLETE.md) |
| **WhatsApp لا يعمل** | إعدادات خاطئة | راجع دليل الإعداد | [📖](WHATSAPP_GATEWAY_GUIDE.md) |
| **بطء في التقارير** | بيانات كثيرة | استخدم فلاتر الفترة | [📖](REPORTS_SETUP.md) |
| **مشكلة في الصلاحيات** | صلاحيات المستخدم | تحقق من الأدوار | [📖](TENANT_ROLES_IMPLEMENTATION.md) |

### 📚 دليل الاستفسارات السريعة

**❓ كيف أضيف منتج جديد؟**
- المنتجات → إنشاء → املأ البيانات → احفظ
- [التفاصيل: دليل استخدام الشاشات ▲](#1%EF%B8%8F⃣-شاشة-المنتجات-products)

**❓ كيف أعرف المنتجات القريبة من الانتهاء؟**
- التقارير → تقرير دفعات الصلاحية → ابحث عن 🟠
- [التفاصيل: EXPIRY_TRACKING_GUIDE.md](EXPIRY_TRACKING_GUIDE.md)

**❓ كيف أرسل كشف حساب عبر WhatsApp؟**
- العملاء → اختر العميل → زر WhatsApp → إرسال
- [التفاصيل: WHATSAPP_GATEWAY_GUIDE.md](WHATSAPP_GATEWAY_GUIDE.md)

**❓ كيف أصدر تقرير Excel؟**
- افتح أي تقرير → زر "تصدير Excel" → تحميل
- [التفاصيل: EXPORT_SYSTEM_COMPLETE.md](EXPORT_SYSTEM_COMPLETE.md)

**❓ ماذا يعني FEFO؟**
- First Expire First Out - بيع الأقدم صلاحية أولاً
- [التفاصيل: قسم المصطلحات ▲](#%EF%B8%8F-المصطلحات-والمفاهيم-الأساسية)

**❓ كيف أضيف مستخدم جديد؟**
- الإدارة → المستخدمون → إنشاء → اختر الدور → احفظ
- [التفاصيل: TENANT_ROLES_IMPLEMENTATION.md](TENANT_ROLES_IMPLEMENTATION.md)

**❓ كيف أنشئ فاتورة مبيعات؟**
- المبيعات → إنشاء → اختر العميل → أضف المنتجات → احفظ
- [التفاصيل: دليل استخدام الشاشات ▲](#3%EF%B8%8F⃣-شاشة-المبيعات-sales)

**❓ كيف أراقب الخزينة؟**
- التقارير → حركة خزينة → اختر الخزينة → عرض
- [التفاصيل: CASHBOX_MOVEMENT_REPORT.md](CASHBOX_MOVEMENT_REPORT.md)

**❓ كيف أتابع حركة منتج معين؟**
- التقارير → حركة صنف → اختر المنتج والمخزن → عرض
- [التفاصيل: ITEM_MOVEMENT_REPORT.md](ITEM_MOVEMENT_REPORT.md)

**❓ هل يمكن استخدام النظام لعدة فروع؟**
- نعم! عبر نظام Multi-Tenancy
- [التفاصيل: MULTI_TENANCY_COMPLETE_GUIDE.md](MULTI_TENANCY_COMPLETE_GUIDE.md)

---

## 📞 معلومات الاتصال والدعم

### 🎓 التدريب والتأهيل
- 📧 **التدريب عن بُعد:** متاح بالتنسيق
- 👨‍🏫 **التدريب الميداني:** زيارات حسب الموقع
- 📹 **فيديوهات تعليمية:** قيد الإنشاء
- 📖 **ورش العمل:** دورية حسب الطلب

### 🛠️ الدعم الفني
- 📧 **البريد الإلكتروني:** support@adly.system
- 📱 **الهاتف:** [يُحدد حسب المؤسسة]
- 💬 **الدردشة الحية:** متاح خلال ساعات العمل
- 🎫 **نظام التذاكر:** لمتابعة المشاكل

### 🔄 التحديثات
- ✨ **تحديثات أمنية:** شهرياً
- 🚀 **ميزات جديدة:** ربع سنوي
- 📝 **تحديثات الوثائق:** مستمرة
- 🐛 **إصلاح الأخطاء:** خلال 48 ساعة

---

## 📝 ملاحظات هامة وتحذيرات

### ⚠️ تنبيهات حرجة

```
🔴 تحذير مهم جداً:
1. نظام FEFO إجباري - لا يمكن تجاوزه لحماية الصحة العامة
2. الصلاحية الخاطئة قد تؤدي لمشاكل صحية خطيرة
3. راجع تقرير الصلاحيات أسبوعياً كحد أدنى
4. وثّق جميع الخسائر من المنتجات المنتهية
5. درّب فريق البيع على مفهوم FEFO بشكل كامل
6. احتفظ بنسخ احتياطية يومية من قاعدة البيانات
```

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

```
⚡ نصائح للأداء الأمثل:
- استخدم فلاتر التاريخ دائماً في التقارير الكبيرة
- نظف الملفات المؤقتة شهرياً
- راجع سجل الأنشطة أسبوعياً
- حدّث الصلاحيات حسب التغييرات التنظيمية
- استخدم اختصارات لوحة المفاتيح لزيادة الإنتاجية
```

### 🟢 أفضل الممارسات

```
✅ للحصول على أفضل تجربة:
- أدخل البيانات الأساسية بشكل كامل قبل البدء
- استخدم أسماء واضحة للمنتجات (عربي + إنجليزي)
- حدد حد الائتمان لكل عميل بدقة
- فعّل الصلاحية فقط للمنتجات التي تحتاجها
- راجع لوحة التحكم يومياً لمتابعة الأداء
- صدّر التقارير المهمة كنسخة احتياطية
- درّب المستخدمين الجدد قبل منحهم صلاحيات كاملة
```

---

## 🎓 الخلاصة والنقاط الرئيسية

### ✨ ما يميز نظام Adly ERP؟

```
🏆 نظام Adly يوفر لك:

✅ إدارة مخزون احترافية مع تتبع الصلاحيات (فريد من نوعه)
✅ FEFO إجباري - حماية من الأخطاء البشرية
✅ 13+ تقرير شامل مع تصدير Excel و PDF
✅ تكامل WhatsApp (Twilio + Gateway الشخصي)
✅ واجهة سهلة وسريعة بتقنية Filament v4
✅ دعم كامل للغة العربية مع RTL
✅ Multi-Tenancy - إدارة عدة مؤسسات
✅ نظام صلاحيات متقدم ودقيق
✅ لوحة تحكم تحليلية بالرسوم البيانية
✅ توثيق شامل بأكثر من 25 ملف
✅ تحديثات مستمرة ودعم فني
✅ محاسبة مزدوجة (قريباً)
```

### 🎯 الأهداف المحققة

| الهدف | الحالة | الملاحظات |
|-------|--------|-----------|
| نظام مخزون متكامل | ✅ 100% | مع FEFO وتتبع الصلاحيات |
| تقارير احترافية | ✅ 100% | 13 تقرير + تصدير |
| تكامل WhatsApp | ✅ 100% | نظامين متكاملين |
| Multi-Tenancy | ✅ 100% | جاهز للإنتاج |
| واجهة سهلة | ✅ 100% | Filament v4 |
| توثيق شامل | ✅ 100% | 25+ ملف |
| دعم لغات | ✅ 100% | 3 لغات |
| المحاسبة المزدوجة | 🚧 60% | قيد التطوير |

### 📊 إحصائيات الإنجاز

| المقياس | القيمة | الوصف |
|--------|--------|-------|
| **عدد الأقسام** | 40+ قسم | في هذا الدليل |
| **عدد الأمثلة** | 30+ مثال | سيناريوهات عملية |
| **عدد الأسئلة** | 25+ سؤال | أسئلة شائعة |
| **وقت القراءة الكلي** | ~6 ساعات | لقراءة كل شيء |
| **وقت البدء السريع** | ~5 دقائق | للبدء الفوري |
| **وقت التدريب الكامل** | 2-4 ساعات | حسب الدور |

---

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

### للمستخدم الجديد:
1. ✅ قرأت هذا الدليل → انتقل إلى [QUICK_START.md](QUICK_START.md)
2. ✅ فهمت الأساسيات → ابدأ بإدخال بياناتك
3. ✅ أدخلت البيانات → ابدأ العمل الفعلي
4. ✅ واجهت مشكلة → راجع قسم [الدعم والمساعدة ▲](#%EF%B8%8F-الدعم-والمساعدة)

### للمطور:
1. ✅ فهمت البنية العامة → اقرأ الملفات التقنية
2. ✅ تريد التطوير → راجع [DOUBLE_ENTRY_IMPLEMENTATION.md](DOUBLE_ENTRY_IMPLEMENTATION.md)
3. ✅ قبل النشر → راجع [PRODUCTION_CHECKLIST.md](PRODUCTION_CHECKLIST.md)

### للمدير:
1. ✅ فهمت الميزات → درّب فريقك
2. ✅ النظام جاهز → ابدأ الاستخدام الفعلي
3. ✅ تريد ميزات إضافية → تواصل مع الدعم الفني

---

## 📅 سجل التحديثات

## 📅 سجل التحديثات (Changelog)

### 🔄 يناير 2026 - تحديث شامل

#### ✨ ميزات جديدة:
- ✅ **نظام تتبع الصلاحيات الشامل** - FEFO enforcement كامل
- ✅ **تقرير دفعات الصلاحية** - مع فلاتر متقدمة وحالات ملونة
- ✅ **نظام التصدير الكامل** - Excel و PDF لجميع التقارير (13 تقرير)
- ✅ **تكامل WhatsApp Gateway** - استخدام رقمك الشخصي مجاناً
- ✅ **الرسائل السريعة** - قوالب جاهزة مع متغيرات ذكية
- ✅ **صفحة إعدادات الرسائل** - تخصيص القوالب بسهولة
- ✅ **دعم Evolution API / WAHA / WPPConnect** - خيارات متعددة للـ Gateway
- ✅ **Multi-Tenancy كامل** - دعم مؤسسات متعددة بعزل تام
- ✅ **نظام الاشتراكات** - خطط مرنة مع حدود استخدام

#### 🔧 تحسينات:
- ⚡ **تحسين أداء الاستعلامات** - فهارس محسّنة
- ⚡ **تحميل أسرع للتقارير** - تخزين مؤقت ذكي
- 🎨 **واجهة محسّنة** - تجربة مستخدم أفضل
- 🌍 **ترجمات محدّثة** - تغطية 100% للغات الثلاث
- 🔒 **أمان محسّن** - التحقق الثنائي من FEFO

#### 🐛 إصلاحات:
- ✅ إصلاح مشكلة الخصومات في المرتجعات
- ✅ إصلاح مشكلة الأعمدة المفقودة في قاعدة البيانات
- ✅ إصلاح تعارضات الـ Traits في الويدجتات
- ✅ إصلاح مشاكل التصدير للعربية في PDF

#### 📚 وثائق جديدة:
- 📖 EXPIRY_TRACKING_GUIDE.md (355 سطر)
- 📖 EXPORT_SYSTEM_COMPLETE.md (318 سطر)
- 📖 WHATSAPP_GATEWAY_GUIDE.md (458 سطر)
- 📖 WHATSAPP_QUICK_MESSAGES_GUIDE.md (300+ سطر)
- 📖 MULTI_TENANCY_COMPLETE_GUIDE.md (1868 سطر)
- 📖 DOUBLE_ENTRY_ACCOUNTING_PLAN.md (842 سطر)
- 📖 وملفات إضافية متعددة

---

### 🔄 ديسمبر 2025

#### ✨ ميزات:
- ✅ نظام المدفوعات (سندات القبض والصرف)
- ✅ لوحة التحكم التحليلية (5 ويدجتات)
- ✅ التقارير الاحترافية (كشوف الحسابات)

#### 🔧 تحسينات:
- ⚡ تحسين الأداء العام
- 🎨 تحسين التصميم

---

### 🔄 نوفمبر 2025

#### ✨ ميزات:
- ✅ نظام المرتجعات (مبيعات ومشتريات)
- ✅ إدارة الخصومات والضرائب

#### 🔧 تحسينات:
- ⚡ تحسين استعلامات قاعدة البيانات

---

## 🔮 الميزات القادمة (Roadmap)

### 📅 Q1 2026 (يناير - مارس)

#### 🚧 قيد التطوير:
- 🔨 **نظام المحاسبة المزدوجة** (Double Entry Accounting)
  - شجرة الحسابات متعددة المستويات
  - القيود اليومية التلقائية
  - ميزان المراجعة
  - قائمة الدخل
  - الميزانية العمومية
  - تقرير المركز المالي

#### 📋 مخطط لها:
- 📊 **تقارير محاسبية متقدمة**
- 💰 **إدارة الرواتب والمصروفات**
- 🏭 **إدارة الإنتاج** (للمصانع)
- 📱 **تطبيق موبايل** (iOS & Android)

---

### 📅 Q2 2026 (أبريل - يونيو)

#### 📋 مخطط لها:
- 🤖 **ذكاء اصطناعي للتنبؤات**
  - توقع المبيعات
  - توقع نقص المخزون
  - اقتراحات الطلبات الذكية
- 📊 **Dashboard متقدم**
  - مؤشرات أداء KPIs
  - تنبيهات ذكية
- 🔔 **نظام الإشعارات**
  - إشعارات push
  - تنبيهات البريد
  - تنبيهات SMS

---

### 📅 Q3-Q4 2026 (يوليو - ديسمبر)

#### 📋 مخطط لها:
- 🌐 **API عامة** (للتكامل مع أنظمة خارجية)
- 🔗 **تكامل مع المنصات الإلكترونية**
  - WooCommerce
  - Shopify
  - Magento
- 💳 **بوابات الدفع الإلكتروني**
  - Stripe
  - PayPal
  - Fawry
  - Paymob
- 🚚 **إدارة الشحن والتوصيل**
- 📦 **إدارة الموردين المتقدمة**
- 🎁 **برامج الولاء والنقاط**

---

## 🎖️ شهادات الجودة والمعايير

### ✅ المعايير المطبقة:

```
🏆 معايير البرمجة:
- ✅ PSR-12 Coding Standards
- ✅ Laravel Best Practices
- ✅ SOLID Principles
- ✅ Clean Code

🔒 معايير الأمان:
- ✅ OWASP Top 10 Protection
- ✅ SQL Injection Prevention
- ✅ XSS Protection
- ✅ CSRF Protection
- ✅ Authentication & Authorization

📊 معايير قاعدة البيانات:
- ✅ Database Normalization
- ✅ Indexed Properly
- ✅ Foreign Key Constraints
- ✅ Transaction Management

🌍 معايير الجودة:
- ✅ RTL Support
- ✅ Accessibility (WCAG 2.1)
- ✅ Mobile Responsive
- ✅ Cross-browser Compatible

📝 معايير التوثيق:
- ✅ Comprehensive Documentation
- ✅ Code Comments
- ✅ API Documentation
- ✅ User Guides
```

---

## 🌟 شكر وتقدير

### 👏 المساهمون في تطوير النظام:

```
💻 فريق التطوير:
- Backend Development Team
- Frontend/UI Team
- Database Architects
- Testing & QA Team

📝 فريق التوثيق:
- Technical Writers
- Translators (AR/EN/FR)
- Documentation Reviewers

🎨 فريق التصميم:
- UI/UX Designers
- Graphic Designers

🛠️ فريق الدعم:
- Technical Support Team
- Training Team
```

### 🙏 شكر خاص:

```
- Laravel Framework Team
- Filament PHP Team
- جميع المساهمين في المكتبات مفتوحة المصدر
- المستخدمين الأوائل الذين قدموا ملاحظاتهم القيمة
- فريق الاختبار الميداني
```

---

## 📜 الترخيص والاستخدام

### ⚖️ شروط الاستخدام:

```
📋 الترخيص:
- النظام مطور خصيصاً للاستخدام التجاري
- كل مؤسسة تحتاج ترخيص منفصل
- الترخيص يشمل التحديثات والدعم الفني

🚫 محظورات:
- إعادة البيع أو التوزيع
- إزالة علامات الملكية
- الهندسة العكسية
- مشاركة بيانات الاعتماد

✅ مسموح:
- الاستخدام التجاري الكامل
- التخصيص حسب احتياجاتك
- التدريب الداخلي
- التكامل مع أنظمة أخرى
```

---

## 🎯 رؤيتنا ورسالتنا

### 🌟 الرؤية (Vision):

> "أن نكون النظام الأول والأشمل لإدارة موارد المؤسسات في المنطقة العربية، مع التركيز على السهولة والكفاءة والابتكار"

### 🎯 الرسالة (Mission):

> "نوفر حلول ERP متكاملة وسهلة الاستخدام تساعد الشركات على إدارة عملياتها بكفاءة أعلى، مع دعم كامل للغة العربية ومعايير الجودة العالمية"

### 💎 القيم الأساسية:

```
✨ الجودة أولاً - Quality First
🚀 الابتكار المستمر - Continuous Innovation
👥 محورية العميل - Customer-Centric
🔒 الأمان والخصوصية - Security & Privacy
📚 الشفافية والوضوح - Transparency
🌍 الدعم المحلي - Local Support
```

---

## 🎊 نصائح للنجاح مع النظام

### 🏆 10 نصائح ذهبية:

```
1️⃣ ابدأ صغيراً
   - لا تحاول إدخال كل شيء في اليوم الأول
   - ابدأ بالبيانات الأساسية، ثم توسع تدريجياً

2️⃣ درّب فريقك جيداً
   - خصص وقتاً كافياً للتدريب
   - استخدم الأدلة المتوفرة
   - اصنع فيديوهات تدريبية داخلية

3️⃣ راجع التقارير بانتظام
   - لوحة التحكم يومياً
   - تقارير المخزون أسبوعياً
   - التقارير المالية شهرياً

4️⃣ احتفظ بنسخ احتياطية
   - نسخة احتياطية يومية تلقائية
   - نسخة خارجية أسبوعية
   - اختبر استرجاع النسخة شهرياً

5️⃣ راقب الصلاحيات
   - راجع تقرير الصلاحيات أسبوعياً
   - تصرف فوراً في المنتجات القريبة من الانتهاء
   - وثق جميع الخسائر

6️⃣ استخدم الفلاتر
   - في التقارير الكبيرة، استخدم فلاتر الفترة
   - لا تحمّل بيانات أكثر من اللازم
   - صدّر التقارير المهمة

7️⃣ تواصل مع الدعم
   - لا تتردد في طلب المساعدة
   - اقترح تحسينات
   - أبلغ عن أي مشاكل فوراً

8️⃣ حدّث بياناتك
   - راجع بيانات العملاء والموردين
   - حدّث الأسعار بانتظام
   - نظف البيانات المكررة

9️⃣ استفد من الأتمتة
   - استخدم الرسائل السريعة
   - فعّل التنبيهات التلقائية
   - استخدم القوالب الجاهزة

🔟 ابقَ محدّثاً
   - تابع التحديثات الجديدة
   - اقرأ ملاحظات الإصدار
   - جرّب الميزات الجديدة
```

---

## 📞 تواصل معنا

### 🌐 قنوات التواصل:

```
📧 البريد الإلكتروني:
   support@mobtakeraraby.com
   sales@mobtakeraraby.com
   info@mobtakeraraby.com

📱 الهاتف:
   الدعم الفني: [رقم الدعم]
   المبيعات: [رقم المبيعات]
   التدريب: [رقم التدريب]

🌐 الموقع الإلكتروني:
   https://mobtakeraraby.com

💬 وسائل التواصل:
   Facebook: /AdlyERP
   Twitter: @AdlyERP
   LinkedIn: /company/mobtakeraraby

📍 العنوان:
   [يُحدد حسب المكتب]
```

---

## ✅ قائمة المراجعة النهائية

### 🎯 قبل البدء، تأكد من:

```
☐ قرأت دليل البدء السريع
☐ فهمت المصطلحات الأساسية
☐ أنشأت المستخدمين الأوليين
☐ أدخلت البيانات الأساسية (منتجات، عملاء، موردين)
☐ أدخلت الأرصدة الافتتاحية
☐ جربت إنشاء فاتورة تجريبية
☐ راجعت التقارير الأساسية
☐ فهمت نظام FEFO (إذا كنت تستخدمه)
☐ أعددت WhatsApp (إذا كنت تحتاجه)
☐ درّبت فريقك
☐ جهزت خطة النسخ الاحتياطي
☐ لديك معلومات الاتصال بالدعم
```

---

**🎉 مبروك! أنت الآن جاهز لاستخدام نظام Adly ERP بكفاءة عالية!**

---

**استمتع بالنظام وحقق أهدافك!** 🚀

---

**آخر تحديث:** 25 يناير 2026  
**الإصدار:** v2.0 - الإصدار الشامل  
**الحالة:** ✅ مكتمل وجاهز للإنتاج  
**عدد الصفحات:** 1000+ سطر  
**عدد الأقسام:** 50+ قسم  
**اللغات:** عربي 100%  

---

## 📚 الملفات المرجعية السريعة

| الفئة | الملفات | الوقت المقدر |
|------|--------|--------------|
| **🚀 البدء السريع** | QUICK_START.md, README.md | 25 دقيقة |
| **📦 المخزون** | EXPIRY_TRACKING_GUIDE.md, ITEM_MOVEMENT_REPORT.md | 55 دقيقة |
| **📊 التقارير** | REPORTS_IMPLEMENTATION.md, EXPORT_SYSTEM_COMPLETE.md | 45 دقيقة |
| **📱 WhatsApp** | WHATSAPP_GATEWAY_GUIDE.md, WHATSAPP_QUICK_MESSAGES_GUIDE.md | 55 دقيقة |
| **💰 المحاسبة** | DOUBLE_ENTRY_ACCOUNTING_PLAN.md | 60 دقيقة |
| **🏢 Multi-Tenancy** | MULTI_TENANCY_COMPLETE_GUIDE.md | 90 دقيقة |
| **🔧 التقني** | IMPLEMENTATION_CHECKLIST.md, PRODUCTION_CHECKLIST.md | 35 دقيقة |

**📖 إجمالي وقت القراءة الكامل:** ~6 ساعات  
**⚡ البدء السريع فقط:** 5 دقائق

---

<div align="center">

### 🌟 شكراً لاستخدامك نظام Adly ERP 🌟

**نحن هنا لدعمك في كل خطوة** 💪

**للدعم:** support@mobtakeraraby.com 📧  
**للمبيعات:** sales@mobtakeraraby.com 💼  
**للتدريب:** training@mobtakeraraby.com 🎓

---

## 🏢 المقاول والتصميم

### 📋 بيانات المشروع

**نظام Almobtaker ERP** - نظام إدارة موارد المؤسسات الشامل  
تم التصميم والتطوير بواسطة:

#### 🎨 **شركة المبتكر العربي للبرمجيات**
> المبتكر العربي هي شركة رائدة في مجال تطوير البرمجيات، تقدم حلولاً مبتكرة ومخصصة للشركات في المنطقة العربية، مع التركيز على الجودة والابتكار وخدمة العملاء.

**المستشار الفني والمصمم الرئيسي:**
- 👨‍💼 **د. جابر محمد الشيمي**
- 📱 **الهاتف:** 01013688446
- 🏢 **الشركة:** شركة المبتكر العربي للبرمجيات

---

### 🔧 المعلومات التقنية

**الإصدار:** v2.0 - الإصدار الشامل  
**تاريخ الإنتاج:** 2026  
**الحالة:** ✅ مكتمل وجاهز للإنتاج  
**آخر تحديث:** 28 فبراير 2026  

**البيئة التقنية:**
- 🐘 **Laravel 12** - إطار العمل الرئيسي
- 🎨 **Filament v4** - واجهة المستخدم
- 💾 **MySQL 8.0+** - قاعدة البيانات
- ⚡ **PHP 8.2+** - لغة البرمجة

### 📞 للتواصل والدعم

```
👤 المشرف الفني:
   د. جابر محمد الشيمي
   📱 01013688446

🏢 الشركة المطورة:
   شركة المبتكر العربي للبرمجيات

📧 البريد الإلكتروني:
   gabershemy@gmail.com
   mobtakeraraby.com

🌐 الموقع الإلكتروني:
   https://mobtakeraraby.com

💬 وسائل التواصل الأخرى:
   Facebook: /AdlyERP
   LinkedIn: /company/mobtakeraraby
```

---

### ⚖️ الحقوق والرخصة

**© 2026 Adly ERP System. جميع الحقوق محفوظة.**

**الملكية الفكرية:**
- جميع أكوام البرنامج والتصاميم ملك حصري لشركة المبتكر العربي للبرمجيات
- يُمنع النقل أو الاستنساخ دون إذن كتابي
- يُمنع تعديل أو توزيع البرنامج الأصلي

**الترخيص:**
- هذا النظام مرخص للاستخدام وفقاً لشروط الترخيص المتفق عليها
- لا يجوز استخدام النظام لأغراض تجارية دون ترخيص

**المسؤولية:**
- توفير الدعم الفني محدود بفترة الصيانة المتفق عليها
- الشركة غير مسؤولة عن فقدان البيانات الناتج عن سوء الاستخدام
- يُنصح بعمل نسخ احتياطية دورية

---

### 🙏 شكر خاص

شكراً لجميع المختبرين والمستخدمين الأوائل الذين ساهموا في تحسين وتطوير هذا النظام.

**نسأل الله أن يكون هذا النظام أداة مفيدة لإدارة أعمالك بكفاءة وميسّر لك النجاح والازدهار.**

---

*Powered by Laravel 12 & Filament v4*  
**Made with ❤️ by Al-Mobtaker Al-Arabi for Software Solutions**

</div>