docs: Alexa TTS文書を30番に一本化しアーカイブ索引を追加

docs/30_マスタードキュメント_Alexa_TTS_API編.md

@@ -1,6 +1,6 @@
 # マスタードキュメント - Alexa TTS API 編
 
-> **最終更新**: 2026-03-03
+> **最終更新**: 2026-03-04
 > **対象システム**: windmill.keinafarm.net（ワークスペース: admins）
 > **目的**: このドキュメントだけで Alexa TTS API の全容を把握し、作業を継続できること
 
@@ -44,10 +44,11 @@ Windmill ワークフロー
 
 ### 現在の状態
 
-**✅ 完全動作中（2026-03-03 解決済み）**
+**✅ 完全動作中（2026-03-04 時点）**
 
 - ローカルPCからもサーバーのDockerコンテナからも、日本語テキストの読み上げが動作する
 - 解決の鍵: `sequenceJson` 内の日本語文字を `\uXXXX` 形式にエスケープして送信する
+- 補足: `u/admin/alexa_speak` を API 更新した直後、Windmill UI の入力欄が即時更新されない場合がある（後述の運用回避策を適用）
 
 ---
 
@@ -506,6 +507,22 @@ curl -X POST \
   "https://windmill.keinafarm.net/api/w/admins/jobs/run_wait_result/p/u/admin/alexa_speak"
 ```
 
+### API反映後にUI入力欄が変わらない場合（2026-03-04 追記）
+
+`u/admin/alexa_speak` を `create-script` で更新後、API上の `schema` は更新済みでも、Input フォームが旧表示のまま残ることがある。
+
+対応手順:
+
+1. APIで最新状態を確認する
+2. `hash` 更新と `schema.properties.device` の以下2項目を確認する
+   - `format = "dynselect-device"`
+   - `originalType = "DynSelect_device"`
+3. Windmill UI を `Ctrl + Shift + R` でハードリロードする
+4. 反映されない場合は `Edit -> Deploy` を1回実行する
+5. Input フォームで `Device` がドロップダウン表示になったことを確認する
+
+実運用上は「API反映成功」と「UIフォーム反映成功」を別チェックとして扱う。
+
 ---
 
 ## 11. 既知の問題・落とし穴
@@ -546,9 +563,11 @@ curl -X POST \
 
 | ファイル | 説明 |
 |---------|------|
-| `docs/alexa-api/10_Alexa TTS API 実装記録 (2026-03-02).md` | Claude Code による実装記録（Triliumからコピー） |
-| `docs/alexa-api/11_色々やってダメだった.txt` | ChatGPT との試行錯誤チャットログ |
-| `docs/alexa-api/12_ローカルで試したこと.md` | 日本語TTS問題の調査記録（解決過程） |
+| `docs/archive/alexa-tts/10_Alexa TTS API 実装記録 (2026-03-02).md` | Claude Code による実装記録（アーカイブ） |
+| `docs/archive/alexa-tts/11_色々やってダメだった.txt` | ChatGPT との試行錯誤チャットログ（アーカイブ） |
+| `docs/archive/alexa-tts/12_ローカルで試したこと.md` | 日本語TTS問題の調査記録（アーカイブ） |
+| `docs/archive/alexa-tts/21_引き継ぎ_alexa_speak_API反映後にUIドロップダウンが変わらない件.md` | API反映後のUI未反映事象の切り分けと回避策（アーカイブ） |
+| `docs/archive/alexa-tts/README.md` | Alexa TTS 関連の中間資料アーカイブ索引 |
 | `docs/30_マスタードキュメント_Alexa_TTS_API編.md` | 本ドキュメント |
 
 ---
@@ -602,3 +621,4 @@ var rawSequenceJson = JSON.stringify(sequenceObj).replace(
 | 2026-03-03 | `\uXXXX` エスケープで日本語TTS完全解決。server.js・test_tts.js に反映 |
 | 2026-03-03 | 本マスタードキュメント作成 |
 | 2026-03-03 | findDevice 検索ロジック、キャッシュ仕様、起動初期化、auth4.js 詳細、Dockerfile 仕様を追記 |
+| 2026-03-04 | `u/admin/alexa_speak` の API 反映後にUIドロップダウンが即時反映されない事象と標準対応（`Edit -> Deploy`）を統合。中間資料のアーカイブ索引を追加 |