feat(classroom): クラス管理右上のお知らせ通知センター (#1111)

[smalruby3-editor-bot]

Summary

EPIC #1111 の実装。クラス管理画面の右上に「お知らせ」通知センター（🔔 + 未読バッジ + 一覧パネル）を追加し、Admin からお知らせを送る最小の仕組みを揃える。後続の #1110（推薦通知）/ #1106（共有促し）がこの基盤に乗る。

アーキテクチャ（設計判断）

• classroom スタックが ClassroomNotifications{suffix} テーブルを所有（PK teacherSub / SK notificationId = createdAt 接頭辞、TTL 180日）。先生の読み出しは既存の先生 ID Token 認証をそのまま利用
• admin スタックが単一の書き手: 名前規約 import + write-only grant（N2 維持・SharedAssignments と同型）。エディタ側からお知らせを偽造できない
• 宛先の teacherSub は SPA に出さない: admin は classroomId を送り、サーバー側で所有者を解決（authorSub を隠す既存原則の踏襲）
• link.kind は whitelist（現在 classroom のみ）。エディタは未知の kind を無視（前方互換）

各コミットのメッセージに、その時点の設計分岐（採用案 / 代替案 / 理由）を記録済み。分岐をやり直す場合は該当コミットに立ち戻れる。

Changes Made

• infra/smalruby-classroom: ClassroomNotifications テーブル + GET /notifications（一覧+未読数）/ POST /notifications/mark-read（ids 省略で全既読）
• infra/smalruby-admin: POST /admin/notifications（audit 付き・write-only grant）
• packages/admin: クラス詳細に「先生へのお知らせ」送信フォーム（二段階確認）
• packages/scratch-gui: タイトルバー 🔔 + 未読バッジ + 一覧パネル（開いたら全既読）+ link.kind='classroom' で該当クラスへジャンプ + 60 秒ポーリング
• docs: architecture / source-code / ui-ux（data-testid 一覧）/ admin README + スクリーンショット 2 枚
• tools/playwright-verify: verify-notification-center.mjs（API スタブ式・stg 不要）

Test Coverage

• classroom infra: handler-notifications.test.ts 8 件（全 13 スイート 227 件パス）
• admin infra: handler-notifications.test.ts 5 件（全 4 スイート 44 件パス）
• admin SPA: classrooms-view テスト +1 件（lint + 38 件パス）
• scratch-gui: teacher-notifications.test.jsx 5 件 + classroom-api 3 件（対象ファイル lint クリーン）
• headless Playwright（API スタブ）: 9/9 チェック（教師 UI）+ 7/7 チェック（admin SPA）

残タスク（マージ前後）

• stg デプロイ（ClassroomStack-stg / AdminStack-stg）— AWS SSO 再ログイン待ち。cdk synth は両スタックとも検証済み
• stg での integration 確認（npm run test:integration + verify スクリプト）

Related Issues

Refs #1111（topic branch 集約後に develop PR で Close 予定）

🤖 Generated with Claude Code

[github-actions]

🚀 Preview deployed: https://smalruby.jp/smalruby3-editor/feature/notification-center-1111/

[smalruby3-editor-bot]

敵対レビュー結果（自動レビュー + 対応済み）

diff 全体（infra 2 スタック / admin SPA / scratch-gui）を対象に、正確性・セキュリティ・.claude/rules 準拠・整合性・テスト妥当性の 5 観点で敵対的に検証した。全新規テスト実行 + tsc/eslint/prettier 確認済み。

指摘と対応（コミット 56c226c）

分類	指摘	対応
[Must]	通知タイムスタンプが ISO slice で UTC 表示（日本では 9 時間ずれ・日付も前日になりうる）	toLocaleString() に変更 ✅
[Question]	handleToggleNotifications が state updater 内で副作用（StrictMode/concurrent で二重送信の芽）	副作用を updater の外へ ✅
[FYI]	admin の link.kind whitelist 検証が dead code	putNotification 内へ移動（将来の送信経路も通る位置） ✅
[FYI]	mark-read: body が JSON 配列だと暗黙に全既読 / 巨大 id が 500	配列 body → 400、id 200 文字上限 ✅
[FYI]	classroom Lambda に通知テーブルの RW grant（PutItem 含む）	Query/UpdateItem のみに縮小（単一ライターを IAM でも担保） ✅
[FYI]	フック（interval/既読化ロジック）にユニットテストなし	use-teacher-notifications.test.js 6 件追加 ✅
[FYI]	rules のテーブル一覧ドリフト（「4 テーブル」のまま）	8 テーブルに更新 ✅

クリーンと確認された点（抜粋）

• SK（ISO 固定長 + #uuid）の newest-first 並びは正しい（固定長 prefix なので # がクロスタイムスタンプ順序に影響しない）
• 他の先生の通知の読み取り/既読化は key スキーマ上不可能。createdBy/teacherSub は投影から除外（テストで serialized body を検証）
• 新ルートはどの既存 regex にも飲み込まれない。admin ルートは prod JWT authorizer を通る
• N2（admin から classroom スタック不変更）維持、audit あり、4xx パスへのログ追加なし
• CSS オフセット変更（logout/email の移動）に位置依存の外部利用なし

判定: 指摘対応後 MERGEABLE（stg デプロイ + integration 確認は SSO 再ログイン後のフォローアップ）

[smalruby3-editor-bot]

stg デプロイ・検証完了（2026-07-25）

ClassroomStack-stg / AdminStack-stg をデプロイし、integration テスト（49 件パス・教師フロー含む）+ 実 API のスモークで 3 EPIC の通しを確認:

• epic(classroom): クラス管理の右上「お知らせ」通知センター #1111: admin 送信 → 先生 inbox（unread 1・link 付き）→ mark-read → unread 0 ✅
• feat(admin+classroom): 有益な課題を先生に「みんなの課題へ共有」促す (推奨フラグ + 先生UIバナー) #1106: 中身なし課題への推奨 400 → 課題作成後の推奨 → 先生一覧に recommendedForSharing → share_suggestion 通知 ✅
• epic(classroom): Admin による課題推薦（限定公開 → みんなの課題への発展） #1110: 合言葉限定公開 → admin 推薦 → 自分の投稿に recommended（recommendedBy 非漏出）→ shared_recommended 通知（shared-mine リンク）✅

検証データはクリーンアップ済み（取り下げ + アーカイブ、stg TTL 1 日）。