ForHosting KIT · أدوات المطورين

نطاق الدرجة النهائية الممكنة مع الأعمال المتبقية

تبيّن حاسبة نطاق الدرجة النهائية الممكن مقدار المجال المتبقي في المقرر قبل تصحيح جميع الأعمال.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

أدخلوا كل درجة مكتملة مع وزنها، ثم الوزن الإجمالي لكل الواجبات غير المكتملة. تعرض النتيجة متوسطكم الموزون الحالي، وأسوأ وأفضل درجة نهائية يمكن بلوغها إذا حصل العمل المتبقي على الحد الأدنى أو الأقصى المسموح به. يمكن استخدام أوزان مئوية أو عشرية أو قائمة على النقاط، بشرط اعتماد المقياس نفسه لجميع الأوزان.

صفوا الجزأين المكتمل والمتبقي من المقرر

ابدؤوا بإدخال كل عمل مكتمل في صورة درجة ووزن. يمكن أن يكون وزن اختبار نصفي قيمته 25 في المئة هو 25، ووزن اختبار قصير قيمته 5 في المئة هو 5. وإذا كانت الخطة تستخدم حصصًا عشرية، فإن 0.25 و0.05 يعملان بالطريقة نفسها. المهم هو الاتساق؛ فلا تخلطوا النسب المئوية والكسور العشرية والنقاط الخام في الطلب نفسه. بعد ذلك أدخلوا الوزن المجمع لجميع الأعمال غير المكتملة. لا حاجة إلى توقع كل درجة متبقية، لأن الحاسبة تحدد الطرفين لا توقعًا واحدًا. الحد الأدنى الافتراضي هو 0 والأقصى 100، ويمكن تغييرهما لمقاييس أخرى أو نقاط مشاركة مضمونة أو اختبارات ذات سقف أو قواعد الدرجات الإضافية. يجب أن تقع الدرجات المكتملة ضمن الحدود نفسها لكشف أخطاء الإدخال الشائعة. الوزن الكلي هو مجموع الوزن المكتمل والمتبقي، ولذلك تعمل الحسبة حتى عندما لا تجمع أوزان الخطة إلى 100 حرفيًا.

افهموا كيفية حساب النطاق الممكن بلوغه

تُضرب كل درجة مكتملة في وزنها ثم تُجمع النواتج لتكوين المساهمة المحققة حتى الآن. يقسم المتوسط الحالي هذه المساهمة على الوزن المكتمل وحده، ولذلك يصف أداء الأعمال المصححة. أما النطاق النهائي فيستخدم الوزن المكتمل مضافًا إليه الوزن المتبقي في المقام. للحصول على أسوأ درجة نهائية ممكنة، يُسند الحد الأدنى المسموح به إلى كل الوزن المتبقي؛ وللحصول على الأفضل يُسند الحد الأقصى. هذه أطراف رياضية وليست تنبؤات. إذا بقي نصف المقرر فقد يكون النطاق واسعًا رغم استقرار المتوسط، وإذا لم يبق إلا مشروع صغير فعادة يكون ضيقًا. لا يطبق التقريب إلا على القيم المعروضة بعد الحسابات الموزونة، ويمكن اختيار ما بين صفر وست منازل عشرية. وبما أن حدود الدرجات نفسها تنطبق على العمل المكتمل والمتبقي، يسهل فهم النتيجة على مقياس 0–100 وعلى مقاييس مثل 0–20 أو 1–10.

استخدموا النتيجة للتخطيط دون مبالغة في تفسيرها

تعاملوا مع أسوأ قيمة وأفضلها بوصفهما حدين للتخطيط. إذا كانت الدرجة المطلوبة أعلى من أفضل قيمة ممكنة، فلن تكفي الدرجات الكاملة في جميع الأعمال المتبقية وفق الأوزان المدخلة. وإذا كان حد النجاح مساويًا لأسوأ قيمة أو أدنى منها، فقد أصبح مضمونًا حتى مع أدنى درجة متبقية. يظل الهدف الواقع داخل النطاق ممكنًا، لكن الحاسبة لا تحدد المتوسط المطلوب لبلوغه؛ بل تعرض المجال الممكن كله. راجعوا خطة المقرر قبل اتخاذ قرار، لأن إسقاط الواجبات والتطبيع حسب الفئات ومنحنيات الدرجات والاختبارات البديلة والعقوبات والدرجات الإضافية والإعفاءات قد تغير الحساب الفعلي. اجمعوا الواجبات غير المكتملة في وزن واحد فقط عندما تشترك في نطاق الدرجات المسموح به. وإذا كان لأحد الاختبارات سقف خاص أو حد أدنى مضمون، فاحسبوا سيناريوهات منفصلة بحدود مناسبة. يساعد حفظ المدخلات مع النتيجة على تحديث النطاق بعد ظهور الدرجة التالية وشرح الافتراضات المستخدمة بوضوح.

حالات الاستخدام

تحققوا مما إذا كان الهدف ما زال ممكنًا

قارنوا الدرجة المطلوبة بأفضل درجة نهائية ممكنة عند نيل الحد الأقصى في كل الأعمال المتبقية.

اعرفوا ما إذا كان الحد المطلوب مضمونًا

قارنوا حد النجاح أو المنحة أو المتطلب السابق بأسوأ درجة نهائية ممكنة عند الحد الأدنى المحدد.

حدّثوا الخطة بعد ظهور كل درجة

انقلوا العمل المصحح حديثًا إلى قائمة المكتمل، وخفّضوا الوزن المتبقي، وراقبوا تضيق النطاق الممكن.

الأسئلة الشائعة

ما تكلفة الحساب؟

يمكن تشغيله مجانًا في المتصفح. تبلغ تكلفة طلب API مقدار $0.002.

هل يجب أن يكون مجموع الأوزان 100؟

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

لماذا يختلف المتوسط الحالي عن النطاق النهائي؟

يستخدم المتوسط الحالي الوزن المكتمل وحده، بينما يضم طرفا النطاق النهائي الوزن المكتمل والمتبقي في المقام.

هل يمكن استخدام مقياس غير 0 إلى 100؟

نعم. اضبطوا min_score وmax_score على طرفي المقياس، وعبّروا عن كل الدرجات المكتملة بالمقياس نفسه.

هل تتنبأ أفضل درجة بما سأحصل عليه؟

لا. إنها الحد الأقصى الرياضي وفق الأوزان والحدود المدخلة، وليست توقعًا أو احتمالًا.

كيف أتعامل مع الدرجات الإضافية أو المستبعدة؟

مثّلوا فقط الأوزان والحدود الفعلية التي تقررها سياسة المقرر، وشغّلوا سيناريوهات متعددة إذا تغيرت الأعمال المحتسبة.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/edu/grade-range-remaining

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/edu/grade-range-remaining \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"completed":[{"score":82,"weight":20},{"score":91,"weight":30}],"remaining_weight":50}'

const res = await fetch("https://api.kit.forhosting.com/edu/grade-range-remaining", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "completed": [
      {
        "score": 82,
        "weight": 20
      },
      {
        "score": 91,
        "weight": 30
      }
    ],
    "remaining_weight": 50
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/grade-range-remaining",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "completed": [
        {
            "score": 82,
            "weight": 20
        },
        {
            "score": 91,
            "weight": 30
        }
    ],
    "remaining_weight": 50
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/grade-range-remaining", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"completed":[{"score":82,"weight":20},{"score":91,"weight":30}],"remaining_weight":50}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"completed":[{"score":82,"weight":20},{"score":91,"weight":30}],"remaining_weight":50}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/grade-range-remaining", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "completed": [
    {
      "score": 82,
      "weight": 20
    },
    {
      "score": 91,
      "weight": 30
    }
  ],
  "remaining_weight": 50
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "edu.grade_range_remaining",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

max_items 100

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←