💈 نظام إدارة محل الحلاقة الرجالية

Barbershop Management System

نظام إدارة متكامل لمحلات الحلاقة الرجالية

الميزات • التنصيب • الاستخدام • الدعم

---

📖 نظرة عامة

نظام احترافي متكامل لإدارة محلات الحلاقة الرجالية، مصمم خصيصاً للسوق السعودي. يوفر النظام جميع الأدوات اللازمة لإدارة المواعيد، العملاء، الحلاقين، والتقارير المالية بشكل سهل وفعّال.

🎯 لماذا هذا النظام؟

• ✅ محلي بالكامل - لا يحتاج إنترنت للعمل
• ✅ سهل الاستخدام - واجهة عربية بديهية
• ✅ احترافي - تصميم عصري وجذاب
• ✅ شامل - جميع الميزات في مكان واحد
• ✅ آمن - بياناتك محمية محلياً
• ✅ سريع - أداء ممتاز حتى مع آلاف السجلات

---

✨ الميزات

📅 إدارة المواعيد

• حجز وتعديل وإلغاء المواعيد
• جدول مواعيد يومي/أسبوعي/شهري
• تنبيهات تلقائية للمواعيد القادمة
• قائمة انتظار للعملاء

👥 إدارة العملاء

• قاعدة بيانات شاملة للعملاء
• سجل كامل لزيارات كل عميل
• نظام نقاط الولاء (4 مستويات)
• إحصائيات تفصيلية لكل عميل

✂️ إدارة الحلاقين

• متابعة أداء كل حلاق
• حساب العمولات تلقائياً
• تقييمات العملاء
• جدول عمل مرن

💈 إدارة الخدمات

• 22 خدمة جاهزة ومحملة مسبقاً
• إضافة وتعديل الخدمات
• تحديد السعر والمدة لكل خدمة
• تصنيفات متعددة

📊 التقارير والإحصائيات

• تقارير يومية وشهرية
• تقارير الحلاقين والعمولات
• تقارير العملاء والخدمات
• رسوم بيانية تفاعلية

💰 إدارة مالية

• تتبع الإيرادات والأرباح
• حساب العمولات تلقائياً
• تقارير ضريبية جاهزة
• تصدير Excel وPDF

📱 رسائل واتساب

• تأكيد المواعيد تلقائياً
• تذكير قبل الموعد
• رسائل شكر بعد الزيارة
• حملات تسويقية

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

• تصميم عصري واحترافي
• شعار المحل
• رمز QR للدفع
• إرسال عبر واتساب

🔒 الأمان

• نظام مستخدمين (4 مستويات)
• تشفير كلمات المرور
• سجل نشاطات كامل
• نسخ احتياطي تلقائي

---

🚀 التنصيب السريع

المتطلبات:

• Windows 10/11 أو Linux أو MacOS
• Python 3.8 أو أحدث
• 100 MB مساحة فارغة

خطوات التنصيب:

1️⃣ تنزيل Python (إذا لم يكن مثبتاً):

# تحقق من وجود Python
python --version

# إذا لم يكن موجوداً، نزّله من:
# https://www.python.org/downloads/

2️⃣ تنزيل النظام:

# طريقة 1: باستخدام git
git clone https://github.com/yourusername/barbershop-system.git
cd barbershop-system

# طريقة 2: تحميل مباشر
# نزّل الملف المضغوط وفك ضغطه

3️⃣ تنصيب المكتبات:

# إنشاء بيئة افتراضية (اختياري لكن مستحسن)
python -m venv venv

# تفعيل البيئة الافتراضية
# في Windows:
venv\Scripts\activate

# في Linux/Mac:
source venv/bin/activate

# تنصيب المكتبات المطلوبة
pip install -r requirements.txt

4️⃣ تشغيل النظام:

python barbershop.py

🎉 مبروك! النظام جاهز للاستخدام!

---

📚 الاستخدام

الإعداد الأولي:

1. معلومات المحل:

• افتح: الإعدادات > معلومات المحل
• أدخل: اسم المحل، العنوان، الجوال، البريد
• احفظ التغييرات

2. إضافة الحلاقين:

• افتح: الحلاقين > + حلاق جديد
• أدخل: الاسم، الجوال، نسبة العمولة
• حدد أيام وساعات العمل
• احفظ

3. مراجعة الخدمات:

• افتح: الخدمات
• راجع قائمة الخدمات المحملة مسبقاً
• عدّل الأسعار حسب احتياجك
• أضف خدمات جديدة إذا لزم الأمر

الاستخدام اليومي:

حجز موعد جديد:

1. اضغط Ctrl+N أو زر "موعد جديد"
2. أدخل اسم العميل والجوال
3. اختر الحلاق المطلوب
4. اختر الخدمة
5. حدد التاريخ والوقت
6. احفظ الموعد

جلسة سريعة (عميل بدون موعد):

1. اضغط Ctrl+Q أو زر "جلسة فورية"
2. أدخل البيانات الأساسية
3. اختر الحلاق والخدمة
4. ابدأ الجلسة
5. عند الانتهاء: أنهِ واحفظ

عرض التقارير:

1. اضغط Ctrl+R أو زر "التقارير"
2. اختر نوع التقرير المطلوب
3. حدد الفترة الزمنية
4. عرض أو تصدير أو طباعة

---

⌨️ اختصارات لوحة المفاتيح

الاختصار	الوظيفة
Ctrl+N	موعد جديد
Ctrl+Q	جلسة سريعة
Ctrl+C	إدارة العملاء
Ctrl+B	إدارة الحلاقين
Ctrl+M	إدارة الخدمات
Ctrl+R	التقارير
Ctrl+D	لوحة التحكم
Ctrl+P	طباعة
Ctrl+E	تصدير
Ctrl+W	قائمة الانتظار
F5	تحديث
F1	المساعدة
F11	ملء الشاشة
Escape	إغلاق النافذة الحالية

---

📁 هيكل المشروع

BarbershopSystem/
│
├── barbershop.py              # الملف الرئيسي
├── requirements.txt           # المكتبات المطلوبة
├── README.md                  # هذا الملف
├── config.json               # ملف الإعدادات
│
├── database/
│   └── barbershop.db         # قاعدة البيانات
│
├── backups/                  # النسخ الاحتياطية
│   └── ...
│
├── exports/                  # الملفات المصدرة
│   └── ...
│
├── invoices/                 # الفواتير
│   └── ...
│
├── assets/                   # الموارد
│   ├── logo.png
│   ├── icon.ico
│   └── templates/
│
└── logs/                     # السجلات
    └── ...

---

🔧 الإعدادات المتقدمة

تخصيص الألوان:

عدّل ملف config.json:

{
  "colors": {
    "primary": "#1a3a52",
    "secondary": "#2d5270",
    "accent": "#d4af37"
  }
}

تخصيص الخطوط:

{
  "fonts": {
    "family": "Cairo",
    "title_size": 16,
    "body_size": 11
  }
}

إعدادات نقاط الولاء:

{
  "loyalty": {
    "points_per_riyal": 0.1,
    "riyal_per_points": 0.5,
    "expiry_months": 12
  }
}

---

📊 الإحصائيات الفنية

📝 عدد الأسطر: ~3,500+ سطر
📦 حجم الملف: ~150 KB
🗂️ عدد الجداول: 6 جداول
⚙️ عدد الدوال: 180+ دالة
🪟 عدد النوافذ: 20+ نافذة
📊 عدد التقارير: 10+ تقرير

---

❓ الأسئلة الشائعة

هل يحتاج النظام إنترنت؟

لا! النظام يعمل محلياً بالكامل. الإنترنت مطلوب فقط لـ:

• إرسال رسائل واتساب
• النسخ السحابي (اختياري)
• التحديثات (اختياري)

هل يدعم أكثر من فرع؟

نعم في النسخة الاحترافية!

هل يمكن تخصيص الخدمات؟

بالتأكيد! يمكنك إضافة وتعديل وحذف الخدمات كما تريد.

كيف يتم حساب العمولات؟

نسبة مئوية من سعر كل خدمة، قابلة للتخصيص لكل حلاق ولكل خدمة.

ماذا عن أمان البيانات؟

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

---

🛠️ حل المشاكل

المشكلة: النظام لا يبدأ

# تحقق من تنصيب Python
python --version

# تحقق من تنصيب المكتبات
pip list

# أعد تنصيب المكتبات
pip install -r requirements.txt --upgrade

المشكلة: خطأ في قاعدة البيانات

# استعد نسخة احتياطية
# افتح النظام > نسخ احتياطي > استعادة

# أو يدوياً:
# انسخ ملف من مجلد backups/ إلى database/

المشكلة: الخطوط غير واضحة

# نزّل وثبّت خط Cairo:
# https://fonts.google.com/specimen/Cairo

# ثم أعد تشغيل النظام

---

📞 الدعم

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

1. راجع دليل المستخدم (F1 داخل النظام)
2. تحقق من سجل الأخطاء في logs/errors.log
3. استعد نسخة احتياطية
4. أعد تشغيل النظام

للدعم الفني:

• 📧 البريد: support@example.com
• 📱 واتساب: +966 XX XXX XXXX
• 🌐 الموقع: www.example.com

---

🔄 التحديثات

الإصدار الحالي: v1.0.0

آخر التحديثات:

• ✅ إطلاق النسخة الأولى
• ✅ نظام المواعيد الكامل
• ✅ إدارة العملاء والحلاقين
• ✅ التقارير والإحصائيات
• ✅ نقاط الولاء
• ✅ رسائل واتساب

قريباً:

• 🔜 تطبيق موبايل
• 🔜 نسخة سحابية
• 🔜 API للتكامل
• 🔜 لوحة تحكم ويب

---

📄 الترخيص

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

للحصول على ترخيص استخدام، يرجى التواصل معنا.

---

🙏 شكر وتقدير

تم تطوير هذا النظام بعناية فائقة ليلبي احتياجات أصحاب محلات الحلاقة في السوق السعودي.

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

---

🌟 تقييمك يهمنا!

إذا أعجبك النظام، لا تنسَ:

• ⭐ إضافة نجمة على GitHub
• 📢 نشر تجربتك
• 💬 اقتراح تحسينات

---

صُنع بـ ❤️ في المملكة العربية السعودية

💈 نظام إدارة محل الحلاقة - النسخة الاحترافية 💈

الموقع • التوثيق • الدعم