メンテナンスモード(運営向け)

このページは KadaiLog の運営(弊社の運営メンバー)向けです。サーバーの移行や大きな更新などで、サービス全体を一時的に止めるときの手順と、そのあいだにお客様から見える表示をまとめています。お客様の管理者がスペースを止める機能ではありません。

メンテナンスモードでできること

運営メンバーがスイッチ 1 つで ON/OFF を切り替えます。切り替えた瞬間に、開いているすべての画面が切り替わります(再読み込みは不要です)。
ON のあいだは、運営メンバー以外の全員に「メンテナンス中」の画面だけが出ます(ログイン前の画面も同じです)。課題の登録などの書き込みは受け付けず、API と MCP は 503 を返します。
運営メンバーはそのまま KadaiLog を操作できます。画面上部に「メンテナンスモード ON」の赤い帯が出続けます。
予定を前もって知らせる帯(事前のお知らせ)を、日時と文面を決めて出せます。

運営メンバー(運営の許可リストに入っているアカウント)でログインしてください。

サイドバー下部の「メンテナンス」を開きます(運営メンバーにだけ表示されます)。
「文面と予定」で、「メンテナンス中の文面」と「開始予定」「終了予定」を入力し、「保存」を押します。終了予定は「メンテナンス中」の画面に出るほか、API の再試行の目安(Retry-After)にも使われます。
「いまの状態」の「ON にする」を押し、確認ダイアログで「ON にする」を押します。

ON のあいだ、運営メンバーの画面上部には「メンテナンスモード ON」の赤い帯が出ます。帯の「設定」からこの画面に戻れます。

ログアウトしていると、運営メンバーにも「メンテナンス中」の画面が出ます。画面下の「運営メンバーのログイン」からログインすると中に入れます。運営メンバー以外のアカウントでログインしても「メンテナンス中」のままです。

「メンテナンス」の「文面と予定」で、「開始予定」「終了予定」を入力します。
「お知らせを出し始める日時」を入力します(例: 開始予定の 3 日前)。
「お知らせの文面」は空のままでもかまいません。空なら予定から「2026/10/25 01:00〜2026/10/25 03:00 にメンテナンスを予定しています。この間はご利用いただけません。」のような文面になります。画面下の「利用者に見える文面」で確かめられます。
「保存」を押します。

「お知らせを出し始める日時」から開始予定までのあいだ、すべての利用者の画面上部に黄色の帯が出ます。利用者が「閉じる」で閉じると、そのタブでは出し直しません(タブを開き直すとまた出ます)。文面や日時を変えて保存すると、閉じた人にもまた出ます。

画面: ログインの前後を問わず、全画面の「メンテナンス中」が出ます。運営が設定した文面と終了予定、「再読み込み」ボタンがあります。メンテナンスが終わると、自動で元の画面に戻ります。規約・プライバシーポリシーのページは読めます。
書き込み: 課題の登録・コメント・設定の変更などは受け付けません(画面が切り替わるので、通常は操作できる状態になりません)。
API と MCP: /api/v1 のすべてのエンドポイントが、読み取りも含めて 503 を返します。本文は {"error":{"code":"maintenance","message":"…"}} で、Retry-After ヘッダーに終了予定までの秒数(予定が無ければ 300)が入ります。MCP サーバーからは「KadaiLog はメンテナンス中のため、API を利用できません。…約 N 分後に再試行してください。」のように返るので、AI エージェントは終了を待って再試行します。
メール・Webhook: 朝のダイジェストや通知メール、Webhook の配信はメンテナンス中も動きます。止めたいときは別途対応が必要です。
お問い合わせ: ログイン前のお問い合わせフォームも受け付けません。メンテナンス中の文面に、緊急の連絡先を入れておくことをおすすめします。

死活監視の確認口(/health)は、メンテナンス中も 200 のままです。本文が {"ok":true,"maintenance":true} になるので、監視の誤検知にはなりません。