docs(locadex): update translations on main

ar/api-reference/guides/consensus-ratings-explained.mdx

@@ -0,0 +1,320 @@
+---
+title: "شرح تصنيفات الإجماع"
+description: "تعرّف على كيفية قيام Benzinga باحتساب تصنيفات الإجماع من توصيات المحللين الفردية"
+---
+
+<div id="overview">
+  ## نظرة عامة
+</div>
+
+توفّر تقييمات الإجماع صورة مجمّعة لآراء المحللين حول سهم معيّن من خلال تجميع تقييمات كل محلّل في مؤشر واحد سهل الفهم. يشرح هذا الدليل كيفية حساب تقييمات الإجماع لمساعدتك على اتخاذ قرارات استثمارية مستنيرة.
+
+<div id="how-consensus-ratings-are-calculated">
+  ## كيفية حساب تقييمات الإجماع
+</div>
+
+<div id="step-1-collecting-analyst-ratings">
+  ### الخطوة 1: جمع تقييمات المحللين
+</div>
+
+نجمع جميع تقييمات المحللين المتاحة لسهم معيَّن. يتضمن كل تقييم:
+
+* **اسم المحلِّل** و**اسم الشركة**
+* **التقييم** (مثلًا: Strong Buy، Buy، Hold، Sell، Strong Sell)
+* **السعر المستهدَف** - السعر المستقبلي المتوقَّع للسهم بحسب تقدير المحلِّل
+* **تاريخ التحديث** - تاريخ إصدار التقييم
+
+<div id="step-2-filtering-for-unique-analysts">
+  ### الخطوة 2: التصفية حسب المحللين المميزين
+</div>
+
+لضمان الدقة وتجنّب احتساب التقييم نفسه أكثر من مرة، نقوم فقط بتضمين **أحدث تصنيف** من كل تركيبة مميزة من محلل وشركة.
+
+**مثال:** إذا قام المحلل في Morgan Stanley جون دو بتقييم سهم عدة مرات، فسيتم تضمين أحدث تصنيف صادر عنه فقط في عملية الحساب.
+
+<Note>
+  يتم استبعاد التقييمات التي لا تحتوي على هدف سعر صالح من التحليل.
+</Note>
+
+<div id="step-3-categorizing-ratings">
+  ### الخطوة 3: تصنيف التوصيات
+</div>
+
+يتم تصنيف توصيات المحللين إلى خمس فئات معيارية:
+
+| الفئة | القيمة الرقمية |
+|----------|---------------|
+| **بيع قوي** | 1 |
+| **بيع** | 2 |
+| **احتفاظ** | 3 |
+| **شراء** | 4 |
+| **شراء قوي** | 5 |
+
+<div id="step-4-aggregating-ratings">
+  ### الخطوة 4: تجميع التقييمات
+</div>
+
+نحسب عدد المحللين الذين يَقَع كلٌّ منهم في كل فئة.
+
+**مثال على التجميع:**
+
+* Strong Buy: 8 محللين
+* Buy: 12 محللًا
+* Hold: 5 محللين
+* Sell: 2 محللين
+* Strong Sell: 1 محلل
+
+**الإجمالي:** 28 محللًا فريدًا
+
+<div id="step-5-calculating-the-consensus-rating-value">
+  ### الخطوة 5: حساب قيمة التقييم الإجماعي
+</div>
+
+تُحسب قيمة التقييم الإجماعي كمتوسط موزون:
+
+```
+Consensus Value = (Strong Buy × 5 + Buy × 4 + Hold × 3 + Sell × 2 + Strong Sell × 1) / Total Analysts
+```
+
+**استنادًا إلى المثال أعلاه:**
+
+```
+Consensus Value = (8×5 + 12×4 + 5×3 + 2×2 + 1×1) / 28
+Consensus Value = (40 + 48 + 15 + 4 + 1) / 28
+Consensus Value = 108 / 28
+Consensus Value = 3.86
+```
+
+<div id="step-6-determining-the-consensus-rating">
+  ### الخطوة 6: تحديد التوصية الإجماعية
+</div>
+
+يتم تقريب قيمة الإجماع إلى أقرب عدد صحيح وتحويلها إلى تصنيف:
+
+| قيمة الإجماع | التصنيف القياسي | التصنيف المبسط |
+|---------------|------------------|------------------|
+| **1** | بيع قوي | بيع |
+| **2** | بيع | بيع |
+| **3** | احتفاظ | احتفاظ |
+| **4** | شراء | شراء |
+| **5** | شراء قوي | شراء |
+
+**في مثالنا:** يتم تقريب 3.86 إلى **4**، ما يقابل توصية إجماعية **&quot;شراء&quot;**.
+
+***
+
+<div id="display-options">
+  ## خيارات العرض
+</div>
+
+<div id="standard-vs-simplified-ratings">
+  ### التقييمات القياسية مقابل المبسطة
+</div>
+
+نوفّر شكلين للعرض:
+
+**قياسي (5 فئات):**
+
+* بيع قوي، بيع، احتفاظ، شراء، شراء قوي
+
+**مبسّط (3 فئات):**
+
+* بيع (يجمع بين بيع قوي + بيع)
+* احتفاظ
+* شراء (يجمع بين شراء + شراء قوي)
+
+<div id="count-vs-percentage-display">
+  ### عرض العدد مقابل النسبة المئوية
+</div>
+
+**عرض العدد:**
+يعرض العدد الفعلي للمحللين في كل فئة.
+
+**عرض النسبة المئوية:**
+يعرض نسبة المحللين في كل فئة، بعد تقريبها إلى نسب مئوية صحيحة بحيث يكون مجموعها 100% بالضبط.
+
+**مثال:**
+
+* شراء: ‎71%‎ (20 محللًا)
+* احتفاظ: ‎18%‎ (5 محللين)
+* بيع: ‎11%‎ (3 محللين)
+
+***
+
+<div id="price-target-calculations">
+  ## حساب السعر المستهدف
+</div>
+
+<div id="consensus-price-target">
+  ### السعر المستهدف وفق إجماع المحللين
+</div>
+
+متوسط جميع الأسعار المستهدفة التي حددها المحللون:
+
+```
+Consensus PT = Sum of all Price Targets / Number of Analysts
+```
+
+<div id="low-and-high-price-targets">
+  ### أدنى وأعلى الأسعار المستهدفة
+</div>
+
+* **أدنى سعر مستهدف:** أقل سعر مستهدف بين جميع المحللين
+* **أعلى سعر مستهدف:** أعلى سعر مستهدف بين جميع المحللين
+
+توفِّر هذه القيم نطاقًا يوضّح مدى توقعات المحللين.
+
+***
+
+<div id="understanding-the-metrics">
+  ## فهم المقاييس
+</div>
+
+<div id="total-analyst-count-vs-unique-analyst-count">
+  ### إجمالي عدد المحللين مقابل عدد المحللين الفريدين
+</div>
+
+* **إجمالي عدد المحللين:** جميع التقييمات التي جُمِعت (قد تتضمن عدة تقييمات من نفس المحلل)
+* **عدد المحللين الفريدين:** عدد التركيبات المميَّزة بين المحلل والشركة (تُستخدم في الحسابات)
+
+يضمن عدد المحللين الفريدين احتساب صوت كل محلل مرة واحدة فقط، مما يوفر إجماعًا أكثر دقة.
+
+***
+
+<div id="important-considerations">
+  ## اعتبارات مهمة
+</div>
+
+<div id="rating-freshness">
+  ### حداثة التقييم
+</div>
+
+تعكس تقييمات الإجماع أحدث آراء المحللين. يشير الطابع الزمني **Updated At** إلى وقت آخر مرة جرى فيها احتساب الإجماع.
+
+<div id="coverage-depth">
+  ### عمق التغطية
+</div>
+
+تكون تقييمات الإجماع أكثر موثوقية عندما تستند إلى عدد أكبر من المحللين المختلفين. قد تكون الأسهم ذات التغطية المحدودة من المحللين (أقل من 3–5 محللين) ذات تقييمات إجماع أقل استقرارًا.
+
+<div id="rating-distribution">
+  ### توزيع التقييمات
+</div>
+
+انتبه إلى توزيع التقييمات، وليس إلى مستوى الإجماع فقط. السهم الذي يحمل 50% تقييمات &quot;Buy&quot; و50% تقييمات &quot;Sell&quot; سيُظهِر إجماعًا على &quot;Hold&quot;، لكن هذا يُخفي خلافًا كبيرًا بين المحللين.
+
+***
+
+<div id="example-calculation-walkthrough">
+  ## استعراض مثال حساب
+</div>
+
+لنستعرض مثالاً كاملاً لشركة **XYZ Corporation**:
+
+<div id="raw-data-10-analysts">
+  ### البيانات الخام (10 محللين)
+</div>
+
+| المحلل | الشركة | التصنيف | السعر المستهدف |
+|---------|------|--------|--------------|
+| المحلل أ | Goldman Sachs | شراء | $150 |
+| المحلل ب | JP Morgan | شراء قوي | $165 |
+| المحلل ج | Morgan Stanley | شراء | $155 |
+| المحلل د | Bank of America | الاحتفاظ | $140 |
+| المحلل هـ | Citigroup | شراء قوي | $170 |
+| المحلل و | Wells Fargo | شراء | $152 |
+| المحلل ز | Deutsche Bank | الاحتفاظ | $145 |
+| المحلل ح | Barclays | بيع | $130 |
+| المحلل ط | UBS | شراء | $158 |
+| المحلل ي | Credit Suisse | شراء قوي | $168 |
+
+<div id="step-by-step-calculation">
+  ### الحساب خطوة بخطوة
+</div>
+
+**1. تصفية التقييمات حسب المحللين الفريدين:** كل واحد من التقييمات العشرة صادر عن محلل مختلف (10 محللين مشاركين)
+
+**2. تجميع الأعداد:**
+
+* Strong Buy: 3
+* Buy: 4
+* Hold: 2
+* Sell: 1
+* Strong Sell: 0
+
+**3. حساب قيمة الإجماع:**
+
+```
+(3×5 + 4×4 + 2×3 + 1×2 + 0×1) / 10 = (15 + 16 + 6 + 2 + 0) / 10 = 3.9
+```
+
+**4. تحديد الإجماع:** 3.9 تُقرَّب إلى **4 = &quot;شراء&quot;**
+
+**5. الأسعار المستهدفة:**
+
+* سعر مستهدف توافقي (Consensus PT): ‏(150+165+155+140+170+152+145+130+158+168) / 10 = **$153.30**
+* أقل سعر مستهدف (Low PT): **$130**
+* أعلى سعر مستهدف (High PT): **$170**
+
+**6. التوزيع النسبي:**
+
+* شراء (Buy): ‏70% ‏(شراء قوي 30% + شراء 40%)
+* احتفاظ (Hold): ‏20%
+* بيع (Sell): ‏10%
+
+<div id="final-consensus-rating-output">
+  ### النتيجة النهائية لتصنيف الإجماع
+</div>
+
+```json
+{
+  "consensusRating": "BUY",
+  "consensusRatingValue": 3.9,
+  "consensusPriceTarget": 153.30,
+  "priceTargetLow": 130,
+  "priceTargetHigh": 170,
+  "totalAnalysts": 10,
+  "uniqueAnalysts": 10,
+  "lastUpdated": "2026-01-16T10:30:00Z"
+}
+```
+
+***
+
+<div id="frequently-asked-questions">
+  ## الأسئلة الشائعة
+</div>
+
+<AccordionGroup>
+  <Accordion title="لماذا قد يختلف العدد الإجمالي للمحللين عن عدد المحللين الفريدين؟">
+    إذا قام محلل من نفس الشركة بتحديث تصنيفه عدة مرات، فإن العدد الإجمالي يشمل كل هذه التحديثات، لكن يتم استخدام أحدث تصنيف فقط في الحسابات (كما ينعكس في عدد المحللين الفريدين).
+  </Accordion>
+
+  <Accordion title="كل متى يتم تحديث تصنيفات الإجماع؟">
+    يتم إعادة حساب تصنيفات الإجماع كلما نُشرت تصنيفات جديدة من المحللين أو تم تحديث التصنيفات الحالية.
+  </Accordion>
+
+  <Accordion title="ماذا يحدث إذا لم تكن هناك أي تصنيفات من المحللين؟">
+    في غياب تغطية من المحللين، لا يمكن حساب تصنيف إجماع. سيُعرَض السهم دون بيانات إجماع.
+  </Accordion>
+
+  <Accordion title="هل يمكن أن يتغير تصنيف الإجماع دون وجود تصنيفات جديدة من المحللين؟">
+    لا. يتغير تصنيف الإجماع فقط عندما يصدر المحللون تصنيفات جديدة أو يحدِّثون التصنيفات الحالية.
+  </Accordion>
+</AccordionGroup>
+
+***
+
+<div id="related-endpoints">
+  ## نقاط النهاية ذات الصلة
+</div>
+
+<CardGroup cols={2}>
+  <Card title="Consensus Ratings API" icon="chart-bar" href="/ar/api-reference/calendar_api/consensus_ratings/returns-analyst-ratings-consensus-data">
+    جلب بيانات تصنيفات الإجماع للأسهم
+  </Card>
+
+  <Card title="Analyst Ratings API" icon="users" href="/ar/api-reference/calendar_api/ratings/returns-analyst-ratings-data">
+    جلب التصنيفات الفردية للمحللين
+  </Card>
+</CardGroup>