# Application Firebase Configuration Documentation

## نظرة عامة

هذا النظام يسمح بتخزين وإدارة إعدادات Firebase للتطبيقات المحمولة لكل عميل (Client) بشكل منفصل. يدعم النظام إعدادات Android و iOS مع إمكانية استرجاعها عبر API للتطبيقات المحمولة (Flutter).

## المكونات

### 1. Database Migration

**الملف:** `database/migrations/2026_08_11_000001_create_client_firebase_configs_table.php`

**الجدول:** `client_firebase_configs`

**الأعمدة:**
- `id` - المفتاح الأساسي
- `client_id` - معرف العميل (رقم)
- `app_type` - نوع التطبيق (workshop, pos, ecommerce, other)
- **Android Configuration:**
  - `android_package_name` - اسم الباكدج (مثال: com.client.workshop)
  - `android_firebase_api_key` - مفتاح API الخاص بـ Firebase
  - `android_firebase_app_id` - معرف التطبيق
  - `android_firebase_messaging_sender_id` - معرف المرسل للإشعارات
  - `android_firebase_project_id` - معرف المشروع
  - `android_firebase_storage_bucket` - حاوية التخزين
- **iOS Configuration:**
  - `ios_bundle_id` - معرف الباندل (مثال: com.client.workshop)
  - `ios_firebase_api_key` - مفتاح API الخاص بـ Firebase
  - `ios_firebase_app_id` - معرف التطبيق
  - `ios_firebase_messaging_sender_id` - معرف المرسل للإشعارات
  - `ios_firebase_project_id` - معرف المشروع
  - `ios_firebase_storage_bucket` - حاوية التخزين
- `created_at` - تاريخ الإنشاء
- `updated_at` - تاريخ التحديث

### 2. Model

**الملف:** `app/ClientFirebaseConfig.php`

**الوظائف الرئيسية:**
- `getAndroidConfigAttribute()` - تحويل إعدادات Android إلى مصفوفة منظمة
- `getIosConfigAttribute()` - تحويل إعدادات iOS إلى مصفوفة منظمة
- `toApiArray()` - تحويل كامل الإعدادات إلى صيغة API

### 3. Admin Dashboard

**الملفات:**
- `resources/views/admin/dashboard/index.blade.php` - إضافة التبويب الجديد
- `resources/views/admin/dashboard/settings_app_config.blade.php` - نموذج الإدخال
- `app/Http/Controllers/Admin/AdminDashboardController.php` - معالجة البيانات

**التبويب الجديد:** "App Config" في لوحة تحكم الإدارة `/admin/dashboard`

**الحقول المتاحة:**
- Client ID
- App Type (اختياري: workshop, pos, ecommerce, other)
- إعدادات Android الكاملة
- إعدادات iOS الكاملة

### 4. API Controller

**الملف:** `app/Http/Controllers/Api/AppConfigController.php`

**الوظائف:**
- `getAppConfig()` - الحصول على إعدادات عميل محدد
- `getAllConfigs()` - الحصول على جميع الإعدادات (للإدارة)

### 5. API Routes

**الملف:** `Modules/Connector/Routes/api.php`

**الـ Endpoints:**

#### الحصول على إعدادات عميل محدد
```
GET /connector/api/app-config
```

**Query Parameters:**
- `client_id` (required) - معرف العميل
- `app_type` (optional) - نوع التطبيق (الافتراضي: workshop)

**Response Example:**
```json
{
  "success": true,
  "data": {
    "client_id": 123,
    "app_type": "workshop",
    "android": {
      "package_name": "com.client.workshop",
      "firebase": {
        "api_key": "AIza...",
        "app_id": "1:123456789:android:abc...",
        "messaging_sender_id": "123456789",
        "project_id": "client-project",
        "storage_bucket": "client-project.firebasestorage.app"
      }
    },
    "ios": {
      "bundle_id": "com.client.workshop",
      "firebase": {
        "api_key": "AIza...",
        "app_id": "1:123456789:ios:def...",
        "messaging_sender_id": "123456789",
        "project_id": "client-project",
        "storage_bucket": "client-project.firebasestorage.app"
      }
    }
  }
}
```

#### الحصول على جميع الإعدادات
```
GET /connector/api/app-config/all
```

**Response Example:**
```json
{
  "success": true,
  "data": [
    {
      "client_id": 123,
      "app_type": "workshop",
      "android": { ... },
      "ios": { ... }
    },
    {
      "client_id": 456,
      "app_type": "pos",
      "android": { ... },
      "ios": { ... }
    }
  ]
}
```

## خطوات التثبيت

### 1. تشغيل الـ Migration
```bash
php artisan migrate --path=database/migrations/2026_08_11_000001_create_client_firebase_configs_table.php
```

### 2. إضافة الإعدادات عبر لوحة التحكم
1. اذهب إلى `/admin/dashboard`
2. اختر تبويب "App Config"
3. أدخل بيانات العميل وإعدادات Firebase
4. اضغط "حفظ"

### 3. استخدام الـ API في التطبيق المحمول

**مثال في Flutter:**
```dart
// استدعاء الـ API
final response = await http.get(
  Uri.parse('https://your-domain.com/connector/api/app-config?client_id=123&app_type=workshop'),
  headers: {
    'Authorization': 'Bearer $token',
    'Accept': 'application/json',
  },
);

if (response.statusCode == 200) {
  final data = json.decode(response.body);
  if (data['success']) {
    final config = data['data'];
    
    // استخدام إعدادات Android
    if (config['android'] != null) {
      final androidConfig = config['android'];
      // تهيئة Firebase بإعدادات Android
    }
    
    // استخدام إعدادات iOS
    if (config['ios'] != null) {
      final iosConfig = config['ios'];
      // تهيئة Firebase بإعدادات iOS
    }
  }
}
```

## ملاحظات مهمة

1. **الأمان:** الـ API محمي بـ middleware `auth:api` لضمان أن المستخدمين المصرح لهم فقط يمكنهم الوصول للبيانات.

2. **المرونة:** النظام يدعم عملاء متعددين بأنواع تطبيقات مختلفة، مما يسمح بتخصيص إعدادات Firebase لكل عميل.

3. **التحديث:** يمكن تحديث الإعدادات في أي وقت عبر لوحة التحكم، وسيحصل التطبيق المحمول على الإعدادات الجديدة في المرة القادمة التي يستدعي فيها الـ API.

4. **التحقق:** يتحقق الـ Controller من وجود `client_id` قبل البحث في قاعدة البيانات.

5. **التخزين:** يتم تخزين الإعدادات في جدول منفصل لسهولة الإدارة والاستعلام.

## مثال على سيناريو الاستخدام

1. **السيناريو:** لديك عميل (Workshop) يريد تطبيق محمول خاص به بإعدادات Firebase مختلفة.

2. **الخطوات:**
   - أنشئ سجل جديد في جدول `client_firebase_configs` بـ `client_id = 123` و `app_type = 'workshop'`
   - أدخل إعدادات Firebase الخاصة بهذا العميل (Android و iOS)
   - في التطبيق المحمول، استدعي `GET /connector/api/app-config?client_id=123&app_type=workshop`
   - استخدم الإعدادات المستلمة لتهيئة Firebase في التطبيق

3. **النتيجة:** كل عميل يحصل على إعدادات Firebase الخاصة به دون الحاجة لتعديل الكود في التطبيق.
