昇昇咖啡訂位系統
客人訂完就走，店裡不用追 LINE 截圖對帳到天亮。
為台灣餐飲業設計的 包廂訂位 + LINE 訂金 + 後台營運 平台。
服務昇昇咖啡（大安店）日常營運，架構可擴至多分店。
線上網址： https://sunrise-cafe-six.vercel.app
目錄
為什麼需要這套系統
多數小型餐廳的訂位仍靠 LINE 私訊 + 手寫登記 + 截圖對帳：
- 客人問「還有包廂嗎？」店員要翻聊天紀錄、對照滿房表
- 訂金截圖散落在群組，誰付過、誰沒付，要靠人工記憶
- 逾期未付的訂位不敢釋放，怕得罪客人；放了又怕雙重訂位
- 候補客人要靠店員手動通知，常常錯過黃金時間
昇昇系統把這些變成可預測的流程——客人自助訂位、系統追訂金、逾期自動釋放、候補自動通知；店員在後台審核、確認、看 KPI，而不是在 LINE 裡當人肉資料庫。
它是怎麼運作的
客人訂位 → 系統鎖檔 → LINE 收訂金 → 店員審核 → 營運數據回流。
- 客人在網站選分店、包廂、時段，送出訂位
- 後台確認後，客人 Bot 推送訂金請求；群組 Bot 通知店內有新單
- 客人回傳付款截圖或關鍵字 → 進入審核佇列（或符合規則時自動標記）
- 訂金逾期 → Cron 自動釋放名額 → 觸發候補通知
- 每日 20:00（台灣）→ 群組收到明日訂位清單
- Executive Dashboard 彙整訂金率、審核 SLA、部署健康——用數據決策，不靠感覺
工程面還有一層 AI Engineering Orchestrator：任務牆排序下一項工作、自主迴圈在 GitHub 上持續合併改進、失敗時寫入學習紀錄而非原地打轉。（見 工程自主運轉）
核心能力
1. 客人端體驗
- 選分店 / 包廂 / 日期時段，線上預約包廂（手機優先、繁中/英文）
- 以電話查詢訂位、24 小時前可取消
- LINE Login 綁定，接收訂金請求與提醒
- 自助點餐（QR 桌位牌掃碼進入）
2. 店員後台
- 訂位列表：確認、取消、發送 LINE 訂金通知
- 儀表板：今日統計、可用包廂、時間軸視圖
- 付款審核：截圖審核、SLA 追蹤（
/admin/payments）
- 多分店、包廂、菜單、點餐訂單管理
- Executive Dashboard
/admin/executive：North Star KPI、營運風險、工程任務牆
3. 營運自動化
- 每日 20:00 台灣時間 推播明日訂位至 LINE 群組（多分店各自推播）
- 訂金逾期自動釋放 + 候補通知（期限 = min(建立後 24h, 訂位開始時間)）
- 付款截圖 →
payment_events 審核工作流 → 群組/客人通知
- Cron 健康、部署 SHA parity、migration 狀態——Executive API 即時可查
4. 工程自主運轉
借鑑 AI-company 任務牆 / 失敗煉金 / 停滯偵測概念，以 bash + GitHub Actions 落地（無額外 Python 後端）：
| 機制 | 說明 | 入口 |
|---|
| Task Wall | 評分排序下一項可執行工程任務 | npm run cto:task-wall · GET /api/admin/orchestrator |
| Autonomous Loop | 每日無人值守迭代：選任務 → 實作 → PR → 合併 | .github/workflows/autonomous-loop.yml |
| Failure Alchemy | CI/驗證失敗時寫入防禦規則與案例 | orchestrator/failure-learnings.jsonl |
| Stall Check | 72h 無迭代、PR 卡住、重複失敗時告警 | npm run cto:stall-check |
| Governance Gate | 生產穩定 / GitHub 衛生未過則優先治理任務 | npm run cto:governance |
完整對照與採用決策：docs/internal/automation/AI_COMPANY_ADOPTION.md
工程 SSOT：docs/internal/automation/ORCHESTRATOR.md
系統架構
產品層（客人與店員）
┌─────────────────────────────────────────────────────────────┐
│ 客人瀏覽器 / LINE App 店員瀏覽器 / Admin │
│ │ │ │
│ └──────────────┬───────────────┘ │
│ │ HTTPS │
│ ┌──────▼──────┐ │
│ │ Vercel │ Next.js 15 App Router │
│ │ Serverless │ /book · /order · /admin │
│ │ + Cron Jobs │ /api/* · RBAC session │
│ └──────┬──────┘ │
│ ┌───────────┼────────────┐ │
│ ▼ ▼ ▼ │
│ Supabase LINE API Sentry / Upstash │
│ PostgreSQL 雙 Bot 架構 監控 / Rate limit │
│ │
│ 店內電腦 ── print-bridge (Node.js) ── 熱感印表機 │
└─────────────────────────────────────────────────────────────┘
工程層（持續改進）
┌─────────────────────────────────────────────────────────────┐
│ CTO Orchestrator (bash + JSON SSOT) │
│ discover → prioritize → plan → execute → verify → record │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ task-catalog task-wall.json autonomous-loop.yml │
│ priority.json stall.json GitHub PR / merge │
│ failure-learnings.jsonl │
│ │ │
│ ▼ │
│ /admin/executive · GET /api/admin/orchestrator │
└─────────────────────────────────────────────────────────────┘
技術棧
| 層 | 技術 |
|---|
| Frontend / Backend | Next.js 15 App Router, TypeScript, Tailwind CSS |
| Database | Supabase (PostgreSQL + Realtime) |
| 部署 | Vercel（含 Cron Job） |
| 通知 | LINE Messaging API（群組 Bot + 客人 Bot，見 docs/LINE.md） |
| 列印 | print-bridge（店內本機 Node.js，不部署 Vercel） |
| 觀測 | Sentry · structured ops-log · Executive outcome API |
模組與路由詳解：docs/ARCHITECTURE.md
與其他做法的差異
| 面向 | LINE 人工 + 表格 | 通用訂位 SaaS | 昇昇系統 |
|---|
| 台灣 LINE 訂金 | 截圖散落群組 | 多半不支援或需另接金流 | 雙 Bot + 審核佇列 + 話術資料庫驅動 |
| 逾期釋放 | 店員不敢放 | 固定規則，難客製 | min(24h, 訂位開始) + 候補自動通知 |
| 多分店 | 每店一套群組 | 常見但 LINE 整合弱 | branches.line_group_id 各自推播 |
| 後台 KPI | 無 | 報表偏銷售 | Executive：訂金率、審核 SLA、部署/migration |
| 工程演進 | 外包一次交件 | 平台方 roadmap | 自主 orchestrator + task wall + GHA loop |
| 資料主權 | 分散在聊天室 | 平台託管 | 自架 Supabase + 可 fork 擴展 |
產品定位與路線圖：docs/PRODUCT.md · docs/ROADMAP.md
快速開始
環境需求
- Node.js 20+
- npm
- Supabase 專案（見
docs/ENV.md）
- LINE Developers 兩組 Channel（群組 + 客人）
本機開發
git clone https://github.com/jerry200176-png/sunrise-cafe.git
cd sunrise-cafe
cp .env.local.example .env.local # 填入 Supabase / LINE 等變數
npm install
npm run dev
# → http://localhost:3000
工程指揮（可選）
npm run cto:orchestrator # 發現信號 → 排序任務 → 產出 ORCHESTRATOR_PLAN.md
npm run cto:task-wall # 更新任務牆 JSON
npm run cto:governance # 治理 gate（PASS 才能衝功能）
npm run cto:outcomes # 擷取 Executive KPI 快照
測試與品質
npm test # Vitest 單元測試（180+）
npm run lint # ESLint
npm run design:audit # Anti-AI-slop 掃描（Hallmark-inspired）
npm run verify:migrations # DB migration 一致性
npm run build && npm run test:e2e # Playwright E2E
設計規範（觸控目標、safe-area、Warm Artisan 視覺）：DESIGN.md
CI/CD 與部署
| 階段 | 說明 |
|---|
| PR | Lint → Unit tests → Migration verify → Build → Playwright |
Merge main | Vercel production deploy |
| Post-deploy | verify-production 比對 /api/version SHA |
| 每日 | autonomous-loop.yml 自主工程迭代（bounded） |
| 每日 | orchestrator.yml 心跳 + plan artifact |
vercel --prod # 手動部署（見 docs/RUNBOOK.md）
環境變數：docs/ENV.md · 初次部署：docs/DEPLOYMENT.md
維運手冊
文件索引
產品與架構（公開）
工程與自主運轉（內部）
安全
- Admin session 驗證 + RBAC（
owner / branch_manager / staff / finance）
- Rate limiting（Upstash；未設定時 fail-open）
- Sentry 錯誤追蹤
- 漏洞回報：
SECURITY.md
授權
私人專案 · 昇昇咖啡
