المحررات المخصصة

ثمة أعمال لا توجد في أي لوحة، لأنها خاصة بك وحدك: إعادة حساب الأسعار وفق معادلة المورّد، ومطابقة الكتالوج مع نظام محاسبي آخر، وشاشة «تعبئة خصائص الدفعة في مرور واحد». يتيح قسم «المحررات المخصصة» كتابة محرر مصغّر كهذا بنفسك (أو طلبه من مطوّر) وتشغيله داخل لوحة الإدارة — في بيئة معزولة، بوصول إلى البيانات التي سمحت بها فقط.

للفتح: لوحة الإدارة → المحررات المخصصة (admin.cenaly.com/custom-editors). يُفعَّل القسم عبر بطاقة «المحررات المخصصة (SDK)» في متجر التطبيقات — وهو مخفي افتراضيًا. وزر «📌 إلى الشريط الجانبي» في الصفحة نفسها يضيفه إلى القائمة الجانبية عندما تحتاج إليه كثيرًا.

ما هذا القسم#

الإضافة عبارة عن سكربت مُجمَّع (index.js) ووصفه (manifest.json). تحمّل اللوحة السكربت في إطار معزول: فلا وصول له إلى جلستك، ولا إلى كود لوحة الإدارة، ولا إلى الشبكة. ولا يمكنه التخاطب مع البيانات إلا عبر الجسر — مجموعة من الطلبات المسموح بها، يُتحقق من كل واحد منها وفق الصلاحيات الممنوحة.

تتكوّن الصفحة من الكتل التالية:

المحرر المفتوح يشغل الشاشة كاملة، ويحصل عنوان الصفحة على لاحقة ?app=<المعرّف> — ويمكنك مشاركة هذا الرابط مع من لديه صلاحية الوصول.

ما يلزم للتشغيل#

الخطوة 1. تحديد من سيكتب المحرر#

ثمة ثلاثة مسارات، وتختلف بحسب من يملك الكود:

في المسارات الثلاثة جميعًا يبقى التثبيت بيد المالك: فحتى المطوّر الحاصل على صلاحية لا يستطيع إلا تشغيل كوده في وضع المطوّر عنده، لا تثبيته في الحساب.

الخطوة 2. التطوير بالذكاء الاصطناعي (البرمجة بالوصف)#

توفّر كتلة «🤖 التطوير بالذكاء الاصطناعي (البرمجة بالوصف)» أربعة أشياء لتسليم المهمة إلى وكيل ذكاء اصطناعي (Claude Code وCursor وما شابههما) دون شرح العقد له من الصفر:

1. «⬇️ تنزيل قالب المشروع (zip)» — هيكل جاهز للإضافة: البيان، ونقطة الدخول، ووصف العقد (GUIDE.en.md)، وتعليمات للوكيل. يُجمَّع الأرشيف في المتصفح مباشرة، دون تنزيل أي شيء من الخارج.
2. «📋 نسخ الموجّه للوكيل» — نص المهمة بالإنجليزية: الانطلاق من القالب، والرجوع إلى الدليل، وكيفية التحقق من النتيجة.
3. إعداد مجموعة أدوات للوكيل — وبها يجمع الوكيل الإضافة، ويقيم نسخة محلية من البيئة المعزولة، ويلتقط صورًا ولقطات للحالة، ويجمع في النهاية إصدارًا: ملف zip للتثبيت اليدوي أو إصدار في GitHub.
4. «⬇️ تنزيل لقطة الكتالوج (بيانات اختبار)» — فئاتك وعناصرك في ملف، ليختبر الوكيل على بيانات حقيقية لا على بيانات مُتخيَّلة.

⚠️ تُقتطع من اللقطة كليًا الحقول المخصصة لإضافات أخرى: فالبيانات التي يحفظها امتداد غيرك على بطاقاتك لا تخرج من الحساب مع بيانات الاختبار.

الخطوة 3. تثبيت المحرر#

من الملفات. كتلة «تثبيت محرر»: اختر «الحزمة (index.js)» و«البيان (manifest.json)» → «تحقق وثبّت». تتحقق اللوحة أولًا من البيان — المعرّف، والاسم المترجم، والإصدار، والحد الأدنى لإصدار SDK، والمواضع، والصلاحيات، وقائمة المضيفات الشبكية — ثم تعرض الموافقة: «يطلب هذا المحرر:» وقائمة الصلاحيات بلغة واضحة. وما لم تضغط «تثبيت»، لا يُثبَّت أي شيء.

من GitHub. كتلة «التثبيت من GitHub»: حقل «المستودع (URL أو owner/repo)»، وحقل «الوسم (فارغ = آخر إصدار)»، وزر «تحقق من المستودع». والاصطلاح بسيط: manifest.json في جذر المستودع، وdist/index.js المُجمَّع في الوسم، والوسم بصيغة v{الإصدار}. يُسحب البيان والحزمة من متصفحك مباشرة. وفي الحالتين يُحسب عند التثبيت ويُحفظ بصمة الحزمة (sha256): فإذا استُبدل الملف لاحقًا، يُحظر التشغيل وتطلب اللوحة إعادة تثبيت المحرر.

الحقوق وأماكن النشر#

الحقوق (وتسمى أيضًا النطاقات) يطلبها الملحق في ملف التعريف، وأنت تؤكدها عند التثبيت. القائمة الكاملة هي هذه، ولا يستطيع الجسر فعل أي شيء أكثر من ذلك:

وما ليس في القائمة إطلاقًا لن يحصل عليه الملحق بأي إعدادات: الضيوف والعملاء، والطلبات، والإيصالات، والبيانات المالية، والموظفون، والمراسلات والمكالمات — لا يمنحها الجسر.

أماكن النشر (الفتحات) ثلاث:

وضع المطوّر والوصول للمتعهد#

وضع المطوّر (كتلة «🛠️ وضع المطوّر») يثبّت الملحق مباشرة من حاسوبك: حقل «URL الحزمة» لا يقبل إلا عناوين localhost / 127.0.0.1، وبجواره «JSON ملف التعريف»، وزر «بدء جلسة التطوير». وفي هذه الحالة لا يُثبَّت البصمة، وتبقى الجلسة حتى إغلاق علامة التبويب؛ و«إيقاف جلسة التطوير» يوقفها فورًا.

منح المطوّر (كتلة «👩‍💻 وصول المطوّر») مطلوبة عندما لا يكون الكاتب هو المالك. يُنشأ للمطوّر حساب موظف عادي، ثم يمنح المالك المنحة: «البريد الإلكتروني للمطوّر (تسجيل دخوله كموظف)»، و«الحقوق المسموح بها»، و«مدة الصلاحية (بالأيام)» وملاحظة اختيارية → «منح الوصول». ويمكن الإلغاء في أي لحظة بزر «إلغاء».

ما تمنحه المنحة وما لا تمنحه:

• تمنح — وضع المطوّر فقط بالحقوق التي حددتها (المدة الافتراضية 14 يومًا، والحد الأقصى 90)؛
• تُقصّ الحقوق بالتقاطع: ما يطلبه ملف التعريف و ما مُنح في المنحة؛ فلن يحصل الملحق على أكثر من ذلك، حتى لو طلبه في ملف التعريف؛
• لا تمنح — تثبيت الملحقات وتشغيلها وحذفها: يبقى ذلك للمالك.

التحديث والتشغيل والحذف#

لا يوجد تحديث تلقائي عن قصد: فالنسخة الجديدة من كود شخص آخر هي بصمة جديدة، وربما حقوق جديدة، لذلك يكون التحديث دائمًا إجراءً واعيًا من المالك.

الإضافات المدمجة#

بعض وحداتنا الخاصة محزومة بالصيغة نفسها — ويظهر ذلك من السلوك، لكن لا حاجة لتثبيتها: فهي تأتي مع اللوحة وتُشغَّل من بطاقة في متجر التطبيقات، لا في هذا القسم.

وحاليًا هناك وحدة واحدة من هذا النوع — «Mercury/VetIS» لروسيا: تعمل كعلامة تبويب في قسم «المخزون»، وتُنفَّذ في الرملة نفسها وبفحوص البصمة نفسها. ولا تدخل الإضافات المدمجة في قائمة المحررات المثبّتة.

ما يستطيع المحرر فعله وما لا يستطيع#

تُوسم ملحقات الطرف الثالث على البطاقة بتحذير: «تطبيق طرف ثالث في الرملة — لا يطلب كلمة المرور أبدًا». وإذا طلب الملحق بيانات دخول اللوحة أو بيانات الدفع أو رمزًا من رسالة SMS — فهذا احتيال، وليس عمل الإضافة.

القيود#

• القسم مُعطَّل افتراضيًا وهو موجَّه لمن يكتبون الكود (أو يطلبونه): لا شأن للمالك العادي به هنا.
• كل شيء عدا العرض متاح لمالك الحساب فقط. يرى الموظف المركز بصلاحية قراءة فقط؛ ووضع المطوّر لا يُفعَّل إلا بمنحة سارية.
• مستودعات GitHub الخاصة غير مدعومة — يجب أن يكون المستودع عامًّا، ويتم التثبيت عبر وسم الإصدار.
• لا توجد تحديثات تلقائية: تحديث الإضافة يشغّله المالك دائمًا.
• لا يوجد متجر لإضافات الآخرين. لا تُنشر الإضافات الجاهزة ولا تُباع عبر اللوحة — المصدر هو ملفك أو مستودعك فقط.
• هناك ثلاث خانات (صفحة خاصة، زر الكتالوج، تبويب المخزون) — لا يمكن للإضافة أن تتوضع في أي شاشة عشوائية من اللوحة.
• الجسر لا يمنح الوصول إلى الضيوف أو الطلبات أو المالية أو الموظفين أو المراسلات — ولا يمكن تجاوز ذلك بالصلاحيات، إذ لا وجود لمثل هذه الطلبات أصلًا.
• لا يوجد سجل منفصل بعنوان «الإضافة فعلت كذا». تظهر الصلاحيات على البطاقة، وتدخل تعديلات الكتالوج في سجل العناصر المعتاد؛ وإن أردت تحكمًا، فابدأ بإضافة مُنحت صلاحية القراءة فقط.
• الحدود التقنية: حزمة حتى 4 ميجابايت، وحتى 8 عناوين شبكية في البيان، وحتى 1 ميجابايت لكل مفتاح تخزين؛ والتشغيل من الخادم حتى 30 ثانية وحتى 50 اتصالًا بالإنترنت في المرة الواحدة.
• تبقى بيانات الإضافة في سحابة علامتك التجارية: بالنسبة لحساب على cenaly.ru يقع وضع الجزء الخادمي في المحيط الروسي.

استكشاف الأخطاء وإصلاحها#

الأسئلة الشائعة#

هل يجب أن أعرف البرمجة؟#

لتثبيت إصدار جاهز — لا. وللحصول على الإصدار نفسه — نعم: يكتبه مطوّر أو وكيل ذكاء اصطناعي وفق قالبنا من قسم «التطوير بالذكاء الاصطناعي». القسم أداة للكود، وليس مُنشئًا يعمل «بالفأرة».

هل يمكن لإضافة تابعة لطرف آخر رؤية عملائي أو إيراداتي؟#

لا. تعمل الإضافة في بيئة معزولة ولا تتلقى البيانات إلا عبر الجسر، والجسر قادر على ستة أمور فقط: الكتالوج، والأسعار وقوائم الإيقاف، ودليل المخزون، وتخزينها الخاص، واستدعاء جزءها الخادمي، وعناصر الواجهة. أما الضيوف والطلبات والإيصالات والمالية والموظفون والمراسلات فغير موجودة هناك مبدئيًا. وما هو مسموح تحديدًا لإضافة معيّنة يظهر دائمًا على بطاقتها في سطر «الصلاحيات».

كيف أسلّم التطوير لمتعهد دون إدخاله إلى الحساب بالكامل؟#

أنشئ له حساب موظف، ثم امنحه منحة في قسم «وصول المطوّر»: حدِّد الصلاحيات المطلوبة فقط واضبط المدة (14 يومًا افتراضيًا، و90 كحد أقصى). سيحصل على وضع المطوّر ولا شيء غيره؛ ويبقى تثبيت الإضافة من نصيبك على أي حال. وتُسحب المنحة بزر واحد.

هل ستُحدَّث الإضافة تلقائيًا عندما يصدر المؤلف إصدارًا جديدًا؟#

لا. المالك هو من يشغّل التحديث: «التحقق من التحديثات» ← «التحديث إلى …». وهكذا لا يظهر إصدار جديد في الحساب دون علم أحد — فقد تتغير الصلاحيات المطلوبة مع الإصدار.

أين تحفظ الإضافة إعداداتها وبياناتها؟#

في حسابك، في تخزين منفصل تحت معرّفها (حتى 1 ميجابايت لكل مفتاح)، وإضافةً إلى ذلك، إن كانت تستخدمها، في الحقول المخصصة لبطاقاتك — وكل إضافة ترى مساحتها فقط. وبالنسبة لحساب على cenaly.ru يبقى الجزء الخادمي وحالته في المحيط الروسي.

كيف يختلف هذا عن API وMCP؟#

API للمطورين وMCP لمقسمك ضروريان عندما يعمل البرنامج من الخارج: موقعك الخاص، أو نظام محاسبة لطرف آخر، أو وكيل ذكاء اصطناعي. أما المحرر المخصص فهو على العكس واجهة داخل اللوحة: يفتحه الموظف كصفحة عادية من صفحات لوحة الإدارة ولا يغادر نافذة العمل.

أقسام ذات صلة#

• متجر التطبيقات — حيث يُفعَّل القسم والإضافات المدمجة
• المخزون — التبويب الذي تعمل فيه إضافات مثل «VetIS»، ودليل المنتجات
• استيراد الكتالوج — الطريق المعتاد لتحميل العناصر، إن كانت المهمة تقتصر على ذلك
• واجهة عرض على كودك الخاص (headless) — عقد بيانات مفتوح لموقع خارجي
• API وMCP لمقسمك وGuest API لوكلاء الذكاء الاصطناعي — العمل من الخارج، لا من داخل اللوحة
• الموظفون والورديات — حساب للمطوّر والأدوار
• الأمان والبيانات — أين تُخزَّن البيانات ومن يمكنه الوصول إليها
• الدعم — أين تكتب إذا سلكت الإضافة سلوكًا مريبًا