整合拓譜

飯店 SaaS 套裝的人類操作與維修手冊。資料層 → 情報層 → Bot 層 → 管理後台。

四服務如何串起來

                 ┌─────────────────────┐
                 │   hotel-intel      │  資料層
                 │   (Python pipeline)│  收集 Google 評論 → 統計/SEO 素材
                 └─────────┬───────────┘
                           │ 評論資料 / 統計
                           ▼
                 ┌─────────────────────┐
                 │  topreview-hotel   │  情報層
                 │  (CF Workers/D1)   │  多租戶評論分析、評分、回覆建議
                 └─────────┬───────────┘
                           │ 評論情報 API
                           ▼
   ┌───────────────────────┴───────────────────────┐
   │                                               │
   ▼                                               ▼
┌──────────────┐                         ┌─────────────────┐
│  omni-bot    │  Bot 層                 │  hotel-cms      │  整合面/後台
│ (5 workers)  │  館內客服 LINE/TG/WeChat │  (Astro Pages)  │  多租戶管理後台
└──────────────┘                         └─────────────────┘
   客人 ↔ Bot 對話                          飯店 admin 登入管理

hotel-intel

資料中心。Python pipeline 收集評論、產出統計與 SEO 素材，餵給情報層。

topreview-hotel

情報層。把評論轉成多租戶可用的分析、評分、AI 回覆建議。

omni-bot

Bot 層。多租戶多頻道客服 Bot（LINE／Telegram／WeChat／PWA），共用一台 xstate 機器。

hotel-cms

整合面。飯店內部管理後台 SaaS，整合上面三個服務，每家飯店只看到自己的資料。

誰該看哪一頁

角色	先看
飯店 admin（終端使用者）	hotel-cms 管理後台
客服 Bot 維護者	omni-bot 客服 Bot
維運 / 部署	部署與環境、疑難排解
新進人員 onboarding	上線檢查表

這份手冊只給人類看。各服務的 LLM／agent 工作合約（CLAUDE.md、guard 規則）留在各自 repo，不進本站。