Note requise à l’examen final

L’outil réarrange l’identité du cours pondéré pour que l’inconnue soit la note de l’examen elle-même, puis renvoie ce needed_on_final exact ainsi que le fait que la cible soit déjà assurée, encore atteignable sur une échelle standard, ou mathématiquement hors de portée même avec une copie parfaite. Le max_score optionnel couvre les cours en pourcent, les échelles sur vingt et les plafonds de points bonus sans changer l’algèbre.

Ce que signifie la note requise au final et comment on l’isole

L’identité du cours est simplement current_grade fois un moins w, plus la note inconnue de l’examen fois w, et cette combinaison doit égaler le target_grade que vous voulez sur le relevé. Isoler la note d’examen donne needed égal à target moins current fois un moins w, le tout divisé par w, où w est final_weight divisé par cent. Ce chiffre est exact même lorsqu’il dérange : l’API indique needed_on_final comme cent dix, attainable comme false, shortfall comme dix et max_possible_course comme quatre-vingt-huit, pour que vous voyiez l’algèbre et le plafond. Lorsque la note d’examen résolue est nulle ou négative, already_secured vaut true : même un zéro au final satisferait encore la cible car le travail antérieur dépasse déjà. Lorsque la note résolue se situe entre zéro et max_score, la cible reste en jeu et needed_practical égale needed_on_final.

Contrat d’entrée, plafond d’échelle optionnel et comportement d’erreur

Les chaînes numériques et un signe de pourcentage final sont acceptés afin qu’un formulaire qui envoie « 20% » soit encore interprété. Envoyez par POST un corps JSON avec trois nombres finis obligatoires : current_grade (non négatif, la marque que vous avez déjà sur l’échelle du cours), target_grade (non négatif, la marque globale voulue après le final) et final_weight (pourcentage du cours, strictement supérieur à zéro et au plus cent). Les alias current, current_score et now correspondent à current_grade ; target, desired et goal à target_grade ; weight, exam_weight et final_percent à final_weight. Le max_score optionnel (alias max, exam_max, scale) est le plafond positif de l’échelle de l’examen et du cours et vaut cent par défaut ; il ne change jamais la note d’examen résolue, seulement le drapeau d’atteignabilité, le shortfall et les notes de cours min et max possibles si vous obtenez zéro ou le plafond. En cas de succès le corps renvoie les entrées, remaining_weight, weight_fraction, current_contribution, needed_on_final, needed_practical (zéro lorsque la cible est déjà assurée), already_secured, attainable, max_score, min_possible_course, max_possible_course, plus formula et method weighted_final_needed pour des clients stables. Lorsque la note d’examen requise dépasse max_score, shortfall est le surplus de points que le plafond ne peut fournir. Champs manquants, valeurs non finies, actuel ou cible négatifs, max_score non positif et final_weight nul ou supérieur à cent échouent avec invalid_input en nommant le champ ; ces échecs de validation ne sont pas facturés. Exemple : actuel quatre-vingt-huit, cible quatre-vingt-dix, final quarante pour cent donne needed_on_final quatre-vingt-treize et attainable true, un plan que vous emportez dans la dernière semaine de révision.

Où une API de note requise au final justifie son existence

Les bureaux de conseil et les assistants entendent « de combien ai-je besoin au final ? » plus que toute autre question de note le dernier mois du semestre ; un oracle partagé à formule publiée arrête la dérive des tableurs entre permanences, centres de tutorat et discussions d’étudiants. Une validation en échec ne consomme pas de solde. Lorsque le syllabus est en lettres à points totaux ou une longue liste de notes de catégories non combinées, utilisez les outils dédiés à ces intentions ; cette page reste sur la question à trois nombres et au poids du final que les étudiants cherchent réellement. Parents et coachs peuvent accompagner un apprenant face à une cible inatteignable avec honnêteté — en montrant max_possible_course plutôt qu’un chiffre d’encouragement — puis baisser la cible ou parler de points bonus avec le même contrat. Comme l’implémentation est parse de niveau A pur, chaque appel réussi coûte le tarif de base publié $0.002 sans jetons de modèle ni réseau sortant. Gardez les requêtes petites, figez needed_on_final et attainable dans les tests, et vous obtenez une planification reproductible de la semaine des examens pour plugins LMS, workers en bordure et démos de classe sans dresser votre propre feuille de notes.