Skip to content

refactor(gui): teacher/student UI に残る「クラス」と「課題」の揺れを整理する #1135

Description

@smalruby3-editor-bot

EPIC #1129 の A(#1131)で Admin の用語を統一した際、その 4 番目のタスクとして teacher / student UI
packages/scratch-gui/src/components/classroom-modal/** と ja / ja-Hira ロケール)も監査した。
Admin ほど深刻ではないが、課題(1授業 = Classrooms)を「クラス」と呼んでいる文言が残っている。

用語の正(辞典は docs/admin/README.md の「用語辞典(クラス / 課題)」):

概念 日本語 テーブル 主キー
Group クラス(学級) ClassroomGroups groupId
Classroom 課題(1 授業) Classrooms classroomId

見つかった揺れ(packages/scratch-gui/src/locales/ja.js / ja-Hira.js

メッセージ ID 現在の文言 指しているもの 所見
gui.classroom.error.classroomInactive 「このクラスは現在利用できません。」 課題Classrooms.status !== 'active' 明確な誤り。「この課題は…」が正
gui.classroom.studentStatus.title 「参加しているクラス」 参加中の課題(下の行で「課題」も別途表示している) 生徒には「クラス」の方が通りが良い可能性があり、要検討
gui.classroom.studentStatus.class 「クラス」 className(= 課題に写されたクラス(学級)名) 表示値としては妥当だが、上の title と合わせて整理したい
gui.classroom.kicked.banner.title 「先生によってクラスから退室させられました。」 課題(membership は classroomId 単位) 生徒向けの分かりやすさとの兼ね合いを検討

gui.classroom.googleCourses.*(Google Classroom のコース)や gui.classroom.classList.* /
gui.classroom.groups.*(= 学級)は正しく「クラス」を使っているので対象外。

やること

  1. 上記 4 件について「厳密さ」と「生徒の分かりやすさ」のどちらを取るかを決める
    (生徒向け画面は課題 = 参加コードの単位なので、機械的な置換ではなく UX 判断が要る)。
  2. 決めた方針を用語辞典(docs/admin/README.md)に「生徒向け UI での例外」として追記する。
  3. ja / ja-Hira の両方を更新し、文言に依存する integration テストを追随させる。
  4. UI に視覚的変更があれば docs/classroom/screenshots/ を更新する。

スコープ外

Part of #1129

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions