> ## 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 صغير ومضبوط قبل إضافة الحقول أو النماذج أو الأتمتة.

## ابدأ بنتيجة يستطيع الفريق قياسها

التطبيق ليس مجموعة شاشات. إنه طريقة مضبوطة لنقل سجل من حالة أولية إلى نتيجة واضحة مع الدليل والمالك ونقطة المراجعة المناسبة.

اكتب جملة واحدة قبل فتح المنشئ:

> «يستطيع الفريق استقبال \[نوع العمل] وتقييمه واتخاذ قرار بشأنه وإعداد تقرير عنه خلال \[الهدف]، مع مالك مسؤول ودليل لكل قرار.»

أمثلة:

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

## استخدم لوحة التخطيط نفسها لكل تطبيق

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

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

## مثال تفصيلي: خدمة التراخيص والمعاينات

### 1. عرّف خريطة السجلات

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

### 2. عرّف دورة حالة الإصدار الأول

لا تبدأ بعشرات الحالات. استخدم أصغر مجموعة تخبر العامل بما يجب فعله تالياً.

```text theme={null}
مسودة → مستلم → تقييم → معاينة مطلوبة → قرار جاهز → مغلق
                       ↘ أعيد لاستكمال المعلومات ↗
```

لكل حالة اكتب:

* من يملك نقل السجل إليها؛
* الدليل المطلوب قبل النقل؛
* الدور المسؤول عن الإجراء التالي؛
* هل يبقى السجل قابلاً للتحرير؛
* سؤال لوحة المعلومات أو التقرير الذي يجب أن تجيب عنه.

### 3. صمّم تجربة الإدخال

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

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

### 4. عرّف القرارات قبل الأتمتة

اكتب القرار البشري أولاً:

| القرار              | المدخلات المطلوبة              | الدور المسؤول     | النتيجة المسجلة                  |
| ------------------- | ------------------------------ | ----------------- | -------------------------------- |
| هل الطلب مكتمل؟     | الفئة، الموقع، الأدلة المطلوبة | موظف الاستقبال    | مستلم أو معاد لاستكمال المعلومات |
| هل يلزم فحص؟        | الفئة، الخطر، خصائص الموقع     | مدير الخدمة       | معاينة مطلوبة أو قرار جاهز       |
| هل المعاينة مقبولة؟ | الملاحظة، الصور، التوصية       | المفتش أو المراجع | اجتاز أو لم يجتز أو متابعة       |
| هل يصدر التصريح؟    | دليل مكتمل، شروط، مراجع        | مراجع مخول        | معتمد أو مرفوض أو معاد           |

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

### 5. خطط للمقاييس

اختر مقاييس تساعد الفريق على التصرف لا أرقاماً للعرض فقط.

* الطلبات المستلمة والمغلقة أسبوعياً؛
* التراكم حسب الحالة الحالية والمالك؛
* متوسط الزمن من الاستلام إلى أول مراجعة؛
* المعاينات المستحقة هذا الأسبوع والمتأخرة؛
* الطلبات المعادة مجمعة حسب الدليل المفقود؛
* نتائج القرارات حسب الفئة والموقع.

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

## تكييف النمط مع أعمال أخرى

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

تتغير خريطة السجل، أما أسئلة التخطيط فلا تتغير.

## ابنِ على مراحل متعمدة

### الإصدار الأول: اجعل السجل قابلاً للاستخدام

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

### الإصدار الثاني: اجعل المسؤولية مرئية

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

### الإصدار الثالث: اجعل العمل قابلاً للقياس

أضف لوحات المعلومات والتقارير والمؤشرات المحسوبة ومخرج المستند. أعد التحقق من أن الحقول المستخدمة للتقرير منظمة ومدخلة بصورة متسقة.

### الإصدار الرابع: أتمت فقط القرارات المستقرة

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

## قائمة تحقق التخطيط

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

## الخطوات التالية

* أنشئ نموذج السجل في [الكيانات](/ar/build/entities).
* اختر أنواع الحقول بالتفصيل في [حقول الكيانات وتخطيطاتها](/ar/build/entity-fields-and-layouts).
* ابنِ مسار الإدخال في [النماذج](/ar/build/forms).

![مساحة تخطيط تطبيق KayanOS](https://kayanos.app/docs-images/ar/build/plan-an-app.png)