# موجز النشاط

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

***

## الوصول إلى موجز النشاط

موجز النشاط متاح عبر عنصر **النشاط** في شريط التنقل الجانبي الأيسر الرئيسي. وتُظهر **شارة غير المقروء** على عنصر التنقل عدد العناصر غير المرئية.

***

## تخطيط الموجز

موجز النشاط قائمة عناصر أحداث تُمرَّر عموديًا. وفي أعلى الصفحة، يتيح لك **شريط المباني الدوار** ترشيح الموجز حسب مبنى محدد.

### شريط المباني الدوار

صف أفقي من صور المباني المصغّرة في أعلى الموجز. تمثّل كل صورة مصغّرة مبنى ذا نشاط حديث. والنقر على صورة مصغّرة يرشّح الموجز ليعرض أحداث ذلك المبنى فقط. انقر مجددًا (أو انقر على "All Buildings") لإزالة الترشيح.

تُعرض فقط المباني ذات النشاط الحديث في الشريط الدوار — أما المباني بلا أحداث حديثة فلا تُعرض.

***

## عناصر الموجز

يمثّل كل عنصر في موجز النشاط حدثًا واحدًا ويحتوي على العناصر التالية:

| العنصر                     | الوصف                                                              |
| -------------------------- | ------------------------------------------------------------------ |
| **الصورة المصغّرة للمبنى** | صورة للمبنى بحجم 56×56 بكسل (صورة الغلاف). النقر يفتح المبنى.      |
| **العنوان**                | عنوان موجز يصف الحدث (مثلًا: "تتطلب الوثيقة تحققًا").              |
| **شارة نوع الحدث**         | تسمية ملوّنة تشير إلى الفئة: DOCUMENT أو REMINDER أو ANNOUNCEMENT. |
| **الوصف**                  | وصف مفصّل لما حدث، بما في ذلك المعلومات السياقية.                  |
| **الطابع الزمني النسبي**   | منذ متى وقع الحدث (مثلًا: "قبل ساعتين"، "أمس").                    |
| **زر الإجراء**             | زر سياقي لاتخاذ الإجراء المناسب استجابةً للحدث.                    |

### التفاصيل السياقية في الأوصاف

تتضمن الأوصاف إشارات ديناميكية لجعل الأحداث مفهومة على الفور:

* **اسم صاحب المصلحة** — من نفّذ الإجراء (مثلًا: "رفع Marie Dupont وثيقة جديدة").
* **اسم الوثيقة** — اسم الوثيقة المتأثرة.
* **نسخة الوثيقة** — رقم نسخة الوثيقة المعنية.
* **سبب الرفض** — إذا رُفضت وثيقة أو سجل، يُعرض سبب الرفض ضمن الوصف.

***

## أنواع الأحداث

تُصنَّف عناصر موجز النشاط إلى 3 أنواع:

| النوع            | الشارة          | الوصف                                                                                     |
| ---------------- | --------------- | ----------------------------------------------------------------------------------------- |
| **DOCUMENT**     | أزرق أو محايد   | أحداث تتعلق برفع الوثائق أو التحقق منها أو رفضها أو استبدالها أو الوصول إليها.            |
| **REMINDER**     | أصفر أو برتقالي | تذكيرات آلية بإجراءات قادمة أو متأخرة (مثلًا: وثائق منتهية الصلاحية، عمليات تحقق معلّقة). |
| **ANNOUNCEMENT** | أخضر أو بنفسجي  | إعلانات على مستوى المنصة أو المبنى (مثلًا: إصدارات ميزات جديدة، تغييرات حالة المبنى).     |

***

## أزرار الإجراءات

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

| زر الإجراء              | متى يُعرض                                                    | الإجراء                                                               |
| ----------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------- |
| **See Document**        | رُفعت وثيقة أو تُحقِّق منها أو رُفضت أو حُدِّثت.             | يفتح الوثيقة في Data Room.                                            |
| **See Object 3D Model** | وقع حدث كائن BIM (تقديم تغيير حقل أو الموافقة عليه أو رفضه). | يفتح عارض BIM ثلاثي الأبعاد عند الكائن المحدد باستخدام الرابط العميق. |
| **See Invitation**      | دُعي صاحب مصلحة جديد إلى المبنى.                             | يفتح تفاصيل دعوة صاحب المصلحة.                                        |
| **Review Request**      | قدّم صاحب مصلحة طلب وصول لوثيقة.                             | يفتح سير عمل الموافقة على طلب الوصول.                                 |
| **Assign Validator**    | رُفعت وثيقة دون تعيين محقِّق.                                | يفتح نموذج رفع الوثيقة لتعيين المحققين.                               |
| **See Lot Divisions**   | وقع حدث في قسم تقسيم القطع.                                  | يفتح قسم تقسيم القطع للمبنى.                                          |
| **See Energy Meter**    | وقع حدث في قسم المخطط التشغيلي للموائع.                      | يفتح قسم المخطط التشغيلي للموائع للمبنى.                              |
| **See Tasks**           | أُنشئت مهمة جديدة للمستخدم.                                  | يفتح لوحة المهام للمبنى ذي الصلة.                                     |
| **See Comment**         | أُضيف تعليق توضيحي جديد إلى وثيقة.                           | يفتح الوثيقة في العارض عند موضع التعليق التوضيحي.                     |

***

## العناصر غير المرئية

تُبرَز عناصر موجز النشاط التي لم تُشاهَد بعد بصريًا بلون خلفية **primaryLighter**. يجعل هذا من السهل التمرير لأسفل إلى حيث توقفت وتحديد الأحداث الجديدة بنظرة سريعة.

### المسح التلقائي عند تحميل الصفحة

عندما تنتقل إلى صفحة موجز النشاط، تُعلَّم جميع العناصر المرئية حاليًا كـ"مُشاهَدة". وتُمسح شارة غير المقروء في التنقل الأيسر عند زيارة الموجز. أما الأحداث الجديدة التي تصل بعد فتحك الموجز فستظهر مع الإبراز حتى تعيد التحميل أو تزور الصفحة من جديد.

***

## الفرز

يُفرَز موجز النشاط حسب **occurredOn تنازليًا** — تظهر أحدث الأحداث في الأعلى. ويُحفظ ترتيب الفرز هذا كـ**تفضيل مستخدم**، بحيث يستمر ترتيب الفرز الذي اخترته بين الجلسات.

حاليًا، الفرز الأساسي حسب الحداثة (الأحدث أولًا)، ما يضمن بقاء الأحداث الأكثر قابلية للإجراء والأكثر حساسيةً زمنيًا دائمًا في أعلى موجزك.

***

## الترشيح حسب المبنى

استخدم **شريط المباني الدوار** في أعلى الموجز لعرض أحداث مبنى محدد فقط:

1. انقر على صورة مصغّرة لمبنى في الشريط الدوار.
2. يرشّح الموجز ليعرض أحداث ذلك المبنى فقط.
3. انقر على الصورة المصغّرة نفسها مجددًا، أو انقر على خيار "All"، للعودة إلى الموجز غير المُرشَّح.

هذا مفيد بشكل خاص عند إدارة محفظة كبيرة — إذ يمكنك التركيز على مبنى واحد في كل مرة والعمل على بنود نشاطه قبل الانتقال إلى التالي.

***

## سيناريوهات شائعة في موجز النشاط

### تقديم وثيقة للتحقق

يرفع أحد أعضاء الفريق وثيقة ويعيّنك محققًا. ترى:

* **نوع الحدث:** DOCUMENT
* **العنوان:** "وثيقة بانتظار تحققك"
* **الوصف:** "رفع \[الاسم] ‏\[اسم الوثيقة] الإصدار 2 في قسم \[المستوى]."
* **الإجراء:** See Document ← يفتح الوثيقة لتتمكن من مراجعتها والتحقق منها.

### رفض وثيقة

رفعت وثيقة ورفضها محقِّق. ترى:

* **نوع الحدث:** DOCUMENT
* **العنوان:** "رُفضت وثيقتك"
* **الوصف:** "رفض \[اسم المحقِّق] ‏\[اسم الوثيقة] — السبب: \[سبب الرفض معروض ضمن النص]."
* **الإجراء:** See Document ← يفتح الوثيقة لتتمكن من مراجعة سبب الرفض ورفع نسخة مصحَّحة.

### استلام طلب وصول

طلب طرف خارجي الوصول إلى وثيقة تملكها. ترى:

* **نوع الحدث:** DOCUMENT
* **العنوان:** "طلب وصول إلى \[اسم الوثيقة]"
* **الوصف:** "يطلب \[اسم مقدِّم الطلب] الوصول إلى \[اسم الوثيقة]."
* **الإجراء:** Review Request ← يفتح سير عمل الموافقة/الرفض.

### تعليق توضيحي على وثيقة

ترك صاحب مصلحة تعليقًا على صفحة وثيقة. ترى:

* **نوع الحدث:** DOCUMENT
* **العنوان:** "تعليق جديد على \[اسم الوثيقة]"
* **الوصف:** "علّق \[اسم صاحب المصلحة] على الصفحة \[X] من \[اسم الوثيقة]."
* **الإجراء:** See Comment ← يفتح عارض الوثيقة عند موضع التعليق.

### تذكير: وثيقة توشك على الانتهاء

تقترب صلاحية وثيقة من تاريخ انتهائها. ترى:

* **نوع الحدث:** REMINDER
* **العنوان:** "وثيقة توشك على الانتهاء"
* **الوصف:** "تنتهي صلاحية \[اسم الوثيقة] بتاريخ \[التاريخ]. ارفع نسخة مجدَّدة لتجنّب عقوبة المؤشر."
* **الإجراء:** See Document ← يفتح الوثيقة للاستبدال.

***

## نصائح لاستخدام موجز النشاط

* تحقّق من موجز النشاط **يوميًا** للبقاء مطّلعًا على طلبات التحقق وتذكيرات الانتهاء — فالمهام غير المعالَجة تتراكم وقد تُبطئ تقدّم Magma Index.
* استخدم **مرشّح شريط المباني الدوار** عندما يكون لديك مبنى محدد يحتاج إلى اهتمام — فهو يزيل الضوضاء من المباني الأخرى.
* تصرّف بشأن أحداث **REMINDER** بسرعة — فالوثائق التي توشك على الانتهاء تسبب عقوبة فورية على Magma Index بمجرد تجاوزها تاريخ انتهائها.
* إجراء **Review Request** حساس زمنيًا — فالأطراف الخارجية التي تنتظر الوصول تحتاج إلى رد لتتمكن من المضي في عملها.
* إذا كنت تدير فريقًا كبيرًا، فموجز النشاط طريقة فعّالة لمراقبة جميع إجراءات أصحاب المصلحة عبر المبنى دون الحاجة إلى فتح كل قسم على حدة.


---

# 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/activity-feed.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.
