> ## 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 المناسبة للمصادقة.

![إعداد البوابة العامة في KayanOS لاستقبال طلب خدمة مواطن.](https://kayanos.app/docs-images/ar/build/public-portal.png)

## ما الذي يجعل النموذج مؤهلاً

يظهر النموذج في البوابة العامة فقط عندما تتحقق كل الشروط التالية:

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

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

## صمم رحلة المواطن قبل النشر

اكتب الرحلة الكاملة من وجهة نظر المواطن:

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

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

## اضبط هندسة معلومات البوابة

### المجلدات والترتيب وقابلية الاكتشاف

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

البنية العامة المقترحة:

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

اضبط ترتيب قائمة متعمداً واختبر البحث. يطابق بحث البوابة عناوين النماذج المرئية؛ ولا يجعل نموذجاً مؤهلاً ولا يبحث سجلات داخلية ولا يتجاوز حد مجلد/نشر.

### الهوية والثيمة واللغة

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

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

### مسار الحساب المطلوب مقابل المشارك العام

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

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

لا يمنح طلب حساب المواطن صلاحيات عضو؛ إنه يغير فقط شرط المشارك العام للنموذج.

عندما يطلب تدفق الحساب رمز تحقق، استخدم الرمز المكون من ستة أرقام من قناة البريد أو الهاتف المضبوطة خلال 10 دقائق. لا يمكن طلب رمز جديد أكثر من مرة كل 60 ثانية، كما أن الطلبات المتكررة محدودة. تقفل خمس محاولات تحقق خاطئة تدفق التحقق لمدة 15 دقيقة؛ انتظر انتهاء القفل بدلاً من تجربة هويات بديلة أو طلب تجاوز الضبط من الموظفين.

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

## انشر طلب خدمة مواطن مضبوطاً

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

## حد الجلسة العامة

عندما يبدأ مشارك عام نموذجاً مؤهلاً، ينشئ KayanOS جلسة مرتبطة بذلك المشارك. يقتصر النشاط الأخير في البوابة على جلسات ذلك المشارك العامة الحديثة. لا يستطيع مشارك عام فتح جلسة بتخمين أو استلام معرف جلسة داخلي لشخص آخر.

هذا الحد مهم لتصميم المتابعة:

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

## حدود الإتاحة وسلوك الإغلاق

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

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

## مصفوفة الاختبار

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

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

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

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

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

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

* [النماذج](/ar/build/forms)
* [إرسالات النماذج](/ar/build/form-submissions)
* [إجراءات النموذج ومنطقه وتوقيعاته](/ar/build/form-actions-logic-and-signatures)
* [الصلاحيات والإتاحة](/ar/reference/permissions-and-availability)
* [مرجع الواجهة البرمجية العامة](/ar/reference/public-api)
* [استكشاف الأخطاء وإصلاحها](/ar/reference/troubleshooting)