# 🚀 دليل إعداد نظام IoT السريع

## ✨ الميزة الجديدة: إعدادات WiFi التلقائية!

الآن يمكنك حفظ إعدادات WiFi مرة واحدة، وسيتم تضمينها تلقائياً في كل كود Arduino تنسخه!

---

## 📋 خطوات الإعداد الأولية

### 1️⃣ إنشاء الجداول
افتح أحد هذه الروابط:
```
http://localhost/KL/backend/database/fix_all_iot_tables.php
http://localhost/KL/backend/database/create_iot_settings_table.php
```

### 2️⃣ تكوين الإعدادات
```
http://localhost/KL/backend/admin/iot_settings.php
```

أدخل:
- ✅ اسم شبكة WiFi (SSID)
- ✅ كلمة مرور WiFi
- ✅ عنوان السيرفر (استخدم IP بدلاً من localhost)
  - مثال: `http://192.168.1.100/KL/backend/api/esp_control.php`
- ✅ فترة الاستعلام (افتراضي: 3000 ميلي ثانية)
- ✅ Relay Pin (افتراضي: GPIO5/D1)
- ✅ LED Pin (افتراضي: GPIO2/D4)

### 3️⃣ إضافة جهاز
```
http://localhost/KL/backend/admin/iot_devices.php
```

اضغط "إضافة جهاز" وأدخل:
- Device ID: مثل `ESP01`
- اسم الجهاز: مثل `Living Room Light`
- النوع: ESP8266
- الموقع: مثل `Living Room`

### 4️⃣ نسخ الكود
اضغط زر "نسخ الكود" 💜

**الكود سيكون جاهز للرفع مباشرة!** ✨
- WiFi SSID ✅
- WiFi Password ✅
- Server URL ✅
- Pin Configuration ✅

### 5️⃣ رفع الكود
1. افتح Arduino IDE
2. الصق الكود (Ctrl+V)
3. اختر Board: NodeMCU 1.0 (ESP-12E Module)
4. اختر Port
5. اضغط Upload ⬆️

---

## 🎯 الأوامر المتاحة

| الأمر | الوصف |
|------|-------|
| `turn_on` | تشغيل الريلاي |
| `turn_off` | إيقاف الريلاي |
| `toggle` | تبديل الحالة |
| `pulse` | نبضة بمدة محددة |
| `get_status` | قراءة الحالة |
| `custom` | أوامر مخصصة |

---

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

### المشكلة: الجهاز لا يتصل
**الحل:**
1. تأكد من صحة WiFi SSID و Password
2. تأكد من أن ESP8266 في نطاق الشبكة
3. افتح Serial Monitor (115200 baud) لرؤية الأخطاء

### المشكلة: الجهاز متصل لكن لا يستقبل أوامر
**الحل:**
1. تأكد من صحة Server URL
2. استخدم IP السيرفر بدلاً من localhost
3. تأكد من أن السيرفر يعمل
4. تحقق من Firewall

### المشكلة: الجهاز يظهر Offline
**الحل:**
- الجهاز يُعتبر offline إذا لم يتصل خلال آخر 30 ثانية
- تحقق من اتصال WiFi
- تحقق من Serial Monitor

---

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

```
iot_devices         - معلومات الأجهزة
iot_commands        - الأوامر المرسلة
iot_logs            - سجل الأحداث
iot_sensors_data    - بيانات الحساسات
iot_schedules       - الجدولة التلقائية
iot_settings        - الإعدادات العامة ⭐ جديد
```

---

## 🎨 واجهة الإدارة

### الصفحات المتاحة:
- 📱 **iot_devices.php** - لوحة التحكم الرئيسية
- ⚙️ **iot_settings.php** - إعدادات WiFi والنظام
- 🧪 **iot_test.php** - اختبار النظام

### التبويبات:
- 📋 **الأجهزة** - عرض وإدارة الأجهزة
- 📡 **الأوامر** - سجل الأوامر
- 📝 **السجلات** - الأخطاء والتحذيرات
- 📖 **دليل ESP8266** - شرح كامل

---

## 💡 نصائح

1. **احفظ إعدادات WiFi مرة واحدة** - ستُستخدم في كل الأجهزة
2. **استخدم IP ثابت للسيرفر** - أو استخدم DDNS
3. **راقب Serial Monitor** - لمعرفة ما يحدث
4. **ابدأ بجهاز واحد** - للتأكد من عمل النظام
5. **استخدم أسماء واضحة** - للأجهزة والمواقع

---

## 🔐 الأمان

⚠️ **تحذير:** النظام الحالي لا يحتوي على:
- Authentication للـ Admin Panel
- API Keys للأجهزة
- HTTPS Encryption

**للاستخدام الإنتاجي:**
- أضف نظام تسجيل دخول
- استخدم HTTPS
- أضف API Keys للأجهزة
- فعّل Rate Limiting

---

## 📞 الدعم

إذا واجهت مشاكل:
1. افتح `iot_test.php` للتشخيص
2. تحقق من Serial Monitor
3. راجع سجل الأخطاء في تبويب "السجلات"

---

**تم التطوير بواسطة Kiro AI** 🤖