# 🖥️ دليل تشغيل تطبيق سطح المكتب

## نظام إدارة المستأجرين - تطبيق سطح المكتب

هذا الدليل يوضح كيفية تشغيل نظام إدارة المستأجرين كتطبيق سطح مكتب مستقل.

---

## 🎯 المميزات

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

---

## 📋 المتطلبات

- **Python 3.8+** (مطلوب)
- **pywebview** (سيتم تثبيته تلقائياً)
- **Flask** (موجود في requirements.txt)

---

## 🚀 طرق التشغيل

### 1️⃣ الطريقة الأسهل (مستحسنة)

#### على Windows:
```cmd
# انقر مرتين على الملف
تشغيل_البرنامج.bat
```

#### على macOS/Linux:
```bash
# انقر مرتين على الملف أو شغله من Terminal
./تشغيل_البرنامج.sh
```

### 2️⃣ التشغيل السريع

#### على Windows:
```cmd
START.bat
```

#### على macOS/Linux:
```bash
./START.sh
```

### 3️⃣ من سطر الأوامر

```bash
# الطريقة الأساسية
python main.py

# أو
python desktop_app.py

# أو المشغل المتقدم
python run_desktop_app.py
```

---

## 🔧 التثبيت والإعداد

### التثبيت التلقائي:
ملفات `.bat` و `.sh` ستقوم بتثبيت كل شيء تلقائياً.

### التثبيت اليدوي:
```bash
# تثبيت المتطلبات الأساسية
pip install -r requirements.txt

# تثبيت مكتبة واجهة سطح المكتب
pip install pywebview

# تشغيل التطبيق
python main.py
```

---

## 🖼️ واجهة التطبيق

عند التشغيل ستحصل على:

- **نافذة مستقلة** بحجم 1200x800 بكسل
- **قابلة لتغيير الحجم** (الحد الأدنى: 800x600)
- **شريط عنوان** يحمل اسم التطبيق
- **أزرار التحكم** العادية (تصغير، تكبير، إغلاق)

---

## 📁 ملفات التشغيل

| الملف | الوصف | الاستخدام |
|-------|--------|-----------|
| `تشغيل_البرنامج.bat` | مشغل كامل Windows | الأفضل للاستخدام اليومي |
| `تشغيل_البرنامج.sh` | مشغل كامل Unix/Linux | الأفضل للاستخدام اليومي |
| `START.bat` | تشغيل سريع Windows | للاستخدام السريع |
| `START.sh` | تشغيل سريع Unix/Linux | للاستخدام السريع |
| `main.py` | ملف التطبيق الرئيسي | للمطورين |
| `desktop_app.py` | تطبيق سطح المكتب | نسخة محسنة |
| `run_desktop_app.py` | مشغل متقدم | مع فحص شامل |

---

## ⚠️ استكشاف الأخطاء

### خطأ: "webview module not found"
```bash
pip install pywebview
```

### خطأ: "Python is not recognized"
- تأكد من تثبيت Python
- أضف Python إلى PATH
- أعد تشغيل Terminal/CMD

### النافذة لا تظهر:
- تأكد من عدم حجب برامج مكافحة الفيروسات
- جرب تشغيل CMD/Terminal كمدير
- تحقق من إعدادات الجدار الناري

### البرنامج بطيء في البدء:
- هذا طبيعي في المرة الأولى
- سيكون أسرع في المرات التالية
- انتظر 3-5 ثوانِ لظهور النافذة

---

## 🎨 التخصيص

### تغيير حجم النافذة:
عدل في `main.py`:
```python
webview.create_window(
    title='نظام إدارة المستأجرين',
    url='http://127.0.0.1:8080',
    width=1400,  # العرض
    height=900,  # الارتفاع
    min_size=(1000, 700)  # الحد الأدنى
)
```

### تغيير عنوان النافذة:
```python
title='اسم مخصص للتطبيق'
```

---

## 🔄 الفرق بين التطبيق والموقع

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

---

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

### ملفات السجلات:
- تحقق من رسائل الخطأ في Terminal/CMD
- ابحث عن ملفات `.log` في مجلد المشروع

### معلومات مفيدة للدعم:
- نظام التشغيل وإصداره
- إصدار Python (`python --version`)
- رسائل الخطأ الكاملة
- الخطوات التي اتبعتها

---

## 🎉 تهانينا!

الآن لديك تطبيق سطح مكتب احترافي لإدارة المستأجرين!

### للاستخدام اليومي:
1. انقر مرتين على `تشغيل_البرنامج.bat` (Windows) أو `تشغيل_البرنامج.sh` (Mac/Linux)
2. انتظر ظهور النافذة (3-5 ثوانِ)
3. استمتع بالاستخدام!

### للإغلاق:
- أغلق النافذة كأي برنامج عادي
- أو اضغط Alt+F4 (Windows) أو Cmd+Q (Mac)

---

**ملاحظة:** احتفظ بجميع ملفات المشروع في نفس المجلد لضمان عمل التطبيق بشكل صحيح.