# دليل التشغيل الكامل

نظام إدارة متجر الاتصالات والخطوط

هذا الملف يشرح طريقة العمل على السيستم من أول يوم حتى التحصيل اليومي والإقفال والتقارير.

اللغة الافتراضية للعربية. يمكنك التبديل إلى الإنجليزية من الشريط العلوي في أي وقت، والواجهة تتحول تلقائياً من اليمين لليسار والعكس.

---

# 1. الفكرة العامة للسيستم

السيستم يدير محل اتصالات / خطوط موبايل، وليس مجرد شاشة بيع.

الترتيب الطبيعي للشغل:

1. تثبيت السيستم وإنشاء حساب المدير
2. ضبط بيانات المحل من الإعدادات
3. إضافة شركات الاتصالات
4. إضافة الباقات وأسعارها
5. إضافة الخطوط المتاحة في المخزن
6. إنشاء العملاء والحسابات عند الحاجة
7. بيع الخط للعميل
8. تحصيل الاشتراك الشهري شهر بشهر أو عدة أشهر مرة واحدة
9. متابعة المتأخرات
10. إدارة درج النقدية وإقفال اليوم
11. التقارير والنسخ الاحتياطي والتحديثات

مهم جداً:

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

---

# 2. التثبيت لأول مرة

1. ارفع ملفات المشروع على السيرفر أو شغّله من Laragon.
2. أنشئ قاعدة بيانات MySQL، مثلاً: `telecom_store`
3. افتح من المتصفح:

```
/install
```

مثال محلي:

```
http://esim.test/install
```

4. أكمل خطوات المعالج بالترتيب:

- الترحيب
- فحص متطلبات السيرفر وإضافات PHP
- صلاحيات المجلدات
- بيانات قاعدة البيانات واختبار الاتصال
- بيانات التطبيق (اسم الشركة، الرابط، اللغة، المنطقة الزمنية)
- إنشاء حساب المدير
- تشغيل الجداول والبيانات الأساسية

5. بعد النجاح ادخل من شاشة تسجيل الدخول بنفس إيميل وكلمة مرور المدير.

ملاحظات التثبيت:

- التثبيت يشغّل ترحيل الجداول العادي، ولا يمسح قاعدة البيانات.
- إذا كانت القاعدة فيها جداول السيستم بالفعل، سيطلب منك تأكيد أنك لا تريد حذف البيانات.
- بعد التثبيت لا يمكن فتح `/install` مرة أخرى.

---

# 3. تسجيل الدخول واللغة والصلاحيات

## تسجيل الدخول

ادخل بالإيميل وكلمة المرور. إذا كان الحساب غير نشط لن يتم الدخول.

## تغيير اللغة

من الشريط العلوي اختر:

- العربية
- English

اللغة تُحفظ على المستخدم وتعمل على كل الشاشات.

## الأدوار الجاهزة

| الدور | الشغل المتوقع |
|---|---|
| Administrator | كل الصلاحيات |
| Manager | إدارة التشغيل اليومي بدون تحديثات النظام غالباً |
| Cashier | التحصيل والفوترة ودرج النقدية |
| Sales Employee | بيع الخطوط والعملاء |
| Accountant | التحصيل والفواتير والتقارير |
| Viewer | مشاهدة فقط بدون إضافة أو تعديل |

إذا ظهرت رسالة 403 فالسبب أن الدور الحالي لا يملك صلاحية هذه الشاشة.

---

# 4. أول إعداد بعد الدخول

ادخل **الإعدادات** وأكمل بيانات المحل:

- اسم الشركة
- الشعار
- العنوان والهاتف والإيميل
- العملة
- نسبة الضريبة
- بادئة الفاتورة مثل `INV`
- اللغة الافتراضية
- طريقة الدفع الافتراضية
- نوع الطابعة: A4 أو حراري
- تنسيق التاريخ
- المنطقة الزمنية، مثل `Africa/Cairo`
- عدد أيام الاحتفاظ بالنسخ الاحتياطي
- تذييل الفاتورة

احفظ. هذه البيانات تظهر في الفواتير والتقارير ولوحة التحكم.

---

# 5. تجهيز بيانات التشغيل

لا تبدأ البيع قبل هذه الخطوات.

## 5.1 شركات الاتصالات

القائمة: **شركات الاتصالات** ← **إضافة**

أدخل:

- الاسم
- الرمز
- الهاتف / الإيميل / جهة الاتصال
- العنوان
- الحالة: نشط
- ملاحظات

لا تكتب أسماء الشركات داخل الكود. كل شركة تُضاف من هنا، ويمكن إضافة أكثر من شركة.

## 5.2 الباقات

القائمة: **الباقات** ← **إضافة**

أدخل:

- اسم الباقة
- شركة الاتصالات
- نوع الباقة: مسبق الدفع / لاحق الدفع / بيانات / مكالمات / باقة شاملة
- السعر الحالي
- دورة الفوترة: شهري عادة
- تاريخ البداية والنهاية إن وجد
- الحالة: نشط

السعر قابل للتعديل لاحقاً، لكن الفواتير القديمة تحتفظ بالسعر وقت التحصيل.

## 5.3 الخطوط

القائمة: **الخطوط** ← **إضافة**

أدخل:

- رقم الهاتف
- ICCID
- الرقم التسلسلي للشريحة
- شركة الاتصالات
- نوع الشريحة: شريحة فعلية أو eSIM
- سعر بيع الخط
- ملاحظات

الخط الجديد حالته **متاح**. هذا هو المخزن الذي ستبيع منه.

حالات الخط:

- متاح: جاهز للبيع
- محجوز
- مباع
- نشط: تم بيعه وغالباً عليه باقة
- معلق
- ملغى
- مرتجع

## 5.4 الحسابات الرئيسية والفرعية

تستخدم للشركات أو العملاء الذين لديهم أكثر من خط.

مثال:

- حساب رئيسي: شركة النور
- حسابات فرعية: فرع القاهرة، فرع الإسكندرية
- تحت كل حساب عدة خطوط

القائمة:

- **الحسابات الرئيسية**
- **الحسابات الفرعية**

الحساب الفرعي مرتبط دائماً بحساب رئيسي.

من صفحة الحساب تظهر:

- العملاء المرتبطون
- الخطوط
- الفواتير
- المبلغ المستحق

## 5.5 العملاء

القائمة: **العملاء** ← **إضافة**

أدخل:

- الاسم
- الهاتف
- الرقم القومي
- العنوان
- الإيميل
- نوع العميل: فرد أو شركة
- الحساب الرئيسي والحساب الفرعي إن وجد
- الحالة
- ملاحظات

يمكن البحث بالاسم أو الهاتف أو الرقم القومي أو الحساب.

من ملف العميل تظهر خطوطه وفواتيره وتحصيلاته والمستحق وآخر فاتورة وآخر دفعة.

يمكن أيضاً إنشاء العميل أثناء عملية البيع مباشرة دون الدخول لشاشة العملاء أولاً.

---

# 6. يوم العمل المعتاد

هذا هو الترتيب العملي داخل المحل.

## الصباح

1. تسجيل الدخول
2. فتح **درج النقدية** وإدخال الرصيد الافتتاحي إن لم يفتح تلقائياً
3. مراجعة لوحة التحكم: الخطوط المتاحة، مبيعات اليوم، التحصيلات، النقدية، المتأخرات

## أثناء اليوم

- بيع خطوط جديدة
- تحصيل اشتراكات شهرية
- مراجعة المتأخرات
- تسجيل المصروفات والوارد والصادر النقدي

## آخر اليوم

1. مراجعة درج النقدية
2. إدخال النقد الفعلي
3. إقفال اليوم
4. طباعة أو تصدير التقارير إن لزم

---

# 7. بيع خط

القائمة: **المبيعات** ← **إضافة**

## الطريقة

1. اختر عميلاً حالياً من القائمة، أو اتركه وأدخل اسم ورقم عميل جديد.
2. اختر خطاً حالته **متاح**.
3. اختر باقة، أو اتركها **بدون باقة** إذا كان البيع خطاً فقط.
4. راجع:

- سعر الخط
- سعر الباقة
- الخصم
- الضريبة
- المبلغ المدفوع
- طريقة الدفع: نقداً / فيزا / تحويل بنكي / محفظة / أخرى
- تاريخ البيع
- تاريخ التفعيل

5. اضغط **حفظ**.

## ماذا يحدث داخل السيستم تلقائياً

- إنشاء عملية بيع
- إنشاء فاتورة
- تسجيل دفعة إذا كان هناك مبلغ مدفوع
- تسجيل حركة في درج النقدية
- ربط الخط بالعميل والحساب
- ربط الباقة إن وجدت
- تغيير حالة الخط إلى **نشط** إذا وُجدت باقة، أو **مباع** إذا بيع بدون باقة
- حفظ سجل الملكية
- كتابة حركة في سجل التدقيق

## قاعدة مهمة

إذا ظهرت رسالة أن الخط غير متاح، فهذا يعني أن حالته ليست **متاح**. لا يمكن بيع خط مباع أو نشط أو ملغى إلا بعد إرجاعه للمخزن أولاً.

بعد الحفظ افتح عملية البيع ثم افتح الفاتورة للطباعة A4 أو الحراري أو PDF.

---

# 8. التحصيل الشهري

هذه أهم شاشة بعد البيع.

القائمة: **الفوترة**

## البحث

ابحث بأي من:

- رقم الهاتف
- اسم العميل
- الرقم القومي
- الحساب الرئيسي
- الحساب الفرعي

## ماذا تظهر الشاشة

- رقم الخط
- اسم العميل
- الرقم القومي
- الحساب الرئيسي والفرعي
- الباقة الحالية وسعرها الحالي
- آخر فاتورة
- آخر دفعة
- **مسدد حتى** شهر معين
- الشهور غير المسددة
- المبلغ المستحق

مثال:

العميل سدد يناير وفبراير ومارس وأبريل.

الشاشة تعرض:

- مسدد حتى أبريل
- المستحق: مايو، يونيو، يوليو...

## تحصيل شهر واحد أو عدة شهور

1. علّم الشهور المطلوب تحصيلها
2. اختر طريقة الدفع
3. أدخل خصماً إن وجد
4. اضغط **تحصيل**

السيستم يحسب سعر كل شهر حسب سعر الباقة في ذلك الشهر.

مثال:

- يوليو = 100
- أغسطس = 120
- الإجمالي = 220

بعد التحصيل:

- الشهران يصبحان مسددين
- تُنشأ فاتورة
- تُسجل دفعة
- يُوزع المبلغ على الشهور
- تُسجل حركة نقدية
- يتحدث **مسدد حتى**

## قواعد التحصيل

- لا يمكن سداد نفس الشهر مرتين لنفس الخط
- سعر الشهر يُحفظ وقت التحصيل ولا يتغير إذا تغيّر سعر الباقة لاحقاً
- يمكن تحصيل أكثر من شهر في عملية واحدة

---

# 9. الفواتير والتحصيلات

## الفواتير

القائمة: **الفواتير**

أنواع الفاتورة:

- بيع خط
- فوترة شهرية
- تسوية

حالات الفاتورة:

- نشطة
- مدفوعة
- مدفوعة جزئياً
- ملغاة
- باطلة

من صفحة الفاتورة يمكن:

- طباعة A4
- طباعة حراري
- تنزيل PDF
- تسجيل دفعة على المتبقي
- إلغاء الفاتورة مع كتابة السبب

مهم:

لا تُحذف الفاتورة. إذا حصل خطأ، ألغِ القديمة واكتب السبب ثم أنشئ فاتورة صحيحة.

كل بند في الفاتورة يحفظ السعر المستخدم وقتها. لذلك يوليو يبقى 100 حتى لو أصبحت الباقة 150 بعد ذلك.

## التحصيلات

القائمة: **التحصيلات**

كل دفعة لها رقم، عميل، مبلغ، طريقة دفع، وتوزيع على الشهور أو الفاتورة.

---

# 10. المتأخرات

القائمة: **المتأخرات**

استخدمها لمعرفة من لم يسدد شهراً معيناً.

التصفية حسب:

- السنة
- الشهر
- شركة الاتصالات
- الباقة
- الحساب الرئيسي
- الحساب الفرعي
- العميل
- الخط

الجدول يعرض:

- الخط
- العميل
- الرقم القومي
- الحساب
- الباقة
- المبلغ الشهري
- آخر فترة مسددة
- عدد الأشهر المتأخرة
- إجمالي المستحق

يمكن البحث والتصفية والتصدير والطباعة.

مثال عملي:

اختر السنة 2026 والشهر 7 لمعرفة كل الخطوط التي لم تسدد يوليو 2026.

---

# 11. درج النقدية وإقفال اليوم

## درج النقدية

القائمة: **درج النقدية**

تعرض الشاشة:

- الرصيد الافتتاحي
- المبيعات
- التحصيلات
- المصروفات
- المرتجعات
- الوارد النقدي
- الصادر النقدي
- الرصيد المتوقع
- النقد الفعلي
- الفرق

طرق الدفع الموجودة في السيستم:

- نقداً
- فيزا
- تحويل بنكي
- محفظة
- أخرى

البيع والتحصيل النقدي يظهران في الدرج. أول حركة مالية يمكن أن تفتح الدرج تلقائياً إذا لم يكن مفتوحاً، أو افتحه يدوياً وأدخل الرصيد الافتتاحي.

من نفس الشاشة يمكن:

- تسجيل مصروف
- تسجيل وارد نقدي أو صادر نقدي

## إقفال اليوم

في آخر اليوم:

1. افتح درج النقدية
2. راجع الرصيد المتوقع
3. عدّ النقد الفعلي في الدرج
4. أدخل النقد الفعلي والملاحظات
5. اضغط **إقفال اليوم**

بعد الإقفال:

- يُحفظ تقرير اليوم في **الإقفال اليومي**
- يظهر الفرق بين المتوقع والفعلي
- حركات هذا الدرج المغلق لا تُعدل
- اليوم التالي يُفتح درج جديد

---

# 12. لوحة التحكم والبحث

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

تعرض ملخص المحل:

- إجمالي الخطوط
- المتاح / المباع / النشط / المعلق / الملغى
- عدد العملاء
- مبيعات اليوم
- تحصيلات اليوم
- مصروفات اليوم
- الرصيد النقدي الحالي
- المستحق
- المتأخرات
- إيرادات الشهر
- تحصيلات الشهر
- رسم بياني للمبيعات والتحصيلات

## البحث العام

من أعلى الصفحة أو قائمة **بحث** يمكن البحث بـ:

- رقم الهاتف
- اسم العميل
- الرقم القومي
- رقم الفاتورة
- ICCID
- الحساب الرئيسي
- الحساب الفرعي

---

# 13. التقارير

القائمة: **التقارير**

التقارير المتاحة:

- المبيعات
- التحصيلات
- الفواتير
- الخطوط
- الخطوط المتاحة
- الخطوط المباعة
- العملاء
- المتأخرات
- الإقفال اليومي

كل تقرير يمكن تصفيته حسب التاريخ والشركة والعميل والخط والباقة وطريقة الدفع حسب نوع التقرير.

يمكن:

- عرض على الشاشة
- طباعة
- PDF
- إكسل / CSV

---

# 14. نقل الخط وإرجاعه وتغيير سعر الباقة

## نقل ملكية الخط

افتح صفحة الخط ثم **نقل الخط**:

- اختر العميل الجديد
- اكتب السبب
- احفظ

الخط ينتقل للعميل الجديد، ويبقى سجل العميل السابق موجوداً في **سجل الملكية**.

## إرجاع الخط للمخزن

من صفحة الخط اختر **إرجاع الخط** وحدد:

- السبب
- الحالة الجديدة: **متاح** أو **مرتجع**

السجل القديم لا يُحذف. الخط يمكن بيعه لاحقاً إذا أُرجع إلى حالة متاح.

## تغيير سعر الباقة

افتح الباقة ← **تعديل**:

- غيّر السعر
- حدد تاريخ السريان
- اكتب سبب التغيير

النتيجة:

- السعر الجديد يُستخدم من تاريخ السريان فصاعداً
- الفواتير القديمة تبقى بنفس أسعارها
- يوليو الذي تحصّل بـ 100 يبقى 100 حتى لو أصبح السعر 150

---

# 15. المستخدمون والصلاحيات وسجل التدقيق

## المستخدمون

القائمة: **المستخدمون**

أضف موظفاً بالاسم والإيميل وكلمة المرور واللغة والدور والحالة.

لا تحذف المستخدمين الذين لهم حركات مالية. عطّل الحساب بدلاً من الحذف.

## الأدوار والصلاحيات

القائمة: **الأدوار**

يمكن تعديل صلاحيات الأدوار ما عدا المدير العام.

أمثلة صلاحيات:

- مشاهدة العملاء / إضافة / تعديل
- بيع الخطوط / نقل / إلغاء
- الفوترة والتحصيل
- طباعة أو إلغاء الفاتورة
- إدارة وإقفال الدرج
- التقارير والتصدير
- الإعدادات والتحديثات والنسخ الاحتياطي

## سجل التدقيق

القائمة: **سجل التدقيق**

يسجل العمليات المهمة مثل:

- بيع خط
- تحصيل يوليو وأغسطس
- تغيير سعر باقة
- إلغاء فاتورة
- نقل ملكية خط
- تغيير حالة خط

كل حركة تحفظ المستخدم والوقت والجهاز والقيم القديمة والجديدة.

---

# 16. النسخ الاحتياطي والتحديث وصحة النظام

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

القائمة: **النسخ الاحتياطي**

- إنشاء نسخة من قاعدة البيانات
- تنزيل النسخة
- حذف النسخ القديمة حسب مدة الاحتفاظ في الإعدادات

الملفات ليست متاحة للعامة. احفظ نسخة خارج السيرفر أيضاً.

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

القائمة: **تحديث النظام** أو الرابط:

```
/admin/system/update
```

الشاشة تعرض الإصدار الحالي وأحدث إصدار وحالة الترحيلات وسجل التحديثات.

عند التحديث:

1. تُنشأ نسخة احتياطية
2. يدخل السيستم وضع الصيانة
3. تُطبَّق الملفات الجديدة إن وُجدت حزمة
4. تُشغَّل ترحيلات قاعدة البيانات بدون حذف البيانات
5. تُمسح الكاش
6. يُحدَّث رقم الإصدار
7. تُوقف الصيانة

التحديث لا يستخدم حذف الجداول، ولا يمسح العملاء أو الخطوط أو الفواتير.

## صحة النظام

القائمة: **صحة النظام**

تعرض إصدار PHP وLaravel واتصال القاعدة وصلاحيات التخزين والكاش والإصدار الحالي ومساحة القرص.

---

# 17. سيناريو شغل كامل من الألف للياء

نفّذ هذا الترتيب مرة واحدة بعد التثبيت لتتأكد أن السيستم جاهز.

1. ثبّت السيستم من `/install` وأنشئ المدير.
2. سجل الدخول.
3. اختر العربية أو الإنجليزية.
4. اضبط الإعدادات.
5. أضف شركة اتصالات.
6. أضف باقة بسعر 100 مثلاً.
7. أضف خطاً حالته متاح.
8. أضف عميلاً أو أدخله أثناء البيع.
9. بع الخط مع الباقة.
10. راجع الفاتورة وطبعها.
11. تأكد أن المبلغ ظهر في درج النقدية.
12. افتح الفوترة وابحث برقم الخط.
13. راجع سجل السداد و**مسدد حتى**.
14. اختر شهرين غير مسددين.
15. حصّل المبلغ.
16. راجع فاتورة التحصيل.
17. تأكد أن **مسدد حتى** تحدث.
18. افتح المتأخرات وصفِّ حسب الشهر.
19. راجع إجماليات درج النقدية.
20. أدخل النقد الفعلي وأقفل اليوم.
21. افتح التقارير.
22. غيّر سعر الباقة إلى 150.
23. افتح فاتورة قديمة وتأكد أن سعرها لم يتغير.
24. انقل الخط أو أرجعه، ثم راجع سجل الملكية.
25. أنشئ نسخة احتياطية.
26. عند صدور نسخة جديدة حدّث السيستم بدون حذف البيانات.

---

# 18. قواعد لا تكسرها أثناء الشغل اليومي

1. لا تبع خطاً إلا إذا كان **متاح**.
2. لا تحصّل نفس الشهر مرتين لنفس الخط.
3. لا تعدّل سعر باقة وتتوقع أن الفواتير القديمة تتغير. لن تتغير.
4. لا تحذف فاتورة أو دفعة أو حركة نقدية. ألغِ أو عطّل مع السبب.
5. كل دفعة لازم يكون لها توزيع.
6. التحصيل النقدي يظهر في الدرج.
7. أي نقل أو إرجاع للخط لازم سبب، والسجل يبقى.
8. أي حركة مالية مهمة تُسجل في التدقيق.
9. بعد إقفال اليوم لا تعدّل حركات الدرج المغلق.
10. التحديثات تتم بالترحيلات، وليس بمسح قاعدة البيانات.

---

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

**شاشة التثبيت لا تفتح أو تقول إن السيستم مثبت**
معناها التثبيت تم سابقاً. ملف القفل موجود في `storage/installed`.

**لا أستطيع فتح شاشة معينة**
الدور الحالي لا يملك الصلاحية. ادخل بحساب مدير أو عدّل صلاحيات الدور.

**لا يظهر البيع أو التحصيل في الدرج**
افتح الدرج أو نفّذ حركة نقدية بعد فتحه. راجع أن طريقة الدفع نقداً إذا كنت تتابع الكاش.

**رسالة أن الفترة مسددة مسبقاً**
هذا الشهر لهذا الخط تم تحصيله من قبل. راجع الفوترة أو التحصيلات.

**غيّرت سعر الباقة والفواتير القديمة كما هي**
هذا سلوك صحيح. السعر الجديد يسري على الشهور الجديدة فقط.

**بعت خطاً بالخطأ**
لا تحذف العملية. أرجع الخط من شاشة الخط مع كتابة السبب، ثم راجع الفاتورة إذا كانت تحتاج إلغاء وتصحيح.

**العميل لديه أكثر من خط**
اربطه بحساب رئيسي/فرعي، وحصّل كل خط لوحده من شاشة الفوترة برقم الخط.

**الطباعة**
من الفاتورة اختر A4 أو حراري حسب الطابعة المضبوطة في الإعدادات.

---

# 20. ملخص سريع للموظف

| عايز تعمل إيه | ادخل منين |
|---|---|
| تجهيز الشركة والباقات | شركات الاتصالات ثم الباقات |
| إضافة خط للمخزن | الخطوط |
| بيع خط | المبيعات |
| تحصيل شهر أو أكثر | الفوترة |
| معرفة مين متأخر | المتأخرات |
| شوف الكاش | درج النقدية |
| قفل اليوم | درج النقدية ثم الإقفال اليومي |
| طباعة فاتورة | الفواتير |
| تقرير المبيعات أو التحصيل | التقارير |
| نسخة من البيانات | النسخ الاحتياطي |
| تحديث السيستم | تحديث النظام |

الشغل اليومي المختصر:

**بيع من المبيعات، حصّل من الفوترة، راجع المتأخرات، قفل الدرج آخر اليوم.**