ابدأ بالقرار لا بقائمة الحقول
الكيان هو نوع السجل الذي يديره الفريق: طلب، ترخيص، معاينة، أصل، تعيين موظف، مشروع، أو تعديل مالي. الحقل يجيب عن سؤال واحد في هذا السجل، أما التخطيط فيحدد متى وأين يظهر السؤال. قبل إضافة أي حقل، حدّد ما يلي:- ما القرار أو الإجراء الذي ستدعمه هذه القيمة؟
- من سيدخلها وفي أي مرحلة من المسار؟
- هل هي وصف حر أم اختيار مضبوط أم علاقة أم وقت أم نتيجة محسوبة؟
- هل يجب البحث فيها أو تصفيتها أو تضمينها في تقرير أو توقيع أو تصدير أو تقييد رؤيتها؟
نموذج عملي: التراخيص والمعاينات
يمكن لفريق خدمة بلدي استخدام تطبيق واحد لاستقبال طلب ترخيص، وتكليف معاينة، وتسجيل القرار، ومتابعة الإجراء التالي. وينطبق النموذج نفسه على التصاريح والبلاغات وصيانة الأصول والخدمات الاجتماعية والمشتريات وتهيئة الموظفين وطلبات تغيير المشاريع.
لا تضع كل تفاصيل المعاينة داخل الطلب. استخدم العلاقات لكي يكون لكل سجل مالك ودورة حياة واضحة مع بقاء التنقل بين السجلات سهلاً.
المرجع الكامل لأنواع الحقول
كل الأنواع التالية مدعومة في كيانات KayanOS. اختر النوع بحسب معنى القيمة وليس بحسب شكل عنصر الإدخال فقط.أدلة مستقلة للحقول ذات الضوابط الخاصة
تحتاج ميزتان إلى قرار أوسع من اختيار نوع الحقل. اقرأ المعرّفات التسلسلية قبل إصدار مرجع عام: يشرح الدليل النطاقات وأنماط الإصدار وحدود التعيين اليدوي وسجل التدقيق والاختبار الآمن من التكرار. واقرأ الحقول المحسوبة قبل اشتقاق قيمة: يشرح سياق التعبير والعلاقات المباشرة والعكسية والحفظ والتحديث الخلفي وحدود جودة البيانات.text
استخدم النص لقيمة قصيرة في سطر واحد: عنوان طلب، مرجع خارجي، اسم حي، لوحة مركبة، أو اسم جهة اتصال.
- اختره عندما تقرأ القيمة كنص وغالباً تكون قصيرة.
- لا تستخدمه للوصف الطويل أو الحالة المضبوطة أو التاريخ أو العمليات الحسابية.
- استخدم مفتاحاً ثابتاً مثل
external_reference؛ يمكن تغيير العنوان الظاهر لاحقاً دون كسر التكاملات. - استخدم النص للمعرفات التي تهم فيها الأصفار البادئة، وليس الرقم.
long_text
استخدم النص الطويل لوصف غير منسق: وصف المشكلة، ملاحظة المعاينة، المبرر، أو ملاحظة التسليم.
- يحتفظ بإجابة واضحة على شكل فقرات من دون تحويل الحقل إلى محرر مستندات.
- اطرح سؤالاً محدداً لكل حقل؛ افصل بين «الملاحظة» و«الإجراء المقترح» لكي يمكن مراجعتهما وتقريرهـما منفصلين.
- لا تجعله بديلاً عن حقول مضبوطة تحتاج إلى فرز أو تصفية أو عدّ.
- اجعله إلزامياً فقط عندما لا يمكن استمرار المسار من دون تفسير ذي معنى.
rich_text
استخدم النص المنسق عندما يحتاج الكاتب إلى عناوين وقوائم وتأكيدات أو تعليمات منظمة.
- يناسب تقرير معاينة أو توجيهات خدمة أو تبرير قرار أو مادة معرفة داخلية.
- احتفظ بالعنوان والحالة والمالك والتواريخ في حقول منفصلة؛ النص المنسق ليس مصدراً موثوقاً للتقارير التحليلية.
- استخدمه بحذر في المسارات العامة؛ الحقول المنظمة أفضل للحقائق التي يجب البحث فيها أو تدقيقها.
- حدد الأدوار التي تستطيع تحريره لأن التنسيق قد يجعل التعديل أكثر تأثيراً من ملاحظة عادية.
phone
استخدم الهاتف لرقم اتصال يجب إدخاله وعرضه كرقم هاتف.
- يناسب رقم التواصل المفضل أو خط الطوارئ أو رقم مكتب الخدمة.
- احتفظ بحقل نص منفصل للامتداد أو الرقم المرجعي الذي يشبه رقم الهاتف فقط.
- لا تستخدمه لمعرف وطني أو قيمة تحتوي أصفاراً بادئة ولا تُستخدم للاتصال.
- راجع من يملك حق العرض أو التصدير؛ أرقام الاتصال غالباً بيانات شخصية.
serial_id
استخدم المعرف التسلسلي لرقم مقروء وقابل للتتبع ينشئه النظام.
- أمثلته:
LIC-2026-0142أو رقم معاينة أو رمز دورة رواتب أو تذكرة صيانة. - اجعله المرجع المستخدم في المحادثات والمستندات ولوحات المعلومات، ولا تطلب من الموظفين اختراعه يدوياً.
- افصله عن معرف قاعدة البيانات وعن المرجع الخارجي القادم من نظام آخر.
- صمم البادئة وقاعدة الترقيم قبل النشر؛ تغييرها بعد استخدامها خارجياً يسبب التباساً غير ضروري.
- استخدم دليل المعرّفات التسلسلية لضبط نمط الإصدار والنطاق وتنسيق التاريخ والتعبئة المسبقة وسجل التصحيح وحالات الاختبار.
number
استخدم الرقم للقيم التي ستُحسب أو تقارن أو تجمع أو تعرض في مخطط.
- استخدمه للكمية أو المساحة أو عدد الحضور أو الدرجة أو المبلغ أو النسبة أو ساعات الحمل.
- لا تستخدمه للهاتف أو الرمز البريدي أو المعرف الوطني أو أي قيمة تهم فيها الأصفار البادئة.
- بيّن الوحدة في العنوان أو الوصف:
area_m2وestimated_hoursأوrequested_amount_sypأوضح منvalue. - اربطه بقاعدة تحقق أو بحقل محسوب عندما يكون المدى أو النتيجة المشتقة مهماً.
- للنتيجة المشتقة المخزنة، استخدم الحقول المحسوبة لاختيار تعبير آمن وسياق العلاقة ومسار التحديث وخطة الاختبار.
duration
استخدم المدة لكمية زمن لا للحظة زمنية.
- تناسب مدة المعاينة المتوقعة أو مهلة مستوى الخدمة أو زمن السفر أو ساعات التدريب.
- استخدم التاريخ أو الوقت أو التاريخ والوقت عندما تحتاج إلى معرفة متى يقع الحدث.
- اذكر وحدة العمل في تسمية الحقل والتزم بوحدات متسقة في التقارير.
- يمكن للمدة أن تدعم تخطيط الحمل، لكنها لا تثبت الحضور من دون سجل وقت منفصل.
boolean
استخدم القيمة المنطقية لحقيقة واضحة نعم/لا.
- أمثلتها: «الموقع قابل للوصول»، «وصلت الموافقة»، «يتطلب مراجعة مشرف»، «المستندات مكتملة».
- اجعل معنى الحالتين واضحاً؛ «المستندات مكتملة» أقل التباساً من «حالة المستندات».
- لا تستخدمها عندما تكون الإجابة الحقيقية أكثر من حالتين؛ استخدم قائمة اختيار أو حالة.
- لا تجعل الحقل الاختياري يحمل ثلاث معانٍ مثل نعم/لا/لم يقيّم. نمذج «لم يقيّم» صراحة إن كان مهماً.
date
استخدم التاريخ ليوم تقويمي لا يهم فيه وقت اليوم.
- يناسب تاريخ الطلب أو الانتهاء أو الميلاد أو الإجازة أو الإكمال المخطط.
- استخدم التاريخ والوقت للمواعيد والأحداث التي يهم فيها التوقيت أو المنطقة الزمنية.
- لا تخزن التاريخ في نص لمجرد وصوله بهذه الصيغة من جدول بيانات.
- استخدم تعبيرات محسوبة لقواعد الاستحقاق بدلاً من مطالبة المستخدم بالحساب اليدوي.
datetime
استخدم التاريخ والوقت لحدث يقع في لحظة محددة.
- يناسب وقت الإرسال أو بدء الموعد أو وقت الاعتماد أو وقوع حادث أو تسليم رسالة.
- وضّح توقع المنطقة الزمنية للفرق التي تعمل في مواقع متعددة.
- استخدم نطاق التاريخ والوقت عندما يملك الحدث بداية ونهاية.
- افصل طابع التدقيق النظامي عن تاريخ عمل مثل «اكتملت المعاينة في».
time
استخدم الوقت لساعة متكررة من دون يوم محدد.
- يناسب وقت الافتتاح أو بداية الوردية أو موعد القطع اليومي أو نافذة خدمة متكررة.
- لا تستخدمه لموعد واحد؛ استخدم التاريخ والوقت.
- اجمعه مع تاريخ فقط عندما يحتاج المسار إلى القيمتين مستقلتين.
- اذكر قاعدة المنطقة الزمنية أو قاعدة المكتب المحلي في الوصف عندما تستخدمه جهات متعددة.
date_range
استخدم نطاق التاريخ لفترة لها بداية ونهاية تقويميتان.
- يناسب فترة إجازة أو مرحلة مشروع أو تعليق خدمة أو نافذة تمويل.
- استخدمه بدلاً من حقلي تاريخ منفصلين عندما يكون النطاق مفهوماً واحداً في العمل.
- تحقق من أن النهاية لا تسبق البداية.
- استخدم نطاق التاريخ والوقت للمواعيد المحجوزة أو أي فترة تهم فيها الساعة والدقيقة.
datetime_range
استخدم نطاق التاريخ والوقت لنافذة دقيقة لها لحظة بداية ونهاية.
- يناسب موعد معاينة أو انقطاع صيانة أو فتحة حدث أو نافذة خدمة مزودة بالموظفين.
- يجعـل فحوص التداخل وعرض التقويم أوثق من جدول نصي حر.
- حدد قاعدة إعادة الجدولة والإلغاء؛ النطاق وحده ليس حالة عمل.
- أضف حقل حالة منفصلاً لتمييز المقترح والمؤكد والمكتمل والملغى.
time_range
استخدم نطاق الوقت لفاصل يومي متكرر من دون تاريخ.
- يناسب ساعات فتح المركز أو ساعات الوردية العادية أو نافذة مركز الاتصال اليومية.
- لا يحل محل الحضور الفعلي للموظف أو موعد مؤرخ.
- سمِّه بحسب الغرض مثل «نافذة خدمة الجمهور» لا «نطاق الوقت» فقط.
- نمذج الاستثناءات مثل العطل أو الإغلاقات الخاصة في سجلاتها الخاصة.
select
استخدم الاختيار لقائمة قيم مضبوطة يجب أن يختار منها الموظفون بصورة متسقة.
- أمثلته: فئة الخدمة أو الأولوية أو اللغة أو فئة الترخيص أو مستوى الخطر أو رمز السبب.
- امنح كل خيار قيمة تقنية ثابتة وتسمية عرض واضحة ومترجمة.
- استخدم الإعداد متعدد القيم فقط عندما يكون تعدد الاختيارات ذا معنى؛ العلاقة غالباً أوضح عند الحاجة إلى سجلات فعلية.
- لا تضع دورة حياة العملية في قائمة اختيار عامة عندما تحتاج انتقالات ومسؤوليات وتقارير حسب المرحلة؛ استخدم الحالة.
file
استخدم الملف للمستندات أو الصور أو المسح الضوئي أو المرفقات الأخرى.
- يناسب إثبات الهوية أو صور المعاينة أو الخطاب الموقّع أو مخطط الموقع أو جدول داعم.
- اجعل غرض الملف واضحاً؛ حقل «صورة الموقع» أنفع من حقل مرفقات واحد غير منظم عندما تهم أنواع الأدلة.
- لا تعتمد على اسم الملف كحالة عمل. خزّن الاعتماد والمراجع والقرار في حقول مستقلة.
- تحقق من الوصول والاحتفاظ قبل عرض الملفات في نموذج عام أو تكامل خارجي.
relation
استخدم العلاقة لربط هذا السجل بكيان آخر في KayanOS.
- أمثلتها: طلب إلى حالة، حالة إلى معاينة، معاينة إلى موقع، مشروع إلى ميزانية، موظف إلى تعيين.
- تحافظ العلاقة على مصدر حقيقة واحد. لا تنسخ الاسم والحالة والمالك من السجل المرتبط إلى حقول نص متعددة من دون سبب واضح للتاريخ أو التقرير.
- حدد هل العلاقة واحد لواحد أو واحد لعديد أو عديد لعديد قبل بناء النماذج ولوحات المعلومات.
- راجع سلوك الحذف ونموذج الوصول؛ رؤية الطلب لا تعني تلقائياً السماح برؤية كل سجل مرتبط.
form_session
استخدم جلسة النموذج عندما يجب أن يحتفظ الكيان بسياق إرسال النموذج الذي أنشأه أو حدّثه.
- تفيد في تتبع إرسال نموذج عام أو داخلي إلى الجلسة التي أنشأت السجل أو حدّثته.
- استخدم العلاقة لعلاقة عمل عادية بين كيانين؛ جلسة النموذج خاصة بدورة حياة النموذج.
- اجعل حقول العمل في الكيان مفهومة وحدها. يجب أن يفهم المراجع حالة السجل من دون فتح جلسة النموذج.
- لا تجعل الجلسة بديلاً عن مالك مسؤول أو حالة عمل.
json
استخدم JSON للبيانات المنظمة المتقدمة التي يحدد شكلها تكامل أو تصميم تقني مضبوط بعناية.
- يناسب حمولة خارجية محدودة أو كائن إعدادات أو بنية متغيرة لا يمكن تمثيلها بأمان في الحقول العادية.
- لا تستخدمه لبيانات عمل عادية يدخلها الموظفون؛ يصعب التحقق منها والبحث فيها وترجمتها وإعداد تقارير عنها.
- وثّق المفاتيح المتوقعة وأنواع القيم وقاعدة الإصدار قبل أن يكتب أي تكامل فيه.
- اعرض القيم التي يحتاج الناس إلى تصفيتها أو مراجعتها أو تصديرها في حقول محسوبة أو عادية منفصلة.
member_selector
استخدم محدد العضو لعضو KayanOS مسؤول أو لأعضاء مسؤولين.
- يناسب مالك الحالة أو المدير المعتمد أو المفتش أو قائد المشروع أو مكلف المتابعة.
- استخدم النص أو العلاقة للشخص غير العضو في KayanOS مثل مقدم طلب أو جهة موردة.
- افصل المسؤولية عن الهيكل الإداري؛ المدير ليس مالك كل سجل في وحدته تلقائياً.
- اربط المالك بحالة وتاريخ استحقاق عندما يمثل السجل عملاً يجب أن يتقدم.
avatar
استخدم الصورة الرمزية عندما يحتاج السجل إلى هوية بصرية مختصرة.
- يمكن أن تدعم عرض عضو أو فريق أو خدمة أو موقع حين تحسن الصورة الصغيرة سرعة التعرف.
- لا تجعلها الدليل الوحيد للهوية؛ احتفظ باسم نصي ومعرف ثابت أيضاً.
- استخدم الملف للصور الرسمية أو الأدلة التي يجب الاحتفاظ بها أو مراجعتها أو تنزيلها.
- تحقق من توقعات الخصوصية قبل تخزين صورة شخص.
location
استخدم الموقع لمكان جغرافي يمكن عرضه على خريطة أو استخدامه لتوجيه الخدمة.
- يناسب موقع معاينة أو مرفق أو فرع أو منطقة مشروع أو مركز خدمة.
- استخدم النص لاسم مكان وصفي بسيط عندما لا تحتاج إلى سلوك جغرافي.
- حافظ على اتساق العنوان والإحداثيات ومنطق منطقة الخدمة مع قواعد الخرائط والخصوصية في المؤسسة.
- اربط المواقع المتكررة بعلاقة بدلاً من إعادة كتابة الموقع نفسه في كل سجل.
action
استخدم الإجراء لعملية مضبوطة على مستوى السجل يستدعيها المستخدم عمداً.
- يناسب خطوة مصممة بعناية مثل إنشاء متابعة أو إنتاج مستند أو بدء مراجعة معتمدة.
- يجب أن يشرح اسم الإجراء نتيجته؛ «إرسال للمراجعة» أوضح من «تشغيل».
- لا تستخدمه لإخفاء قرار مسار عمل. خزّن القرار والمنفذ والحالة الناتجة في حقول قابلة للمراجعة لاحقاً.
- اختبره بسجل غير إنتاجي وتحقق من الصلاحيات قبل إتاحته لدور أوسع.
status
استخدم الحالة لمرحلة دورة حياة السجل.
- أمثلتها: مسودة، مستلم، قيد المراجعة، بانتظار دليل، معتمد، مرفوض، مكتمل، أو ملغى.
- الحالة أكثر من تسمية؛ يجب أن تعكس موضع السجل في المسار وتجعل الإجراء المسؤول التالي مفهوماً.
- اجعل قائمة الحالات صغيرة وواضحة ولا تتداخل معانيها. إذا كانت حالتان تقودان إلى العمل نفسه فادمجهما.
- استخدم الاختيار لتصنيف مثل فئة الخدمة؛ واستخدم الحالة عندما تغير القيمة كيفية تقدم العمل.
صمّم التخطيط بحسب العمل
يقرأ موظف الاستقبال والمراجع والمدير والمدقق السجل نفسه بطرق مختلفة. يجب أن يقلل التخطيط الضوضاء من دون إخفاء الحقائق اللازمة للقرار التالي.بنية مقترحة لسجل خدمة
استخدم التبويبات عندما يملك السجل مراحل متميزة أو أدلة كثيرة. استخدم تخطيط الحقول الواحد عندما يكون السجل صغيراً ويجب إدخاله بسرعة. ضع القرار التالي الأهم في الأعلى، ولا تجعل المراجع يمر على التفاصيل التاريخية ليجد الحالة والمالك الحاليين.
اضبط تجربة تفاصيل السجل
اختر الصورة الأساسية للكيان
يمكن لإعداد حقل الصورة الأساسية في إعدادات الكيان أن يشير إلى حقلavatar مؤهل في الكيان نفسه. اختره عندما تساعد صورة أو علامة ثابتة الموظفين على تمييز السجلات في القوائم وترويسة السجل، واتركه بلا حقل عندما لا يملك الكيان هوية بصرية معتمدة. يتحكم الحقل المهيأ في العرض فقط؛ فلا يجعل صورة خاصة عامة، ولا يستبدل اسم السجل، ولا يمنح الوصول إلى الملف أو السجل.
اختبر إنشاء الصورة وتحديثها وإزالتها وسجلاً بلا صورة. تحقق من أن القائمة تستخدم هوية احتياطية بلا رابط صورة معطل، وأن تغيير صورة الـavatar أو حذفها يحدّث العرض عبر دورة حياة الحقل المعتادة. لا تستخدم مرفق دليل حساساً أو حقل ملف غير مرتبط كصورة أساسية.
افتح إعدادات الكيان لاختيار طريقة عرض السجلات المحفوظة. يحافظ التخطيط القياسي على عرض الحقول والأقسام المألوف. ويضيف التخطيط المحسّن منطقة هوية أوضح ونظرة عامة وملخصات دلالية وتنقلاً متجاوباً بين التبويبات ومناطق اختيارية للسجلات المرتبطة والنشاط. اختر العرض بعد استقرار نموذج السجل وقواعد الوصول؛ فالتخطيط المحسّن لا يصلح حقولاً مبهمة أو صلاحيات ناقصة.
اضبط عرض التفاصيل عن قصد:
- اختر كثافة مضغوطة أو افتراضية أو مريحة بحسب كمية المعلومات والأجهزة المستخدمة؛
- حدد التبويبات ورتبها ثم اختر تبويباً افتراضياً صالحاً؛
- اختر حقول الهوية الأساسية والثانوية التي تعرف السجل من دون كشف بيانات مقيدة؛
- قرر إظهار معاينة النظرة العامة وشريط الأقسام؛
- فعّل النشاط أو عرض السجلات المرتبطة فقط عندما يملك الدور المقصود الوصول إليها؛
- واختبر التخطيط بسجل فارغ وآخر عادي وحالة استثنائية وفي اتجاهي الواجهة.
مراجعة تصميم قبل النشر
- أنشئ سجلاً غير إنتاجي واحداً لكل مسار طبيعي واستثنائي.
- تحقق من أن الحقول الإلزامية تمنع قراراً ناقصاً من دون منع المسودات المشروعة.
- افحص القوائم والبحث والتصديرات ولوحات المعلومات والمستندات باستخدام الحقول التي يجب أن تدعمها.
- تحقق من أن الدور المقيد لا يستطيع رؤية أو تحرير ملفات أو أفراد أو رواتب أو قرارات حساسة.
- اطلب من شخص لم يبن التطبيق أن يدخل سجلاً بالاعتماد على عناوين الحقول وحدها. راجع أي حقل يحتاج إلى شرح من المنشئ.
الخطوات التالية
- تعلّم إنشاء السجلات وربطها في الكيانات.
- اضبط المراجع الدائمة في المعرّفات التسلسلية.
- ابنِ القيم المشتقة واختبرها في الحقول المحسوبة.
- استخدم التعبيرات في المنشئ للحقول المحسوبة والقواعد الشرطية.
- ابنِ مسار إدخال واضحاً في النماذج.
