Noah PMS 系統功能使用說明書
享宿 StayJoy — 智慧旅宿管理系統 完整功能參考手冊 v1.0
25
功能模組
300+
API 端點
85
資料模型
70+
系統頁面
10
微服務
功能模組總覽
核心
儀表板 Dashboard
即時營運總覽，房態統計、營收趨勢、入住率一目了然
核心
訂房管理
完整訂房生命週期，從建立到退房全程追蹤
核心
前台作業
入住登記、退房作業、散客管理、換房延住
核心
房務管理
清潔任務派工、房態追蹤、維修通報
房型與房間
房型定義、房間設定、房態看板、房價管理
定價與收益
AI 動態定價、季節設定、促銷活動管理
核心
財務管理
帳務、發票、付款、退款、對帳作業
人事管理
員工名冊、排班、出勤、請假、薪資
庫存採購
備品管理、庫存追蹤、採購流程
會員 CRM
會員等級、積點系統、優惠券、行銷活動
通路管理
OTA/GDS 連接、庫存分配、價格同步
直接訂房引擎
官網直訂、5 步驟訂房流程、公開 API
IoT 智慧客房
裝置控制、機器人調度、能源管理
報表分析
KPI 指標、營收報表、入住率分析
AI 智慧助手
智慧問答、操作教學、RAG 語義搜尋
系統網址：https://pms.jini.tw
版本：1.0 ｜ 更新日期：2026 年 3 月 6 日 ｜ 廠商：享宿科技 StayJoy Technology
版本：1.0 ｜ 更新日期：2026 年 3 月 6 日 ｜ 廠商：享宿科技 StayJoy Technology
系統概述
Noah PMS 是一套雲端 SaaS 多租戶旅宿管理系統，專為住宿業者設計
產品定位
Noah PMS（享宿 StayJoy PMS）涵蓋前台營運、後勤管理、通路分銷、收益優化、智慧客房等全方位功能，協助業者實現數位轉型、提升營運效率、降低人力成本。
適用對象
| 業態 | 規模 |
|---|---|
| 觀光飯店 | 50 ~ 500 間客房 |
| 商務旅館 | 30 ~ 200 間客房 |
| 精品民宿 | 5 ~ 50 間客房 |
| 度假村 | 100 ~ 1000 間客房 |
| 青年旅舍 | 20 ~ 200 床位 |
| 連鎖旅宿集團 | 多據點統一管理 |
核心價值
多租戶架構
一套系統服務多家旅宿，資料完全隔離
跨平台支援
Web、iOS、Android 三端一致體驗
即時同步
房態、價格、庫存即時更新
智慧定價
AI 驅動動態定價，自動最佳化收益
全通路整合
支援主流 OTA、GDS、Meta Search
智慧客房
IoT 管控、服務機器人、能源管理
技術架構
微服務架構，10 個獨立服務協同運作
系統架構圖
┌─────────────────────────────────────────────────────┐
│ 前端 (Flutter) │
│ Web / iOS / Android │
└──────────────────────┬──────────────────────────────┘
│ HTTPS / REST
┌──────────────────────▼──────────────────────────────┐
│ API Gateway (Port 3000) │
│ JWT 驗證 │ 限流 │ 路由 │ 日誌 │ CORS │
└──────┬────┬────┬────┬────┬────┬────┬────┬────┬──────┘
│ │ │ │ │ │ │ │ │
┌───▼┐┌─▼─┐┌─▼─┐┌─▼─┐┌─▼─┐┌─▼─┐┌─▼─┐┌─▼─┐┌─▼──┐
│Auth││Book││Front││Fin ││HR ││Inv ││CRM ││Rpt ││Notif│
│3001││3002││3003 ││3004││3005││3006││3007││3008││3009 │
└─┬──┘└─┬──┘└─┬──┘└─┬──┘└─┬──┘└─┬──┘└─┬──┘└─┬──┘└─┬──┘
└─────┴─────┴─────┼─────┴─────┴─────┴─────┴─────┘
│ Prisma ORM
┌────────▼────────┐
│ PostgreSQL 16 │ ← 主資料庫
│ (+ pgvector) │
└─────────────────┘
┌─────────────────┐
│ Redis 7 │ ← 快取 / 佇列 / Session
└─────────────────┘
┌─────────────────┐
│ MongoDB 7 │ ← 日誌 / 非結構化資料
└─────────────────┘
技術棧
| 層級 | 技術選型 | 說明 |
|---|---|---|
| 前端框架 | Flutter 3.x + Dart | 跨平台（Web / iOS / Android）一套代碼 |
| 狀態管理 | Riverpod 2.x | 強型別、可測試、高效能 |
| 路由 | GoRouter | 宣告式路由、Deep Linking |
| HTTP 客戶端 | Dio + Retrofit | 攔截器、錯誤處理、重試機制 |
| 後端框架 | Node.js + Express | 輕量、高效、生態成熟 |
| ORM | Prisma | 型別安全、自動遷移、查詢優化 |
| 服務間通訊 | gRPC + Protobuf | 高效能、強型別 |
| 主資料庫 | PostgreSQL 16 | ACID 交易、JSON 支援、向量搜尋 |
| 快取 | Redis 7 | Session、快取、即時通訊 Adapter |
| 文件資料庫 | MongoDB 7 | 日誌、分析、非結構化資料 |
| AI 引擎 | OpenAI API + RAG | 智慧問答、知識庫檢索、向量嵌入 |
微服務清單
| 服務 | 端口 | 職責 |
|---|---|---|
| Gateway | 3000 | API 路由、JWT 認證、限流、CORS |
| Auth | 3001 | 認證授權、使用者管理、多租戶 |
| Booking | 3002 | 訂房管理、房態、房價、可用性查詢 |
| Frontdesk | 3003 | 入住/退房、房卡、房務管理 |
| Finance | 3004 | 財務、發票、付款、退款 |
| HR | 3005 | 人事、排班、出勤、薪資 |
| Inventory | 3006 | 庫存、採購、供應商 |
| CRM | 3007 | 會員、忠誠度、行銷 |
| Report | 3008 | 報表、分析、統計 |
| Notification | 3009 | Email、SMS、推播通知 |
多租戶架構
隔離策略：Row-Level Isolation — 每筆資料含
認證機制：JWT Token 攜帶
租戶管理：獨立設定、品牌、方案、權限
tenant_id，所有查詢自動過濾認證機制：JWT Token 攜帶
tenantId，確保資料完全隔離租戶管理：獨立設定、品牌、方案、權限
📊 儀表板 Dashboard
即時營運總覽，一目了然掌握旅宿營運狀態
| 功能項目 | 說明 |
|---|---|
| 房態統計 | 即時顯示已入住、空房、清潔中、維修中房數及比例 |
| 今日營收 | 當日營收金額、與昨日/上月/去年同期比較 |
| 入住率趨勢 | 折線圖顯示每日/每週/每月入住率變化 |
| 營收趨勢 | 長條圖顯示營收走勢、預測趨勢 |
| 訂單來源分析 | 圓餅圖展示各通路（直客、OTA、企業）訂單占比 |
| 今日到達 | 當日預計入住的訂單列表，可快速操作入住 |
| 今日離開 | 當日預計退房的訂單列表，可快速操作退房 |
| 房態分佈圖 | 視覺化房態圓餅圖，快速識別各狀態占比 |
📅 訂房管理
完整的訂房生命週期管理，從建立到退房全程追蹤
功能清單
| 功能項目 | 說明 |
|---|---|
| 訂房清單 | 依狀態分頁：待確認 / 已確認 / 已入住 / 已完成 / 已取消 |
| 關鍵字搜尋 | 支援依訂單號、旅客姓名、電話、Email 搜尋 |
| 進階篩選 | 依日期區間、狀態、來源、房型篩選 |
| 新增訂房 | 填寫旅客資料、選擇房型、日期、計算房價 |
| 訂房詳情 | 完整訂房資訊：旅客、房間、付款、歷史紀錄 |
| 訂房修改 | 修改日期、房型、人數、加床、特殊需求 |
| 訂房取消 | 取消訂房，計算取消費用，觸發退款流程 |
| 會員帶入 | 選擇會員自動帶入姓名、電話、Email、身分證 |
| 房態日曆 | 時間軸顯示各房間的訂房狀態 |
| 統計概覽 | 總訂單數、待收金額、入住提醒、延住訂單 |
新增訂房流程
1
旅客資料
填寫旅客姓名、聯繫方式，或搜尋現有會員自動帶入
2
選擇房型
選擇入住/退房日期、房型、房間數量，系統即時查詢空房
3
付款資訊
選擇付款方式、收取訂金，右側面板顯示即時費用摘要
4
確認訂房
確認所有資料無誤後送出，系統自動產生訂單編號
訂房狀態流程
待確認 → 已確認 → 已入住 → 已退房
任何狀態皆可 → 已取消（依取消政策計算費用）
未到旅客 → No-Show（依政策處理）
任何狀態皆可 → 已取消（依取消政策計算費用）
未到旅客 → No-Show（依政策處理）
取消政策
| 政策類型 | 說明 |
|---|---|
| 免費取消 | 入住日前 N 天內免費取消，全額退款 |
| 部分扣款 | 依設定比例收取取消手續費 |
| 不可退費 | 預付訂單不予退款 |
🛎️ 前台作業
櫃台人員的核心工作台，管理旅客入住與退房全流程
功能清單
| 功能項目 | 說明 |
|---|---|
| 今日到達 | 列出當日預計入住的訂單，可快速辦理入住 |
| 在住旅客 | 目前在住旅客清單，含房號、預計退房日 |
| 今日離開 | 當日預計退房的訂單列表 |
| 入住登記 | 核驗身份、分配房間、發放房卡、登記入住 |
| 退房作業 | 退房檢查、結算費用、收取款項 |
| 散客入住 | 無預訂旅客現場入住（Walk-in） |
| 延住處理 | 延長住宿日期，自動計算追加費用 |
| 換房作業 | 更換房間，記錄換房原因 |
| No-Show | 標記未到訂單，觸發後續處理 |
| 快速動作面板 | 一鍵入住、退房、換房、延住 |
| 即時警示 | 逾時未到、特殊旅客、VIP 提醒 |
入住登記流程
1
確認預訂
從今日到達列表選擇訂單，或掃描訂單 QR Code
2
核驗身份
核對旅客身分證件（國民：身分證 / 外國旅客：護照）
3
分配房間
確認或重新分配房間，需確認房間為「已清潔」狀態
4
處理付款
收取剩餘房費或信用卡預授權
5
發放房卡
製作房卡並交付旅客
6
完成入住
系統自動更新房態為「已入住」，產生入住記錄
退房作業流程
1
確認旅客
選擇退房旅客或掃描房卡
2
結算帳務
檢視所有消費明細（房費、餐飲、迷你吧等）
3
收取款項
處理未付款項，支援分帳付款
4
回收房卡
回收並清除房卡授權
5
房間檢查
進行退房檢查，確認物品完整、設備正常
6
完成退房
房態自動更新為「待清潔」，觸發房務任務
🧹 房務管理
房務人員任務派工與進度追蹤
功能清單
| 功能項目 | 說明 |
|---|---|
| 任務清單 | 列出所有清潔任務，依優先順序排列 |
| 房間狀態 | 即時顯示每間房的清潔狀態（待清 / 清潔中 / 已清潔 / 已檢查） |
| 人員管理 | 房務人員排班、工作量分配 |
| 任務指派 | 依房號或樓層指派清潔人員 |
| 檢查清單 | 清潔檢查項目表，確保品質標準 |
| 狀態更新 | 房務人員即時更新清潔進度 |
| 維修通報 | 清潔時發現問題可直接通報維修 |
| 統計儀表板 | 已完成 / 進行中 / 待處理任務統計 |
清潔任務類型
| 任務類型 | 說明 | 優先級 |
|---|---|---|
| 每日清潔 | 在住旅客的日常清潔 | 一般 |
| 退房清潔 | 旅客退房後的全面清潔 | 中 |
| 深度清潔 | 定期深度清潔作業 | 中 |
| 緊急清潔 | 臨時緊急清潔需求 | 緊急 |
任務狀態流程
待處理 → 進行中 → 已完成 → 待檢查 → 通過 ✅ 或 不合格（退回重做）
🚪 房型與房間管理
管理房型定義、房間設定與房態追蹤
| 功能項目 | 說明 |
|---|---|
| 房型管理 | 建立/編輯房型（名稱、容量、設施、基準價、坪數、床型） |
| 房間列表 | 所有房間清單，含即時狀態 |
| 房態看板 | 視覺化顯示所有房間狀態（入住 / 空房 / 清潔 / 維修 / OOO） |
| 房價管理 | 設定房型基準價、週末價、假日價 |
| 房態日曆 | 月/週視圖顯示各房間的佔用時間軸 |
| 房間封鎖 | 封鎖特定房間特定日期（維修、翻新） |
| 快速操作 | 直接在看板上變更房間狀態 |
💰 定價與收益管理
AI 驅動的動態定價引擎，最佳化收益
| 功能項目 | 說明 |
|---|---|
| 動態定價規則 | 依入住率、需求、淡旺季自動調整房價 |
| 季節設定 | 定義旺季、平季、淡季及對應費率倍數 |
| 特殊日期 | 國定假日、連假、大型活動特別定價 |
| 價格日曆 | 日曆視圖顯示每日各房型價格 |
| 促銷活動 | 建立限時優惠、早鳥折扣、連住優惠 |
| 入住率導向 | 依入住率自動調升或調降房價 |
| 需求曲線 | 視覺化需求與定價關係 |
| 批次調整 | 批次修改指定日期區間的房價 |
🧾 財務管理
完整的財務作業系統，涵蓋帳務、發票、付款、退款
| 功能項目 | 說明 |
|---|---|
| 財務總覽 | 今日/本月營收、應收帳款、月度費用一覽 |
| 發票管理 | 建立、查詢、列印發票，支援作廢與重開 |
| 付款紀錄 | 所有付款明細，含金流閘道資訊 |
| 退款處理 | 退款流程管理、審核、撥付追蹤 |
| 旅客帳戶 (Folio) | 旅客住宿期間所有消費明細 |
| 費用登記 | 登記房費、餐飲、服務、迷你吧等費用 |
| 結帳結算 | 退房時結算所有未付款項 |
| 應收帳款 | A/R 帳齡分析與催收管理 |
付款方式
現金
信用卡
銀行轉帳
掛帳
優惠券
積點折抵
退款授權層級
| 層級 | 金額上限 |
|---|---|
| 櫃台人員 | $1,000 |
| 主管 | $10,000 |
| 財務部 | $50,000 |
| 經理 | 無上限 |
🌙 夜間稽核
每日營業結帳的自動化稽核流程
| 功能項目 | 說明 |
|---|---|
| 自動稽核 | 一鍵執行每日自動過帳與結帳 |
| 手動稽核 | 異常項目手動調整與確認 |
| 營收報表 | 每日營收明細與彙總 |
| 待處理項目 | 未結帳項目提醒 |
| 異常偵測 | 自動偵測異常交易與差異 |
| 現金核對 | 實際現金與系統帳務核對 |
夜間稽核步驟
1
確認交易
確認今日所有交易紀錄完整無誤
2
執行稽核
系統自動過帳房費、處理 No-Show
3
處理例外
處理異常項目（金額差異、帳務錯誤）
4
產出報表
自動產生日報、營收明細、對帳報表
5
確認完成
確認稽核完成，系統切換至新營業日
🌐 通路管理 Channel Manager
統一管理所有 OTA 通路的庫存與價格同步
| 功能項目 | 說明 |
|---|---|
| 通路列表 | 已連接的 OTA/GDS 通路清單與狀態 |
| 支援通路 | Booking.com、Agoda、Expedia、Hotels.com、Klook、Traveloka 等 15+ 平台 |
| 房型對應 | PMS 房型與通路房型對應關係設定 |
| 費率對應 | PMS 費率方案與通路費率對應 |
| 庫存分配 | 各通路的庫存配額設定 |
| 佣金設定 | 各通路佣金比例設定 |
| 同步觸發 | 手動或自動觸發庫存/價格同步 |
| 同步日誌 | 查看同步歷史紀錄與錯誤排查 |
📡 內容管理系統 CMS
通路內容的統一管理與分發
| 功能項目 | 說明 |
|---|---|
| CMS 儀表板 | 通路狀態總覽、最近訂單、警示通知 |
| 通路管理 | 通路啟用/停用、同步狀態顯示 |
| 費率分發 | 基礎費率設定、各通路差異定價 |
| 庫存分配 | 各通路可售房數配置、分配規則 |
| 通路訂單 | 來自各通路的訂單彙總與溯源 |
| 同步排程 | 自動排程同步庫存與費率 |
🔗 直接訂房引擎
官網直接訂房功能，降低 OTA 佣金依賴
| 功能項目 | 說明 |
|---|---|
| 訂房引擎設定 | 啟用/停用直接訂房、歡迎訊息、飯店名稱 |
| 訂房規則 | 最低提前天數、最短/最長住宿天數 |
| 付款設定 | 現場付款 / 線上付款、訂金比例設定 |
| 直接訂房連結 | 自動產生專屬直接訂房 URL |
| 公開 API | 可嵌入任何外部網站 |
5 步驟訂房流程
1
搜尋
輸入入住/退房日期、人數，查詢可用房型
2
選擇房型
瀏覽房型照片、設施、容量，選擇偏好房型
3
填寫資料
填寫旅客姓名、聯繫方式、特殊需求
4
確認明細
確認訂房明細與費用
5
完成付款
處理付款，收到訂房確認
👥 團體訂房
大型團體預訂的專業管理工具
| 功能項目 | 說明 |
|---|---|
| 團體訂房建立 | 建立團體預訂（含名稱、日期、房數），最低 5 間 |
| 分房清單 | 管理團體中每位旅客的房間分配 |
| 團體帳務 | 統一帳務（Master Folio）或個人分帳 |
| 企業合約 | 企業簽約價管理 |
| 旅行社管理 | 旅行社基本資料、佣金設定 |
⚠️ 超額預訂管理
智慧超訂策略，最大化入住率同時降低風險
| 功能項目 | 說明 |
|---|---|
| 超訂設定 | 各房型超訂比例上限設定 |
| 超訂偵測 | 自動偵測超訂日期並發出警示 |
| 事件記錄 | 紀錄每次超訂事件 |
| 合作飯店 | 合作飯店網絡，超訂時可轉介旅客 |
| 補償追蹤 | 超訂補償方案記錄與費用追蹤 |
🎯 櫃台服務中心 FCS
旅客服務請求的統一管理平台
| 功能項目 | 說明 |
|---|---|
| FCS 儀表板 | 服務請求統計、進行中請求 |
| 旅客服務 | 服務請求建立、指派、追蹤、完成 |
| 遺失物管理 | 遺失物登記、認領、歸還追蹤 |
| 叫醒服務 | 叫醒電話排程與自動提醒 |
| 活動管理 | 旅客活動排程與報名管理 |
| 禮賓服務 | 餐廳推薦、交通安排、景點資訊 |
| 工單管理 | 服務工單建立、指派、追蹤 |
🔧 維修保養管理
設備維修與預防性保養的完整管理
| 功能項目 | 說明 |
|---|---|
| 工單管理 | 維修工單建立、指派、進度追蹤 |
| 問題通報 | 旅客或員工通報設備問題 |
| 績效報表 | 維修人員績效統計 |
| 費用報表 | 維修費用統計與分析 |
| 歷史紀錄 | 每間房的維修歷史追蹤 |
問題回應時間
| 優先級 | 回應時間 |
|---|---|
| 緊急 | 30 分鐘內 |
| 高 | 2 小時內 |
| 中 | 當日處理 |
| 低 | 48 小時內 |
💎 會員與忠誠度 CRM
會員經營與忠誠度計畫，提升回客率
| 功能項目 | 說明 |
|---|---|
| 會員清單 | 搜尋、篩選（等級、日期、消費額、積點） |
| 會員等級 | 五級制（鑽石 / 白金 / 金 / 銀 / 銅） |
| 會員詳情 | 個人資料、訂房歷史、積點餘額、消費紀錄 |
| 積點系統 | 消費累點、活動加碼、積點兌換 |
| 優惠券管理 | 建立、發放、核銷優惠券 |
| 行銷活動 | 建立促銷活動、目標客群推播 |
| 兌換商城 | 積點兌換商品/服務目錄 |
| 會員分析 | KPI、成長趨勢、RFM 分析 |
| 客訴管理 | 投訴記錄、處理流程、回饋追蹤 |
會員等級與權益
| 等級 | 折扣 | 積點倍率 | 主要權益 |
|---|---|---|---|
| 銅卡 | 0% | 1x | 基本累點 |
| 銀卡 | 5% | 1.5x | 延遲退房 |
| 金卡 | 10% | 2x | 免費升等、提早入住 |
| 白金 | 15% | 2.5x | 迎賓飲品、免費早餐 |
| 鑽石 | 20% | 3x | 貴賓室、免費住宿夜 |
👤 人事管理
員工從入職到薪資的全程管理
| 功能項目 | 說明 |
|---|---|
| 員工名冊 | 員工基本資料、部門、職位、狀態管理 |
| 排班管理 | 月/週排班日曆，拖拉式排班 |
| 班別設定 | 定義班別（早班/中班/晚班/大夜班）及時段 |
| 出勤打卡 | 上下班打卡紀錄，支援手動補打 |
| 出勤統計 | 遲到、早退、缺勤統計報表 |
| 請假管理 | 線上請假申請、主管審核 |
| 薪資計算 | 依出勤、加班、獎金自動計算薪資 |
| 部門管理 | 部門建立與組織架構維護 |
📦 庫存與採購
備品耗材庫存追蹤與採購流程管理
| 功能項目 | 說明 |
|---|---|
| 品項管理 | 庫存品項建檔（名稱、類別、單位、安全庫存量） |
| 庫存查詢 | 即時庫存數量、分類篩選、低庫存警示 |
| 庫存異動 | 入庫、出庫、調整、盤點記錄 |
| 採購單管理 | 建立 → 送審 → 核准 → 收貨 完整採購流程 |
| 供應商管理 | 供應商資料維護、聯繫資訊、評價 |
| 收貨確認 | 到貨驗收並自動更新庫存 |
🛒 POS 銷售系統
館內銷售點的訂單與收款管理
| 功能項目 | 說明 |
|---|---|
| 訂單管理 | 建立、修改、結帳訂單 |
| 收銀機 | 收銀操作介面 |
| 迷你吧管理 | 迷你吧品項設定與消費紀錄 |
| 銷售報表 | 每日/週/月銷售統計 |
| 桌位管理 | 餐廳桌位配置與狀態 |
| 菜單管理 | 品項、分類、價格維護 |
| 掛房消費 | 消費掛到旅客房帳 |
🍽️ 餐飲管理
餐飲營運的專業管理模組
| 功能項目 | 說明 |
|---|---|
| 訂單管理 | 餐飲訂單建立與處理 |
| 菜單管理 | 菜單設計、品項維護、價格設定 |
| 庫存追蹤 | 食材庫存與耗用追蹤 |
| 報表分析 | 餐飲營收分析、熱門品項統計 |
🤖 IoT 智慧客房
智慧飯店的物聯網裝置管理與自動化控制
| 功能項目 | 說明 |
|---|---|
| IoT 儀表板 | 裝置總覽、機器人狀態、警示通知 |
| 客房控制 | 單房裝置控制（燈光、空調、窗簾、電視） |
| 機器人調度 | 服務機器人任務派遣與路線優化 |
| PBX 電話系統 | 飯店電話交換機管理 |
| 感測器監控 | 溫度、濕度、空氣品質即時監控 |
| 能源管理 | 能源消耗追蹤、節能建議 |
| 情境模式 | 預設場景（歡迎、睡眠、退房）一鍵切換 |
| 門禁管理 | 智慧門鎖管理、電子房卡 |
📈 報表與分析
多維度經營分析報表，輔助決策
| 功能項目 | 說明 |
|---|---|
| KPI 摘要卡 | ADR、RevPAR、OCC%、GOP 關鍵指標一覽 |
| 營收報表 | 每日/週/月/年營收統計與趨勢 |
| 入住率分析 | 入住率變化、預測、與同業比較 |
| 訂單來源分析 | 各通路訂單量與營收占比 |
| 期間比較 | 日/週/月/年維度的同期比較 |
| 匯出功能 | Excel / PDF 格式匯出 |
| 營收預測 | 基於歷史數據的營收預測 |
關鍵指標說明
| 指標 | 全名 | 計算方式 |
|---|---|---|
| ADR | Average Daily Rate | 客房營收 ÷ 售出房間數 |
| RevPAR | Revenue Per Available Room | 客房營收 ÷ 可售房間數 |
| OCC% | Occupancy Rate | 售出房間數 ÷ 可售房間數 × 100% |
| GOPPAR | Gross Operating Profit Per Available Room | 營業毛利 ÷ 可售房間數 |
🔔 通知中心
多管道通知發送與訊息管理
| 功能項目 | 說明 |
|---|---|
| 通知收件匣 | 系統通知列表，未讀標記 |
| 通知分類 | 依類型篩選（系統、訂房、付款、警示） |
| Email 發送 | Email 通知發送 |
| SMS 發送 | 簡訊通知發送 |
| 推播通知 | App 推播通知 |
| 訊息模板 | 通知模板管理（含變數替換） |
| 內部訊息 | 員工間直接訊息 |
| 廣播公告 | 全館廣播公告 |
🧠 AI 智慧助手
AI 驅動的營運助手，提供即時諮詢與操作指引
| 功能項目 | 說明 |
|---|---|
| 智慧問答 | 自然語言問答，解答營運問題 |
| 知識庫管理 | 上傳營運文件建立知識庫 |
| RAG 語義搜尋 | 基於向量嵌入的語義搜尋 |
| 操作教學 | 10+ 操作教學文件，步驟式引導 |
| 使用統計 | AI 問答使用頻率與滿意度分析 |
| 情境感知 | 根據使用者角色與情境提供建議 |
AI 助手使用 OpenAI API 搭配 RAG（Retrieval-Augmented Generation）技術，結合系統知識庫中的 23+ 篇操作指南與 FAQ 文件，提供精確的操作指引與問題解答。
⚙️ 系統管理
系統設定、帳號管理與權限控制
| 功能項目 | 說明 |
|---|---|
| 飯店設定 | 飯店基本資料、營業時間、政策設定 |
| 使用者管理 | 帳號建立、編輯、停用、密碼重設 |
| 角色管理 | 角色定義與權限指派 |
| 權限控制 | 細粒度 RBAC 權限矩陣 |
| 安全設定 | 雙因素驗證、SMS 驗證 |
| 登入紀錄 | 登入歷史、裝置資訊、IP 紀錄 |
| Session 管理 | 查看活躍 Session、強制登出 |
| 系統日誌 | 操作日誌與快取管理 |
🔌 API 整合
Platform API 與 Webhook 事件
Platform API 端點
| API 端點 | 方法 | 說明 |
|---|---|---|
/platform/hotels | GET | 取得已上架飯店列表 |
/platform/hotels/:tenantId | GET | 取得飯店詳情 |
/platform/hotels/:tenantId/room-types | GET | 取得可用房型 |
/platform/hotels/:tenantId/availability | GET | 查詢空房 |
/platform/hotels/:tenantId/quote | POST | 取得報價 |
/platform/booking | POST | 建立訂房 |
/platform/booking/:id | GET | 查詢訂房 |
/platform/booking/:id/cancel | POST | 取消訂房 |
/platform/booking/:id/modify | PUT | 修改訂房 |
/platform/webhook/register | POST | 註冊 Webhook |
Webhook 事件
| 事件名稱 | 觸發時機 |
|---|---|
booking.created | 新訂房建立 |
booking.confirmed | 訂房確認 |
booking.cancelled | 訂房取消 |
booking.checked_in | 旅客入住 |
booking.checked_out | 旅客退房 |
booking.modified | 訂房修改 |
booking.no_show | 旅客未到 |
Integration Hub
透過 Integration Hub 與外部系統進行跨系統通訊，支援合約管理、訊息傳遞、合約驗證、健康狀態監控。
❓ 常見問題 FAQ
系統使用常見問題與解答
訂房相關
如何新增訂房？▼
進入「訂房管理」→ 點擊「新增訂房」→ 依照 4 步驟精靈完成：旅客資料 → 選擇房型 → 付款資訊 → 確認送出。可在輸入旅客姓名時搜尋現有會員自動帶入資料。
如何修改訂房？▼
進入訂房詳情頁 → 點擊「編輯」→ 可修改入住日期、房型、人數、特殊需求等。系統會自動檢查房間可用性並重新計算房價。所有修改記錄會留存在操作歷史中。
如何取消訂房？▼
進入訂房詳情頁 → 點擊「取消訂房」→ 系統會依取消政策（免費取消/部分扣款/不可退費）計算取消費用 → 確認取消後自動觸發退款流程。退款方式依原付款方式返回。
如何處理團體訂房？▼
進入「團體訂房」→ 建立團體（最低 5 間房）→ 設定入住/退房日期 → 選擇房型與數量 → 管理分房清單（可手動輸入、稍後補充或 Excel 批次匯入）→ 選擇付款方式（統一/個人/混合）。
系統操作
忘記密碼怎麼辦？▼
在登入頁面點擊「忘記密碼」→ 輸入註冊 Email → 系統會發送密碼重設連結至信箱 → 點擊連結設定新密碼。如無法收到信件，請聯繫系統管理員重設密碼。
支援哪些瀏覽器？▼
支援 Chrome 90+、Firefox 90+、Safari 14+、Edge 90+。建議使用最新版 Chrome 以獲得最佳體驗。系統採響應式設計，支援桌面、平板、手機瀏覽。
可以多裝置同時登入嗎？▼
可以。系統支援同一帳號在多個裝置同時登入。管理員可在「系統管理 → Session 管理」查看所有活躍 Session 並可強制登出特定裝置。
如何匯出報表？▼
進入任何報表頁面 → 設定篩選條件 → 點擊右上角「匯出」按鈕 → 選擇格式（Excel / PDF / CSV）→ 系統會自動下載檔案。
付款與發票
支援哪些付款方式？▼
系統支援 6 種付款方式：現金、信用卡、銀行轉帳、掛帳（帳戶客戶）、優惠券、積點折抵。支援分帳付款（同一筆帳務使用多種付款方式組合）。
如何開立發票？▼
進入「財務管理 → 發票管理」→ 點擊「新增發票」→ 選擇類型（二聯式/三聯式）→ 填寫發票資料 → 送出。支援電子發票，發票品名可選擇：住宿費、餐飲費、服務費、洗衣費等。
退款需要多久？▼
依付款方式不同：現金（當日退款）、信用卡（3~7 個工作天）、銀行轉帳（1~3 個工作天）。退款需依權限層級審核：櫃台（$1,000 以下）、主管（$10,000 以下）、財務（$50,000 以下）、經理（無上限）。