# メンテナンス告知 企画 v0.1

依頼: Discord thread 1572739448679043205（ああああ、2026-11-19）。メンテナンスモード中に「○○時間の予定です」「○○時にはオープン予定です」などを自由に書いて、生徒に知らせたい。

状態: 4問すべて決定済み（ああああ、Discord message 1572746973034061874、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`）。

できないこと（今回の穴）:

1. **終了予定時刻を入力できない。** GM画面は `expectedEnd: null` を固定で送っているため、生徒には必ず「終了時刻は未定です」と表示されます。本文に「15時ごろ再開予定」と書いても、その下に「未定」と出て矛盾します。
2. **メンテナンス中に文面を直せない。** 切り替えボタンは「今の状態と違う状態」を選んだときしか押せません。延長や再開時刻の変更を伝えるには、いったん通常に戻すしかありません。
3. **全体停止中の生徒画面が分かりにくい。** 小さな帯の下で、各ページがAPIの503を受けて読み込み失敗の表示になります。ログイン画面でもログインが失敗するだけで、理由が伝わりません。
4. 変更の記録は監査ログにありますが、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. 決定事項

決定: ああああ（Discord message 1572746973034061874、2026-11-19）。

1. 全体停止中（テスター以外）の生徒画面は、帯ではなく専用の画面にする。
2. 再開予定を過ぎたら、生徒画面は自動で「予定より時間がかかっています。もうしばらくお待ちください」に切り替える。
3. 予約開始（指定時刻に自動でメンテナンスに入る）は今回入れない。事前告知は既存の「コンテンツ・お知らせ」で出す。
4. ひな形3つ（定期メンテナンス・緊急メンテナンス・データ移行）の文面はモックの文で進める。

## 4. 受入条件

- GMで再開予定を「2時間後」にして全体停止にすると、生徒の全ページが専用画面になり、タイトル・本文・再開予定が日本時間で出る。
- メンテ中に「+30分」を押すと、生徒画面の再開予定が1分以内に変わり、GMの変更の記録に1行増える。
- 再開予定を過ぎると、生徒画面が「予定より時間がかかっています」に切り替わる。
- 未定を選ぶと、生徒画面に「決まりしだいお知らせします」と出る。
- 通常に戻すと、専用画面が1分以内に「メンテナンスが終わりました」に変わる。
- 閲覧のみでは、全ページの上に1行の帯が出て、保存・送信を押すと案内が出る。
- PC（1440×900）とスマホ（390×844）の両方で、本文がはみ出さない。

## 5. モックについて

- 生徒画面はdevの実画面（ホーム・ログイン）のCSSとフォントを取り込んで作りました。GM画面はgm-devの実画面の枠を取り込んでいます。
- 名前・時刻・記録は見本です。モックの操作はこのブラウザの中だけで保存され、devには何も送りません。
- GM画面で切り替えた状態は、同じブラウザで開いた生徒画面に反映されます。
