画面設計: 管理者 学習者詳細・進捗グラフ

関連: api.md §4 / auth-rbac.md §4 / data-model.md

URL

• /admin/learners/:id
• サブタブ: progress / vocab / credibility / exam / notes

目的

担当学習者の状況を俯瞰し、躓きを特定し、面談メモを残す。

レイアウト

[パンくず: 学習者 > 氏名]
[ヘッダー: アバター / 氏名 / コホート / JLPT / 最終学習日]
[サブタブ: 進捗 | 単語 | 一貫性(OA有効時) | 試験 | 面談メモ]
[メインエリア]
[右サイドバー: 直近アラート / 異議申立 / クイック操作（メッセージ送信等）]

タブ: 進捗

• 期間指定（3ヶ月／6ヶ月／カスタム）
• JLPT 到達度（N5→N4 進行）
• 単語習得数推移
• 学習時間（measured / reported を同時表示、乖離はハイライト）
• テストスコア推移
• 出席日数・出席率

タブ: 単語

• 全単語セットごとの習得率
• 未習得単語の抽出
• カテゴリ別正答率

タブ: 一貫性（OA 有効時のみ表示）

• 一貫性スコア推移
• 内訳（乖離／スキップ率／回答バラツキ）
• 閾値超過のアラート
• TA は閲覧のみ。スコア変更は OA 経由
• 異議申立履歴（Appeal）一覧

タブ: 試験

• 試験一覧（日付・名称・点数）
• 成績入力（TA/OA のみ）
• PDF 出力（OA のみ）

タブ: 面談メモ

• 過去メモ一覧（作成者・日付）
• 新規メモ作成（リッチテキスト）
• メモは他管理者と共有される（公開範囲：自組織内管理職）
• 編集は作成者本人と OA のみ

API

• GET /admin/learners/:id — 概要
• GET /admin/learners/:id/progress — 進捗
• GET /admin/learners/:id/vocab-stats — 単語
• GET /admin/learners/:id/credibility — 一貫性（OA 有効時のみ）
• GET /admin/learners/:id/exams — 試験
• GET /admin/learners/:id/notes — 面談メモ一覧
• POST /admin/learners/:id/notes — 面談メモ作成
• PATCH /admin/notes/:noteId — 編集（作成者 または OA）
• DELETE /admin/notes/:noteId — 削除（OA のみ）

LearnerNote（追加エンティティ・data-model.md 追補対象）

カラム	型	備考
id	uuid	PK
learner_user_id	uuid	対象学習者
organization_id	uuid	テナント境界
author_user_id	uuid	作成者
body	text	本文（Markdown）
visibility	text	org_internal（既定）／personal
created_at	timestamptz
updated_at	timestamptz

data-model.md への正式追加は別 issue で。

RBAC

• TA: 担当学習者のみ、一貫性は閲覧のみ
• OA: 自組織全員、全タブ操作可
• TM: 引継ぎ済のみ、閲覧限定（編集・成績入力・メモ作成不可）
• SA: 本画面へアクセス不可（一覧の集計のみ）
• EM: 本画面へアクセス不可

アクセシビリティ

• 大量データのチャートは alt text／表形式代替
• タブはキーボード操作可能

モック（M1）

• 1 名分の詳細データをサンプル用意
• 各タブで想定表示が再現されること

未確定

• 面談メモの他テナント共有（引継ぎ時）の扱い
• 大量履歴の仮想スクロール