N
Noah 系統說明書
v1.0 | 2026-03-06

Noah 訂位候位整合系統

完整功能使用說明書

訂位管理 候位管理 桌位管理 KIOSK 自助取號 候位看板 LINE 通知 營運報表

系統簡介

Noah 訂位候位整合系統是一套專為餐飲業打造的全方位解決方案，提供從線上訂位、現場候位、KIOSK 自助取號到候位看板的完整功能。 系統採用微服務架構，支援多店管理與跨國部署（多時區），並整合 LINE 與 SMS 多管道通知。

訂位系統

線上預約 + OTP 驗證、餐期管理、人數規則、自動桌位分配、訂位狀態流程管理

候位系統

現場/線上取號、叫號、過號、入座、候位看板顯示、KIOSK 自助取號機

桌位管理

視覺化桌位圖、區域劃分、標籤系統、即時協作編輯、自動桌位分配

通知系統

LINE 推播 / SMS 簡訊 / Email 三管道通知，支援多語系範本、自動備援機制

系統架構

系統由五個主要前端介面與後端微服務組成：

 ┌────────────────┐  ┌────────────────┐  ┌───────────┐  ┌──────────┐  ┌──────────┐
 │  顧客網站(Vue) │  │ 店家後台(Flutter)│ │ KIOSK取號  │  │ 候位看板  │  │ 營運後台  │
 └───────┬────────┘  └───────┬────────┘  └─────┬─────┘  └────┬─────┘  └────┬─────┘
         │                   │                 │              │              │
         ▼                   ▼                 ▼              ▼              ▼
 ┌───────────────┐   ┌──────────────────────────────────────────────┐  ┌──────────┐
 │Customer Gateway│  │            Store Gateway                     │  │ Store GW │
 │  Socket.IO    │   │  /v1/store  │  /v1/kiosk  │  /v1/display   │  │(Socket.IO)│
 └───────┬───────┘   └──────────────────┬───────────────────────────┘  └────┬─────┘
         │                              │                                   │
         └──────────────────────────────┼───────────────────────────────────┘
                                        │ BullMQ
         ┌──────────┬──────────┬────────┼────────┬──────────┬──────────┐
         ▼          ▼          ▼        ▼        ▼          ▼          ▼
    ┌─────────┐┌─────────┐┌────────┐┌────────┐┌────────┐┌──────────┐┌────────┐
    │訂位服務 ││候位服務 ││桌位服務││會員服務││通知服務││排程服務  ││報表服務│
    └─────────┘└─────────┘└────────┘└────────┘└────────┘└──────────┘└────────┘
         │          │          │        │                    │
         └──────────┴──────────┴────────┘                    │
                        │                                    │
                   ┌────┴────┐                     ┌─────────┴────────┐
                   │  MySQL  │                     │ Redis / Valkey   │
                   │ 資料庫  │                     │ 快取 + 佇列      │
                   └─────────┘                     └──────────────────┘
即時通訊

所有前端透過 Socket.IO (WebSocket) 與 Gateway 通訊，確保資料即時同步

非同步處理

服務間透過 BullMQ 訊息佇列通訊，確保高可用性與擴展性

多端同步

透過 Redis Pub/Sub 實現跨裝置即時推播（訂位/候位/桌位變更）

角色與權限

角色 說明 權限範圍
SUPER_ADMIN系統管理員所有權限，跨店管理
ENTERPRISE_ADMIN企業管理員管理品牌下所有門店
STORE_ADMIN店家管理員（店長）單店所有管理功能（設定、員工、餐期等）
STORE_STAFF店家員工基本操作（候位、訂位、叫號等）
提示：標記為「需 ADMIN」的功能，僅限 STORE_ADMIN 及以上角色使用。STORE_STAFF 僅能進行日常操作（取號、叫號、訂位確認等）。

店家後台

登入與切換門店

店家後台是餐廳日常營運的核心工具。使用帳號密碼登入後即可開始操作。

單店帳號登入

  1. 1開啟店家後台網址
  2. 2輸入帳號和密碼
  3. 3點擊「登入」，系統直接進入該店家的管理頁面

多店帳號登入（企業/集團）

  1. 1輸入帳號和密碼後登入
  2. 2系統顯示可管理的門店列表
  3. 3選擇要進入的門店（需在 15 分鐘內選擇，逾時需重新登入）
  4. 4進入該門店的管理頁面，Token 有效期 30 天

Dashboard 總覽

登入後預設進入 Dashboard 頁面，可以快速掌握今日營業狀況。

包含資訊

  • 今日訂位統計（待確認 / 已確認 / 已入座 / 已完成 / 未到 / 已取消）
  • 今日候位統計（等候中 / 已叫號 / 已入座 / 已取消）
  • 即時連線數（店家 / KIOSK / 看板）
  • 餐期狀態（目前開啟的餐期）

訂位管理

管理所有線上與店家自建的訂位。提供時間軸（Timeline）和列表兩種檢視模式。

檢視模式

時間軸模式 (Timeline)

以時間軸方式顯示當日各時段的訂位，直覺掌握各時段用餐情況

列表模式

以表格形式列出訂位，可篩選日期、狀態，適合查找特定訂位

新增訂位（店家端）

  1. 1點擊「新增訂位」按鈕
  2. 2填寫顧客姓名、電話、用餐人數
  3. 3選擇訂位日期與時段
  4. 4可選填備註
  5. 5送出後系統自動歸戶（建立或關聯會員資料）

訂位狀態流程

等待 OTP → 待確認 → 已確認 → 已入座 → 已完成
* 可在「待確認」「已確認」階段取消訂位
* 「已確認」階段可標記為未到 (No-show)
* 店家端建立的訂位直接為「待確認」狀態（略過 OTP）

訂位操作

確認訂位 — 接受顧客預約
拒絕訂位 — 無法接受預約
入座 — 顧客到店入座
清桌中 — 桌位清理中
完成用餐 — 結束用餐
未到 (No-show) — 顧客未出現
編輯訂位 — 修改訂位資訊（使用編輯鎖防衝突）
手動發送簡訊 — 向顧客發送通知

月曆總覽

可切換到月曆檢視，查看每月各日的訂位量統計，方便掌握繁忙日期。

候位管理

管理現場候位的核心功能。支援多桌型分類（大桌、中桌、小桌等），並可透過特殊需求標記提供更好的服務。

開啟餐期（必要步驟）

重要：必須先開啟餐期才能開始取號。未開啟餐期時，所有取號管道（店家/KIOSK/線上）都無法取號。
  1. 1點擊「開啟餐期」按鈕
  2. 2選擇要開啟的餐期（午餐/晚餐/自訂餐期）
  3. 3系統開始接受取號

取號（店家端）

  1. 1點擊「取號」按鈕
  2. 2輸入用餐人數（系統自動分配桌型）
  3. 3可選填電話和姓名（用於簡訊通知叫號）
  4. 4可選擇特殊需求（如：嬰兒椅、輪椅等）
  5. 5系統產生候位號碼

候位操作流程

叫號

通知顧客準備入座，有留電話的顧客會收到簡訊/LINE 通知

入座

確認顧客已入座，可指定桌號

過號

顧客未回應，暫時跳過（可設定自動過號次數上限）

還原

將過號的顧客還原至等候佇列

取消

取消候位號碼

報到

顧客確認到場，等待入座

切換/關閉餐期

  • 切換餐期：切換到下一個餐期前，系統會檢查是否還有等候中的號碼
  • 關閉餐期：結束當前餐期，可選擇將尚在等候的號碼標記為未到

桌位管理

視覺化的桌位圖管理系統，支援拖曳擺放、多區域劃分，並可即時與其他登入裝置同步。

區域管理 （需 ADMIN 權限）

  • 建立用餐區域（例如：室內區、戶外區、包廂）
  • 為每個區域命名、排序
  • 刪除不再使用的區域

桌位操作 （需 ADMIN 權限）

  • 新增桌位：設定桌號、容納人數、所屬區域
  • 拖曳移動桌位位置（即時同步到其他裝置）
  • 調整桌位大小、旋轉桌位
  • 批次更新多張桌位

桌位標籤

可為桌位設定標籤（如：窗邊、安靜區、景觀），方便訂位時配對顧客偏好。

  • - 建立自訂標籤（名稱 + 顏色）
  • - 將標籤關聯到指定桌位
  • - 訂位分配時可依標籤篩選可用桌位

餐期設定 （需 ADMIN 權限）

管理訂位時段與營業餐期的設定，支援靈活的範本系統和特殊日期覆蓋。

餐期範本系統

  1. 1建立餐期範本：定義不同的營業模式（例如：平日範本、假日範本）
  2. 2設定時段：每個範本可包含多個餐期（午餐 11:00-14:00、晚餐 17:00-21:00）
  3. 3對應星期：將範本批次對應到星期幾（例如：平日範本 → 週一至週五）
  4. 4特殊覆蓋：為特定日期設定不同的餐期（例如：國定假日用假日範本）

其他餐期功能

  • 查看月排程：一覽當月每天使用哪個餐期範本
  • 休業影響分析：設定休假前查看會影響多少已有訂位
  • 可用日期/時段查詢：供顧客端取得可訂位的日期和時段

店家設定 （需 ADMIN 權限）

基本資訊

  • 店家名稱、電話、地址
  • 時區設定（支援跨國部署：Asia/Taipei、Asia/Tokyo 等）
  • 店家 Logo 和封面圖

訂位設定

  • 訂位時段間隔（例如：每 30 分鐘一個時段）
  • 每時段最大訂位數
  • 可提前訂位天數

候位設定

  • 桌型分類設定（大桌/中桌/小桌的人數範圍）
  • 過號上限次數
  • 叫號通知設定（簡訊範本、是否自動發送）
  • KIOSK 顯示設定

人數規則

設定不同人數範圍的訂位規則：

1-2 人 → 允許線上訂位（小桌）
3-4 人 → 允許線上訂位（中桌）
5-10 人 → 需電話預約（大桌），線上不開放

休假日管理

  • 設定全日休假或部分時段休假
  • 可填寫休假原因
  • 休假期間自動封鎖線上訂位

員工管理 （需 ADMIN 權限）

  • 檢視員工列表
  • 新增員工帳號（設定帳號、密碼、角色）
  • 修改員工資料與權限
  • 停用/刪除員工帳號

顧客 CRM

管理顧客資料與互動紀錄，建立良好的顧客關係。

顧客資料

  • 檢視顧客詳細資料（姓名、電話、訂位/候位歷史）
  • 搜尋顧客（電話、姓名）
  • 顧客統計（到訪次數、No-show 次數、消費頻率）

標籤系統

  • 建立自訂標籤（VIP、常客、素食等）
  • 為顧客加上/移除標籤
  • 依標籤篩選顧客

備註與黑名單

  • 為顧客新增備註（可標記為重要備註）
  • 黑名單管理：加入/移除黑名單，記錄原因
  • 自動記錄 No-show 次數

簡訊設定 （需 ADMIN 權限）

  • 設定簡訊發送規則
  • 自訂簡訊範本內容
  • 查看簡訊發送紀錄

圖片管理 （需 ADMIN 權限）

圖片類型

Logo — 店家標誌
Cover — 封面圖片
Gallery — 店家相簿
Menu — 菜單圖片

上傳流程

  1. 1選擇圖片類型後點擊上傳
  2. 2系統取得上傳 URL（Presigned URL）
  3. 3圖片直接上傳至雲端儲存（Cloudflare R2）
  4. 4確認上傳完成，圖片顯示在列表中
支援拖曳排序、設定主圖、刪除圖片等操作。

顧客端

線上訂位

訂位流程

  1. 1
    選擇日期與時段
    在店家頁面選擇想用餐的日期，查看可用時段
  2. 2
    填寫訂位資訊
    輸入姓名、手機號碼、用餐人數，可選填備註
  3. 3
    OTP 驗證
    系統發送驗證碼到手機（SMS），在 5 分鐘內輸入驗證碼完成訂位
  4. 4
    等待店家確認
    訂位成功後狀態為「待確認」，等待店家確認預約
  5. 5
    收到確認通知
    店家確認後，顧客會收到 LINE 或 SMS 通知
注意：OTP 驗證碼 5 分鐘內未輸入，訂位將自動取消。

線上候位取號

線上取號流程

  1. 1
    進入店家候位頁面
    可查看目前候位狀態（等候組數、預估等待時間）
  2. 2
    選擇用餐人數
    系統自動分配對應桌型
  3. 3
    輸入手機號碼（選填）
    留下手機可收到叫號通知
  4. 4
    通過驗證（CAPTCHA）
    完成人機驗證後取號成功
  5. 5
    查看候位狀態
    即時查看排隊位置，收到叫號通知後前往報到

會員中心

登入方式

透過手機 OTP 驗證碼登入，無需設定密碼。

會員功能

  • 查看個人資料（姓名、電話、Email）
  • 修改個人資料
  • 查看訂位紀錄（歷史與即將到來的訂位）
  • 取消訂位
  • 查看訂位詳情

LINE 綁定

顧客可透過 LINE LIFF 綁定帳號，綁定後享有 LINE 推播通知服務。

綁定流程

  1. 1從 LINE 官方帳號開啟 LIFF 頁面
  2. 2使用手機號碼 + OTP 驗證身份
  3. 3系統自動綁定 LINE User ID 到會員帳號
  4. 4後續訂位/候位通知將優先透過 LINE 推播
好處：LINE 推播免費且即時，綁定後不再消耗簡訊費用。

KIOSK 自助取號

KIOSK 功能說明

KIOSK 是放在店門口的平板/螢幕，讓顧客自助取號，減輕店員負擔。

KIOSK 設定

  • 使用店家帳號登入 KIOSK 模式
  • KIOSK Token 有效期 1 年（長效）
  • 可自訂顯示設定（桌型選項、是否要求手機號碼等）

顧客自助取號流程

  1. 1選擇用餐人數
  2. 2可選擇是否輸入手機號碼（叫號通知用）
  3. 3確認取號
  4. 4螢幕顯示候位號碼和目前排隊位置

KIOSK 可用功能

  • 自助取號
  • 查看候位列表
  • 查看目前等候狀況統計
  • 報到功能
  • 手動簡訊通知

候位看板

候位看板功能說明

候位看板是顯示在店內的大螢幕，讓顧客查看叫號狀態。

看板顯示內容

  • 目前叫號：顯示正在叫號的號碼（醒目大字）
  • 等待中列表：顯示尚在等候的號碼清單
  • 店家資訊：顯示店名等基本資訊

特點

  • 即時更新（WebSocket 推播，無需重新整理）
  • Display Token 有效期 1 年（設定一次長期使用）
  • 叫號時有視覺提示動畫
  • 支援自訂顯示風格

營運後台

Dashboard

營運後台提供跨店的全局檢視，適合企業管理者和系統管理員使用。Dashboard 顯示營運總覽指標。

報表中心

可用報表

訂位報表

按日期、狀態、來源篩選訂位資料

候位報表

候位取號、叫號、入座等數據

現場報表

Walk-in 資料統計

補位報表

臨時補位的統計資料

進階統計

  • - 每日統計 / 時段統計 / 星期統計 / 小時統計
  • - 來源統計（線上/店家/KIOSK）
  • - 狀態統計（確認率、No-show 率等）
  • - 月度趨勢分析
  • - 熱門時段排行

品牌管理

  • 品牌/商家基本資訊管理
  • 門店列表檢視與管理
  • 新增門店

平台管理 （需 SUPER_ADMIN）

  • 商家列表（所有註冊商家）
  • 商家詳情查看
  • 全平台門店列表
  • 門店詳情查看

人員管理

  • 員工帳號管理（新增/編輯/停用）
  • 營運後台操作者管理
  • 權限角色設定

顧客管理

  • 顧客列表（跨店）
  • 簡訊發送歷史
  • 簡訊額度購買（Preview）

第三方串接

  • LINE OA 串接設定
  • Google Maps 串接
  • OpenTable 串接（規劃中）

通知系統

通知機制說明

通知管道

💬
LINE 推播

優先使用（免費）

📱
SMS 簡訊

LINE 未綁定時備援

📧
Email

補充通知管道

自動通知情境

情境 通知內容 管道
訂位 OTP 驗證驗證碼SMS
訂位確認訂位資訊確認LINE / SMS
訂位被拒拒絕原因LINE / SMS
候位叫號請前往報到LINE / SMS
店家手動發送自訂訊息SMS

多語系通知

系統支援多語系通知範本，根據顧客的語言偏好自動選擇對應語系的範本發送：

繁體中文 (zh-TW) English (en-US) 日本語 (ja-JP)

附錄

常見問題 FAQ

為什麼開不了候位取號？ ▶
需要先開啟餐期（mealPeriod:open）。在候位管理頁面點擊「開啟餐期」後，KIOSK、線上和店家端才能開始取號。
顧客沒收到 OTP 驗證碼怎麼辦？ ▶
OTP 有冷卻時間，請等待後再重新發送。檢查手機號碼是否正確，以及是否被電信商攔截為垃圾簡訊。
多店帳號登入後為什麼要選店？ ▶
多店帳號（企業管理員）管理多家門店，登入後需選擇要操作的門店。臨時 Token 有效期 15 分鐘，超時需重新登入。
候位過號後會怎樣？ ▶
過號的號碼會暫時移出等候佇列。可使用「還原」功能將其重新加入等候。若過號次數達到上限（可在候位設定中配置），將自動取消。
如何讓顧客收到 LINE 通知而不是簡訊？ ▶
顧客需要透過 LINE LIFF 綁定帳號。綁定後系統會自動優先使用 LINE 推播，只有未綁定或取消關注的顧客才會收到 SMS 簡訊。
可以設定大桌不開放線上訂位嗎？ ▶
可以！在「人數規則」設定中，可以為不同人數範圍設定是否允許線上訂位。例如設定 5 人以上需電話預約（allowOnline: false）。
桌位圖可以多人同時編輯嗎？ ▶
可以！桌位圖支援即時協作。當 A 裝置移動桌位時，B 裝置會即時看到變化。系統透過 WebSocket 廣播桌位的移動、縮放、旋轉操作。

名詞對照表

名詞 說明
餐期一天中的用餐時段（如午餐、晚餐），需開啟才能接受候位
候位/取號顧客到店後排隊等候座位的機制
訂位顧客提前預約特定日期時段的用餐
OTP一次性密碼（One-Time Password），用於驗證手機號碼
KIOSK自助取號機，通常是放在門口的平板設備
候位看板顯示叫號狀態的螢幕（Display）
桌型依人數分類的桌位類型（大桌/中桌/小桌）
叫號通知候位顧客準備入座
過號顧客未回應叫號，暫時跳過
No-show已預約但未到場的顧客
LIFFLINE Front-end Framework，在 LINE 內開啟網頁的技術
CRMCustomer Relationship Management，顧客關係管理
歸戶將顧客的訂位/候位資料自動關聯到會員帳號