# منهجية المقاييس

كيف تُحسب الأرقام التي يذكرها Azoth OS في المواد التسويقية ومواد المنتج، ومن أين تأتي، و— قبل كل شيء — ما الذي لا يمثّله كلٌّ منها. استخدم هذه الصفحة للتحقق من أي رقم تقرؤه على الموقع أو تسمعه في مكالمة مبيعات.

## وسوم الثقة

- **مُقاس** — مستمَد من بيانات القياس عن بُعد في الإنتاج خلال نافذة زمنية محددة، أو من اختبار أداء حتمي مودَع في المستودع (`reports/benchmark-report.json`، `npm run benchmark`).
- **مُنمذَج** — محسوب بالمحاكاة على قائمة أسعار وحِمل عمل تمثيلي؛ ويتوقف على هذه الافتراضات. وقد تصفه النصوص الأقدم بأنه «محاكى».
- **مُتوقَّع** — رقم استشرافي: قائمة أسعار منشورة مطبَّقة على ملف عميل نموذجي. وليس ضمانًا.

> يجب أن يحمل كل رقم في المواد الموجّهة للعملاء وسمه. والرقم الذي لا وسم له لا ينبغي أن يظهر.

## الأرقام، ومن أين يأتي كل منها

- **التكلفة لكل استدعاء · مُقاسة، لكل استدعاء** — من الرموز التي عدّها المزوّد والسعر الساري في كتالوج النماذج؛ تُعاد في الترويسة `X-Azoth-Cost-Usd` وتُختم مع القرار. وأرقامك أنت في لوحة التحكم.
- **الطاقة لكل استدعاء · مُنمذَجة، لكل استدعاء** — تقدير وفق منهجية GreenOps، يُعاد في الترويسة `X-Azoth-Energy-Wh`. والغرامات المطلقة استرشادية؛ والنسبة المُتجنَّبة هي الرقم القابل للإبلاغ.
- **الإجابات المُعاد استخدامها · مُقاسة على منصة الاختبار المرجعي** — معدل إصابة الذاكرة المؤقتة في `npm run benchmark` على سيناريوهاته دون اتصال (`reports/benchmark-report.md`). ومعدلك أنت يتوقف على حِمل عملك.
- **زمن الاستجابة الذي يضيفه Azoth · لم يُنشر** — لا رقم بعد: قياس p50 وp95 مُدرج في خارطة الطريق.
- **التوافر · في صفحة الحالة** — الحالة المرصودة في صفحة الحالة. لا يُنشر هنا أي رقم للتوافر؛ وحيث يحدد عقدٌ اتفاقية مستوى خدمة، فهو ينص على رقمه.

## الجودة التي يزنها الموجِّه · مُقاس، لكل مساحة عمل

- عامل الجودة في التوجيه هو نسبة الحالات المرجعية الخاصة بمساحة العمل التي نجح فيها النموذج، خلال آخر 90 يومًا، بمجرد الحكم على 10 حالات على الأقل.
- وإلا فهو 0.5، أي محايد: ما لم تقِسه مساحة العمل يزن القدر نفسه لكل نموذج، ويعود الاختيار إلى الزمن الكامن والتكلفة.
- لا تستبعد أرضية الجودة نموذجًا إلا إذا كان معدل نجاحه المقيس أدنى منها، ولا تستبعد أبدًا نموذجًا غير مقيس. ويقرأ عامل التكلفة أسعار كتالوج النماذج.
- يذكر كل قرار توجيه أيّهما كان: «نجحت N% من M حالة مرجعية»، أو «لم يُقَس شيء بعد». وهو بيان عن حالات مساحة العمل هذه، وفق معاييرها هي، وليس عن نموذج بوجه عام.

## ما ليست عليه هذه الأرقام

- ليست وعدًا بشأن فاتورتك: قل «حتى» أو «الوسيط»، واذكر الوسم.
- ليست متوسطًا على عملاء Azoth: لا يُجمَّع حِمل عمل أي عميل في رقم علني.
- ليست ثابتة: أسعار المزوّدين، والنماذج الجديدة، والتغييرات في المحركات تحرّكها، ويُشغَّل اختبار الأداء من جديد مع كل إصدار.
- ليست وعدًا بالتوافر: الحالة المرصودة في صفحة الحالة.

## المصدر

المرجع في المستودع هو `docs/METRICS_METHODOLOGY.md`، ويُحدَّث بالتوازي مع هذه الصفحة. وأي رقم على الموقع لا يمكن ردّه إليه خلل — أخبرنا به من فضلك.
