# 🚀 دليل البدء السريع - نظام مقايسة مشاريع IoT

## خطوات البدء في 5 دقائق

### 1️⃣ التثبيت (دقيقة واحدة)

قم بتشغيل ملف الإعداد:

```bash
php backend/database/setup_iot_estimation.php
```

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

✅ **النتيجة المتوقعة:**
- تم إنشاء 5 جداول
- تم إدراج 12 قالب جهاز
- تم إدراج 4 قوالب غرف

---

### 2️⃣ الوصول للنظام (30 ثانية)

1. سجل دخول إلى لوحة التحكم
2. من القائمة الجانبية: **الإدارة والإعدادات** > **مقايسة مشاريع IoT**
3. ستظهر لك الصفحة الرئيسية مع الإحصائيات

---

### 3️⃣ إنشاء أول مشروع (دقيقتان)

#### الخطوة 1: معلومات المشروع
```
اضغط "مشروع جديد"
↓
أدخل:
- اسم العميل: محمد أحمد
- رقم الهاتف: 0512345678
- البريد: mohammed@example.com
- نوع المشروع: منزل
- ملاحظات: منزل دورين
↓
اضغط "حفظ والمتابعة"
```

#### الخطوة 2: إضافة الغرف
```
اختر قالب: "غرفة نوم رئيسية ذكية"
↓
سيتم ملء البيانات تلقائياً
↓
اضغط "إضافة الغرفة"
↓
كرر لإضافة غرف أخرى
```

#### الخطوة 3: إضافة الأجهزة
```
اضغط أيقونة "إدارة الأجهزة" للغرفة
↓
اختر من القوالب: "مصباح ذكي LED"
↓
حدد الكمية: 4
↓
سيحسب الإجمالي تلقائياً: 680 ر.س
↓
اضغط "إضافة الجهاز"
```

---

### 4️⃣ عرض وطباعة المقايسة (دقيقة واحدة)

```
من قائمة المشاريع
↓
اضغط أيقونة "عرض" 👁️
↓
راجع التفاصيل والتكلفة
↓
اضغط "طباعة المقايسة" 🖨️
↓
احفظ كـ PDF أو اطبع مباشرة
```

---

## 🎯 سيناريو عملي كامل

### مثال: مشروع فيلا ذكية

**معلومات العميل:**
- الاسم: خالد السعيد
- الهاتف: 0555123456
- النوع: فيلا
- الملاحظات: فيلا 3 أدوار + حديقة

**الغرف المطلوبة:**

1. **غرفة نوم رئيسية** (الدور الثاني)
   - مصباح ذكي LED × 6
   - مفتاح إضاءة ذكي × 3
   - ثيرموستات ذكي × 1
   - كاميرا مراقبة × 1

2. **صالة معيشة** (الدور الأرضي)
   - شريط LED ذكي × 2
   - تلفاز ذكي × 1
   - سماعات ذكية × 2
   - لوحة تحكم مركزية × 1

3. **مطبخ** (الدور الأرضي)
   - مصباح ذكي LED × 4
   - مفتاح إضاءة ذكي × 2
   - حساس دخان × 1

4. **حديقة**
   - كاميرا مراقبة × 2
   - حساس حركة × 4
   - إضاءة خارجية ذكية × 8

**النتيجة:**
- إجمالي الأجهزة: 37 جهاز
- التكلفة الإجمالية: ~25,000 ر.س
- بعد خصم 10%: 22,500 ر.س

---

## 💡 نصائح للاستخدام الفعال

### ⚡ استخدم القوالب
- توفر 70% من الوقت
- أسعار محدثة ومعتمدة
- يمكن تعديل الأسعار حسب الحاجة

### 📊 راجع الإحصائيات
- تابع عدد المشاريع الجديدة
- راقب الإيرادات المتوقعة
- حدد المشاريع المعلقة

### 🔍 استخدم الفلترة
- فلتر حسب الحالة
- بحث بالاسم أو الهاتف
- ترتيب حسب التاريخ أو التكلفة

### 💰 إدارة الخصومات
- أضف خصم من صفحة التعديل
- الخصم بالنسبة المئوية
- يحسب تلقائياً على الإجمالي

---

## 🎨 اختصارات لوحة المفاتيح

| الاختصار | الوظيفة |
|---------|---------|
| `Ctrl + P` | طباعة المقايسة |
| `Ctrl + S` | حفظ التعديلات |
| `Esc` | إغلاق النوافذ المنبثقة |

---

## 📱 الوصول السريع

### الصفحات الرئيسية:

```
📊 قائمة المشاريع
/backend/admin/iot-estimation/index.php

➕ مشروع جديد
/backend/admin/iot-estimation/add.php

🔌 قوالب الأجهزة
/backend/admin/iot-estimation/templates/devices.php

🚪 قوالب الغرف
/backend/admin/iot-estimation/templates/rooms.php
```

---

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

### س: كيف أضيف خصم للمشروع؟
**ج:** من صفحة تعديل المشروع، أدخل نسبة الخصم في حقل "نسبة الخصم (%)"

### س: هل يمكن تعديل أسعار القوالب؟
**ج:** نعم، عند إضافة جهاز يمكنك تعديل السعر يدوياً

### س: كيف أحذف غرفة؟
**ج:** من صفحة إدارة الغرف، اضغط أيقونة الحذف 🗑️ (سيتم حذف جميع الأجهزة المرتبطة)

### س: هل يمكن نسخ مشروع؟
**ج:** حالياً لا، لكن يمكنك استخدام القوالب لتسريع العملية

### س: كيف أرسل المقايسة للعميل؟
**ج:** اطبع المقايسة واحفظها كـ PDF، ثم أرسلها عبر البريد أو WhatsApp

---

## 🎓 فيديوهات تعليمية (قريباً)

- [ ] إنشاء مشروع كامل (5 دقائق)
- [ ] استخدام القوالب بفعالية (3 دقائق)
- [ ] طباعة وتصدير المقايسات (2 دقيقة)
- [ ] إدارة القوالب المخصصة (4 دقائق)

---

## 🚦 حالات الاستخدام

### ✅ مناسب لـ:
- شركات تركيب المنازل الذكية
- مهندسي IoT
- مقاولي الأتمتة المنزلية
- موزعي الأجهزة الذكية

### ⚠️ غير مناسب لـ:
- المشاريع الصناعية الكبيرة (يحتاج تخصيص)
- الأنظمة المعقدة جداً (يحتاج ميزات إضافية)

---

## 📞 تحتاج مساعدة؟

1. راجع [الدليل الكامل](README.md)
2. تحقق من [قائمة TODO](../iot/IOT-ESTIMATION-TODO.md)
3. تواصل مع فريق الدعم

---

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

ابدأ بإنشاء مشروعك الأول الآن! 🚀