# 🎨 أنواع الكيانات المخصصة

## 📋 الأنواع الثابتة من النظام

النظام يوفر 8 أنواع ثابتة:

| # | النوع | الاستخدام |
|---|-------|-----------|
| 1 | شركة | الشركات التجارية |
| 2 | مؤسسة | المؤسسات الفردية |
| 3 | فرد | الأفراد |
| 4 | جهة حكومية | الجهات الحكومية |
| 5 | موظف | الموظفون |
| 6 | مقاول | المقاولون |
| 7 | مورد | الموردون |
| 8 | مقدم خدمة | مقدمي الخدمات |
| 9 | 🔧 نوع مخصص | **يحددها المستخدم بنفسه** |

---

## 🌟 الأنواع المخصصة

### **ما هي؟**
عندما تختار "🔧 نوع مخصص"، يمكنك كتابة أي نوع تريده، مثل:
- محاسب
- مستشار
- وسيط
- محامي
- مهندس
- مصمم
- مبرمج
- أي شيء آخر!

---

## 🎯 كيفية الاستخدام

### **1. إضافة كيان بنوع مخصص:**

```
1. افتح: سند صرف عام
2. اضغط: ⚙️ إدارة الكيانات
3. اضغط: + إضافة كيان جديد
4. نوع الكيان: [🔧 نوع مخصص (أدخله بنفسك) ▼]
   
   ↓ يظهر حقل جديد:
   
5. اكتب النوع المخصص: [محاسب]
6. اسم الكيان: [مكتب محمد للمحاسبة]
7. ... (بقية الحقول)
8. [حفظ الكيان]
```

---

## 📊 الواجهة

### **عند اختيار "نوع مخصص":**

```
┌──────────────────────────────────────────┐
│ نوع الكيان [ثابت من النظام]            │
│ [🔧 نوع مخصص (أدخله بنفسك) ▼]          │
│                                           │
│ ✏️ اكتب النوع المخصص [مخصص]            │
│ [محاسب________________________]          │
│                                           │
│ اسم الكيان                               │
│ [مكتب محمد للمحاسبة___________]         │
└──────────────────────────────────────────┘
```

---

## 🎨 عرض الأنواع المخصصة

### **في الجدول:**
```
نوع الكيان
─────────────────
[شركة]           (أزرق - ثابت)
[مؤسسة]          (أزرق - ثابت)
[⭐ محاسب]       (برتقالي - مخصص)
[⭐ مستشار]      (برتقالي - مخصص)
[موظف]           (أزرق - ثابت)
```

### **في Select الكيان:**
```
[اختر الكيان ▼]
  شركة ABC (شركة)
  مكتب XYZ (مؤسسة)
  محمد للمحاسبة (محاسب) [مخصص]
  أحمد (مستشار) [مخصص]
```

---

## 🔍 البحث والتصفية

### **البحث:**
```
🔍 ابحث: "محاسب"
→ النتائج:
  • مكتب محمد للمحاسبة (⭐ محاسب)
  • مكتب علي للمحاسبة (⭐ محاسب)
```

### **التصفية:**
```
[فلتر نوع الكيان ▼]
  ☐ شركة
  ☐ مؤسسة
  ☐ فرد
  ☐ جهة حكومية
  ☐ موظف
  ☐ مقاول
  ☐ مورد
  ☐ مقدم خدمة
  ☐ 🌟 مخصص (جميع الأنواع المخصصة)
```

---

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

### **الحقول:**
```sql
office_entities:
  - entity_type: 'custom'
  - entity_type_custom: 'محاسب'
```

### **أمثلة:**

| id | entity_type | entity_type_custom | entity_name |
|----|-------------|--------------------|-------------|
| 1 | company | NULL | شركة ABC |
| 2 | individual | NULL | محمد علي |
| 3 | custom | محاسب | مكتب محمد |
| 4 | custom | مستشار | أحمد للاستشارات |
| 5 | employee | NULL | سعد (موظف) |

---

## 🎯 أمثلة عملية

### **مثال 1: محاسب**
```
نوع الكيان: [🔧 نوع مخصص]
النوع المخصص: [محاسب]
اسم الكيان: [مكتب محمد للمحاسبة]
رقم السجل: 1234567890
جوال: 0501234567

النتيجة:
✓ يظهر في الجدول: ⭐ محاسب (برتقالي)
✓ يظهر في Select: مكتب محمد (محاسب) [مخصص]
```

---

### **مثال 2: مستشار عقاري**
```
نوع الكيان: [🔧 نوع مخصص]
النوع المخصص: [مستشار عقاري]
اسم الكيان: [أحمد للاستشارات]

النتيجة:
✓ نوع فريد خاص بك
✓ ينحفظ في نظامك فقط
✓ لا يظهر للمكاتب الأخرى
```

---

### **مثال 3: محامي**
```
نوع الكيان: [🔧 نوع مخصص]
النوع المخصص: [محامي]
اسم الكيان: [مكتب المحامي سعد]
العملاء:
  - عميل 1: محمد علي
  - عميل 2: أحمد سعد

النتيجة:
✓ كيان محامي مع عملائه
✓ جاهز لإصدار سندات صرف
```

---

## ✅ المميزات

### **1. مرونة كاملة**
```
✓ لا تحديد لعدد الأنواع المخصصة
✓ اكتب أي نوع تريده
✓ مناسب لكل الأعمال
```

### **2. تمييز واضح**
```
✓ أنواع النظام: أزرق
✓ أنواع مخصصة: برتقالي ⭐
✓ سهل التفريق
```

### **3. بحث وتصفية**
```
✓ ابحث بالنوع المخصص
✓ صفي "كل المخصصة"
✓ نتائج دقيقة
```

---

## 🔒 الأمان

### **عزل البيانات:**
```
✓ كل مكتب يرى أنواعه المخصصة فقط
✓ المكتب A لا يرى أنواع المكتب B
✓ خصوصية كاملة
```

---

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

### **1. النوع المخصص مطلوب:**
```
إذا اخترت "🔧 نوع مخصص"
→ يجب كتابة النوع المخصص
→ وإلا لن يُحفظ الكيان
```

### **2. التعديل:**
```
✓ يمكن تعديل النوع المخصص لاحقاً
✓ يمكن تغييره من مخصص إلى ثابت
✓ يمكن تغييره من ثابت إلى مخصص
```

### **3. الحذف:**
```
⚠️ حذف الكيان يحذف:
  - بيانات الكيان
  - النوع المخصص
  - العملاء المرتبطين
```

---

## 🚀 الاستخدام السريع

### **تدفق كامل:**
```
1. إدارة الكيانات
2. + إضافة كيان
3. نوع: [🔧 نوع مخصص]
4. اكتب: "محاسب"
5. اسم: "مكتب محمد"
6. + إضافة عميل
7. حفظ
   ↓
8. سند صرف عام
9. اختر: مكتب محمد (محاسب) [مخصص]
10. اختر العميل
11. أكمل السند
12. حفظ ✓
```

---

## 🎊 جاهز!

**الآن يمكنك:**
- ✅ استخدام 8 أنواع ثابتة
- ✅ إنشاء أنواع مخصصة غير محدودة
- ✅ مرونة كاملة في التصنيف
- ✅ تنظيم أفضل لكياناتك

---

**الإصدار:** 6.1.0  
**التاريخ:** 2025-10-26  
**الميزة:** أنواع كيانات مخصصة ✨

