# 🏠 نظام مقايسة مشاريع IoT للمنازل الذكية

## نظرة عامة

نظام متكامل لإدارة وإنشاء مقايسات مشاريع المنازل الذكية (IoT). يتيح النظام إنشاء مقايسات احترافية للعملاء مع حساب تلقائي للتكاليف وإدارة شاملة للمشاريع.

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

### ✅ إدارة المشاريع
- إنشاء مشاريع جديدة بمعلومات العميل الكاملة
- تتبع حالة المشروع (جديد، قيد التنفيذ، مكتمل، ملغي)
- فلترة وبحث متقدم في المشاريع
- إحصائيات فورية شاملة

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

### 🔌 إدارة الأجهزة
- إضافة أجهزة ذكية لكل غرفة
- اختيار من 12 قالب جهاز جاهز
- حساب تلقائي للتكلفة (الكمية × السعر + التركيب)
- تصنيف الأجهزة حسب الفئة (إضاءة، تحكم، أمان، ترفيه، مناخ، حساسات)

### 💰 إدارة التكاليف
- حساب تلقائي للتكلفة الإجمالية
- دعم الخصومات بالنسبة المئوية
- عرض التكلفة النهائية بعد الخصم
- تتبع تكاليف كل غرفة وجهاز

### 🖨️ التقارير والطباعة
- طباعة مقايسة احترافية
- تصميم متجاوب للطباعة
- عرض تفصيلي لجميع الغرف والأجهزة
- ملخص شامل للتكاليف

## 📊 قاعدة البيانات

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

#### 1. iot_projects (المشاريع)
```sql
- id: معرف المشروع
- customer_name: اسم العميل
- customer_phone: رقم الهاتف
- customer_email: البريد الإلكتروني
- project_type: نوع المشروع (house, apartment, villa, office, other)
- status: الحالة (new, in_progress, completed, cancelled)
- total_cost: التكلفة الإجمالية
- discount_percentage: نسبة الخصم
- discount_amount: مبلغ الخصم
- final_cost: التكلفة النهائية
- notes: ملاحظات
- created_at: تاريخ الإنشاء
- updated_at: تاريخ التحديث
```

#### 2. iot_project_rooms (الغرف)
```sql
- id: معرف الغرفة
- project_id: معرف المشروع
- room_name: اسم الغرفة
- room_type: نوع الغرفة
- area_sqm: المساحة بالمتر المربع
- floor_number: رقم الطابق
- notes: ملاحظات
```

#### 3. iot_project_devices (الأجهزة)
```sql
- id: معرف الجهاز
- room_id: معرف الغرفة
- device_name: اسم الجهاز
- device_type: نوع الجهاز
- device_model: الموديل
- quantity: الكمية
- unit_price: سعر الوحدة
- installation_cost: تكلفة التركيب
- total_price: السعر الإجمالي
- notes: ملاحظات
```

#### 4. iot_device_templates (قوالب الأجهزة)
```sql
- id: معرف القالب
- device_name: اسم الجهاز
- device_type: نوع الجهاز
- category: الفئة (lighting, control, security, entertainment, climate, sensors, other)
- default_price: السعر الافتراضي
- installation_cost: تكلفة التركيب
- description: الوصف
- is_active: حالة التفعيل
```

#### 5. iot_room_templates (قوالب الغرف)
```sql
- id: معرف القالب
- room_name: اسم الغرفة
- room_type: نوع الغرفة
- default_devices: الأجهزة الافتراضية (JSON)
- description: الوصف
- estimated_cost: التكلفة التقديرية
- is_active: حالة التفعيل
```

## 🚀 دليل الاستخدام السريع

### 1. إعداد النظام

```bash
# تشغيل ملف الإعداد
php backend/database/setup_iot_estimation.php
```

أو عبر المتصفح:
```
http://localhost/backend/database/setup_iot_estimation.php
```

### 2. إنشاء مشروع جديد

1. انتقل إلى: `لوحة التحكم > الإدارة والإعدادات > مقايسة مشاريع IoT`
2. اضغط على "مشروع جديد"
3. أدخل معلومات العميل:
   - اسم العميل (مطلوب)
   - رقم الهاتف (مطلوب)
   - البريد الإلكتروني (اختياري)
   - نوع المشروع
   - ملاحظات
4. اضغط "حفظ والمتابعة لإضافة الغرف"

### 3. إضافة الغرف

1. بعد إنشاء المشروع، ستنتقل تلقائياً لصفحة إدارة الغرف
2. يمكنك:
   - اختيار قالب غرفة جاهز (اختياري)
   - إدخال اسم الغرفة
   - اختيار نوع الغرفة
   - إدخال المساحة ورقم الطابق
   - إضافة ملاحظات
3. اضغط "إضافة الغرفة"
4. كرر العملية لإضافة غرف أخرى

### 4. إضافة الأجهزة

1. من قائمة الغرف، اضغط على أيقونة "إدارة الأجهزة" للغرفة المطلوبة
2. يمكنك:
   - اختيار جهاز من القوالب الجاهزة (يملأ البيانات تلقائياً)
   - أو إدخال بيانات الجهاز يدوياً
   - تحديد الكمية
   - سيتم حساب الإجمالي تلقائياً
3. اضغط "إضافة الجهاز"
4. كرر العملية لإضافة أجهزة أخرى

### 5. عرض وطباعة المقايسة

1. من قائمة المشاريع، اضغط على أيقونة "عرض" للمشروع
2. ستظهر جميع التفاصيل مع ملخص التكلفة
3. اضغط "طباعة المقايسة" للحصول على نسخة قابلة للطباعة
4. يمكنك طباعتها مباشرة أو حفظها كـ PDF

## 📁 هيكل الملفات

```
backend/admin/iot-estimation/
├── index.php              # قائمة المشاريع
├── add.php                # إضافة مشروع جديد
├── edit.php               # تعديل مشروع
├── view.php               # عرض مشروع
├── rooms.php              # إدارة الغرف
├── devices.php            # إدارة الأجهزة
├── print.php              # طباعة المقايسة
├── delete.php             # حذف مشروع
├── api/
│   ├── add-room.php       # API إضافة غرفة
│   ├── delete-room.php    # API حذف غرفة
│   ├── add-device.php     # API إضافة جهاز
│   └── delete-device.php  # API حذف جهاز
└── templates/
    ├── devices.php        # قوالب الأجهزة
    └── rooms.php          # قوالب الغرف
```

## 🎨 القوالب الجاهزة

### قوالب الأجهزة (12 قالب)

#### 💡 إضاءة
- مصباح ذكي LED (150 ر.س)
- شريط LED ذكي (200 ر.س)
- مفتاح إضاءة ذكي (180 ر.س)

#### 🎛️ تحكم
- مساعد صوتي (500 ر.س)
- لوحة تحكم مركزية (800 ر.س)

#### 🔒 أمان
- كاميرا مراقبة (600 ر.س)
- قفل ذكي (800 ر.س)
- جرس باب ذكي (450 ر.س)
- حساس حركة (120 ر.س)

#### ❄️ مناخ
- ثيرموستات ذكي (700 ر.س)

#### 🎬 ترفيه
- تلفاز ذكي (3000 ر.س)
- سماعات ذكية (350 ر.س)

### قوالب الغرف (4 قوالب)

1. **غرفة نوم رئيسية ذكية** (3500 ر.س)
2. **صالة معيشة ذكية** (8000 ر.س)
3. **مطبخ ذكي** (4500 ر.س)
4. **مكتب منزلي ذكي** (3000 ر.س)

## 🔧 API Endpoints

### الغرف

#### إضافة غرفة
```
POST /backend/admin/iot-estimation/api/add-room.php

Parameters:
- project_id (required)
- room_name (required)
- room_type (required)
- area_sqm (optional)
- floor_number (optional)
- notes (optional)

Response:
{
  "success": true,
  "message": "تم إضافة الغرفة بنجاح",
  "room_id": 123
}
```

#### حذف غرفة
```
POST /backend/admin/iot-estimation/api/delete-room.php

Body (JSON):
{
  "id": 123
}

Response:
{
  "success": true,
  "message": "تم حذف الغرفة بنجاح"
}
```

### الأجهزة

#### إضافة جهاز
```
POST /backend/admin/iot-estimation/api/add-device.php

Parameters:
- room_id (required)
- device_name (required)
- device_type (optional)
- device_model (optional)
- quantity (required)
- unit_price (required)
- installation_cost (optional)
- total_price (required)
- notes (optional)

Response:
{
  "success": true,
  "message": "تم إضافة الجهاز بنجاح",
  "device_id": 456
}
```

#### حذف جهاز
```
POST /backend/admin/iot-estimation/api/delete-device.php

Body (JSON):
{
  "id": 456
}

Response:
{
  "success": true,
  "message": "تم حذف الجهاز بنجاح"
}
```

## 💡 نصائح وأفضل الممارسات

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

### 2. إدارة الغرف
- استخدم القوالب الجاهزة لتوفير الوقت
- أدخل المساحة بدقة لحساب تكاليف أفضل
- حدد رقم الطابق لتسهيل التركيب

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

### 4. الخصومات
- يمكن إضافة خصم بالنسبة المئوية من صفحة التعديل
- الخصم يطبق على التكلفة الإجمالية
- التكلفة النهائية تحسب تلقائياً

### 5. الطباعة
- راجع المقايسة قبل الطباعة
- استخدم "حفظ كـ PDF" من متصفحك للحصول على نسخة رقمية
- المقايسة صالحة لمدة 30 يوماً من تاريخ الإصدار

## 🔐 الأمان

- جميع العمليات تتطلب تسجيل دخول المدير
- استخدام Prepared Statements لمنع SQL Injection
- التحقق من صحة البيانات المدخلة
- حماية من XSS Attacks

## 📈 الإحصائيات المتاحة

في الصفحة الرئيسية، يمكنك رؤية:
- إجمالي عدد المشاريع
- عدد المشاريع الجديدة
- عدد المشاريع قيد التنفيذ
- عدد المشاريع المكتملة
- عدد المشاريع الملغية
- إجمالي الإيرادات المتوقعة

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

### المشكلة: لا تظهر الجداول بعد التثبيت
**الحل:** تأكد من تشغيل ملف الإعداد:
```bash
php backend/database/setup_iot_estimation.php
```

### المشكلة: خطأ في الاتصال بقاعدة البيانات
**الحل:** تحقق من إعدادات قاعدة البيانات في:
```
backend/config/database.php
```

### المشكلة: لا يتم حساب التكلفة تلقائياً
**الحل:** تأكد من تفعيل JavaScript في المتصفح

### المشكلة: لا تظهر القوالب الجاهزة
**الحل:** تأكد من تشغيل ملف الإعداد الذي يدرج البيانات التجريبية

## 🔄 التحديثات المستقبلية

- [ ] تصدير المقايسات إلى PDF
- [ ] إرسال المقايسات بالبريد الإلكتروني
- [ ] نظام الصلاحيات المتقدم
- [ ] تقارير إحصائية مفصلة
- [ ] تكامل مع أنظمة الدفع
- [ ] تطبيق موبايل
- [ ] نظام الإشعارات
- [ ] تتبع مراحل المشروع

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

للحصول على المساعدة أو الإبلاغ عن مشاكل:
- راجع هذا الدليل أولاً
- تحقق من ملف TODO للميزات المخطط لها
- تواصل مع فريق التطوير

## 📝 الترخيص

هذا النظام جزء من منصة Roz Skin المتكاملة.

---

**تم التطوير بواسطة:** فريق Roz Skin  
**الإصدار:** 1.0.0  
**تاريخ آخر تحديث:** 2025-11-22