Specs — 等老闆 review 的設計提案

老闆 dogfood 截圖薪資 tab 紅屏 + 多欄位沒對齊 POS 觸發完整 audit。5 大問題:(1)薪資 tab 邏輯空殼,DB schema 有 base_salary/pay_grade/labor_insurance 全沒用;(2)公休判定還讀 deprecated business_hours,沒對齊 POS reservation_slots;(3) 4 層架構 0% 覆蓋率(13 個 feature 0 Gate/0 Orchestrator/0 Repo);(4)打賞設定沒 gate restaurant_settings.tip_system_enabled;(5) 多個 schema mismatch(floor_zones.target_hours 不存在 / employee_id vs user_profile_id 混用 / 100m geofence hardcode)。P0~P3 優先級表 ~144h + 7 個老闆決策題。

老闆 2026-05-25 抓到根因:「關帳補記帳 + AdHoc 即時記帳」雙軌制造成 source_marker hack + cashRefunds 反推 + AdHoc UI bug 一連串。提案改成業界標準 event-sourced ledger(Square / Toast / R365 / Stripe 都這套)。完整 audit 現有 code(現金即時記 / 電子付款根本沒記 / 退款根本沒記 / 關帳 sum 一筆)+ 業界 research(per-tender mapping / clearing account / T+2 payout 對帳)+ 12 phase plan(~15-17 天)+ 6 個老闆決策題待答。

老闆 2026-05-25 同日問 + 同日答完 7 問。確定:(1) 3 個進入點(結帳 / 菜單 / 桌邊主頁面新增打賞員工 icon) (2) 老闆只看次數不看金額 (3) 預設金額 100/200/500 + 可自填 (4) 留言選填(鼓勵員工用) (5) 不做整桌均分 (6) 客人選打賞員工頁顯示所有員工含老闆,員工在 StaffsMate 填自我介紹 + 拍頭貼 + 工作崗位 + 職稱 (7) 方案 B(餐廳代收)做備援選項。完整 DB schema + 9 Phase plan(~13 天 + 備援 +3 天)。

老闆 2026-05-20 audit 完跨 App 權限後問:「總部+區經理多出什麼?推測還能用?中央廚房?接 AI?」答案。涵蓋 (1) 3 層 RBAC + group_members.restaurant_scope[] (2) HQ 6 大功能 + 6 個推測沒人想到的 (3) 區經理巡店 + 區目標 (4) 中央廚房 schema + 內部轉撥計帳 (5) 開分店顧問 AI(5 維 readiness,業界沒人做)(6) V2→V3 升級 + tactic_plans 加 restaurant_id 修設計債 (7) BYOA Provider Adapter(OpenAI/Anthropic/Gemini/Azure/Bedrock)(8) Multi/Group/Enterprise 訂閱 (9) 12 個月 6 phases。

老闆問「v1 好嗎?有更好的?業界怎麼做?」誠實 audit v1 過度工程 30-40%。v2 簡化成 2 層架構(Anthropic Tool Use + Zod + Vercel AI SDK Generative UI)。對標 Tableau Pulse / Snowflake Cortex Analyst / Hex Magic / Hashboard(不是 NotebookLM)。8 篇必讀業界文章。MVP 1-2 週可出。

老闆原話「資料整理層 → AI 回覆整理層 → UI 動態渲染」三層架構。涵蓋 12 個 Widget library(限 AI 不亂畫)、4 階段冷啟動 fallback(industry default → SMA-7 → Ridge → YoY)、bronze/silver/gold 信任分 tier、完整 end-to-end 範例(老闆問「明天天氣影響訂位嗎」7 步)、5 Phase roadmap、6 個給老闆的 confirm 問題。

老闆 dogfood 觸發:「整個 codebase 看一看上 production 要做的事情」。6 大類 / 30 切換點:藍新 / ezPay / TapPay / APNs / Wallet cert / OAuth / Stripe / hardcoded URLs / iOS app。標 critical / high / medium 嚴重度 + smoke test 步驟。

dogfood 5/18 觸發:「圖二的按鈕應該照時序排列…audit 一下所有的按鈕」。7 個 button group(pending/confirmed/arrived/取消待確認/修改/訂金/通用守則)的 before/after 示意圖。Phase A-D 實作計劃。

現狀:同意退款只是「假退款」,完全沒呼叫藍新 → 客人卡沒收到錢。3 個 Option(A 自動藍新 / B 手動 ATM / C 兩條 path 分流)

老闆 wish:接出單機 / 收銀機。POS 目前 0 硬體 integration。5 Phase Plan(Phase 1 MVP 2-3 週)。需老闆採購 EPSON TM-m30III (NT$10K) + 回 5 問題。

老闆 wish:LINE OA + AI 解析訂位 + chat 整合。3 個 Option(A 純 LINE / B 雙系統 / C 純訂位 entry)。MVP 2-3 週,完整 5-7 週。Claude Haiku 月成本 NT$5。