# المهام

نظام المهام هو طبقة إدارة الإجراءات المدمجة في Magma. تُنشأ المهام تلقائيًا عند وقوع أحداث في المنصة تستدعي انتباه أصحاب المصلحة — مثل الوثائق التي تنتظر التحقق، أو الوثائق منتهية الصلاحية التي تحتاج إلى تجديد، أو متطلبات سكّ DTT. تضمن المهام ألا يفوت أي شيء.

***

## نظرة عامة

المهام:

* **تُنشأ تلقائيًا** عند وقوع أحداث المجال المُحفِّزة (مثلًا: تقديم وثيقة للتحقق).
* **تكتمل تلقائيًا** عند اتخاذ الإجراء المقابل (مثلًا: موافقة محقِّق على الوثيقة).
* **تُحفظ تاريخيًا** — تبقى المهام المكتملة والمؤرشفة في السجل لأغراض التدقيق.

***

## أنواع المهام

هناك 10 أنواع من المهام، منظَّمة في 3 مجموعات:

### مجموعة DOCUMENTS

| نوع المهمة                     | الوصف                                                               | مُسنَدة إلى           |
| ------------------------------ | ------------------------------------------------------------------- | --------------------- |
| **VALIDATE\_DOCUMENT**         | قُدِّمت وثيقة للتحقق وهي تنتظر مراجعة المحقِّق.                     | المحققون المُعيَّنون  |
| **UPDATE\_EXPIRED\_DOCUMENT**  | انتهت فترة صلاحية وثيقة ويجب تحديثها أو استبدالها.                  | مالك الوثيقة / الرافع |
| **UPDATE\_REJECTED\_DOCUMENT** | رُفضت وثيقة من قِبل محقِّق. على المالك معالجة الرفض وإعادة التقديم. | مالك الوثيقة / الرافع |

### مجموعة 3D\_MODEL

| نوع المهمة                             | الوصف                                                         | مُسنَدة إلى            |
| -------------------------------------- | ------------------------------------------------------------- | ---------------------- |
| **VALIDATE\_3D\_MODEL\_FIELD**         | قُدِّم طلب تغيير حقل BIM وهو ينتظر موافقة المحقِّق.           | محققو BIM المُعيَّنون  |
| **UPDATE\_REJECTED\_3D\_MODEL\_FIELD** | رُفض طلب تغيير حقل BIM. على المقدِّم المراجعة وإعادة التقديم. | مقدِّم طلب تغيير الحقل |

### مجموعة ENERGY\_METERS (المخطط التشغيلي للموائع)

| نوع المهمة                          | الوصف                                                     | مُسنَدة إلى              |
| ----------------------------------- | --------------------------------------------------------- | ------------------------ |
| **VALIDATE\_ENERGY\_METER**         | قُدِّم سجل عدّاد طاقة للتحقق وهو ينتظر مراجعة المحقِّق.   | محقِّق العدّاد المُعيَّن |
| **UPDATE\_REJECTED\_ENERGY\_METER** | رُفض سجل عدّاد طاقة. على المقدِّم التصحيح وإعادة التقديم. | مقدِّم سجل العدّاد       |

### مجموعات أخرى

| نوع المهمة                          | المجموعة  | الوصف                                         | مُسنَدة إلى               |
| ----------------------------------- | --------- | --------------------------------------------- | ------------------------- |
| **MINT\_DTT**                       | DTT       | استُوفيت متطلبات السكّ والمبنى جاهز لسكّ DTT. | مالك المبنى / مدير الحساب |
| **VALIDATE\_LOT\_DIVISION**         | DOCUMENTS | قُدِّم سجل تقسيم قطعة للتحقق.                 | المحققون المُعيَّنون      |
| **UPDATE\_REJECTED\_LOT\_DIVISION** | DOCUMENTS | رُفض سجل تقسيم قطعة ويحتاج إلى تصحيح.         | مقدِّم السجل              |

***

## أوضاع المهام

تقدّم لوحة المهام وضعَي عرض:

### وضع USER (مهامي)

يعرض فقط المهام المُسنَدة إليك شخصيًا. هذا هو الوضع الافتراضي والعرض الأكثر استخدامًا — فهو قائمة المهام الشخصية الخاصة بالإجراءات المطلوبة ضمن المباني التي تكون فيها صاحب مصلحة.

### وضع ALL (كل المهام)

يعرض جميع المهام عبر المبنى، بغض النظر عمّن أُسنِدت إليه. في هذا الوضع، يُعرض عمود **المُسنَد إليه** إضافي، يُظهر صاحب المصلحة المسؤول عن كل مهمة. هذا الوضع متاح للملّاك ومديري الحسابات لأغراض الإشراف وإدارة الفريق.

***

## لوحة المهام في عارض BIM ثلاثي الأبعاد

تندمج لوحة المهام مباشرةً في عارض BIM ثلاثي الأبعاد:

* اضغط **Shift+T** لفتح لوحة المهام أو إغلاقها.
* يُعرض **شارة عدّاد** على زر المهام في شريط أدوات العارض، تُظهر عدد المهام المفتوحة.
* من داخل العارض، يمكنك إدارة المهام المتعلقة بـ BIM (VALIDATE\_3D\_MODEL\_FIELD وUPDATE\_REJECTED\_3D\_MODEL\_FIELD) دون مغادرة السياق ثلاثي الأبعاد.

***

## دورة حياة المهمة

```
(Triggering event) → Task Created (open) → Action taken → Task Completed (archived)
```

| الحالة        | الوصف                                                                   |
| ------------- | ----------------------------------------------------------------------- |
| **Open**      | المهمة نشطة وتنتظر إجراءً.                                              |
| **Completed** | اتُّخذ الإجراء المطلوب. تُعلَّم المهمة كمكتملة وتنتقل إلى السجل.        |
| **Archived**  | مهام تاريخية لم تعد قابلة للإجراء (مثلًا: منتهية الصلاحية أو متجاوَزة). |

### الإنشاء التلقائي

تُنشأ المهام تلقائيًا من قِبل المنصة عند وقوع الأحداث ذات الصلة:

| الحدث                            | المهمة المُنشأة                                          |
| -------------------------------- | -------------------------------------------------------- |
| تقديم وثيقة للتحقق               | VALIDATE\_DOCUMENT (لكل محقِّق مُعيَّن)                  |
| بلوغ تاريخ انتهاء صلاحية الوثيقة | UPDATE\_EXPIRED\_DOCUMENT (لمالك الوثيقة)                |
| رفض الوثيقة من قِبل محقِّق       | UPDATE\_REJECTED\_DOCUMENT (لمالك الوثيقة)               |
| تقديم تغيير حقل BIM              | VALIDATE\_3D\_MODEL\_FIELD (لكل محقِّق BIM مُعيَّن)      |
| رفض تغيير حقل BIM                | UPDATE\_REJECTED\_3D\_MODEL\_FIELD (لمقدِّم طلب التغيير) |
| تقديم سجل قطعة للتحقق            | VALIDATE\_LOT\_DIVISION (للمحققين المُعيَّنين)           |
| رفض سجل قطعة                     | UPDATE\_REJECTED\_LOT\_DIVISION (لمقدِّم السجل)          |
| تقديم سجل عدّاد للتحقق           | VALIDATE\_ENERGY\_METER (للمحقِّق المُعيَّن)             |
| رفض سجل عدّاد                    | UPDATE\_REJECTED\_ENERGY\_METER (لمقدِّم السجل)          |
| استيفاء متطلبات سكّ DTT          | MINT\_DTT (لمالك/مدير حساب المبنى)                       |

### الاكتمال التلقائي

تكتمل المهام تلقائيًا عند اتخاذ الإجراء المقابل:

| المهمة                             | تكتمل تلقائيًا عند                       |
| ---------------------------------- | ---------------------------------------- |
| VALIDATE\_DOCUMENT                 | موافقة المحقِّق على الوثيقة أو رفضها.    |
| UPDATE\_EXPIRED\_DOCUMENT          | رفع نسخة جديدة من الوثيقة.               |
| UPDATE\_REJECTED\_DOCUMENT         | تقديم نسخة وثيقة مصحَّحة.                |
| VALIDATE\_3D\_MODEL\_FIELD         | تصويت المحقِّق على تغيير الحقل.          |
| UPDATE\_REJECTED\_3D\_MODEL\_FIELD | تقديم تغيير حقل مُراجَع.                 |
| VALIDATE\_LOT\_DIVISION            | موافقة المحقِّق على سجل القطعة أو رفضه.  |
| UPDATE\_REJECTED\_LOT\_DIVISION    | تقديم سجل قطعة مصحَّح.                   |
| VALIDATE\_ENERGY\_METER            | موافقة المحقِّق على سجل العدّاد أو رفضه. |
| UPDATE\_REJECTED\_ENERGY\_METER    | تقديم سجل عدّاد مصحَّح.                  |
| MINT\_DTT                          | إتمام سكّ DTT بنجاح.                     |

***

## المهام في موجز النشاط

تظهر الأحداث المتعلقة بالمهام أيضًا في [موجز النشاط](/magma-documentation/ar/almyzat/activity-feed.md). يوفّر موجز النشاط أزرار إجراء ترتبط مباشرةً بالمهمة ذات الصلة:

* **Assign Validator** — تعيين محقِّق لوثيقة تنتظر محققًا.
* **Review Request** — الموافقة على طلب وصول أو رفضه.
* **See Tasks** — الانتقال إلى لوحة المهام للمبنى ذي الصلة.

***

## نصائح للإدارة الفعّالة للمهام

* تحقّق من لوحة المهام بانتظام — تتراكم المهام مع الوقت، والمهام المتأخرة قد تُبطئ تقدّم Magma Index وتؤخّر السكّ.
* استخدم **وضع ALL** بصفتك مالكًا أو مدير حساب لتحديد الاختناقات — إذا كان لدى محقِّق العديد من مهام VALIDATE\_DOCUMENT المفتوحة، ففكّر في إعادة إسناد بعض الوثائق.
* في عارض BIM ثلاثي الأبعاد، راقب **شارة العدّاد** (Shift+T) — فتزايد عدد مهام التحقق من حقول BIM المفتوحة يشير إلى تكدّس طلبات التغيير دون مراجعة.
* بالنسبة للوثائق الحساسة زمنيًا (مثل التأمين والضرائب)، أعطِ الأولوية لمهام UPDATE\_EXPIRED\_DOCUMENT فورًا لتجنّب عقوبة انتهاء صلاحية البيانات على Magma Index.
* يستطيع أصحاب المصلحة متابعة مهامهم عبر إشعارات **موجز النشاط** — فكل حدث ذي صلة يولّد عنصر نشاط مع زر إجراء مباشر.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mymagma.com/magma-documentation/ar/almyzat/tasks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.