كيفية استخدام هذا المسرد
تصف مصطلحات KayanOS طبقات مختلفة من رحلة الخدمة نفسها. في مثال طلب خدمة المواطن، يبدأ المواطن جلسة نموذج؛ ويعمل الموظفون مع سجلات في كيان؛ ويحدد دور مقيد بالنطاق أي أفعال يستطيع العضو استعمالها؛ ويوفر معرف تسلسلي مرجعاً قابلاً للتتبع؛ وينتج قالب مستند إشعاراً؛ وتعرض لوحة معلومات عبء عمل مجمعاً؛ وتتفاعل أتمتة مع حدث معتمد. استخدم المصطلحات أدناه باتساق في الإعداد والتدريب والإجراءات وطلبات الدعم والتسميات الثنائية اللغة. قد تحمل كلمة مألوفة مثل «طلب» معنى تقنياً مختلفاً عن «نموذج» أو «جلسة» أو «سجل»؛ اختر المصطلح الدقيق عند شرح مشكلة أو صلاحية.
المؤسسة والوصول
| المصطلح | المعنى العملي |
|---|---|
| المؤسسة | مساحة KayanOS التي تملك أعضاءها وسجلاتها وإعدادها ولغاتها وحدود وصولها. |
| العضو | مستخدم داخلي موثق مرتبط بمؤسسة، وقد يملك أدواراً ونطاقات. |
| المشارك العام | شخص يستخدم نموذجاً/جلسة عامة مؤهلة، ولا يصبح عضواً في المؤسسة تلقائياً. |
| الدور | مجموعة مسماة من إجراءات المورد المسموحة، تعين للأعضاء تحت نطاق معتمد. |
| الصلاحية | قرار أن الفاعل يستطيع أداء عملية محددة ضمن المؤسسة والمورد والنطاق وقواعد الحالة الحالية. |
| المورد | الشيء المتحكم به الذي تنطبق عليه الصلاحية، مثل كيان أو نموذج أو لوحة أو سطح إدارة رمز أو ميزة صادرة أخرى. |
| الفعل | العملية المحددة على مورد، مثل العرض أو الفتح أو الإنشاء أو التحديث أو الحذف أو البدء أو الإدارة؛ الأفعال خاصة بالمورد. |
| النطاق | حد وصول مرتبط بالأدوار والسجلات، مثل مركز خدمة أو ناحية أو وحدة تنظيمية أو نطاق نموذج. |
| الهيكل | بنية الأب/الابن المضبوطة التي تستخدم عندما يطبق تعيين نطاق مطابقاً أو على الأسلاف أو التوابع. |
| المالك | الشخص أو الدور المؤسسي المسؤول عن سجل أو إعداد أو رمز أو اتصال أو قرار تغيير. الملكية ليست كل صلاحية تلقائياً. |
| الإتاحة | إمكان استخدام قدرة في هذا السياق بعد فحوص المؤسسة والإصدار والدور/الفعل والنطاق والإعداد والحالة ووقت التشغيل. |
| أقل صلاحية | إعطاء الفاعل أصغر مجموعة أفعال ونطاقات ووصول بيانات لازمة للنتيجة المعتمدة. |
المنشئ والكيانات والسجلات
| المصطلح | المعنى العملي |
|---|---|
| التطبيق | تجميع KayanOS يساعد الناس على التنقل بين الكيانات وعمل الخدمة المرتبط. |
| الكيان | نوع سجل قابل للضبط، مثل طلب خدمة مواطن أو معاينة أو مركز خدمة أو قرار. |
| مفتاح الكيان | المفتاح التقني الثابت المستخدم في الإعداد والتعبيرات وطلبات API والتكاملات، وليس بالضرورة عنوان العرض المترجم. |
| السجل | مثيل محفوظ واحد من كيان. سجل طلب خدمة مواطن حالة خدمة واحدة لا تعريف الكيان كله. |
| الحقل | سمة مضبوطة لسجل أو عنصر نموذج، مثل نص أو اختيار أو تاريخ أو علاقة أو ملف أو معرف تسلسلي أو قيمة محسوبة. |
| مفتاح الحقل | المعرف المخزن الثابت للحقل. يمكن ترجمة التسميات؛ تعامل مع المفاتيح كعقود إعداد/API. |
| العلاقة | حقل/إعداد يربط السجلات، ويحدد اتجاهها وعددها كيف ترتبط السجلات. |
| العلاقة العكسية | عرض سجلات مرتبطة مهيأ يصل من الاتجاه المقابل للعلاقة، وليس دليلاً أن كل بيانات مرتبطة ممكنة متاحة. |
| التخطيط | طريقة ترتيب الحقول والأقسام وعلامات التبويب والمعلومات المرتبطة للمستخدمين. رؤية التخطيط ليست قاعدة تحكم وصول. |
| الحالة | حالة سجل مضبوطة تمثل التقدم، مثل وارد أو مجدول للمعاينة أو مراجعة قرار أو مغلق. |
| قالب الحالة | رسم/تعريف قابل لإعادة الاستخدام للحالات والفئات والانتقالات والإجراءات المسموحة، يحكم دورة حياة لا تسمية نص حر. |
| المعرف التسلسلي | معرف قابل للتتبع مولد بإعداد تسلسل ومساحة اسم وتنسيق وتوقيت، مثل CSR-2026-00042. |
| الحقل المحسوب | حقل مشتق من بيانات/منطق تعبير مضبوط، ويجب أن يكون حتمياً وقابلاً للشرح ومختبراً بقيم مصدره. |
| التعبير | تعبير KayanOS صغير في سياق مدعوم لاشتقاق قيمة أو شرط أو تنسيق أو سلوك مضبوط، وليس بديلاً عن تفويض الخادم. |
| مقترح منشئ | اقتراح بناء مساعد قابل للمراجعة لبنية تطبيق/كيان/حقل، لا يغير شيئاً حتى يحفظ صراحةً. |
النماذج والجلسات والمستندات
| المصطلح | المعنى العملي |
|---|---|
| النموذج | تصميم تفاعل خدمة قابل لإعادة الاستخدام فيه حقول وأقسام وإجراءات وتوقيعات وإصدار وجمهور/نموذج وصول. |
| إصدار النموذج | بنية نموذج محفوظة تستخدم لتفسير جلسة. يجعل نشر إصدارها مؤهلاً للرحلة الصادرة المناسبة. |
| جلسة النموذج | مثيل عمل نموذج لمشارك واحد، فيه حالة محفوظة وبادئ وإصدار وحالة ونطاقات وإجراءات. |
| مسودة | جلسة ما زالت قيد الإكمال، وليست بالضرورة جاهزة لسير عمل داخلي أو اتصال عام. |
| مسلّمة | حالة جلسة تبين اكتمال خطوة إرسال النموذج، وما زالت تحتاج أي مراجعة/قرار مأذون منفصل. |
| الرقم المرجعي | معرف نموذج/جلسة ظاهر للبشر عند ضبطه، يستخدم للتواصل التشغيلي بدلاً من كشف معرفات داخلية بلا حاجة. |
| مكرر | حقل أو قسم متكرر يحمل مثيلات متعددة، مثل ملاحظات معاينة أو مستندات داعمة. |
| مثيل مكرر | صف/عنصر واحد داخل مكرر، له قيم وتحقيق محليان؛ موضعه ليس معرف أعمال دائماً. |
| إجراء نموذج | عملية مضبوطة يستطيع مشارك استدعاءها عندما تسمح قواعدها وحالتها وصلاحياتها. |
| توقيع | خطوة نموذج مضبوطة تسجل تفاعل توقيع. عنصر توقيع وحده لا يحدد التفويض النهائي. |
| نموذج غير متصل | نوع نموذج مقيد يخزن العمل/الملفات الميدانية محلياً ويزامن لاحقاً، ويحظر عمداً قدرات متصلة عدة. |
| البوابة العامة | تجربة اكتشاف/إدخال عامة مضبوطة للنماذج العادية المنشورة المؤهلة، وليست متصفح سجل داخلي. |
| قالب المستند | قالب DOCX مُدار يصير مخرجاً معتمداً من سياق سجل ووسوم/تعبيرات مضبوطة ووضع تنفيذ. |
| التصيير | عملية إنتاج مخرج مستند من قالب وبياناته المستهدفة. اختبر الناتج المصير لا مصدر القالب فقط. |
| تعبير اسم الملف | تعبير مراجع يحدد اسم ملف مستند مولد مقروءاً، ولا يجوز أن يكشف بيانات حساسة غير لازمة. |
العمل والعمليات والتقارير
| المصطلح | المعنى العملي |
|---|---|
| المهمة | عنصر عمل متابعة مملوك له حالة ومكلف وسياق تشغيلي؛ ليس جلسة نموذج أو سجل كيان نفسه. |
| المشروع | مبادرة منظمة قد تجمع خططاً وحوكمة وموارد ومقاييس وعملاً تشغيلياً مرتبطاً. |
| لوحة المعلومات | عرض تشغيلي ذي إصدار مكون من أقسام وعناصر ومصادر ومرشحات. فتحها لا يمنح وصول سجل أساسي. |
| عنصر اللوحة | كتلة مرئية أو محتوى واحدة للوحة، مثل KPI أو جدول أو مخطط أو خريطة أو تقويم أو حالة أو تقدم أو نص أو تحليل. |
| مصدر البيانات | البيانات المعتمدة خلف عنصر لوحة، مثل سجلات مدعومة بكيان أو قيمة يدوية موثقة. |
| المرشح | شرط ثابت أو مختار من المشاهد يضيّق عرض البيانات، ولا يوسع حد صلاحية المشاهد. |
| KPI | مؤشر أداء رئيسي: مقياس مسمى يجب أن يبين وحدته وبسطه/مقامه عند الحاجة وأساس الزمن ومالكه. |
| مهمة تصدير | طلب غير متزامن لإنتاج تصدير بيانات مضبوط؛ له حالة وحد وصول ودورة نتيجة/احتفاظ وحالة فشل محتملة. |
| مسار التدقيق | دليل مسجل لأحداث الإنشاء أو التغيير أو الإجراء أو التوقيع أو التشغيل أو الإعداد المستخدمة للمراجعة واستكشاف الخطأ. |
الأتمتات والتكاملات
| المصطلح | المعنى العملي |
|---|---|
| أتمتة KayanOS | إعداد صادر يتفاعل مع حدث ويؤدي نتائج KayanOS معتمدة عبر اتصال KayanOS مختار على مستوى المؤسسة. |
| الاتصال | حد تفويض على مستوى المؤسسة يختار للأتمتة. يلزم لخطوات كتالوج أتمتة KayanOS الصادرة حتى عندما لا تحتاج النتيجة حساباً خارجياً. |
| المشغل | الحدث المعتمد الذي يبدأ أتمتة ويمكن تضييقه بمرشحات مضبوطة. |
| إجراء الأتمتة | خطوة نتيجة مضبوطة في أتمتة، قد تنشئ/تغير عملاً من جانب KayanOS أو تعيد استجابة مضبوطة وفق قواعد وقت التشغيل. |
| التشغيل | محاولة تنفيذ مسجلة واحدة لأتمتة. احتفظ بمعرف التشغيل عند تشخيص النتيجة. |
| الانتظار | خطوة أتمتة توقف/تستأنف حسب شرط مطابقة أو توقيت مضبوط، وليست إيصالاً/اعتماداً مضموناً. |
| مقاومة التكرار | تصميم/مراجعة عملية بحيث لا تنشئ إعادة المحاولة نتيجة مكررة غير مقصودة. |
| الواجهة البرمجية العامة | واجهة KayanOS الخادمية ذات إصدار للكيانات المفعلة صراحةً ومالكي الرموز المقيدين والحقول المرئية وعمليات السجل المضبوطة. |
| رمز API | بيان اعتماد سر لمرة واحدة يملكه عضو ويستخدم مع الواجهة العامة، ويجب حفظه بأمان وتدويره/إلغاؤه وعدم نسخه إلى التوثيق. |
| ETag | ترويسة إصدار سجل تعيدها الواجهة العامة، وترسل في If-Match لتحديث/حذف متزامن آمن. |
If-Match | ترويسة طلب الواجهة العامة التي تثبت أن المتصل يحدث/يحذف الإصدار الذي قرأه سابقاً. |
| معرف الطلب | معرف ربط مثل x-request-id يستخدم للتحقيق في طلب API محدد بلا مشاركة بيان اعتماد. |
| حد المعدل | حد للطلبات في نافذة زمنية. يجب أن يفحص العميل ترويسات الحد ويحترم retry-after بدلاً من إعادة المحاولة بقوة. |
فروق سريعة تمنع الأخطاء
| لا تخلط بين | و | الفرق العملي |
|---|---|---|
| النموذج | جلسة النموذج | النموذج تصميم قابل لإعادة الاستخدام؛ والجلسة مثيل مشارك واحد. |
| الكيان | السجل | الكيان نوع/مخطط؛ والسجل عنصر محفوظ واحد من ذلك النوع. |
| تسمية الحقل | مفتاح الحقل | التسمية موجهة للمستخدم/قابلة للترجمة؛ والمفتاح يستخدم في الإعداد والتكاملات. |
| الرؤية | الصلاحية | الرؤية تغير المعروض؛ والصلاحية تحدد ما يسمح به الخادم. |
| البوابة العامة | API العامة | البوابة إدخال بشري عام؛ وAPI تكامل خادمي موثق برمز. |
| المعرف التسلسلي | معرف السجل | التسلسل مرجع قابل للتتبع مضبوط؛ ومعرف السجل هو الهوية التقنية. |
| الحقل المحسوب | قاعدة اعتماد | الحساب يشتق بيانات؛ ولا يجوز أن يكون قرار التفويض الوحيد. |
| مرشح اللوحة | وصول البيانات | المرشح يضيّق النتائج ولا يمنح وصول سجل مصدر. |
| تشغيل الأتمتة | نتيجة أعمال ناجحة | التشغيل دليل تنفيذ؛ تحقق من هدفه وأي أثر جانبي. |
| الاتصال | بيانات اعتماد خارجية فقط | اتصال أتمتة KayanOS حد تفويض حتى للنتائج الداخلية في KayanOS. |