# Tablee

> Tablee 是專為中小型餐廳打造的雲端餐飲管理 SaaS。整合 QR Code 掃碼點餐、訂位管理、廚房出餐追蹤、桌位結帳，只要一台 iPad 就能營運整間餐廳。消費者用自己的手機掃桌上 QR 即可點餐，不需下載任何 App。

Tablee is a cloud-based restaurant management SaaS for small-to-medium restaurants. It bundles QR-code ordering, reservations, kitchen ticket tracking, and table checkout — one iPad is enough to run a whole restaurant. Guests scan a table QR with their own phone, no app download needed.

- 官方網址 / Official URL: https://restaurant.taiwan-fan.com/
- 產品類型 / Category: Restaurant SaaS (BusinessApplication → RestaurantManagement)
- 支援語言 / Languages: 繁體中文 (zh-Hant) / English (en)
- 基礎架構 / Infrastructure: Cloudflare Workers + D1 + KV
- 狀態 / Status: Production (demo 環境公開可用)

## 核心產品頁 / Main pages

- [首頁 / Home](https://restaurant.taiwan-fan.com/): 產品介紹、核心功能、入座到買單六個節點
- [即時互動 Demo / Live Demo](https://restaurant.taiwan-fan.com/demo-live.html): 現場體驗 QR 點餐與廚房流程
- [產品導覽 / Product Guide](https://restaurant.taiwan-fan.com/pitch.html): 完整產品手冊式介紹
- [靜態 Demo / Static Demo](https://restaurant.taiwan-fan.com/demo.html): 畫面截圖與流程說明

## 功能入口 / Feature entry points

- [業者登入 / Owner login](https://restaurant.taiwan-fan.com/app.html#/auth): 餐廳業者與員工入口
- [訂位 Demo / Booking demo](https://restaurant.taiwan-fan.com/app.html#/booking): 消費者訂位流程
- [常見問題 / FAQ](https://restaurant.taiwan-fan.com/#faq): 16 題常見問題（申請審核、設備操作、QR 點餐流程、菜單設定）

## 核心功能 / Core features

- **QR Code 掃碼點餐** — 同桌多人共用訂單，各自加點，一次結帳。消費者無需下載 App。
- **線上訂位** — 支援消費者線上訂位與後台訂位管理。
- **廚房出餐五階段狀態機** — pending → preparing → cooking → ready → served
- **桌位管理** — 空桌／用餐中／清潔中／預訂中四種狀態
- **多語言菜單** — 繁中／英雙語同時維護，消費者自動切換
- **桌邊 Session 安全機制** — UUID token 綁定桌位，自動 4 小時過期
- **多人共桌** — device_id 區分點餐人，合併為單一結帳
- **OAuth 登入** — Google / LINE（Facebook 待審）

## 技術 / Tech stack

- Backend: Cloudflare Workers + Hono + D1 (SQLite) + KV
- Frontend: Alpine.js + Tailwind CSS + 靜態 HTML（無 build step）
- Auth: JWT 雙 token（access 15min + refresh 7 day）
- OAuth: Google, LINE, Facebook
- Email: Resend
- CDN: Cloudflare R2 for images

## 常見問題摘要 / FAQ Summary

- 怎麼申請？→ 前往 app.html 點「我是業者，立即開店」，5 分鐘完成，審核 1–3 個工作天
- QR 點餐流程 → 入座開桌 → 客人掃碼 → 廚房接單（五階段） → 外場結帳關桌
- 設備 → 任何 Chrome/Safari 裝置即可；消費者無需下載 App
- 多人同桌 → 掃同一張 QR，系統自動合單，一次結帳
- 免費？→ 目前免費方案完整開放，付費進階方案上線前均免費
- QR 需要換嗎？→ 不用，每桌 QR 長期固定，結帳後舊 session 自動失效

## 外部引用 / External references

- [iT邦幫忙技術文章](https://ithelp.ithome.com.tw/articles/10399748): Tablee 技術選型與實作心得（Cloudflare Workers + D1 + Alpine.js）
- [方格子技術文章](https://vocus.cc/article/69e5aba2fd89780001ae2df9): Tablee 技術選型與實作心得（繁體中文）

## Optional

- [完整內容 / Full content](https://restaurant.taiwan-fan.com/llms-full.txt): 包含所有 FAQ、完整功能細節、使用場景
- [Sitemap](https://restaurant.taiwan-fan.com/sitemap.xml)
- [robots.txt](https://restaurant.taiwan-fan.com/robots.txt)