راجع تغييرات نظام قائم
ابدأ من النظام المقصود ليخطط المنشئ بناءً على أجزائه الحالية. اقرأ كل متطلب والتغييرات المقترحة قبل الموافقة. تبقى الخطة المكتملة متاحة للمراجعة؛ ويمكن إغلاق اقتراح لا يتضمن عملاً للتنفيذ دون موافقة. تتطلب إزالة الحقول أو النماذج مراجعة مستقلة للعناصر المحددة والبيانات المتأثرة. قد تمنع الإزالةَ الحقولُ التي ما تزال مستخدمة في تسميات السجلات أو الصور الأساسية أو النماذج الباقية أو الأتمتة. يؤثر حذف النموذج أيضاً في جلساته وتقديماته. تتطلب تغييرات الوصول والتفعيل والحذف تحققاً جديداً بكلمة المرور أو مفتاح المرور عند الموافقة حيث تتاح هذه التغييرات. لا يتجاوز إثبات الهوية الصلاحيات أو فحوص الاعتماديات. إذا تغير التعريف الفعلي أو أعداد العناصر المتأثرة، حدّث الاقتراح وراجعه مجدداً. بعد التنفيذ، افحص النتيجة وإيصال الإزالة قبل المتابعة. لا تفترض أن فشل تغيير متعدد الخطوات أعاد البيانات السابقة. استخدم ضوابط الأدوار والإطلاق الموضحة أدناه.البناء المساعد يقترح؛ والناس يقررون
يمكن للبناء المساعد في KayanOS تحويل وصف خدمة واضح أو مصدر استيراد منظم أو طلب مراجعة إلى مقترح للكيانات والتطبيقات والأقسام وعلامات التبويب والحقول والعلاقات والإعداد المرتبط. إنه مسرع تصميم، لا ناشر تلقائي ولا ضمان لجودة البيانات ولا بديل لمنشئ مسؤول. لتطبيق طلب خدمة مواطن، استخدمه لصياغة بنية مثل الطلب والمعاينة ومركز الخدمة والقرار—ثم دع المديرية تراجع المفاتيح الدقيقة وأنواع الحقول والعلاقات وتسميات اللغة والأفعال وتخطيط العرض قبل حفظ أي شيء.
المتطلبات وحد الصلاحية
لا يتاح عمل المنشئ/الاستيراد المساعد إلا عندما تفعل المؤسسة القدرة المناسبة ويملك العضو صلاحيات المنشئ اللازمة. يفحص الخدمة على الأقل القدرة على إنشاء الكيانات وتحديثها وإنشاء حقول الكيانات. لا يمنح المقترح صلاحية لا يملكها العضو بالفعل. قبل البدء:- سمِّ مالك تطبيق مسؤولاً ومراجعاً لعملية الخدمة.
- أكد أن العضو يملك صلاحيات المنشئ المقصودة في المؤسسة المستهدفة—لا دور مالك إنتاج واسعاً مستعاراً للتسهيل.
- قرر هل العمل تصميم جديد أم توسعة مضبوطة لكيان قائم أم استيراد بيانات/إعداد. لهذه مخاطر مختلفة.
- استخدم مؤسسة غير إنتاجية معتمدة أو مساحة تطوير ضيقة لأول دورة مقترح وحفظ/اختبار.
- افحص سياسة استخدام/حدود البناء المساعد في المؤسسة. الحد أو عدم توفر الخدمة ليس سبباً لتجاوز المراجعة أو رفع البيانات في مكان آخر.
احم المدخل قبل إرساله
الرسائل والمرفقات جزء من طلب البناء المساعد. قد يستخرج محتوى الجداول إلى نص لتجهيز المقترح/الاستيراد، وقد تقدم الصور والملفات إلى الخدمة بحسب نوعها. عامل كل مرفق كبيانات تغادر شاشة المنشئ المحلية إلى مسار المعالجة المساعدة المضبوط في KayanOS. لا ترفع:- بيانات شخصية حية لمواطنين أو معرفات وطنية أو قرارات سرية أو بيانات اعتماد أو رموز API أو مادة توقيع أو تصديرات إنتاج غير منقحة؛
- استخراج قاعدة بيانات إنتاج كاملة عندما تثبت عينة تركيبية/معتمدة صغيرة التعيين؛
- جدولاً لم تراجعه لأوراق مخفية أو تعليقات أو مخرجات صيغ أو بيانات وصفية حساسة.
مسارا عمل في صفحة واحدة
1. صف وراجع مقترح تطبيق
استخدم هذا المسار عندما تحتاج المؤسسة بنية تطبيق KayanOS جديدة أو موسعة.- اكتب موجزاً مقيداً: نتيجة الخدمة والجهات الفاعلة والسجلات واتجاه العلاقة والحقول المطلوبة والحالات والحقول الحساسة والتسميات العربية/الإنكليزية وما هو خارج النطاق صراحةً.
- اطلب مقترحاً صغيراً أولاً—كياناً واحداً أو مجموعة مترابطة واحدة—لا نموذج مؤسسة كاملاً في طلب واحد.
- راجع المقترح في المعاينة: مفتاح/عنوان الكيان وموضع التطبيق/القسم وعلامات التبويب والأقسام والحقول والأنواع وأعلام الإلزام وخيارات الاختيار وأهداف العلاقات وإعداد الوصول المرتبط.
- أرسل طلب مراجعة دقيقاً لكل تغيير. عند مراجعة مقترح قائم، اطلب التغيير المحدد وأعد فحص المقترح الناتج؛ لا تفترض إصلاح عيوب غير مرتبطة بصمت.
- عالج أخطاء التحقق وراجع التحذيرات. تمنع الأخطاء حفظاً آمناً؛ والتحذيرات ليست إذناً لتجاهل تصميم خطر.
- نفذ تعديلات يدوية في المعاينة عندما يكون ذلك أوضح نتيجة مراجعة.
- احفظ فقط بعد موافقة مراجع مسؤول على المقترح الدقيق. ينشئ/يحدث الحفظ الإعداد، ولا ينشر خدمة عامة أو يعتمد وصول البيانات تلقائياً.
2. جهز استيراد بيانات/إعداد
استخدم هذا المسار عندما يحتاج مصدر مضبوط إلى تعيين مقترح في كيانات/حقول صادرة. يستطيع النظام فحص بيانات الكيان/الحقل وسجلات مسموحة محدودة لبناء مقترح ثم يتحقق من أسماء الحقول وأنواع القيم والعلاقات وقيم الخيارات والصلاحيات والتفرد وشكل العملية قبل التنفيذ.- حدد مالك الاستيراد والكيان المستهدف وملف مصدر الحقيقة وعدد الصفوف والمفتاح الفريد وسلوك الإنشاء/التحديث المتوقع وتعيين العلاقة وقاعدة النطاق وخطة التراجع/التسوية.
- أزل الأعمدة غير اللازمة والقيم الحساسة. استخدم عينة صغيرة معتمدة أولاً.
- اطلب من المنشئ اقتراح التعيين. قارن كل عمود مصدر بالحقل المستهدف المقترح وافحص كل هدف علاقة/قيمة خيار.
- اقرأ أخطاء التحقق بالصف/العمود وأصلح المصدر أو التعيين. لا تحول حقلاً مجهولاً إلى نص حر مخمّن لمجرد تمرير التحقق.
- اختبر دفعة صغيرة جداً في الهدف غير الإنتاجي. سوِّ السجلات المنشأة/المحدثة والتسميات والخيارات والعلاقات والنطاقات والتعامل مع التكرار.
- احصل على موافقة نافذة استيراد إنتاج، ثم نفذ الخطة المعتمدة عبر عملية الاستيراد الصادرة واحتفظ بسجل نتيجة/تسوية.
2026-01-04. ترفض معاينة الاستيراد التواريخ غير الصالحة والسنوات خارج 1–9999 بالخطأ INVALID_DATE؛ ولا يحل رقم Excel التسلسلي مثل 46026 محل التاريخ المعروض. صحح المصدر أو الربط ثم أعد المعاينة قبل التطبيق. بعد استيراد تجريبي صغير، قارن الأسماء العربية والإنجليزية المحفوظة بالمصدر، بما فيها النصوص المنسقة في الجدول. لا يحل التنسيق محل الاسم نفسه، وتبقى فحوص صلاحيات الاستيراد مطبقة.
عيّن parent_id عمداً في الكيان الهرمي. يمكن أن يكون الأب سجلاً قائماً أو صفاً آخر في الاستيراد نفسه، ويمكن للمصدر استخدام تسمية التسلسل الظاهرة الدقيقة أو معرف سجل مجرداً أو معرفاً مؤهلاً بمفتاح الكيان نفسه. يحل KayanOS مراجع الدفعة نفسها ويطبق صفوف الآباء قبل الأبناء حتى عندما يسبق الابن أباه في الجدول. ولا يخمّن أباً مفقوداً أو ملتبساً: يبلغ عن الأب غير المحلول أو المؤهل لكيان آخر في parent_id ويمنع التغيير. وتدمج الصفوف المتكررة ذات اختيار التسلسل المحلول نفسه عندما لا يسمح الكيان بتكرار التسميات.
مقترح عملي: تطبيق طلب خدمة مواطن
ابدأ بموجز مثل:
ارفض أو راجع مقترحاً ينشئ حقلاً لأنه «مفيد عموماً». ينشئ كل حقل مسؤوليات بيانات وتحقق ووصول وترحيل وتقارير واحتفاظ.
التحقق جزء من التصميم لا تنظيف لاحق
يتحقق KayanOS من الاستيرادات/الإعدادات المقترحة مقابل سياق المؤسسة الحالي. تشمل المشكلات الشائعة حقولاً مجهولة وقيم خيارات غير صالحة وقيم مطلوبة مفقودة وعمليات إنشاء/تحديث مشوهة وقيم علاقات لا تحل وتعارضات تكرار/مفتاح فريد وصلاحيات حقل/كيان مفقودة. استخدم نمط الاستجابة:
لا تطلب من المساعد «إخفاء كل التحذيرات» من دون فهم كل واحد. قد يشير تحذير علاقة أو خيار أو تكرار أو صلاحية إلى قرار تصميم خدمة حقيقي.
الكيانات القائمة تحتاج عناية إضافية
تختلف توسعة كيان قائم عن إنشاء واحد جديد. يمكن للمقترح إضافة بنية جديدة، لكن البيانات والإعداد القائمان يفرضان قيود توافق. قبل حفظ توسعة:- افحص مفاتيح/أنواع الحقول القائمة والنماذج النشطة وقوالب المستندات ولوحات المعلومات وعملاء API والاستيرادات والأتمتات التي تستخدم الكيان؛
- لا تفترض إمكان تغيير نوع حقل أو عنوان أو قاعدة إلزام أو مجموعة خيارات أو حذف بأمان بعد وجود سجلات؛
- أضف الحقول/علامات التبويب/الأقسام/الأفعال الجديدة المطلوبة فقط وراجع ظهورها بالعربية والإنكليزية؛
- اختبر سجلاً قائماً معروفاً وسجلاً جديداً/فارغاً وكل سطح صادر تابع يقرأ الحقل المتغير؛
- خطط لترحيل/تعبئة البيانات منفصلاً. لا يملأ الحقل المقترح السجلات التاريخية تلقائياً.
اختبر وأصدر مقترحاً محفوظاً
بعد الحفظ الصريح استخدم تسلسل اختبار مضبوط:- أنشئ طلب خدمة مواطن غير إنتاجي ومعاينة واحدة باستخدام الحقول الجديدة.
- اختبر الحقول المطلوبة والقيم الافتراضية وخيارات الاختيار واختيار العلاقة وتسميات الحقول وعرض RTL العربي.
- اختبر الأدوار المقصودة ودوراً يجب أن يبقى مرفوضاً. أكد عدم ظهور الحقول والإجراءات الحساسة على نطاق واسع.
- إذا كان نموذج أو معرف تسلسلي أو حقل محسوب أو قالب مستند أو لوحة أو بوابة عامة أو API أو أتمتة سيستخدم التغيير، اضبط واختبر ذلك السطح منفصلاً. الكيان المحفوظ ليس جاهزاً تلقائياً لكل ميزة.
- للاستيراد الهرمي، ضع أباً وابناً في الدفعة الصغيرة نفسها مع سبق الابن. تحقق أن المعاينة تحل تسمية الأب الظاهرة الدقيقة، وأن الابن المحفوظ يشير إليه، وأن أباً مفقوداً عمداً يرفض قبل تغيير أي سجل.
- راجع سجلات التدقيق/التغيير وإصدار المقترح الدقيق ونتيجة التحقق ودليل الاختبار ومالك التراجع/المعالجة.
- انشر الأسطح الصادرة التي اعتمدت صراحةً فقط. لا تستنتج نشر بوابة عامة أو API عامة أو أتمتة من نجاح حفظ المنشئ.