عرض 1: واجهة الإعدادات – إنشاء بطاقة
 

وصف كامل على مستوى الإدارة والإعدادات

 

نظرة عامة
 

**واجهة الإعدادات** هي لوحة التحكم الإدارية اللي يتم فيها إنشاء وتعريف وصيانة **قوالب البطاقات**.
هالواجهة تمثل **الطبقة الأساسية لنظام البطاقات**.
 

كل شي يتعلق بالبطاقات — إدخال بيانات العملاء، التصفية بالعنوان، المحفزات التلقائية، استخدام الـ API والتقارير — يعتمد بشكل كامل على طريقة تعريف البطاقة في هالواجهة.
 

على هالـمستوى:
 

• ما يتم إنشاء بيانات عملاء

• لسا ما فيه سجلات

• يتم تعريف بس **هيكل البطاقات وقواعدها وسلوكها**
   

عشان كذا، واجهة الإعدادات تستخدم **من قبل مدراء النظام بس** وتلعب دور حاسم في استقرار النظام وتناسق البيانات.
 

---

الموقع والوصول


واجهة إنشاء البطاقات موجودة داخل **منطقة إعدادات المسؤول**.
 

• **مسار الـ URL**: dashboard/admin/settings ← *إعدادات البطاقة*
   

قواعد الوصول
 

المستخدمين بس اللي يستوفون **كل** الشروط التالية يقدرون يوصلون لهالواجهة:
 

• يكون صاحب مؤسسة أو عنده دور مسؤول

• عنده صلاحية الوصول لإعدادات النظام

• عنده صلاحية إنشاء أو تعديل البطاقات
   

هالتقييد يضمن إن إعدادات البطاقات تبقى **مركزية ومتحكم فيها**.
 

---

هدف واجهة الإعدادات
 

واجهة الإعدادات موجودة عشان تسمح لمدراء النظام بـ:
 

• تعريف وحدات عمل مخصصة (بطاقات)

• التحكم بمكان ظهور البطاقات في النظام

• تعريف قواعد جمع البيانات المنظمة

• تعريف سير العمل باستخدام الحالات والحالات الفرعية

• تعيين صلاحيات الوصول

• تجهيز البطاقات للأتمتة واستخدام الـ API
   

بكلمات بسيطة:
 

**واجهة الإعدادات تحدد كيف تتصرف البطاقة في أي مكان ثاني بالنظام.**

---

هيكل واجهة إنشاء البطاقة
 

نموذج إنشاء البطاقة مقسم لـ**خمسة أجزاء منطقية**، كل جزء مسؤول عن جانب معين من سلوك البطاقة.

---

1. معلومات البطاقة الأساسية

(تعريف الهوية والنطاق)
 

هالقسم يحدد **وش هي البطاقة** و**وين مسموح لها تتواجد**.
 

هوية البطاقة
 

• مدراء النظام يوفرون أسماء للبطاقات بـ**الإنجليزي والعبري**

• الأسماء تستخدم بشكل ثابت في:

  • الإعدادات

  • التنقل في الرأس

  • عرض ملف تعريف العميل

  • ربط الـ API
     

معرف آمن للنظام يتم إنشاؤه تلقائياً من الاسم الإنجليزي ويستخدم داخلياً.
 

تعيين المجلد
 

• لازم يتم اختيار مجلد واحد أو أكثر

• البطاقة بتظهر بس للعملاء اللي يتبعون لهالمجلدات

• هالشي يمنع ظهور بطاقات غير ذات صلة لنوع العميل الغلط
   

تعيين المجلد إلزامي لأنها تحدد **نطاق** البطاقة.
 

---

2. تعريف الحالات
 

هالقسم يحدد **كيف تتنقل السجلات داخل البطاقة بين المراحل**.
 

مدراء النظام يعرفون:
 

• حالات رئيسية (مثلاً: جديد، قيد المعالجة، مكتمل)

• حالات فرعية اختيارية لكل حالة رئيسية

• ألوان عشان الوضوح البصري

• عناوين أعمدة للعرض متعدد اللغات
   

ليش الحالات مهمة
 

الحالات مو مجرد زينة.

هي تتحكم بـ:
 

• منطق التصفية

• محفزات الأتمتة

• التقارير

• مؤشرات بصرية في واجهة المستخدم
   

كل حالة:
 

• عندها معرف داخلي فريد

• عندها تسمية عرض

• ممكن تحتوي على عدة حالات فرعية
   

هالشي يخلي البطاقات تتصرف كـ**مسارات عمل، أو سير عمل، أو متتبعات عمليات**.
 

---

3. المشاركة والصلاحيات
 

هالقسم يحدد **مين يقدر يشوف البطاقة ويستخدمها**.
 

مدراء النظام يقدرون:
 

• يشاركون البطاقة مع كل أعضاء الفريق (افتراضي)

• يحددون البطاقة لمستخدمين معينين بس
   

إذا ما تم اختيار مستخدمين بشكل صريح، البطاقة تبقى ظاهرة لكل أعضاء الفريق.
 

هالشي يضمن:
 

• ممكن تحديد البطاقات الحساسة

• ممكن مشاركة البطاقات التشغيلية

• التحكم بالوصول يبقى مرن
   

---

4. إعدادات العرض والسلوك

(قواعد تكامل النظام)
 

هالقسم يتحكم بـ**كيف تندمج البطاقة مع الأجزاء الثانية بالنظام**.
 

الظهور في الرأس
 

• لما يتم تفعيلها، البطاقة تظهر في الرأس

• المستخدمين يقدرون يضغطون عليها عشان يصفون العملاء

• لما تكون معطلة، البطاقة تظهر بس داخل ملفات تعريف العملاء
   

ربط ونسخ البطاقات
 

• البطاقات ممكن تكون مرتبطة ببطاقات ثانية

• السجلات ممكن يتم نسخها تلقائياً

• تغييرات الحالات ممكن تتزامن بشكل اختياري بين البطاقات المرتبطة
   

هالخيارات تسمح بـ**سير عمل متقدم بين عدة بطاقات**.
 

---

5. عناصر التحكم بالعملية

(منطق الحفظ والتحديث)
 

في أسفل النموذج:
 

• زر **حفظ** يتحقق ويرسل الإعدادات

• حقول مخفية تتبع إذا كانت العملية إنشاء أو تحديث

• إعدادات البطاقات الموجودة يتم تحديثها مكانها
   

بعد الحفظ:
 

• البطاقة تصير فعالة فوراً

• وتكون متوفرة في كل النظام

• لسا ما تم إنشاء بيانات عملاء
   

---

قائمة البطاقات (عرض الإدارة)
 

تحت النموذج، الواجهة تعرض قائمة بكل البطاقات الموجودة.
 

من هالـقائمة، مدراء النظام يقدرون:
 

• يعدلون بطاقة

• ينسخون بطاقة

• يضيفون أو يعدلون حقول مخصصة

• يحذفون بطاقة (مع تأكيد)
   

هالـقائمة تستخدم كـ**لوحة تحكم الإدارة** لكل إعدادات البطاقات.
 

---

تعريف الحقول المخصصة
 

الحقول المخصصة تحدد **وش البيانات اللي يتم جمعها** داخل البطاقة.
 

يتم إضافة الحقول عن طريق نافذة منبثقة مخصصة وتدعم:
 

• نص، رقم، تاريخ، وقت

• اختيار واختيار متعدد

• مفاتيح نعم/لا

• اختيار عضو فريق

• إحالة عميل

• ملفات ومرفقات

• حقول محسوبة مبنية على معادلات

• عناوين الأقسام والفواصل
   

كل حقل يتضمن:
 

• تسميات بالإنجليزية والعبرية

• إشارة إجبارية

• قيم افتراضية

• التحقق الخاص بالنوع
   

داخلياً، كل الحقول مخزنة كـ**مخطط JSON**، اللي تسمح بمرونة لا محدودة بدون تغييرات في قاعدة البيانات.
 

---

منطق الحفظ والمعالجة
 

لما يتم إرسال النموذج:
 

1. يتم التحقق من جانب العميل

2. السيرفر يتحقق من الصلاحيات والبيانات

3. هياكل الحالات تتم تسويتها

4. بيانات المجلدات والمشاركة يتم معالجتها

5. مخططات الحقول يتم ترميزها

6. البيانات تدخل أو تتحدث في tabs_setting
    

الحفظ الناجح يفعل البطاقة فوراً.
 

---

الملخص المفاهيمي النهائي
 

• **واجهة الإعدادات** = المخطط الرئيسي

• **إعدادات البطاقة** = القواعد والهيكل

• **سجلات البطاقة** = بيانات العملاء الفعلية (يتم إنشاؤها لاحقاً)
   

تغيير الإعدادات يؤثر على **السلوك**، مو على البيانات الموجودة.
 

---

فهم نهائي في سطر واحد
 

**واجهة الإعدادات لإنشاء البطاقات هي طبقة المخطط الرئيسي الإدارية اللي فيها يتم تعريف البطاقات وتحديد نطاقها وبناؤها وتوحيدها، قبل ما تستخدم في أي مكان ثاني في نظام Biz1.**