← 運用資料ポータル（目次）へ戻る
大前提：APIキー・パスワード等の実値は本書に記載しません。シークレットは .dev.vars（Drive外・gitignore）＋ wrangler pages secret put で管理。Google Drive上のフォルダではビルド不可（node_modules実体が展開されない）→ アプリのビルドは必ずDrive外（例 C:\takken-boost-beta）で行う。
1. デプロイ先 早見表
| 対象 | Pagesプロジェクト | 本番ブランチ | 公開URL |
|---|
| LP（個人/法人/法務/ガイド） | takken-boost-lp | main相当 | https://takken-boost.jp/ |
| アプリ本体 | takken-boost-beta | master | https://app.takken-boost.jp/ |
2. LP の更新・デプロイ手順
- Drive の
takken-boost-lp/ で対象HTML（shokuno.html＝/、shokuno-biz.html＝/biz/、法務、guide等）を編集。
- NG表現・JSON-LD構文をローカル確認（
nodeでJSON.parse、grepでNG=0）。
- デプロイ：
bash deploy-lp.sh（C:/takken-build にステージング→wrangler pages deploy）。
- 本番確認：
curl -s -o /dev/null -w '%{http_code}' https://takken-boost.jp/ 等で200、構造化データ・文言反映を確認。
※ 新規ページを足したら deploy-lp.sh のcp一覧と sitemap.xml にも追加する。
3. アプリの更新・デプロイ手順
- Drive外のクローン（例
C:\takken-boost-beta）で src/ を編集。
npm run build（または既定のビルド）で dist を生成。- デプロイ：
npx wrangler pages deploy dist --project-name takken-boost-beta --branch master --commit-dirty=true。
- 本番確認：主要ページ200、
/api/ai/status が401（認証ゲート）であること等を確認。
4. 障害対応（症状→対処）
| 症状 | 対処 |
|---|
| AIが定型文（フォールバック）のみ | /admin/ai⑤とログのエラーコード確認。429（枠超過）→キー追加/翌日回復。http_404/モデル廃止→GEMINI_MODEL等を有効モデルへ。AI Studioでキー有効性確認。 |
| wrangler が 400 / Not logged in を繰り返す | wrangler logout → wrangler whoami で再認証して回復。 |
| メール送信失敗 | Brevo（My Agent Works）の送信ログ・1日上限（約300通）・DKIM/DMARC有効性を確認。 |
| 受信メールが転送されない | Cloudflare Email Routing の有効化・info@/support@ルール・転送先Gmailのverifyを確認。 |
| デプロイしたのに本番未反映 | 正しいプロジェクト/ブランチか（LP=takken-boost-lp、アプリ=takken-boost-beta/master）。CDNキャッシュ（robots/sitemapは最大4h）も考慮。 |
| ビルドできない | Drive上では不可。Drive外のクローンでビルドする。 |
| robots/AIクローラ設定が戻る | Cloudflareダッシュボードの「robots.txt管理／AIボットブロック」がONだと自前robots.txtを上書きする。両方OFFを維持。 |
5. 定期運用
| 頻度 | 作業 |
|---|
| 日次 | /admin/ai⑤でAI非成功率を確認。問い合わせ（info@/support@→運営Gmail）に対応。 |
| 週次 | AIの問い合わせ傾向をFAQへ反映。公開文面はNG表現チェックを通す。 |
| 月次 | GA4・AI利用状況・SearchConsoleのKPIをまとめ、無料枠余裕と改善点を職能研様へ共有。 |
6. 連絡・体制