期末試験に必要な点数

ツールは加重コースの恒等式を変形し、未知数を試験点そのものにし、その正確な needed_on_final に加えて、目標がすでに確保済みか、標準スケールでまだ届くか、満点でも数学的に届かないかを返します。任意の max_score は百分率科目、20点満点、追加点の上限を、代数を変えずに扱います。

期末に必要な点の意味と、試験点の求め方

科目の恒等式は、current_grade に1引く w を掛け、未知の試験点に w を掛けて足したものであり、その和が成績表に残したい target_grade と一致しなければなりません。試験点について解くと、needed は target から current に1引く w を掛けたものを引き、それを w で割った値になります。ここで w は final_weight を100で割ったものです。APIは needed_on_final を110、attainable を false、shortfall を10、max_possible_course を88と返し、代数と上限の両方を見せます。求めた試験点が0以下なら already_secured は true です。求めた点が0から max_score の間なら目標はまだ有効で、needed_practical は needed_on_final と一致します。

入力契約、任意の満点上限、エラー時の挙動

数値文字列と末尾のパーセント記号も受け付けるので、「20%」を送るフォームも解釈されます。解いた試験点は変えず、到達可否の旗、shortfall、0点または上限を取ったときの科目の最小・最大可能点だけが変わります。POSTでJSON本体に、有限な必須数を3つ送ります。current_grade（非負。科目スケールですでに持っている点）、target_grade（非負。期末後に欲しい総合点）、final_weight（科目に対するパーセントで、0より大きく100以下）。エイリアス current、current_score、now は current_grade に、target、desired、goal は target_grade に、weight、exam_weight、final_percent は final_weight に対応します。任意の max_score（エイリアス max、exam_max、scale）は試験と科目の正の上限で、既定は100です。成功時の本体は入力に加え remaining_weight、weight_fraction、current_contribution、needed_on_final、needed_practical（目標がすでに確保なら0）、already_secured、attainable、max_score、min_possible_course、max_possible_course、さらに安定したクライアント向けの formula と method weighted_final_needed を返します。必要な試験点が max_score を超えるとき、shortfall は上限が供給できない超過点です。欠落、非有限、負の現在点や目標、非正の max_score、0または100超の final_weight は invalid_input で失敗し、フィールド名を示します。これらの検証失敗は課金されません。例：現在88、目標90、期末40パーセントなら needed_on_final は93、attainable は true で、最終週に持っていける計画になります。

期末必要点APIが本領を発揮する場面

保護者やコーチは届かない目標を、励ましの数字ではなく max_possible_course で正直に案内し、同じ契約のまま目標を下げるか追加点を話せます。実装は純粋な parse のティアAなので、成功した呼び出しは毎回、公表された基本料金 $0.002 で、モデルトークンも外向き通信もありません。リクエストは小さく保ち、needed_on_final と attainable をテストに固定すれば、LMSプラグイン、エッジワーカー、授業デモ向けに再現可能な期末週の計画が得られ、自前の成績表を立てる必要はありません。