refactor(admin): クラス（学級）と課題の表現を徹底整理し、Admin にクラスの状態表示とアーカイブ解除を追加

[smalruby3-editor-bot]

背景 — 運用対応で実際に誤認が起きた

先生から「クラスを誤ってアーカイブしたので復旧してほしい」という依頼を受けて調査したところ、
Admin では「復元済み」に見えるのに、実際には先生の画面から見えないままという状態を運用者が
判別できなかった。原因は Admin における クラス（学級）と課題（1 授業）の表現の混同。

ドメインモデルは 2 階層（docs/classroom/README.md）:

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

Classrooms テーブルが「課題」を保持しているというテーブル名自体のねじれが根本にあり、
それが Admin の API 名・UI 文言・タブ名にそのまま漏れている。

現状の問題（コードで確認済み）

1. Admin の「クラス」操作が、実際には課題を操作している

• packages/admin/src/components/classrooms-view.jsx:247 — このクラスをアーカイブしますか？
• 同 :248 — このクラスを利用中に戻しますか？
• 同 :420 — このクラスを復元しますか？
• 同 :551 — 該当する削除済みクラスはありません。
• 同 :734 — タブ名 クラス検索

いずれも実際の書き込み先は infra/smalruby-admin/lambda/handler.ts の handleSetClassroomStatus
（PATCH /admin/classrooms/{classroomId}）で、CLASSROOMS_TABLE（= 課題）にしか書かない。
クラス（ClassroomGroups）の状態は一切変わらない。

2. 課題一覧・詳細に「親クラスがアーカイブ中」が出ない

mapClassroomForAdmin（infra/smalruby-admin/lambda/handler.ts:501 付近）は groupId を返すだけで、
親クラスの status を返さない。そのため:

• 課題が active なら Admin は 🟢「利用中」と表示する
• しかし親クラスが archived だと、先生の画面にはその課題は表示されない
• 運用者は「生きている＝先生に見えている」と誤読する ← 今回の誤認の直接原因

3. 誤解を強める文言がある

packages/admin/src/components/classrooms-view.jsx:376

このクラスはまだ存在しています。アーカイブからの復旧は先生自身のクラス管理画面から行えます。

「クラス」と言いつつ判定しているのは課題の生存。親クラスがアーカイブ中のケースにこの文が出ると、
運用者は「先生側で復旧できる状態にある」と読むが、案内すべき操作（クラス一覧 →
「アーカイブ済みのクラス」→「元に戻す」）とは別物になる。

4. クラス（学級）単位の検索・アーカイブ解除が Admin に無い

Admin Lambda が GROUPS_TABLE に触るのは handler.ts:906-912 の 1 箇所だけで、しかも
読み取り（TTL 失効データのスナップショット復元時に、親クラスが「完全に消えているか」の確認）。
liveGroup.Item が返る＝生きているが archived のケースは何もしない。

結果、ClassroomGroups.status を active に戻せるのは先生用 UI の
PATCH /classroom-groups/{groupId}（infra/smalruby-classroom/lambda/handler.ts:2474 付近）だけで、
Admin も運用 CLI（bin/restore-classroom.ts = TTL 失効専用）もクラスのアーカイブ解除を持たない。
先生が UI 操作に到達できない問い合わせに運用者が対応できない。

やること

A. 用語の徹底監査と統一（最優先・他の作業の前提）

1. 用語辞典を作る（docs/classroom/README.md または docs/admin/README.md に節を追加）:
   クラス（学級）= Group / groupId、課題（1 授業）= Classroom / classroomId。
   「組」「学級」「クラスルーム」などの揺れをどう扱うかも決める。
2. Admin の全文言を監査して、対象が課題なら「課題」、クラスなら「クラス」と正しく呼ぶ。
   packages/admin/src/** のユーザー可視文字列を全て洗い出して確認する（上記 5 箇所は既知だが、
   それだけで終わりにせず網羅する — .claude/rules/ の「パターンは全インスタンスを確認」に従う）。
3. 識別子・型・関数名・data-testid・API パスについても、課題を指しているのに class と
   名乗っているものを洗い出す。互換性の都合で API パス（/admin/classrooms）を変えられない場合は、
   変えない理由と対応表をコードコメント + docs に残す（勝手に破壊的変更をしない）。
4. teacher UI 側（packages/scratch-gui/src/components/classroom-modal/**）にも同種の揺れが無いか
   確認する。あれば本 EPIC の子 Issue として切り出す。

B. 課題に親クラスの状態を出す

• Admin API の課題レスポンスに親クラス情報（groupId / クラス名 / groupStatus）を含める。
• 課題一覧・詳細に「親クラスがアーカイブ中 — 先生には表示されません」という警告バッジ／
  注意文を出す。課題単体が active でも実効的に見えないことが一目で分かること。
• restore-admin-alive の文言を、課題が生きている場合と親クラスがアーカイブ中の場合で
  出し分け、後者では先生に案内すべき正確な操作手順（クラス一覧 → アーカイブ済みのクラス →
  元に戻す）を提示する。

C. Admin にクラス（学級）の検索とアーカイブ解除を追加

• Admin API に クラス（ClassroomGroups）の検索・詳細・status 更新を追加する
  （命名は A の用語辞典に従う。既存の課題向けエンドポイントと明確に区別できるパスにする）。
• Admin SPA に「クラス」タブ（または既存タブ内の明確な切り替え）を追加し、
  アーカイブ⇄利用中の切り替えと、そのクラスに属する課題の一覧を表示する。
• 権限・監査ログ（audit(...)）は既存の課題操作と同じ扱いにする。
• 破壊的操作なので確認ステップを踏む（既存の 2 段階確認パターンに合わせる）。

設計上の注意

• 単一ライターを壊さない: クラスの状態を書く経路が「先生 UI」と「Admin」の 2 つになる。
  どちらも同じ更新形（status + updatedAt）にし、restoredAt 等のスタンプ規約を揃える。
• TTL を触るときは実行時点から再設定（過去の TTL のまま書くと即再削除される。
  docs/classroom/operations.md の既存規約）。
• クラスをアーカイブ解除しても、中の課題の status は変えない（今回のケースは課題は最初から
  active。無関係な課題を勝手に復活させない）。
• 同名クラスが並ぶケースが実際に起きている（Google Classroom 連携での二重作成）。一覧では
  クラス名だけで判断できないため、年度・人数・中の課題名・作成日時を併記して区別できること。

DoD

• 用語辞典が docs にあり、クラス/課題の定義とテーブル・識別子の対応が明記されている
• packages/admin/src/** のユーザー可視文言を全数監査し、課題を「クラス」と呼ぶ箇所が 0 件
• 課題の一覧・詳細で、親クラスがアーカイブ中であることが警告として分かる
• restore-admin-alive の文言が、課題生存／親クラスアーカイブ中で正しく出し分けられている
• Admin からクラス（学級）を検索し、アーカイブ解除できる
• Admin からのクラス状態変更が監査ログに残る
• unit テスト追加（用語・親クラス状態の表示・クラス status 更新 API）
• lint / prettier がエラー 0・警告 0
• docs/admin/README.md（および必要なら docs/classroom/*）を更新
• UI に視覚的変更があるため docs/admin/screenshots/ を更新（docs/_screenshot-guidelines.md に従う）
• 今回の誤認シナリオを再現する形で確認（親クラス archived + 課題 active の状態を作り、
  Admin 上で「先生には見えていない」と判別できること）

[smalruby3-editor-bot]

🤖 autopilot 分解案（#1129 の sub-issue 候補）

粒度: ② 3 個にまとめる — A/B/C は classrooms-view.jsx と handler.ts を共有編集するので並列化できず、かつ「文言のみ」「読み取り表示の追加」「破壊的な書き込み操作の追加」でレビュー観点が明確に違うため、機能単位で 3 leaf に束ねて直列化する（最大分割の 9 leaf は共有ファイル衝突とレビュー分断でコスト過大）。

• [middle] refactor(admin): クラス（学級）と課題の用語辞典を作り、Admin の文言・識別子を全数監査して統一 — EPIC の A。docs/classroom/README.md または docs/admin/README.md に用語辞典の節（クラス=Group/groupId、課題=Classroom/classroomId、「組」「学級」「クラスルーム」の揺れの扱い）を追加。packages/admin/src/** のユーザー可視文字列を全数洗い出し、課題を指しているのに「クラス」と呼ぶ箇所（既知: classrooms-view.jsx:247,248,376,420,551,734）を修正。識別子・型・関数名・data-testid・API パスも監査し、互換性で変えない /admin/classrooms 等は変えない理由と対応表をコードコメント + docs に残す。teacher UI（packages/scratch-gui/src/components/classroom-modal/**）の揺れも確認し、あればフォローアップ Issue として切り出す。挙動は変えない（文言 + docs + testid 追従テストのみ）。

• [middle] feat(admin): 課題に親クラスの状態を表示し、アーカイブ中は「先生には表示されません」と警告する — EPIC の B。mapClassroomForAdmin（infra/smalruby-admin/lambda/handler.ts:493 付近）の課題レスポンスに親クラス情報（groupId / クラス名 / groupStatus）を含める（GROUPS_TABLE 読み取り。一覧はバッチ取得で N+1 を避ける）。課題一覧・詳細に警告バッジ／注意文を出し、課題単体が active でも実効的に不可視であることが一目で分かるようにする。restore-admin-alive の文言を「課題が生きている場合」と「親クラスがアーカイブ中の場合」で出し分け、後者では正確な案内（クラス一覧 → アーカイブ済みのクラス → 元に戻す）を提示。unit テスト（Lambda + classrooms-view）と docs/admin/screenshots/ を更新。先行 leaf の用語辞典に従う（classrooms-view.jsx / handler.ts を共有編集するため 1 番目の後）。

• [large] feat(admin): Admin にクラス（学級）の検索・詳細とアーカイブ解除を追加 — EPIC の C。Admin API に クラス（ClassroomGroups）の検索・詳細・status 更新を追加（命名は用語辞典に従い、既存の課題向けエンドポイントと明確に区別できるパス）。Admin SPA に「クラス」タブを追加し、アーカイブ⇄利用中の切り替えと、そのクラスに属する課題一覧を表示。同名クラスを区別できるよう年度・人数・中の課題名・作成日時を併記。audit(...) は既存の課題操作と同じ扱い、破壊的操作なので既存の 2 段階確認パターンに合わせる。単一ライターを壊さないよう先生 UI の PATCH /classroom-groups/{groupId} と同じ更新形（status + updatedAt + restoredAt スタンプ規約）にし、TTL を触る場合は実行時点から再設定。クラスのアーカイブ解除で中の課題の status は変えない。unit テスト・docs/admin/README.md・screenshots を更新し、誤認シナリオ（親クラス archived + 課題 active）で確認。

直列化: 上記 3 leaf は packages/admin/src/components/classrooms-view.jsx と infra/smalruby-admin/lambda/handler.ts を共有編集するため、後続 leaf の本文に依存ディレクティブ（autopilot-after: #<先行> の形）を入れてチェーン状に順序付けます（1 → 2 → 3）。用語辞典が先に決まらないと 2・3 で新しい揺れを作り込むため、順序も設計上必要です。

承認: この Issue/PR の HITL を解除（🙋 ラベルを外す or Project HITL=No）してください。
調整したい場合はコメントで指示してください。

[smalruby3-editor-bot]

🤖 autopilot: Status が In Progress / AI Status=Decomposing のまま約 36 分進行が止まっていました（run が見当たりません。daemon 再起動や run の異常終了が原因）。安全のため Blocked にしました。

人間の対応: ログ（/log?issue=1129）と worktree を確認してください。🙋 HITL を外す（またはコメントする）と autopilot が再開します（PR があれば指摘対応、無ければ再トリアージ）。再実装なら Sprint Backlog へ、続きから再開なら Review へ Status を動かしても構いません。