> ## 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 ذي الصلة. ولا تكون ذات معنى لكيان غير مرتبط أو نموذج عادي.

## طريقة الكتابة

استخدم الدالة بصيغة `pmProjectProgressPercent($inverseRelations)`. لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.

## مرجع الدوال الكامل

### `pmProjectCharterStatus`

يعيد أحدث حالة لميثاق المشروع، أو قيمة مفقودة عندما لا يوجد ميثاق.

**التوقيع:** `pmProjectCharterStatus(inverseRelations)`

**مثال:**

```txt theme={null}
pmProjectCharterStatus($inverseRelations)
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectCharterStatus(...)`.

### `pmProjectClosureValidation`

يعيد `true` ما لم يخالف إغلاق المشروع متطلبات قائمة للمخرجات أو المخاطر أو المشكلات أو الميزانية أو الموارد أو الدروس المستفادة.

**التوقيع:** `pmProjectClosureValidation(status, inverseRelations)`

**مثال:**

```txt theme={null}
pmProjectClosureValidation($.status, $inverseRelations)
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectClosureValidation(...)`.

### `pmProjectCostHealth`

يعيد صحة التكلفة من القيم المباشرة وعلاقات الميزانية والإنفاق المهيأة.

**التوقيع:** `pmProjectCostHealth(plannedBudget, actualCost, inverseRelations)`

**مثال:**

```txt theme={null}
pmProjectCostHealth($.planned_budget, $.actual_cost, $inverseRelations)
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectCostHealth(...)`.

### `pmProjectDimensionHealth`

يدمج التجاوز اليدوي لصحة البعد مع صحة المؤشرات الخاصة بذلك البعد.

**التوقيع:** `pmProjectDimensionHealth(manualOverride, inverseRelations, dimension)`

**مثال:**

```txt theme={null}
pmProjectDimensionHealth($.cost_override, $inverseRelations, "cost")
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectDimensionHealth(...)`.

### `pmProjectGovernanceRequired`

يحدد ما إذا كان تصنيف المشروع المختار يتطلب حوكمة.

**التوقيع:** `pmProjectGovernanceRequired(framework, approach, projectType, clientType)`

**مثال:**

```txt theme={null}
pmProjectGovernanceRequired($.project_framework, $.delivery_approach, $.project_type, $.client_type)
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectGovernanceRequired(...)`.

### `pmProjectHealthWithIndicators`

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

**التوقيع:** `pmProjectHealthWithIndicators(baseHealth, inverseRelations, dimension)`

**مثال:**

```txt theme={null}
pmProjectHealthWithIndicators($.schedule_health, $inverseRelations, "schedule")
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectHealthWithIndicators(...)`.

### `pmProjectIndicatorDimensionHealth`

يعيد أسوأ صحة مؤشر لبعد أداء واحد في المشروع.

**التوقيع:** `pmProjectIndicatorDimensionHealth(inverseRelations, dimension)`

**مثال:**

```txt theme={null}
pmProjectIndicatorDimensionHealth($inverseRelations, "service_quality")
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectIndicatorDimensionHealth(...)`.

### `pmProjectOverallHealth`

يعيد الصحة الإجمالية للمشروع من صحة أبعاده وحالته.

**التوقيع:** `pmProjectOverallHealth(scope, schedule, cost, quality, risk, status)`

**مثال:**

```txt theme={null}
pmProjectOverallHealth($.scope_health, $.schedule_health, $.cost_health, $.quality_health, $.risk_health, $.status)
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectOverallHealth(...)`.

### `pmProjectProgressPercent`

يعيد نسبة تقدم المشروع من 0 إلى 100 من علاقات هيكل العمل والمخرجات المهيأة.

**التوقيع:** `pmProjectProgressPercent(inverseRelations)`

**مثال:**

```txt theme={null}
pmProjectProgressPercent($inverseRelations)
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectProgressPercent(...)`.

### `pmProjectRiskHealth`

يعيد صحة المخاطر من المخاطر المفتوحة العالية أو الحرجة والمشكلات ومراجعات المخاطر المتأخرة.

**التوقيع:** `pmProjectRiskHealth(inverseRelations)`

**مثال:**

```txt theme={null}
pmProjectRiskHealth($inverseRelations)
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectRiskHealth(...)`.

### `pmProjectScheduleHealth`

يعيد صحة الجدول الزمني من العمل المتأخر والتبعيات المعطلة وتاريخ نهاية المشروع.

**التوقيع:** `pmProjectScheduleHealth(inverseRelations, projectEndDate)`

**مثال:**

```txt theme={null}
pmProjectScheduleHealth($inverseRelations, $.end_date)
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectScheduleHealth(...)`.

### `pmProjectSetupComplete`

يعيد `true` عند وجود الميثاق المعتمد والأشخاص المسؤولين وتاريخي البداية والنهاية المطلوبين.

**التوقيع:** `pmProjectSetupComplete(charterStatus, projectManager, sponsor, startDate, endDate)`

**مثال:**

```txt theme={null}
pmProjectSetupComplete($.charter_status, $.project_manager_id, $.sponsor_id, $.start_date, $.end_date)
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectSetupComplete(...)`.

### `pmProjectSetupProfileKey`

ينشئ مفتاح ملف إعداد ثابتاً من قيم تصنيف المشروع.

**التوقيع:** `pmProjectSetupProfileKey(framework, approach, projectType, clientType)`

**مثال:**

```txt theme={null}
pmProjectSetupProfileKey($.project_framework, $.delivery_approach, $.project_type, $.client_type)
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectSetupProfileKey(...)`.

### `pmProjectSetupStage`

يعيد مرحلة المشروع: الإعداد أو التخطيط أو التنفيذ أو التحكم أو الإغلاق أو المغلق.

**التوقيع:** `pmProjectSetupStage(status, charterStatus)`

**مثال:**

```txt theme={null}
pmProjectSetupStage($.status, pmProjectCharterStatus($inverseRelations))
```

**التوافر:** متاحة في إعداد المشروع الذي يضم بيانات العلاقات العكسية المتوقعة. تسجل صيغتا الدالة والتحويل، لكن استدعاء الدالة أوضح للمراجعة.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | pmProjectSetupStage(...)`.

## قائمة تحقق قبل النشر

* ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
* تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
* لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
* راجع [سياقات وتوافر التعبيرات](/ar/reference/expressions/contexts) قبل نسخ تعبير بين ميزتين.

![دوال إدارة المشاريع في KayanOS](https://kayanos.app/docs-images/ar/reference/expressions-helpers-project.png)