# 🚀 دليل البدء السريع - WiFi Guardian

تثبيت وتشغيل المشروع في 10 دقائق!

---

## خيار 1: التشغيل المحلي (للتطوير)

### Backend

```bash
# 1. استنساخ المشروع
git clone https://github.com/ahmed114745ed-bot/wifi-guardian-backend.git
cd wifi-guardian-backend

# 2. تثبيت Dependencies
composer install

# 3. إعداد البيئة
cp .env.example .env
php artisan key:generate

# 4. إعداد Database (SQLite)
touch database/database.sqlite
php artisan migrate

# 5. تشغيل السيرفر
php artisan serve --host=0.0.0.0 --port=8000
```

✅ Backend جاهز على: `http://localhost:8000`

---

### Frontend

```bash
# 1. استنساخ المشروع
git clone https://github.com/ahmed114745ed-bot/wifi-guardian-frontend.git
cd wifi-guardian-frontend

# 2. تثبيت Dependencies
flutter pub get

# 3. تشغيل على Emulator
flutter run

# أو بناء APK للجهاز الحقيقي
flutter build apk --release
```

✅ APK موجود في: `build/app/outputs/flutter-apk/app-release.apk`

---

## خيار 2: النشر على السيرفر (خطوات سريعة)

### 📦 متطلبات السيرفر
- Ubuntu 22.04
- 2GB RAM
- Domain name (اختياري)

### 🔧 نص التثبيت الأوتوماتيكي

احفظ هذا النص في `install.sh`:

```bash
#!/bin/bash

echo "🚀 بدء تثبيت WiFi Guardian Backend..."

# تحديث النظام
sudo apt update && sudo apt upgrade -y

# تثبيت PHP 8.2
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update
sudo apt install -y php8.2 php8.2-fpm php8.2-cli php8.2-mysql \
    php8.2-xml php8.2-mbstring php8.2-curl php8.2-zip

# تثبيت Composer
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

# تثبيت MySQL
sudo apt install -y mysql-server

# تثبيت Nginx
sudo apt install -y nginx git

# إعداد MySQL
echo "إنشاء قاعدة البيانات..."
sudo mysql -e "CREATE DATABASE wifi_guardian;"
sudo mysql -e "CREATE USER 'wifi_user'@'localhost' IDENTIFIED BY 'StrongPass123!';"
sudo mysql -e "GRANT ALL ON wifi_guardian.* TO 'wifi_user'@'localhost';"
sudo mysql -e "FLUSH PRIVILEGES;"

# استنساخ المشروع
cd /var/www
sudo git clone https://github.com/ahmed114745ed-bot/wifi-guardian-backend.git
cd wifi-guardian-backend

# الصلاحيات
sudo chown -R www-data:www-data .
sudo chmod -R 755 .
sudo chmod -R 775 storage bootstrap/cache

# تثبيت Dependencies
composer install --no-dev --optimize-autoloader

# إعداد .env
cp .env.example .env
sed -i 's/DB_CONNECTION=.*/DB_CONNECTION=mysql/' .env
sed -i 's/DB_DATABASE=.*/DB_DATABASE=wifi_guardian/' .env
sed -i 's/DB_USERNAME=.*/DB_USERNAME=wifi_user/' .env
sed -i 's/DB_PASSWORD=.*/DB_PASSWORD=StrongPass123!/' .env

# Laravel Setup
php artisan key:generate
php artisan migrate --force
php artisan config:cache

# Nginx Configuration
sudo tee /etc/nginx/sites-available/wifi-guardian <<EOF
server {
    listen 80;
    server_name _;
    root /var/www/wifi-guardian-backend/public;
    index index.php;

    location / {
        try_files \$uri \$uri/ /index.php?\$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME \$realpath_root\$fastcgi_script_name;
        include fastcgi_params;
    }
}
EOF

sudo ln -sf /etc/nginx/sites-available/wifi-guardian /etc/nginx/sites-enabled/
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t && sudo systemctl restart nginx

# Firewall
sudo ufw allow 'Nginx Full'
sudo ufw allow ssh
sudo ufw --force enable

echo "✅ التثبيت اكتمل!"
echo "📡 API متاح على: http://$(curl -s ifconfig.me)/api"
echo ""
echo "🔐 معلومات Database:"
echo "  - Database: wifi_guardian"
echo "  - Username: wifi_user"
echo "  - Password: StrongPass123!"
```

**التشغيل:**

```bash
chmod +x install.sh
sudo ./install.sh
```

⏱️ **الوقت المتوقع**: 5-7 دقائق

---

## 📱 تحديث Flutter للـ Production

### في ملف واحد فقط:

`lib/services/api/wifi_guardian_api_client.dart`

```dart
// غيّر من:
static const String baseUrl = 'http://10.0.2.2:8000/api';

// إلى:
static const String baseUrl = 'http://YOUR_SERVER_IP/api';
// أو
static const String baseUrl = 'https://api.yourdomain.com/api';
```

### ثم بناء APK:

```bash
flutter build apk --release
```

---

## 🧪 اختبار سريع

### Backend

```bash
# اختبر API
curl http://YOUR_SERVER_IP/api/auth/register

# يجب أن ترى:
# {"message":"The phone field is required..."}
```

### Frontend

1. ثبّت APK على الجهاز
2. افتح التطبيق
3. سجّل حساب جديد
4. اختبر الميزات

---

## 🔐 تفعيل HTTPS (اختياري لكن موصى به)

```bash
# تثبيت Certbot
sudo apt install -y certbot python3-certbot-nginx

# الحصول على SSL (استبدل api.yourdomain.com بالدومين الخاص بك)
sudo certbot --nginx -d api.yourdomain.com

# تجديد تلقائي
sudo certbot renew --dry-run
```

---

## 📊 إعدادات WhatsApp API

### 1. احصل على API Key من dotsaap.site

### 2. أضف في `.env`:

```env
WHATSAPP_API_URL=https://dotsaap.site/api/send
WHATSAPP_API_KEY=your_key_here
```

### 3. أعد تشغيل:

```bash
php artisan config:cache
sudo systemctl restart nginx
```

---

## 🎯 الخطوات التالية

بعد التثبيت:

1. ✅ **اختبر التطبيق بالكامل**
   - تسجيل حساب
   - ربط العائلة
   - تتبع الاستهلاك

2. 📊 **راقب الأداء**
   ```bash
   # Logs
   tail -f /var/www/wifi-guardian-backend/storage/logs/laravel.log
   ```

3. 💾 **أعد Backup منتظم**
   ```bash
   # Database Backup
   mysqldump -u wifi_user -pStrongPass123! wifi_guardian > backup.sql
   ```

4. 🔄 **حدّث المشروع عند الحاجة**
   ```bash
   cd /var/www/wifi-guardian-backend
   git pull origin main
   composer install --no-dev
   php artisan migrate --force
   php artisan config:cache
   ```

---

## ❓ مشاكل شائعة وحلولها

### Backend لا يعمل

```bash
# تحقق من PHP
php -v

# تحقق من Nginx
sudo systemctl status nginx

# تحقق من الصلاحيات
sudo chown -R www-data:www-data /var/www/wifi-guardian-backend
sudo chmod -R 775 storage bootstrap/cache
```

### Flutter لا يتصل بـ Backend

```bash
# تأكد من الـ URL صحيح
# تأكد من Firewall يسمح بالاتصال
sudo ufw status

# جرب من المتصفح
# افتح: http://YOUR_SERVER_IP/api
```

### Database Error

```bash
# اختبر الاتصال
mysql -u wifi_user -pStrongPass123! wifi_guardian

# أعد إنشاء Database
php artisan migrate:fresh --force
```

---

## 📞 الدعم السريع

- 📚 [الدليل الكامل](DEPLOYMENT_GUIDE.md)
- 🐛 [GitHub Issues](https://github.com/ahmed114745ed-bot/wifi-guardian-backend/issues)
- 📧 Email: your-email@example.com

---

## 🎉 مبروك!

المشروع الآن جاهز للعمل! 🚀

**Backend**: `http://YOUR_SERVER_IP/api`  
**Frontend**: APK جاهز للتوزيع

---

**وقت الإعداد الكلي**: ~10 دقائق ⏱️