ForHosting KIT · التعليم

احسب نسبة حضور الصفوف وتحقق من الحد الأدنى

حضور 31 حصة من 40 يعني نسبة 77.5 بالمئة، وهي أقل من حد أدنى قدره 80 بالمئة. أدخل الحصص المنعقدة والحصص التي حضرتها والحد الذي تشترطه مؤسستك، لتحصل على النسبة وجواب واضح: فوق الحد أم دونه. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

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

مثال محلول

إذا أدخلت

الحصص المعقودة: 40
الحصص التي تم حضورها: 31
حد السياسة: 80

تحصل على

نسبة الحضور: 77.5

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

احسبوا الحضور انطلاقًا من أعداد الصفوف الفعلية

تبدأ نسبة الحضور بعددين من الفترة نفسها: الصفوف المعقودة والصفوف المحضورة. تقسم الحاسبة عدد الصفوف المحضورة على عدد الصفوف المعقودة، ثم تضرب النسبة في 100. فعلى سبيل المثال، يؤدي حضور 31 صفًا من أصل 40 إلى نسبة قدرها 77.5 بالمئة.

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

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

تُقرب النسبة المعروضة إلى منزلتين عشريتين لتكون واضحة ويسهل التحقق منها بصورة مستقلة.

قارنوا النتيجة بالحد الصحيح للسياسة

حد السياسة هو أدنى نسبة حضور مقبولة، ويُعبر عنه بقيمة من 0 إلى 100. أدخلوا 75 إذا كانت المادة تشترط حضور 75 بالمئة على الأقل، أو 90 إذا كان البرنامج يشترط 90 بالمئة. تستخدم المقارنة النسبة الرياضية الكاملة بدلًا من النسبة المقربة المعروضة.

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

يجيب المؤشر باستمرار عن سؤال محدد، لكنه لا يقرر العقوبة أو أهلية دخول الامتحان أو قبول عذر الغياب.

تحققوا من السجلات واستخدموا النتيجة بمسؤولية

تعتمد النسبة الموثوقة على سجلات متسقة داخليًا. يجب أن يكون العددان صحيحين؛ فالقيم مثل 18.5 تُرفض بدلًا من تقريبها دون تنبيه. ويمكن أن يتضمن الحد منازل عشرية، مما يدعم سياسات مثل 82.5 بالمئة.

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

لا تؤثر أي عملية بحث عبر الشبكة أو قيمة عشوائية أو تاريخ حالي أو قاعدة بيانات مدرسية في الحساب؛ بل يأتي المعنى كله من القيم الثلاث التي تقدمونها.

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

متابعة تقدم الطالب

احسبوا نسبة الحضور الحالية قبل نهاية الفترة وتحققوا من أنها لا تقل عن متطلبات المادة.

مراجعة سجل المعلم

تحققوا من نسبة الطالب انطلاقًا من الإجماليات واكتشفوا أي عدد مستحيل قبل نشر التقرير.

أتمتة البوابة التعليمية

طبقوا حدًا معلنًا بصورة متسقة واحفظوا مؤشر السياسة البسيط مع كل نتيجة.

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

كيف تُحسب نسبة حضور الصفوف؟

يُقسم عدد الصفوف المحضورة على عدد الصفوف المعقودة، ثم تُضرب النتيجة في 100. وتُقرب النسبة المعروضة إلى منزلتين عشريتين.

ماذا يحدث عندما تساوي نسبة الحضور الحد؟

ولا يُشار إلا إلى النسبة الأقل بصورة صارمة.

هل يمكن أن يحتوي حد السياسة على منازل عشرية؟

نعم. تُقبل أي قيمة منتهية من 0 إلى 100، بما في ذلك قيم مثل 82.5.

هل يؤثر التقريب في مؤشر السياسة؟

لا. تُقرب النسبة لتسهيل القراءة، لكن المقارنة تستخدم القيمة الرياضية غير المقربة.

هل تُحسب الحصص الملغاة ضمن الحصص المنعقدة؟

عادةً لا. احسب ضمن الحصص المنعقدة ما عُقد فعلًا فقط، لأن أحدًا لم يكن يستطيع حضور الحصص الملغاة. وحدّد قبل الإدخال كيفية التعامل مع التأخر والغياب بعذر والحضور الجزئي وفق قواعد مؤسستك.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/edu/attendance-percentage

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

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

curl -X POST https://api.kit.forhosting.com/edu/attendance-percentage \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"classes_held":40,"classes_attended":31,"policy_threshold":75}'

const res = await fetch("https://api.kit.forhosting.com/edu/attendance-percentage", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "classes_held": 40,
    "classes_attended": 31,
    "policy_threshold": 75
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/attendance-percentage",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "classes_held": 40,
    "classes_attended": 31,
    "policy_threshold": 75
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/attendance-percentage", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"classes_held":40,"classes_attended":31,"policy_threshold":75}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"classes_held":40,"classes_attended":31,"policy_threshold":75}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/attendance-percentage", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "classes_held": 40,
  "classes_attended": 31,
  "policy_threshold": 75
}

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

ملاحظات تقنية

قارنوا النتيجة بالحد الصحيح للسياسة

تتضمن النتيجة below_policy_threshold، ولا تكون قيمته صحيحة إلا عندما تقل نسبة الحضور المحسوبة عن الحد المحدد بصورة صارمة. ولذلك فإن المساواة تحقق الشرط: نسبة 75 بالمئة بالضبط ليست أقل من قاعدة 75 بالمئة.

تحققوا من السجلات واستخدموا النتيجة بمسؤولية

لا يمكن أن يتجاوز عدد الصفوف المحضورة عدد الصفوف المعقودة، ولذلك تعيد الإمكانية خطأ invalid_input عند ظهور هذه العلاقة المستحيلة. عند تكرار الفحص، يمكن للتطبيق استدعاء API بسعر $0.002 لكل عنصر وتخزين الأعداد والنسبة والحد والمؤشر مع فترة التقرير. تستخدم حاسبة المتصفح المنطق الحتمي نفسه الذي تستخدمه API، لذا تنتج المدخلات المتكافئة مخرجات متكافئة.

أسئلة تقنية

لماذا لا يجوز أن تتجاوز الصفوف المحضورة الصفوف المعقودة؟

هذه العلاقة مستحيلة ضمن فترة متسقة. تعيد الإمكانية invalid_input لكي يتسنى تصحيح السجل المصدر.

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

شغّل الأداة مجانًا

مثال محلول

احسبوا الحضور انطلاقًا من أعداد الصفوف الفعلية

قارنوا النتيجة بالحد الصحيح للسياسة

تحققوا من السجلات واستخدموا النتيجة بمسؤولية

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

متابعة تقدم الطالب

مراجعة سجل المعلم

أتمتة البوابة التعليمية

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

ملاحظات تقنية

قارنوا النتيجة بالحد الصحيح للسياسة

تحققوا من السجلات واستخدموا النتيجة بمسؤولية

أسئلة تقنية

شكرًا