Add data update methods and automation details to the system guide

docs/システムガイド.md

@@ -524,7 +524,61 @@ BM25F、単語ベクトル、同義語など各種手法を組み合わせて検
 
 **状況：** MySQLの企画データが更新された
 
+本システムでは、データ更新を以下の3つの方法で実現できます。
+
+#### 方法1: 自動更新（推奨）
+
+毎日午後3時（JST）に自動でデータを更新します。設定は不要です。
+
+**流れ：**
+```
+毎日 18:00 UTC (3:00 JST)
+     ↓
+GitHub Actions が自動実行
+     ↓
+/tasks/update エンドポイントを呼び出し
+     ↓
+スクリプト build_all.py が実行
+     ↓
+新しい企画データで検索エンジンが更新
+```
+
+**設定ファイル：** `.github/workflows/update_data.yaml`
+
+**カスタマイズ方法：** 更新時刻を変更したい場合は、`.github/workflows/update_data.yaml` の `cron` 行を編集します。
+
+例：毎日午前10時に変更
+```yaml
+on:
+  schedule:
+    - cron: '0 1 * * *' # 毎日1時（JST）に実行
+```
+
+#### 方法2: 手動トリガー
+
+GitHub Actions の UI から手動でデータ更新をトリガーできます。
+
 **手順：**
+1. GitHub リポジトリの「Actions」タブを開く
+2. 左側で「update data」ワークフローを選択
+3. 「Run workflow」ボタンをクリック
+4. 約5-10分でデータが更新される
+
+#### 方法3: APIエンドポイント経由
+
+以下のコマンドでデータ更新をリクエストできます：
+
+```bash
+curl -X POST \
+  -H "X-API-KEY: YOUR_SECRET_KEY" \
+  https://your-fastapi-url/tasks/update
+```
+
+このエンドポイントは `app/main.py` で定義されており、直接検索用アセットを再生成します。
+
+**実行に要する時間：** 5-10分
+
+**詳細な流れ：**
 ```
 1. MySQLのデータを確認
    ↓
@@ -538,7 +592,7 @@ BM25F、単語ベクトル、同義語など各種手法を組み合わせて検
    ├─ Step 6: 単語ベクトルを抽出
    └─ Step 7: 団体名インデックスを生成
    ↓
-3. サーバーを再起動
+3. サーバーを再起動（必要に応じて）
    ↓
 4. フロントエンドで新しい企画データが見える
 ```
@@ -829,6 +883,23 @@ python scripts/build_all.py
 python -m uvicorn app.main:app --reload --port 7860
 ```
 
+**注記：** ステップ5（データ生成）は手動で実行する必要があります。本番環境ではこのステップが `.github/workflows/update_data.yaml` により自動実行されます。
+
+**ローカル開発中のデータ更新の流れ：**
+
+通常の開発では、MySQLのデータが更新されたことをシミュレートして検索エンジンをテストしたい場合があります。その際は：
+
+```bash
+# 方法1: 手動でスクリプト実行
+python scripts/build_all.py
+
+# 方法2: サーバー起動後、APIエンドポイント経由（本番と同じ）
+curl -X POST -H "X-API-KEY: test_key" \
+     "http://localhost:7860/tasks/update"
+```
+
+本番環境では GitHub Actions により毎日自動的にこの処理が実行されるため、セクション6.2の「企画データの更新フロー」を参照してください。
+
 ### 8.2 Docker でのデプロイ
 
 ```bash