# 📄 Project Documentation

## 1. الصلاحيات (Permissions)
- موجودة في ملف:
  `database/seeders/RoleSeeder.php`
- هنا بنضيف أسماء الصلاحيات الأساسية:
  ```php
  $permissions = [
      'user.view',
      'user.create',
      'user.edit',
      'user.delete',
      'role.view',
      'role.create',
      'role.edit',
      'role.delete',
       // صلاحية شاملة
  ];
  ```
- بعد كده بنعمل seeding:
  ```bash
  php artisan db:seed --class=RoleSeeder
  ```

---

## 2. الـ Routes
- موجودة في ملف:
  `routes/web.php`
- كل Route مربوط بصلاحية باستخدام الـ middleware:
  ```php
  Route::get('users/create', [UserController::class, 'create'])
      ->middleware('permission:user.create')
      ->name('users.create');
  ```
- نفس الأسلوب مستخدم مع الـ Roles.

---

## 3. الـ Blade Directives
- داخل ملفات الـ Blade نستخدم:
  - `@can('user.create')` → يظهر العنصر لو عنده الصلاحية.
  - `@canany(['user.edit', 'user.delete'])` → يظهر العنصر لو عنده أي واحدة من الصلاحيتين.
- مثال:
  ```blade
  @can('user.create')
      <a href="{{ route('users.create') }}" class="btn btn-success">إضافة مستخدم</a>
  @endcan

  @canany(['user.edit', 'user.delete'])
      <a href="{{ route('users.edit', $user->id) }}" class="btn btn-primary">تعديل</a>
      <form action="{{ route('users.destroy', $user->id) }}" method="POST">
          @csrf
          @method('DELETE')
          <button type="submit" class="btn btn-danger">حذف</button>
      </form>
  @endcanany
  ```

---

## 4. صلاحية الـ General Coordinator
- في ملف:
  `app/Providers/AuthServiceProvider.php`
- أضف:
  ```php
  Gate::before(function ($user, $ability) {
      if ($user->can('general_coordinator')) {
          return true;
      }
  });
  ```
- أي مستخدم معاه الصلاحية دي يقدر يعمل كل حاجة بدون الحاجة لكتابة شروط إضافية في الـ Blade.

---

## 5. الـ Header Component
- استخدم مكون Blade مخصص للـ Header:
  ```blade
  <x-header title="إدارة الأدوار" />
  ```
- المكون ممكن يكون في:
  `resources/views/components/header.blade.php`
  ```blade
  <div class="d-flex justify-content-between align-items-center mb-3">
      <h1 class="h4">{{ $title }}</h1>
      <a href="{{ url()->previous() }}" class="btn btn-secondary">رجوع</a>
  </div>
  ```
- النتيجة: يظهر عنوان الصفحة مع زرار Back يرجع للصفحة السابقة.

---

## 6. ملاحظات عامة
- **الـ Middleware** مسؤول عن حماية الـ Routes.  
- **الـ Blade Directives** مسؤولة عن إظهار/إخفاء العناصر في الواجهة.  
- **Seeder** مسؤول عن إنشاء الصلاحيات والأدوار في قاعدة البيانات.  
- **General Coordinator** يعتبر "سوبر يوزر" يملك كل الصلاحيات بشكل تلقائي.  
- **Header Component** بيخلي شكل الصفحات موحد مع عنوان وزر رجوع.

---