語学目標の1日練習分数

記録済み時間がすでに目標に達していれば、1日の分数は0になり already_reached が真になります。0日の窓、または練習日が残らない休息予定は invalid_input で拒否されます。

時間目標から練習分数・休息日・セッションへ

休息日は余った平日へばらまくのではなく、暦の窓の中の完全な7日週ごとに rest_days_per_week 日の丸ごとの休みを与えます。したがって暦30日で週1日休みなら休息4日・練習26日です。sessions_per_day はその1日合計を分割し、朝の会話枠と夜の復習枠で負荷を分けられるようにします。残り時間がすでに0なら、1日分数もセッション分数も0で already_reached は真となり、計画側は負の練習を作らず追加枠を止められます。天井欄 daily_minutes_ceil と session_minutes_ceil は正確な商を整数分へ上げ、タイマーや学習アプリが丸め不足なく枠を確保できるようにします。

入力契約・応答の形・エラーの扱い

週に7日休むと練習日が残らないため拒否されます。単位付き文字列より素の数値を優先してください。数値文字列はカンマやラベルのない厳密な有限数パターンに一致する場合のみ受け付けます。必須の有限数を2つと任意のペース欄を3つ含む JSON 本体を送信してください。goal_hours（別名 total_hours, target_hours, hours_goal）は非負の語学時間目標です。days（別名 days_left, days_available, calendar_days）は暦の窓で、厳密に0より大きくなければなりません。hours_completed（別名 completed, already_practiced, hours_done）は省略時0で、指定時は非負でなければなりません。rest_days_per_week（別名 rest_days, weekly_rest, off_days）は0から6の整数で、省略時は0です。sessions_per_day（別名 sessions, sessions_daily）は1から24の整数で、省略時は1です。絶対値は1兆以内に保ち、Worker とブラウザ上の IEEE 倍精度で中間積が有限のままになるようにします。成功時、応答は丸めた入力、remaining_hours と remaining_minutes、full_weeks、rest_days_in_window、practice_days、daily_minutes と daily_minutes_ceil、session_minutes と session_minutes_ceil、weekly_practice_days、weekly_minutes、total_planned_minutes、already_reached、文書化された式、短い英語メッセージ、順序付きの代入手順を返します。検証失敗（欠落フィールド、非有限数、絶対限界外、負の合計や記録時間、整数でない休息数やセッション数、範囲外の休息やセッション、0または負の日数窓、練習日が残らない休息予定）は invalid_input を返し課金されません。料金は成功1回あたり固定の $0.002、単位は item です。

語学の1日練習分数 API が役立つ場面

SRS や会話練習アプリは、学習者が時間目標と日付を設定したとき、また記録セッションのたびに hours_completed が更新されたときに、同じ純粋モジュールを呼び出して再計算します。実装は解析ティア A の解析作業なので、成功コールは毎回公開の基本価格 $0.002 で、モデルトークンも外向きネットワークもありません。