# Laravel & Filament Shortcuts Guide

هذا الملف يحتوي على جميع الاختصارات المتاحة لتسهيل العمل مع Laravel و Filament.

## 🚀 PowerShell Aliases

### Laravel Artisan Commands
| الاختصار | الأمر الأصلي | الوصف |
|---------|------------|-------|
| `art` | `php artisan` | أمر artisan أساسي |
| `serve` | `php artisan serve` | تشغيل السيرفر المحلي |
| `migrate` | `php artisan migrate` | تنفيذ migrations |
| `fresh` | `php artisan migrate:fresh --seed` | إعادة بناء قاعدة البيانات مع البذور |
| `tinker` | `php artisan tinker` | فتح Laravel REPL |
| `queue` | `php artisan queue:work` | تشغيل queue worker |
| `cache-clear` | `php artisan cache:clear` | مسح الكاش |
| `config-clear` | `php artisan config:clear` | مسح كاش الإعدادات |
| `route-list` | `php artisan route:list` | عرض قائمة الروتس |

### Laravel Make Commands
| الاختصار | الأمر الأصلي | الوصف |
|---------|------------|-------|
| `make-model` | `php artisan make:model` | إنشاء model جديد |
| `make-controller` | `php artisan make:controller` | إنشاء controller جديد |
| `make-migration` | `php artisan make:migration` | إنشاء migration جديد |

### Laravel Additional Commands
| الاختصار | الأمر الأصلي | الوصف |
|---------|------------|-------|
| `logs` | `php artisan logs:clear` | مسح ملفات السجلات |
| `optimize` | `php artisan optimize` | تحسين الأداء |
| `down` | `php artisan down` | وضع الموقع في وضع الصيانة |
| `up` | `php artisan up` | إخراج الموقع من وضع الصيانة |
| `schedule` | `php artisan schedule:work` | تشغيل المهام المجدولة |
| `storage-link` | `php artisan storage:link` | إنشاء رابط المخزن |

### 🛡️ Filament Shield Commands
| الاختصار | الأمر الأصلي | الوصف |
|---------|------------|-------|
| `shield-install` | `php artisan shield:install` | تثبيت Filament Shield |
| `shield-generate` | `php artisan shield:generate` | توليد الأذونات والسياسات |
| `shield-seeder` | `php artisan shield:seeder` | إنشاء seeder للأذونات |
| `shield-super-admin` | `php artisan shield:super-admin` | إنشاء مستخدم super admin |
| `shield-publish` | `php artisan vendor:publish --tag=filament-shield-config` | نشر إعدادات Shield |
| `shield-upgrade` | `php artisan shield:upgrade` | ترقية Shield |

### Quick Shield Commands
| الاختصار | الأمر الأصلي | الوصف |
|---------|------------|-------|
| `permissions` | `php artisan shield:generate --all` | توليد جميع الأذونات |
| `super-admin` | `php artisan shield:super-admin` | إنشاء مدير عام |
| `shield-seed` | `php artisan db:seed --class=ShieldSeeder` | زراعة بيانات الأذونات |

## 📦 Composer Scripts

| الاختصار | الأمر الأصلي | الوصف |
|---------|------------|-------|
| `composer fresh` | `php artisan migrate:fresh --seed` | إعادة بناء قاعدة البيانات |
| `composer serve` | `php artisan serve` | تشغيل السيرفر |
| `composer tinker` | `php artisan tinker` | فتح Laravel REPL |
| `composer queue` | `php artisan queue:work` | تشغيل queue worker |
| `composer cache` | `php artisan cache:clear && config:clear && view:clear` | مسح جميع أنواع الكاش |
| `composer routes` | `php artisan route:list` | عرض قائمة الروتس |
| `composer check` | `pint + test + phpstan` | فحص الكود والاختبارات |
| `composer dev` | تشغيل السيرفر + Queue + Logs + Vite | بيئة التطوير الكاملة |

## 🔧 أمثلة الاستخدام

### Laravel Basic Commands
```powershell
# تشغيل السيرفر
serve

# عمل migration جديد
migrate

# إعادة بناء قاعدة البيانات
fresh

# إنشاء model جديد
make-model User

# مسح الكاش
cache-clear

# عرض الروتس
route-list
```

### Filament Shield Commands
```powershell
# توليد جميع الأذونات
permissions

# إنشاء مدير عام
super-admin

# توليد أذونات محددة
shield-generate --resource=UserResource

# زراعة بيانات الأذونات
shield-seed
```

### Composer Scripts
```powershell
# إعادة بناء قاعدة البيانات
composer fresh

# تشغيل بيئة التطوير الكاملة
composer dev

# فحص الكود
composer check

# مسح جميع أنواع الكاش
composer cache
```

## 📝 ملاحظات

- جميع الاختصارات تدعم إضافة معاملات إضافية
- يتم تحميل الاختصارات تلقائياً في كل جلسة PowerShell جديدة
- يمكنك تعديل الاختصارات من ملف: `$PROFILE`
- لإعادة تحميل الاختصارات: `. $PROFILE`

## 🎯 نصائح سريعة

### أوامر يومية مفيدة
```powershell
# بدء العمل
serve                    # تشغيل السيرفر
queue                    # تشغيل queue في terminal آخر

# أثناء التطوير  
migrate                  # تنفيذ migrations جديدة
cache-clear              # مسح الكاش عند الحاجة
route-list              # مراجعة الروتس

# نهاية اليوم
fresh                    # إعادة بناء قاعدة البيانات للاختبار
permissions              # تحديث الأذونات عند الحاجة
```

### إدارة الأذونات
```powershell
# الإعداد الأولي
shield-install           # تثبيت Shield
permissions              # توليد جميع الأذونات
super-admin             # إنشاء مدير عام

# التحديثات
permissions              # عند إضافة resources جديدة
shield-seed             # عند تغيير الأذونات
```