# نظام طلبات التنظيف - فرسك

## نظرة عامة

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

## الميزات الرئيسية

### 1. إنشاء طلبات التنظيف
- اختيار العقار المطلوب تنظيفه
- تحديد نوع التنظيف (عادي، عميق، انتقال سكن، ما بعد الإنشاء)
- تحديد تكرار الخدمة (مرة واحدة، أسبوعي، شهري، ربع سنوي)
- إضافة تفاصيل المساحة وعدد الغرف
- تحديد التواريخ والأوقات المفضلة
- رفع المرفقات (صور، مستندات)

### 2. إدارة الطلبات
- عرض جميع طلبات التنظيف
- تصفية حسب الحالة
- إحصائيات شاملة
- إمكانية التعديل والحذف (للطلبات الجديدة فقط)

### 3. نظام المناقصات
- فتح مناقصات للطلبات
- دعوة شركات التنظيف
- استقبال العروض
- تقييم وترسية العروض

### 4. إدارة العروض
- عرض العروض المستلمة
- إخفاء بيانات الشركات (حتى القبول)
- قبول أو رفض العروض
- إنشاء الفواتير تلقائياً

### 5. نظام الفواتير والمدفوعات
- إنشاء فواتير تلقائية
- إدارة المدفوعات
- تتبع حالة الفواتير
- نظام المحفظة الإلكترونية

## هيكل قاعدة البيانات

### الجداول الرئيسية

#### `cleaning_requests`
- طلبات التنظيف الأساسية
- يحتوي على تفاصيل الطلب والعقار

#### `cleaning_tenders`
- مناقصات التنظيف
- إعدادات المناقصة والتواريخ

#### `cleaning_bids`
- عروض شركات التنظيف
- الأسعار والشروط المقدمة

#### `cleaning_tender_invitations`
- دعوات الشركات للمناقصات
- حالة الدعوات والردود

#### `cleaning_tenders_document`
- مرفقات المناقصات
- الصور والمستندات المرفقة

#### `cleaning_bid_attachments`
- مرفقات العروض
- الوثائق المرفقة مع العروض

## دورة حياة الطلب

### 1. إنشاء الطلب
```
المستخدم → إنشاء طلب تنظيف → حفظ في cleaning_requests
```

### 2. فتح المناقصة
```
الطلب → إنشاء مناقصة → حفظ في cleaning_tenders
```

### 3. دعوة الشركات
```
المناقصة → إرسال دعوات → حفظ في cleaning_tender_invitations
```

### 4. استقبال العروض
```
الشركات → تقديم عروض → حفظ في cleaning_bids
```

### 5. تقييم وترسية
```
المالك → مراجعة العروض → قبول/رفض → تحديث الحالة
```

### 6. إنشاء الفاتورة
```
العرض المقبول → إنشاء فاتورة → حفظ في invoices
```

### 7. التنفيذ والمتابعة
```
الشركة → تنفيذ الخدمة → تحديث الحالة → إكمال الطلب
```

## الملفات الرئيسية

### الصفحات
- `index.php` - الصفحة الرئيسية
- `create_request.php` - إنشاء طلب تنظيف
- `view_requests.php` - عرض طلبات التنظيف
- `evaluation_offers.php` - عرض العروض
- `tender_mange.php` - إدارة المناقصات
- `invoices.php` - إدارة الفواتير

### API
- `api/create_cleaning_request.php` - إنشاء طلب تنظيف
- `api/delete_cleaning_request.php` - حذف طلب تنظيف
- `api/submit_dispute.php` - إرسال نزاع
- `api/edit_dispute.php` - تعديل نزاع
- `api/delete_dispute.php` - حذف نزاع

### الملفات المساعدة
- `includes/` - ملفات الإعدادات والوظائف
- `uploads/cleaning_requests/` - مجلد المرفقات

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

### Frontend
- **React** (via CDN)
- **Ant Design** - مكتبة واجهة المستخدم
- **Font Awesome** - الأيقونات
- **Cairo Font** - الخط العربي

### Backend
- **PHP** - لغة البرمجة
- **MySQL** - قاعدة البيانات
- **PDO** - واجهة قاعدة البيانات

### الأمان
- التحقق من الجلسات
- التحقق من الصلاحيات
- تنظيف المدخلات
- حماية من SQL Injection
- التحقق من ملكية البيانات

## التصميم

### الألوان
- الأخضر الرئيسي: `#206843`
- الأخضر الفاتح: `#28a745`
- الأزرق: `#1890ff`
- البرتقالي: `#faad14`
- الرمادي: `#6c757d`

### المبادئ
- تصميم متجاوب (Responsive)
- دعم RTL للعربية
- بدون hover effects (حسب الطلب)
- واجهة بسيطة وسهلة الاستخدام
- تصميم عصري وأنيق

## الإعداد والتشغيل

### المتطلبات
- PHP 7.4+
- MySQL 5.7+
- Apache/Nginx
- تفعيل mod_rewrite

### التثبيت
1. نسخ الملفات إلى مجلد الخادم
2. إنشاء قاعدة البيانات
3. تشغيل ملف SQL لإنشاء الجداول
4. تعديل إعدادات الاتصال بقاعدة البيانات
5. إنشاء مجلد uploads مع الصلاحيات المناسبة

### الصلاحيات المطلوبة
```bash
chmod 755 uploads/cleaning_requests/
chmod 644 includes/*.php
```

## الدعم والصيانة

### السجلات
- جميع العمليات مسجلة في `invoice_log`
- سجلات الأخطاء في `error_log`

### النسخ الاحتياطي
- قاعدة البيانات: يومياً
- الملفات المرفقة: أسبوعياً
- ملفات النظام: شهرياً

### التحديثات
- مراجعة دورية للأمان
- تحديث المكتبات المستخدمة
- إضافة ميزات جديدة حسب الطلب

## المساهمة

للمساهمة في تطوير النظام:
1. Fork المشروع
2. إنشاء branch جديد للميزة
3. تطوير الميزة
4. اختبار الشيفرة
5. إرسال Pull Request

## الترخيص

هذا المشروع مرخص تحت رخصة MIT.

## الاتصال

للأسئلة والدعم التقني:
- البريد الإلكتروني: support@farsak.com
- الهاتف: +966-XX-XXXXXXX
- الموقع: https://farsak.com
