# دليل إنشاء ملف تنفيذي (.exe) لنظام إدارة المستأجرين

## المتطلبات الأساسية

### على نظام Windows:
1. **Python 3.8 أو أحدث** - تحميل من [python.org](https://python.org)
2. **Git** (اختياري) - لتحميل المشروع
3. **Visual C++ Redistributable** - مثبت عادة مع Windows

### على نظام macOS/Linux (للتطوير):
1. **Python 3.8 أو أحدث**
2. **Wine** (لاختبار ملفات exe)

## خطوات البناء

### الطريقة الأولى: استخدام الملف المجمع (الأسهل)

1. **تحميل المشروع:**
   ```bash
   git clone [repository-url]
   cd mostager-3
   ```

2. **تشغيل سكريبت البناء على Windows:**
   ```cmd
   build_exe.bat
   ```

3. **أو تشغيل السكريبت يدوياً:**
   ```bash
   python build_exe.py
   ```

### الطريقة الثانية: البناء اليدوي

1. **تثبيت المتطلبات:**
   ```bash
   pip install -r requirements.txt
   ```

2. **تنظيف الملفات السابقة:**
   ```bash
   rmdir /s build dist __pycache__
   ```

3. **بناء الملف التنفيذي:**
   ```bash
   pyinstaller --clean mostager.spec
   ```

## ملفات المشروع المهمة

- `main_exe.py` - نقطة البداية للتطبيق المحول
- `mostager.spec` - إعدادات PyInstaller
- `build_exe.py` - سكريبت البناء الآلي
- `build_exe.bat` - ملف batch للتشغيل على Windows

## المجلدات الناتجة

- `build/` - ملفات البناء المؤقتة
- `dist/` - الملف التنفيذي النهائي
- `distribution/` - حزمة التوزيع الكاملة

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

### خطأ: "Python not found"
- تأكد من تثبيت Python وإضافته إلى PATH
- أعد تشغيل Command Prompt بعد التثبيت

### خطأ: "Module not found"
- تأكد من تثبيت جميع المتطلبات: `pip install -r requirements.txt`
- تأكد من تفعيل البيئة الافتراضية إذا كنت تستخدم واحدة

### خطأ: "Permission denied"
- تشغيل Command Prompt كمدير (Run as Administrator)
- تعطيل برامج مكافحة الفيروسات مؤقتاً

### خطأ: "Database not found"
- تأكد من وجود ملف `database.db` في مجلد التطبيق
- سيتم إنشاؤه تلقائياً في أول تشغيل

### الملف التنفيذي لا يعمل:
- تأكد من وجود .NET Framework 4.7.2 أو أحدث
- تشغيل الملف كمدير
- فحص ملف `mostager.log` للأخطاء

## تخصيص البناء

### إضافة أيقونة:
```python
# في ملف mostager.spec
exe = EXE(
    # ... other parameters
    icon='icon.ico',  # أضف مسار الأيقونة
)
```

### تغيير اسم الملف:
```python
# في ملف mostager.spec
exe = EXE(
    # ... other parameters
    name='اسم_جديد',
)
```

### إضافة ملفات إضافية:
```python
# في ملف mostager.spec
datas=[
    ('templates', 'templates'),
    ('static', 'static'),
    ('ملف_جديد.txt', '.'),  # أضف هنا
],
```

## التوزيع

### إنشاء مثبت (اختياري):
1. استخدم **Inno Setup** أو **NSIS**
2. أضف الملف التنفيذي وقاعدة البيانات
3. أنشئ اختصارات سطح المكتب

### متطلبات النظام المستهدف:
- Windows 10 أو أحدث
- 4 GB RAM (الحد الأدنى)
- 100 MB مساحة فارغة
- اتصال بالإنترنت (لخدمة WhatsApp)

## الأمان

- الملف التنفيذي قد يُعتبر مشبوهاً من برامج مكافحة الفيروسات
- أضف استثناء في Windows Defender
- وقع الملف رقمياً للتوزيع التجاري

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

### ملفات السجلات:
- `mostager.log` - سجل التطبيق
- `PyInstaller` logs في مجلد `build/`

### معلومات مفيدة للدعم:
- إصدار Windows
- إصدار Python المستخدم
- رسائل الخطأ الكاملة
- محتوى ملف السجل

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

1. **الحجم:** الملف التنفيذي سيكون كبير الحجم (50-100 MB) لأنه يحتوي على Python كاملاً
2. **الأداء:** أول تشغيل قد يكون بطيئاً بسبب استخراج الملفات
3. **التحديثات:** لكل تحديث، يجب إعادة بناء الملف التنفيذي
4. **قاعدة البيانات:** تأكد من نسخ `database.db` مع الملف التنفيذي

## أمثلة للاستخدام

### بناء سريع:
```bash
python build_exe.py
```

### بناء مع تنظيف شامل:
```bash
python build_exe.py --clean
```

### اختبار الملف التنفيذي:
```bash
cd distribution
mostager.exe
```

---

**ملاحظة:** هذا الدليل مخصص لنظام Windows. للأنظمة الأخرى، قد تحتاج إلى تعديلات إضافية.