jp-learning-progress 設計書

Appearance

画面設計: 学習者マイページ ​

関連: api.md §3 / data-model.md §3.5, §3.7 / auth-rbac.md §4

URL ​

  • /app/me — プロファイル／サマリー
  • /app/me/progress — JLPT進捗・学習時間
  • /app/me/credibility — 自分の一貫性スコア
  • /app/me/privacy — 同意・撤回・エクスポート

目的 ​

学習者が自身の学習成果と評価指標を自己閲覧・自己管理できる。一貫性スコアの透明性を確保し、異議申立の起点となる。

1. /app/me（サマリー） ​

  • 氏名・所属送出し機関・JLPT 到達レベル
  • 当月学習時間（実測）・連続学習日数
  • 単語習得数：mastered / assigned
  • テスト直近成績
  • 「詳細」「プライバシー設定」リンク
  • API: GET /me, GET /learner/progress

2. /app/me/progress ​

要素 ​

  • JLPT 進捗：N5 完了 ◎ → N4 学習中 80%（目標単語数・文法数に対する到達率）
  • 単語習得推移：週次ライン（mastered 累計）
  • 学習時間推移：週次バー（measured / reported の両方を表示）
  • テスト推移：時系列ラインチャート
  • カテゴリ別強み・弱み：レーダーチャート（任意）

データ算出 ​

  • GET /learner/progress?from=...&to=... で期間指定
  • 分母・指標定義は data-model §5 計算式に準拠

3. /app/me/credibility（一貫性スコア） ​

必須要素 ​

  • スコア（0.00-1.00）・帯（low/mid/high）
  • 内訳：各指標と重み（申告×実測乖離、スキップ率、回答バラツキ 等）をグラフで可視化
  • 算出ロジックのバージョン（score.version）を表示
  • 利用上の注意：
    • 採用判断の補助情報であり、単独の判定には用いない
    • 管理者確認後に企業ロールへ要約のみ開示される
  • 異議申立：「このスコアに異議がある」ボタン → 申立フォーム（種類、理由、希望する対応）
  • 異議履歴：過去の申立と判定結果

文言 ​

  • 肯定的・説明的な表現（「現在の指標はこうです。改善の余地があります」など）
  • 断定・恥ずかしめ表現を避ける

算出根拠・再計算条件 ​

  • 対象期間：過去 30 日（period_start / period_end を表示）。期間は OA 設定で変更可
  • 入力ソース：StudyTimeLog（申告・実測）、VideoWatchLog（スキップ率・視聴完了）、QuizAnswer.response_time_ms（回答バラツキ）
  • 重み：score.version に紐付いた定義（公開コンフィグ。M1 初期値 v1：乖離0.4 / スキップ0.3 / 回答バラツキ0.3）
  • 再計算トリガー：日次バッチ（00:00 JST）、および異議受理時の個別再計算
  • バージョニング：ロジック変更時は version を更新し、過去スコアは上書きせず履歴として保持

異議申立受理時の再計算フロー ​

  1. 学習者が POST /learner/appeals を送信（対象 credibility_score の ID を含む）
  2. OA（§usecases.md UC-O-01）が検証・判定
  3. 判定結果が accepted の場合：
    • 原データの誤りを OA が特定・訂正
    • 該当期間のスコアを新しい CredibilityScore 行として再計算（旧スコアは「異議により差替」メモ付きで履歴保持）
  4. 判定結果が rejected の場合：スコアは維持、理由を学習者に通知

API ​

  • GET /learner/credibility 応答に version, period_start, period_end, breakdown, appealable: true/false を含む
  • POST /learner/appeals

4. /app/me/privacy ​

要素 ​

  • 現在の同意状況一覧（学習ログ、企業開示 など）
  • 各項目のトグル・履歴
  • 「エクスポート（自分のデータ）」ボタン
  • 「削除請求」ボタン（二重確認、説明文）
  • API: GET /me/consents, POST /me/consents/withdraw, POST /me/delete-request

フロー ​

  • 撤回後の結果：該当機能の制限内容をその場で提示
  • 削除請求：受付後、OA 側で処理、法令期限以内に完了

アクセシビリティ ​

  • チャート：表形式の代替表示を同画面に提供
  • 色覚配慮：パターン併用、色のみに依存しない

RBAC ​

  • LR のみアクセス可、自身のデータのみ
  • 他ロールは閲覧不可

未確定 ​

  • エクスポート形式（JSON/CSV）
  • 削除請求の対象範囲（学習ログ保持、匿名化範囲）

Internal — thriveJobs

© 2026 thriveJobs