メンテナンス告知 企画 v0.1
依頼: Discord thread 1572739448679043205(ああああ、2026-11-19)。メンテナンスモード中に「○○時間の予定です」「○○時にはオープン予定です」などを自由に書いて、生徒に知らせたい。
状態: 提案。決定済みの項目はまだありません。
1. 今のdevでできること・できないこと
origin/dev 6170200f4 のコードで確かめた内容です。
できること:
- 全体メンテナンスには「通常」「閲覧のみ」「全体停止」の3つがあります(
apps/admin/src/MaintenanceControls.tsx)。 - 閲覧のみ・全体停止に切り替えるとき、GMは「利用者向けタイトル(80字)」と「利用者向け説明(500字)」を自由に書けます。
- 学生D1の
service_maintenance_stateには、終了予定時刻を入れるexpected_end欄がすでにあります(apps/student/migrations/0098_service_maintenance.sql)。API(GET /api/service/status)もexpectedEndを返しています。 - 学生画面は60秒ごとと画面に戻ったときに状態を読み直し、画面上部に帯を出します(
apps/student/src/features/service-maintenance/service-maintenance-notice.tsx)。
できないこと(今回の穴):
- 終了予定時刻を入力できない。 GM画面は
expectedEnd: nullを固定で送っているため、生徒には必ず「終了時刻は未定です」と表示されます。本文に「15時ごろ再開予定」と書いても、その下に「未定」と出て矛盾します。 - メンテナンス中に文面を直せない。 切り替えボタンは「今の状態と違う状態」を選んだときしか押せません。延長や再開時刻の変更を伝えるには、いったん通常に戻すしかありません。
- 全体停止中の生徒画面が分かりにくい。 小さな帯の下で、各ページがAPIの503を受けて読み込み失敗の表示になります。ログイン画面でもログインが失敗するだけで、理由が伝わりません。
- 変更の記録は監査ログにありますが、GM画面からは見られません。
2. 作るもの
2-1. GM「メンテナンス・障害」画面(モック: gm.html)
- 今の状態をカードで出します。止めている間は「開始時刻・経過時間」「再開予定(あと何分)」「生徒に出している告知」を一目で見られるようにします。
- 「メンテナンスを始める」「閲覧のみにする」で入力画面を開きます。入力画面には次の欄を置きます。
- 止め方(全体停止/閲覧のみ)。
- 再開予定。「30分後・1時間後・2時間後・3時間後・6時間後・未定」のボタンと、日時の直接指定(JST・5分刻み)を用意します。
- ひな形(定期メンテナンス・緊急メンテナンス・データ移行)。選ぶとタイトルと本文が置き換わります。
- タイトル(80字)と本文(500字)。本文は自由に書けます。「再開予定の一文を入れる」ボタンで「メンテナンスは約2時間の予定です。11/19(木)15:00ごろには再開する予定です。」を差し込めます。
- 操作メモ(任意。生徒には出ません)。
- 右側に「学生に見える画面」をPCとスマホで並べ、入力に合わせてその場で更新します。
- 止めている間は次の操作をできるようにします。
- 「告知を編集」: 状態はそのままで、タイトル・本文・再開予定だけを直します。
- 「再開予定を延ばす +30分/+1時間」: 再開予定を延ばし、本文中の「○時ごろ」も合わせて書き換えます。
- 「メンテナンスを終える」。
- 再開予定を過ぎると、GMのカードに「予定を過ぎています。延長するか、告知を直してください」と出します。自動で解除はしません(今の方針どおり)。
- 下に「変更の記録」(日時・操作・タイトル・再開予定・操作した人)を出します。
- 確認ダイアログは今の
ConfirmDialogの形のままにします。「始める」は赤、「終える」「表示を更新する」は緑にします。
2-2. 生徒アプリ(モック: maintenance.html / home.html)
- 全体停止(テスター以外): どのページを開いても専用の画面にします。中身は、まるのイラスト、「ただいまメンテナンス中です」、GMが書いたタイトル、再開予定(大きく表示し「あと約2時間」を添える)、GMが書いた本文、「これまでの記録はそのまま残っています」、「いまの状態を確認する」ボタンです。
- 1分ごとの自動確認は今の仕組みをそのまま使い、終わったら「メンテナンスが終わりました → ホームへ」に切り替えます。
- 再開予定が未定なら「決まりしだいお知らせします」と出します。
- 再開予定を過ぎたら「予定より時間がかかっています。もうしばらくお待ちください」に自動で切り替えます。GMが直す前に、過去の時刻が「予定」として出続けないようにするためです。
- 閲覧のみ: 画面上部に1行の帯「いまは見るだけ使えます/15:00ごろ再開予定(あと約2時間)」を出し、「詳しく」で本文を開きます。保存や送信のボタンを押したら「メンテナンス中のため、いまは保存・送信できません」と出します。
- 全体停止中のテスター: 今の青い帯を1行にし、再開予定を添えます。
- 時刻はすべて日本時間で「11/19(木)15:00ごろ」の形にします。
2-3. 作る範囲
| 項目 | 画面 | サーバー | DB |
|---|---|---|---|
| GMで再開予定を入れる | GM | なし(APIは expectedEnd を受け取れる) |
なし(expected_end 欄あり) |
| メンテ中に告知を直す・延長する | GM | 同じ状態のままの更新を通す確認とテスト。DBトリガーは同じmodeの追記を拒んでいない | なし |
| 再開予定に過去の時刻を入れさせない | GM | contracts で未来の時刻か確かめる | なし |
| 変更の記録を見る | GM | 学生D1の service_maintenance_events を読むAPIを追加 |
なし |
| 全体停止の専用画面 | 学生 | なし(/api/service/status は全体停止中も開いている) |
なし |
| 閲覧のみ・テスターの1行帯 | 学生 | なし | なし |
DBの変更は要りません。migrationも要りません。
3. 決めてほしいこと(すべて提案)
- 全体停止中の生徒画面を、帯ではなく専用の画面にしてよいですか?
- a(おすすめ): 専用の画面にする。どのページでも同じ画面になり、読み込み失敗も出ません。
- b: 今の帯のまま、再開予定だけ足す。
- 再開予定を過ぎたときの生徒向け表示は?
- a(おすすめ): 自動で「予定より時間がかかっています」に切り替える。GMが延長するまでの間、誤った予定を出さずにすみます。
- b: GMが直すまで、そのまま予定時刻を出す。
- メンテナンスの予約(指定時刻に自動で始める)や事前のお知らせは?
- a(おすすめ): 今回は入れない。事前告知は今ある「コンテンツ・お知らせ」で出せます。自動開始は止める操作が無人で起きるので、別に検討します。
- b: 今回いっしょに作る。
- ひな形の文面(定期メンテナンス・緊急メンテナンス・データ移行の3つ)はモックの文で進めてよいですか?
4. 受入条件(案)
- GMで再開予定を「2時間後」にして全体停止にすると、生徒の全ページが専用画面になり、タイトル・本文・再開予定が日本時間で出る。
- メンテ中に「+30分」を押すと、生徒画面の再開予定が1分以内に変わり、GMの変更の記録に1行増える。
- 再開予定を過ぎると、生徒画面が「予定より時間がかかっています」に切り替わる。
- 未定を選ぶと、生徒画面に「決まりしだいお知らせします」と出る。
- 通常に戻すと、専用画面が1分以内に「メンテナンスが終わりました」に変わる。
- 閲覧のみでは、全ページの上に1行の帯が出て、保存・送信を押すと案内が出る。
- PC(1440×900)とスマホ(390×844)の両方で、本文がはみ出さない。
5. モックについて
- 生徒画面はdevの実画面(ホーム・ログイン)のCSSとフォントを取り込んで作りました。GM画面はgm-devの実画面の枠を取り込んでいます。
- 名前・時刻・記録は見本です。モックの操作はこのブラウザの中だけで保存され、devには何も送りません。
- GM画面で切り替えた状態は、同じブラウザで開いた生徒画面に反映されます。