> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kayanos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# المنشئ بالذكاء الاصطناعي والاستيراد

> استخدم مقترحات KayanOS المساعدة وتجهيز الاستيراد لتسريع تصميم تطبيق مراجع؛ راجع وتحقق واحفظ كل تغيير صراحةً.

## البناء المساعد يقترح؛ والناس يقررون

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

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

![توفر قدرة منشئ KayanOS لمقترح تطبيق مراجع.](https://kayanos.app/docs-images/ar/build/ai-builder-and-import.png)

## المتطلبات وحد الصلاحية

لا يتاح عمل المنشئ/الاستيراد المساعد إلا عندما تفعل المؤسسة القدرة المناسبة ويملك العضو صلاحيات المنشئ اللازمة. يفحص الخدمة على الأقل القدرة على إنشاء الكيانات وتحديثها وإنشاء حقول الكيانات. لا يمنح المقترح صلاحية لا يملكها العضو بالفعل.

قبل البدء:

1. سمِّ مالك تطبيق مسؤولاً ومراجعاً لعملية الخدمة.
2. أكد أن العضو يملك صلاحيات المنشئ المقصودة في المؤسسة المستهدفة—لا دور مالك إنتاج واسعاً مستعاراً للتسهيل.
3. قرر هل العمل **تصميم جديد** أم **توسعة مضبوطة** لكيان قائم أم **استيراد بيانات/إعداد**. لهذه مخاطر مختلفة.
4. استخدم مؤسسة غير إنتاجية معتمدة أو مساحة تطوير ضيقة لأول دورة مقترح وحفظ/اختبار.
5. افحص سياسة استخدام/حدود البناء المساعد في المؤسسة. الحد أو عدم توفر الخدمة ليس سبباً لتجاوز المراجعة أو رفع البيانات في مكان آخر.

## احم المدخل قبل إرساله

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

لا ترفع:

* بيانات شخصية حية لمواطنين أو معرفات وطنية أو قرارات سرية أو بيانات اعتماد أو رموز API أو مادة توقيع أو تصديرات إنتاج غير منقحة؛
* استخراج قاعدة بيانات إنتاج كاملة عندما تثبت عينة تركيبية/معتمدة صغيرة التعيين؛
* جدولاً لم تراجعه لأوراق مخفية أو تعليقات أو مخرجات صيغ أو بيانات وصفية حساسة.

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

## مسارا عمل في صفحة واحدة

### 1. صف وراجع مقترح تطبيق

استخدم هذا المسار عندما تحتاج المؤسسة بنية تطبيق KayanOS جديدة أو موسعة.

1. اكتب موجزاً مقيداً: نتيجة الخدمة والجهات الفاعلة والسجلات واتجاه العلاقة والحقول المطلوبة والحالات والحقول الحساسة والتسميات العربية/الإنكليزية وما هو خارج النطاق صراحةً.
2. اطلب مقترحاً صغيراً أولاً—كياناً واحداً أو مجموعة مترابطة واحدة—لا نموذج مؤسسة كاملاً في طلب واحد.
3. راجع المقترح في المعاينة: مفتاح/عنوان الكيان وموضع التطبيق/القسم وعلامات التبويب والأقسام والحقول والأنواع وأعلام الإلزام وخيارات الاختيار وأهداف العلاقات وإعداد الوصول المرتبط.
4. أرسل طلب مراجعة دقيقاً لكل تغيير. عند مراجعة مقترح قائم، اطلب التغيير المحدد وأعد فحص المقترح الناتج؛ لا تفترض إصلاح عيوب غير مرتبطة بصمت.
5. عالج أخطاء التحقق وراجع التحذيرات. تمنع الأخطاء حفظاً آمناً؛ والتحذيرات ليست إذناً لتجاهل تصميم خطر.
6. نفذ تعديلات يدوية في المعاينة عندما يكون ذلك أوضح نتيجة مراجعة.
7. احفظ فقط بعد موافقة مراجع مسؤول على المقترح الدقيق. ينشئ/يحدث الحفظ الإعداد، ولا ينشر خدمة عامة أو يعتمد وصول البيانات تلقائياً.

### 2. جهز استيراد بيانات/إعداد

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

1. حدد مالك الاستيراد والكيان المستهدف وملف مصدر الحقيقة وعدد الصفوف والمفتاح الفريد وسلوك الإنشاء/التحديث المتوقع وتعيين العلاقة وقاعدة النطاق وخطة التراجع/التسوية.
2. أزل الأعمدة غير اللازمة والقيم الحساسة. استخدم عينة صغيرة معتمدة أولاً.
3. اطلب من المنشئ اقتراح التعيين. قارن كل عمود مصدر بالحقل المستهدف المقترح وافحص كل هدف علاقة/قيمة خيار.
4. اقرأ أخطاء التحقق بالصف/العمود وأصلح المصدر أو التعيين. لا تحول حقلاً مجهولاً إلى نص حر مخمّن لمجرد تمرير التحقق.
5. اختبر دفعة صغيرة جداً في الهدف غير الإنتاجي. سوِّ السجلات المنشأة/المحدثة والتسميات والخيارات والعلاقات والنطاقات والتعامل مع التكرار.
6. احصل على موافقة نافذة استيراد إنتاج، ثم نفذ الخطة المعتمدة عبر عملية الاستيراد الصادرة واحتفظ بسجل نتيجة/تسوية.

## مقترح عملي: تطبيق طلب خدمة مواطن

ابدأ بموجز مثل:

```txt theme={null}
Build a bilingual Citizen Service Request app for a Directorate of Citizen Services.
Create a request record with a public-facing reference, service category, Service Centre,
received date, status, and a relation to repeatable inspections. Create an Inspection record
with inspection date, safety status, note, and supporting-file field. Keep decision fields
separate from public intake. Provide Arabic and English labels. Do not create public access,
automation, or approval rules in this proposal.
```

راجع النتيجة بهذا الترتيب:

| مجال المراجعة    | أسئلة للإجابة                                                                                                                |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| هوية الكيان      | هل المفاتيح ثابتة ومقروءة وفريدة ولا تشتق من تسميات مؤقتة؟ هل كل كيان لازم فعلاً؟                                            |
| تخطيط التطبيق    | هل تساعد أسماء التطبيق وعلامة التبويب والقسم المستخدمين الداخليين المقصودين؟ هل تغيب أقسام القرار الداخلية عن الإدخال العام؟ |
| الحقول           | هل كل نوع صحيح وقواعد الإلزام/الافتراضي مقصودة وقيم الاختيار مضبوطة؟                                                         |
| العلاقات         | هل يعكس الاتجاه/العدد عملية الخدمة؟ هل يستطيع الطلب امتلاك معاينات كثيرة بلا فقد وصلة الأب؟                                  |
| اللغات           | هل كل تسمية كيان وحقل وخيار وعلامة تبويب وقسم متاحة ومفهومة باللغات النشطة؟                                                  |
| البيانات الحساسة | هل تقلص حقول الشخص/المال/العمليات/القرار وتحمي بتصميم وصول منفصل مراجع؟                                                      |
| دورة الحياة      | هل يرتبط حقل الحالة بنهج قالب الحالة المعتمد لا حقل نص حر؟                                                                   |
| النطاق           | ما قاعدة مركز الخدمة/الناحية التي ستحدد نطاق السجل ومن يستطيع العمل عليه؟                                                    |

ارفض أو راجع مقترحاً ينشئ حقلاً لأنه «مفيد عموماً». ينشئ كل حقل مسؤوليات بيانات وتحقق ووصول وترحيل وتقارير واحتفاظ.

## التحقق جزء من التصميم لا تنظيف لاحق

يتحقق KayanOS من الاستيرادات/الإعدادات المقترحة مقابل سياق المؤسسة الحالي. تشمل المشكلات الشائعة حقولاً مجهولة وقيم خيارات غير صالحة وقيم مطلوبة مفقودة وعمليات إنشاء/تحديث مشوهة وقيم علاقات لا تحل وتعارضات تكرار/مفتاح فريد وصلاحيات حقل/كيان مفقودة.

استخدم نمط الاستجابة:

| النتيجة      | المعنى                                    | الخطوة التالية                                                                           |
| ------------ | ----------------------------------------- | ---------------------------------------------------------------------------------------- |
| خطأ          | لا يمكن تطبيق المقترح بأمان كما هو.       | أصلح المصدر أو التعيين أو تصميم الحقل أو العلاقة أو الصلاحية ثم أعد التحقق.              |
| تحذير        | قد يطبق المقترح لكنه يحتاج قراراً بشرياً. | اقرأ الكيان/الحقل/الصف المتأثر الدقيق ووثق القرار أو راجعه.                              |
| معاينة صالحة | تمر البنية التحقق الحالي.                 | راجع معنى الأعمال وكشف البيانات وسلوك الاختبار قبل الحفظ.                                |
| نتيجة حفظ    | طبق الإعداد/الاستيراد صراحةً.             | تحقق من الكيانات/السجلات الناتجة في KayanOS؛ لا تفترض أن عرض المقترح هو الحالة النهائية. |

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

## الكيانات القائمة تحتاج عناية إضافية

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

* افحص مفاتيح/أنواع الحقول القائمة والنماذج النشطة وقوالب المستندات ولوحات المعلومات وعملاء API والاستيرادات والأتمتات التي تستخدم الكيان؛
* لا تفترض إمكان تغيير نوع حقل أو عنوان أو قاعدة إلزام أو مجموعة خيارات أو حذف بأمان بعد وجود سجلات؛
* أضف الحقول/علامات التبويب/الأقسام/الأفعال الجديدة المطلوبة فقط وراجع ظهورها بالعربية والإنكليزية؛
* اختبر سجلاً قائماً معروفاً وسجلاً جديداً/فارغاً وكل سطح صادر تابع يقرأ الحقل المتغير؛
* خطط لترحيل/تعبئة البيانات منفصلاً. لا يملأ الحقل المقترح السجلات التاريخية تلقائياً.

## اختبر وأصدر مقترحاً محفوظاً

بعد الحفظ الصريح استخدم تسلسل اختبار مضبوط:

1. أنشئ طلب خدمة مواطن غير إنتاجي ومعاينة واحدة باستخدام الحقول الجديدة.
2. اختبر الحقول المطلوبة والقيم الافتراضية وخيارات الاختيار واختيار العلاقة وتسميات الحقول وعرض RTL العربي.
3. اختبر الأدوار المقصودة ودوراً يجب أن يبقى مرفوضاً. أكد عدم ظهور الحقول والإجراءات الحساسة على نطاق واسع.
4. إذا كان نموذج أو معرف تسلسلي أو حقل محسوب أو قالب مستند أو لوحة أو بوابة عامة أو API أو أتمتة سيستخدم التغيير، اضبط واختبر ذلك السطح منفصلاً. الكيان المحفوظ ليس جاهزاً تلقائياً لكل ميزة.
5. راجع سجلات التدقيق/التغيير وإصدار المقترح الدقيق ونتيجة التحقق ودليل الاختبار ومالك التراجع/المعالجة.
6. انشر الأسطح الصادرة التي اعتمدت صراحةً فقط. لا تستنتج نشر بوابة عامة أو API عامة أو أتمتة من نجاح حفظ المنشئ.

## أنماط فشل شائعة

| العرض                            | السبب المرجح                                                                   | الاستجابة الآمنة                                                                                  |
| -------------------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| المنشئ/الاستيراد غير متاح        | القدرة غير مفعلة أو بلغ حد استخدام أو الخدمة غير متاحة أو صلاحيات منشئ مفقودة. | افحص قدرة/استخدام المؤسسة وصلاحيات إنشاء/تحديث الكيان/الحقل للعضو؛ لا تستخدم حساباً أوسع كالتفاف. |
| المقترح ناقص أو غامض             | لم يحدد الطلب/المصدر نتيجة الخدمة أو الحقول أو العلاقات أو القيود.             | قدم موجزاً أصغر ملموساً أو عينة معتمدة وراجع كل عنصر مولد.                                        |
| لا يقرأ المرفق كما يتوقع         | مصدر غير مدعوم/كبير/مقتطع أو بنية جدول غير واضحة.                              | جهز ملفاً أدنى مراجعاً وافحص الصفوف/الأعمدة/الأوراق المحذوفة صراحةً قبل المحاولة.                 |
| تحقق بحقل/خيار مجهول             | لا يطابق تعيين المصدر مخطط الهدف الصادر.                                       | صحح المصدر/التعيين أو أنشئ حقلاً/خياراً معتمداً عبر مراجعة تصميم عادية.                           |
| فشل تحقق علاقة/تكرار             | هوية الهدف أو قيمة العلاقة ملتبسة أو متعارضة.                                  | سوِّ مع مالك بيانات الهدف؛ لا تنشئ سجلات مكررة لتجاوزها.                                          |
| يرفض الحفظ                       | صلاحية مفقودة أو خطأ تحقق غير محلول أو مقترح غير متوافق.                       | صحح مشكلة الصلاحية/التصميم الضيقة وأعد التحقق.                                                    |
| تختلف النتيجة المحفوظة عن التوقع | لم تكن المعاينة الحالة النهائية المفحوصة أو قيد إعداد قائم التغيير.            | افحص الكيان/الحقول/السجلات المحفوظة وقارنها بالمقترح المعتمد وعالج بتحكم تغيير.                   |

## الأذونات وحدود جودة البيانات

استخدم البناء المساعد تحت معايير الملكية وأقل صلاحية واللغة وإتاحة الوصول والاحتفاظ والتحكم بالتغيير نفسها للإعداد اليدوي. لا تعامل النص المولد أو أسماء الحقول أو التسميات أو الخيارات أو العلاقات كموافقة قانونية/تشغيلية. أبق إنساناً مسؤولاً عن نموذج الخدمة وتصنيف البيانات والصلاحيات وقرار الإصدار.

## أدلة ذات صلة

* [خطط تطبيقاً قبل البناء](/ar/build/plan-an-app)
* [الكيانات](/ar/build/entities)
* [حقول الكيانات وتخطيطات](/ar/build/entity-fields-and-layouts)
* [النماذج والحقول والقوائم المتكررة](/ar/build/form-fields-and-repeatables)
* [الصلاحيات والإتاحة](/ar/reference/permissions-and-availability)
* [استكشاف الأخطاء وإصلاحها](/ar/reference/troubleshooting)