障害報告書：shift-scheduler-ai プレビューデプロイ失敗

作成日: 2026-07-02　/　作成者: shift M層

要約
シフト管理アプリのPR用プレビュー画面（社内確認用）が作成できない状態になっています。
お客様への影響はゼロです。本番サイト・LINE入力画面・管理画面はすべて通常どおり稼働しています。原因はVercel側の設定ミスで特定済み、対応方針が固まっています。実施タイミングのご判断をお願いします。

1. 事象概要

PRを作るたびに自動で立ち上がるはずの「プレビュー画面」（社内で見た目を事前確認するための一時URL）が、 Missing script: build というエラーで作成に失敗しています。
影響ユーザー: なし（本番は稼働中。喪失したのは社内のプレビュー確認手段のみ）

2. タイムライン

日時 (JST)	出来事
2026-05-23 07:09	GitHub Actions での本番デプロイが `VERCEL_TOKEN 無効` エラーで一度失敗
2026-05-23 18:07	同日、本番デプロイ成功（デプロイID: `otzjjwe68` / `dpl_DBWQTztKF4kpqA7Abz8kpjr31Beq`）
2026-05-24 〜 2026-07-01	main への変更 push なし。本番は 5/23 版で稼働継続
2026-07-01	新規PRのプレビューデプロイが `Missing script: build` で失敗
2026-07-02 09:45	調査で原因特定（Vercel の Root Directory 設定が `.` のまま、正しくは `frontend`）
2026-07-02	本報告書の作成・対応方針決定

3. 影響範囲

対象	状態	備考
本番サイト（稼働）	影響なし	5/23版が継続稼働中
管理画面	影響なし	`shift-scheduler-ai-sepia.vercel.app`（Basic Auth 継続動作）
LINE内シフト希望入力画面	影響なし	`shift-scheduler-ai-liff.vercel.app`（5/17版継続稼働）
Railway backend（API・リマインダー配信）	影響なし	通常稼働
社内のプレビュー確認手段	喪失	PRごとのプレビューURLが失敗する状態

4. 原因

直接原因：Vercelプロジェクト shift-scheduler-ai の「Root Directory（ビルドを開始する起点フォルダ）」設定が .（＝リポジトリのルート）になっています。

実際にフロントエンドのコードは frontend/ というサブフォルダに置いています。ルートには build スクリプトが定義されておらず、Vercelはそこでビルドを始めようとして失敗します。

なぜ本番は成功していたのか

プレビュー経路: VercelのGit連携が自動起動 → ルートを掴んで npm run build → 失敗
本番経路: GitHub Actions の deploy.yml が cd frontend && vercel deploy --prod と明示的にサブフォルダから起動 → 成功
この経路の違いにより、「プレビュー失敗」と「本番成功」が両立していました。

5. 潜在リスク（このまま放置した場合）

次に main への変更を反映するとき、GitHub Actions 経由の本番デプロイが再び成功するかは要検証（前回 VERCEL_TOKEN が一時的に無効化された経緯があります）。
プレビューが使えないため、変更内容の見た目を事前確認できないまま本番反映することになるリスク。
Vercel Git連携は動く設定のまま毎回失敗し続けるため、アラート・通知が慢性的に鳴り続け、感度が鈍る（重要な障害を見落とす）リスク。

6. 対応方針

Vercel REST API 経由で Root Directory を frontend に変更する。
実施は W層（researcher または coder）が自動化スクリプトで実施。CEOのブラウザ操作はゼロ。
実施〜検証完了までの 30分〜1時間、main への push を凍結。
詳細手順書は別紙 DESIGN_vercel_root_dir_shift_scheduler.html を参照。
※ 実施承認後、正式な公開URLに差し替えます。
本番影響ゼロを絶対条件とし、ロールバック手順も準備済み。

7. 実施承認事項

実施タイミングをご判断ください

案	内容	特徴
A（推奨）	いま実施	プレビュー復旧を最短で完了。本番影響なし。
B	別時間帯を予約	CEOが立ち会える時間帯に合わせて実施可能。
C	Issue #67 のPRマージ後に実施	現行案件との切り分けを優先する場合の選択肢。

8. 再発防止

Vercelプロジェクト設定の定期監査：プレビュー成功率をモニタリングする仕組みを導入。
IaC化の検討：Vercel設定を vercel.json + GitHub workflow で管理し、Dashboardの手動設定と乖離しないようにする。
デプロイ経路の整理：GitHub Actions と Vercel Git 連携の並列運用方針を別途整理（Issue化推奨）。

9. 参考リンク

詳細手順書：DESIGN_vercel_root_dir_shift_scheduler.html （実施承認後、公開URLに差し替え予定）
Issue #67（バッチ実装案件、本対応とは独立）