生活智慧王 » 旅遊小幫手

摘要¶

完成研究問題 Q5（booking_helper 既有程式可重用範圍與「住宿遺漏」根因） 的
「審查 → devil-advocate 挑戰 → 業主決策 → system-architect 落地」全鏈閉環，
產出 ADR-004（ARCH-2 採集完整性設計原則）並記錄業主決策 OW-6
（住宿主篩選不含獨立衛浴過濾器）。

背景 / 問題¶

CLAUDE.md 專案目標點名 booking_helper 有「住宿遺漏問題」。Q5 對其
（C:\Users\sashi\Desktop\Code\booking_helper，原文件誤記 D:\Code\...）
做靜態程式碼審查，須界定哪些模組可重用、找出遺漏根因，作為 travel_helper
採集層 ARCH-2/ARCH-3 的工程地基。

處理經過¶

1. 工程審查（data-integration-engineer）

   • 可重用矩陣：app.py/地圖視覺化「機制可搬、版面須重寫」；maps_api.py
     全用 Legacy API 須遷 Routes/Places API (New)；scraper.py GraphQL 核心可重用。
   • 初判遺漏根因＝config.py:47 MAX_PAGES=3 硬上限（75 筆靜默截斷，
     nbResultsTotal 只印 log 不驅動翻頁）。
   • C-1 缺口：採集記錄全缺 source_url/fetched_at；C-5 key 管理健全。

2. 對抗複查（devil-advocate） — 以 file:line 證據反駁與補強

   • 更嚴重的隱蔽遺漏＝「衛浴 False-default 連鎖」：private_bathroom 預設
     None/False + 詳頁脆弱 selector #hotelTm498 + 衛浴過濾預設啟用 + 非 True
     一律剔除 → Booking 任一改版即整批住宿靜默歸零，且 log 誤標「無獨立衛浴」難診斷。
   • 原審查兩修法有反效果：動態 nbResultsTotal 翻頁踩 C-4 封鎖且語義未實測；
     「評分達標才進詳頁」會誤殺評分暫缺但實際達標的旅館。
   • 去重同名碰撞、app.py「直接搬」過樂觀、多個「已驗證」應降【假設】。

3. 業主決策（OW-6 / D-FILTER-1）

   • travel_helper 住宿主篩選不含獨立衛浴強制過濾，只依 C-3 評分門檻
     （Booking≥8.6 / Google≥4.1）→ 最嚴重連鎖爆炸半徑歸零，詳頁從「全量必爬」
     收斂為「候選少量爬」。

4. 規格落地（system-architect → ADR-004）

   • 6 條 ARCH-2 採集設計原則：三態完整性（未確認≠負面值）/ 詳頁候選少量爬 /
     動態翻頁（nbResultsTotal 標【假設】、與詳頁預算綁定）/ 去重複合鍵 /
     C-1 來源欄位 + C-9-10 欄位白名單 / 重用與信心標籤校正。
   • ARCH-2 成熟度維持 ⏳（不下降，理由記入 ADR-004）。

變更檔案¶

• docs/decisions/ADR-004-acquisition-completeness-and-detail-strategy.md（新增）
• docs/specs/architecture.md（ARCH-2 子規格 + ARCH-6 重用標籤 + 路徑更正）
• docs/specs/constraints.md（C-1 來源欄位、C-3 評分 None 三分支降級）
• docs/decisions/ADR-003-accommodation-data-acquisition.md（C/B C-3 收斂註記）
• docs/research/reports/2026-06-05_Q5_booking-helper-reuse_report.md（新增）
• docs/research/devil-advocate/2026-06-05_Q5-booking-helper-reuse-challenge.md（新增）
• docs/decisions/tree/owner/ow-6-accommodation-filter-scope.md（新增）
• docs/decisions/tree/research/q-5-booking-helper-reuse.md（新增）
• docs/decisions/tree/adr/adr-004-acquisition-completeness-and-detail-strategy.md（新增，verification_status: pending）
• docs/decisions/tree/00-index.md（OW-6/Q-5/ADR-004 節點 + 修訂歷史）
• docs/research/open-questions.md（Q5 ✅、新增 Q13）
• docs/owner-tracking/2026-06-04_owner-decision-package.md（D-FILTER-1）

衍生待辦（後續 ticket）¶

• Q13：Booking.com GraphQL nbResultsTotal 語義實測（動態翻頁前提）
• ADR-004 tree 節點 verification_status: pending → system-architect 下次驗證
• qa-engineer 測試計畫：selector 失效注入 / 同名去重 / 評分 None 三分支 /
  欄位白名單 / 完整場景負載（實作前設計）

驗收條件¶

• Q5 審查報告含 file:line 證據與可重用矩陣
• devil-advocate 挑戰報告含嚴重度分級與落地前清單
• 業主 OW-6 決策留痕（owner-tracking + 決策樹節點）
• ADR-004 落地，specs/constraints 同步更新，標籤翻譯/降級紀律遵守
• 決策樹三節點 + index + open-questions 簿記完成