Appearance
情報アーキテクチャ・画面遷移
ステータス: ドラフト(2026-04-15 起案) 対象: M1 モックでカバーする画面群のサイトマップと遷移。関連: requirements.md, usecases.md, auth-rbac.md(策定予定) 注意: ロール別の表示要素は RBAC に従う。本書は画面の存在と遷移を示すもので、詳細要素は
docs/screens/*.mdで定義。
1. グローバルナビゲーション
ロールごとに表示される主ナビは異なる。未認証時は固定のランディングのみ。
| ロール | ナビ項目 |
|---|---|
| 未認証 | ランディング / ログイン |
| 学習者(LR) | ホーム / 単語 / 動画 / テスト / マイページ / 設定 |
| 講師(TA) | ダッシュボード / 学習者 / カリキュラム / テスト / メッセージ |
| 組織管理者(OA) | TA の項目 + ガバナンス(監査/同意/異議)/設定 |
| 企業採用(EM) | 候補者 / 比較 / お気に入り / 設定 |
| 送出し機関Mgr(SA) | クラス/レポート/候補者公開/設定 |
| 研修責任者(TM) | 引継ぎ受信 / 学習者(閲覧)/レポート |
| 運用(SU) | 運用ダッシュボード(匿名化済ログ) |
2. サイトマップ
2.1 学習者(LR)
/login
/app/home ... 今日のタスク
/app/vocab ... 単語セット一覧
/app/vocab/:setId ... 単語リスト・学習
/app/vocab/:setId/quiz ... クイズ実行
/app/vocab/:setId/result ... 結果
/app/video ... 動画一覧
/app/video/:videoId ... プレイヤー
/app/exam ... テスト履歴
/app/exam/:examId ... 結果詳細
/app/me ... マイページ
/app/me/progress ... JLPT進捗・学習時間
/app/me/credibility ... 自分の一貫性スコア(内訳と異議申立)
/app/me/privacy ... 同意・撤回・エクスポート
/app/settings ... 言語/通知2.2 講師(TA)・研修責任者(TM)
TM は TA のサブセット+以下のパスを利用する:
/admin/handover ... 引継ぎ受信一覧(3ヶ月研修完了学習者)
/admin/handover/:learnerId ... 引継ぎ詳細(学習履歴・補強ポイント提案)/login
/admin ... ダッシュボード
/admin/learners ... 学習者一覧・検索
/admin/learners/:id ... 学習者詳細
/admin/learners/:id/progress ... 進捗グラフ
/admin/learners/:id/vocab ... 単語習得率
/admin/learners/:id/credibility ... 一貫性ビュー(OA によって有効化時のみ)
/admin/learners/:id/exam ... テスト成績
/admin/learners/:id/notes ... 面談メモ
/admin/curriculum ... カリキュラム一覧
/admin/curriculum/:id ... 編成画面
/admin/exam ... テスト一覧・作成・採点
/admin/messages ... メッセージ送信
/admin/reports ... レポート出力2.3 組織管理者(OA)
/admin/governance/audit ... 監査ログ閲覧
/admin/governance/consent ... 同意管理
/admin/governance/appeals ... 異議申立一覧・対応
/admin/governance/roles ... ロール付与・剥奪
/admin/governance/settings ... 一貫性ビューの有効/無効、開示範囲2.4 企業採用(EM)
/login
/employer ... 候補者一覧
/employer/candidates/:id ... 候補者レポート(要約)
/employer/compare ... 候補者比較
/employer/favorites ... お気に入り
/employer/settings ... 通知・言語2.5 送出し機関マネージャー(SA)
/org ... 運営ダッシュボード
/org/classes ... クラス・期別
/org/reports ... 期別レポート
/org/disclosure ... 企業公開管理(候補者の公開可否)
/org/settings ... 組織設定2.6 共通・その他
/ ... ランディング(営業資料用のモック公開 OK)
/privacy ... プライバシーポリシー
/terms ... 利用規約
/legal/consent ... 同意履歴(自分の)
/403 ... 権限エラー
/404 ... 不存在3. 主要画面遷移(Mermaid)
3.1 学習者の一日の導線
mermaid
flowchart TD
A[/app/home 今日のタスク] -->|単語| V1[/app/vocab/:setId 単語学習]
A -->|動画| D1[/app/video/:videoId 視聴]
A -->|クイズ| V2[/app/vocab/:setId/quiz クイズ]
V1 --> V2
V2 --> V3[/app/vocab/:setId/result 結果]
D1 --> A
V3 --> A
A -->|進捗確認| M1[/app/me/progress]
M1 --> M2[/app/me/credibility 一貫性]
M2 --> M3[異議申立フォーム]3.2 講師の学習者支援導線
mermaid
flowchart TD
L[/admin ダッシュボード] --> List[/admin/learners 一覧]
List --> Detail[/admin/learners/:id 詳細]
Detail --> P[進捗]
Detail --> V[単語習得]
Detail --> C[一貫性ビュー OA有効時]
Detail --> E[試験]
Detail --> N[面談メモ]
C -.異議対応は OA に委譲.-> OA[/admin/governance/appeals]3.3 企業採用の候補者確認導線
mermaid
flowchart TD
EL[/employer 候補者一覧] --> R[/employer/candidates/:id レポート要約]
EL --> Cmp[/employer/compare 比較]
R --> PDF[PDFエクスポート]
R --> Fav[お気に入り登録]
R -.生ログ・個別回答は.-> X[非表示]3.4 同意・撤回フロー
mermaid
flowchart TD
S[初回ログイン] --> C0[同意取得画面 UC-N-01]
C0 -->|同意| H[/app/home]
C0 -->|不同意| LG[ログアウト・利用制限説明]
H --> PR[/app/me/privacy]
PR -->|撤回申請| OA_C[/admin/governance/consent]
OA_C -->|確認・実行| D[削除/匿名化・通知]4. ナビゲーション原則
- ロール切替禁止:同一セッションでロールを切り替える機能は提供しない。権限昇格は OA による承認フロー経由
- パンくずを常に表示:学習者画面はシンプルに、管理者画面はパンくず必須
- 権限外遷移:URL 直打ちで権限外ページに行った場合は
/403にリダイレクト - 多言語切替:全画面ヘッダーから日本語/ベトナム語切替可能
- モバイル優先:学習者画面はモバイルファースト、管理者画面は PC を優先
5. 未確定事項
- 送出し機関(SA)と研修責任者(TM)のナビ重複整理
- 候補者公開/非公開のトグル設計(SA 側か学習者側か)
- モバイル対応範囲(学習者のみ or 管理者の一部まで)
6. 改訂履歴
- 2026-04-15: 初版ドラフト作成