ARCH-2-followup-l Places live smoke 兩輪實測：field mask 前綴真實 bug 修復＋五項【低信心】映射驗證收口（990 測試綠）¶

背景¶

ADR-010 落地時因本機無 API key，Places API 欄位映射五項標【低信心】【未 live 驗證】（ARCH-2-followup-l，P1）。業主 2026-08-01~02 提供 key（沿用 booking_helper 既有 key，D-4/Q3 既決）並開通 Places API (New)。本批執行規格明文的節制 live smoke（≤15 次呼叫一次性）。

兩輪實測（engineering-fieldtest，不驅動任何 升級）¶

第一輪（2026-08-01）：Geocoding 成功（key 有效，台北 101 座標準確 70m 內）；Nearby Search 403 SERVICE_DISABLED（Places API (New) 未開通）——依紀律 2 次呼叫即停、零重試，回報業主開通連結。

第二輪（2026-08-02，開通後）：5/5 驗證目標通過、7 次呼叫（Geocoding 1＋Nearby 1＋Details 5），90 秒重試分支未觸發。

發現並修復真實 bug（live smoke 的存在意義實證）¶

Place Details 首呼 400 INVALID_ARGUMENT——Google 兩種端點的 field mask 前綴慣例不同：Search（清單型回應）須帶 places. 前綴、Details（單筆型）須裸欄位名，舊常量誤沿用前綴。修復：欄位裸名單一來源＋按端點動態加前綴，六條機械檢查點同步 strip 前綴比對；adapter/呼叫端零改動；+3 迴歸測試鎖定。此正是 ADR-010 已知弱點 3 預告「首次 live 可能暴露映射錯誤」的兌現。

architect 收口裁定（ADR-010 修訂記錄 2026-08-02）¶

• 已 live 驗證五項（含證據強度最高的「API 自身接受/拒絕」雙向確立）：field mask 兩端點慣例、regularOpeningHours 結構/day 編碼 0=Sunday（跨夜樣本與 weekdayDescriptions 逐字吻合）、跨夜 close.day 遞增慣例、businessStatus 欄位名＋OPERATIONAL 值形態、includedTypes/maxResultCount 行為＋Enterprise 欄位「省略鍵非 null」。
• 樣本限制維持【低信心】兩項：24hr 表示（5 筆皆非全天候）、CLOSED_TEMPORARILY/PERMANENTLY 字串形態（5 筆皆營業中）——列條件觸發：自然使用中遇樣本即順帶驗證。
• tier 紀律：IN-ACCOUNT engineering-fieldtest，依接地上限條款兩子面向成熟度維持 不變，只更新「已驗證 vs 未驗證」誠實區分。

安全紀律¶

• .gitignore 補 .env（原缺——key 落地前先堵「git add -A 掃進版控」的 C-5 風險）；key 全程零明文（人工複查＋grep AIza 機械掃描，兩輪皆查）；key 內容未經過對話/log。
• 呼叫預算兩輪合計 9 次，遠低於單輪 ≤15 上限。

驗收標準（全數通過）¶

• python -m pytest tests/ -q → 990 passed, exit code 0（基準 987 → +3 迴歸測試；主協調者獨立複跑）
• 五項驗證目標逐項有 raw 回應存檔佐證（experiments/arch2-followup-l/raw_output/，第一輪 403 紀錄保留歷史）
• 治理紀律：不驅動 升級、殘餘不確定性誠實標記、open-questions/ADR-010 修訂記錄同步

遺留（不阻擋）¶

• 24hr／停業狀態字串兩項條件觸發驗證（自然使用遇樣本即收）
• tps 真實資料排程複核延後至校準批（本輪僅 5 筆樣本，資料量不足以做領域複核）
• adr-010/adr-011 tree 節點 pending 待 architect 下次驗證