Hoochuu Multistore · Phase1 Expense Station

好初多店餐飲管理系統

北極星:店長只負責輸入,系統用廠商主檔自動分類,月損益先誠實預覽、不假裝已關帳。

Phase0

Next.js/TS 骨架、SoT docs、Supabase schema/RLS draft、Zeabur skeleton。

Phase1 花費站

店長輸入花費,已知廠商自動分類;未知廠商先進未分類佇列,不阻擋輸入。

Safety

本分支只提供 repo artifacts/API contracts/UI skeleton;不 apply production migration、不匯入正式 vendor seed。

Expense entry flow

花費輸入:不要求店員選會計科目

店員只填日期、廠商、金額、來源與備註;系統用 canonical name + aliases 自動比對 vendor master,店員不選會計科目。

Phase1.5 預設 fixture mode 固定示範中山店;日期用於月損益預覽歸屬。
已知廠商會自動分類;未知廠商仍可送出,標示「未分類待中央維護」。
只輸入花費金額;分類由 vendor master 決定。
廠商輸入樂清
分類狀態已自動分類
自動科目清潔用品
金額1,280
廠商輸入福農 食品
分類狀態已自動分類
自動科目食材進貨
金額5,320
廠商輸入新廠商臨時採買
分類狀態未分類待中央維護
自動科目
金額900

Central vendor maintenance

未分類廠商處理

中央人員把未知寫法對到既有 canonical vendor,並存成 alias;下一筆同寫法會自動分類。預設 fixture mode 不寫正式資料庫;Supabase mode 需 RLS/release gate。

Seed gate:Phase1.5 只提供 API/persistence handoff;正式 vendor v2 seed import / production migration apply 需後續 Matt decision。

Monthly P&L preview

月損益預覽骨架

  • 清潔用品1,280
  • 食材進貨5,320
  • 未分類花費(需中央維護廠商主檔)900

Phase1 月損益預覽只用於檢查分類與缺漏;尚未包含所有營收、薪資、盤點、外送對帳與關帳檢核,因此不是正式 finalized report。

7 條硬規則

  1. 沿用巡店既有 Supabase Auth;不得新建 Supabase/Auth。
  2. Repo、文件、Notion、聊天不得保存 secrets 或 raw transcripts。
  3. 權限以 DB/RLS 執法;UI/PIN 不是安全邊界。
  4. 店長只輸入、不整理;報表自動生成。
  5. POS/iCHEF 營收由 server-side 匯入,不由店員手 key。
  6. 個人薪資明細 Matt-only;店長只看彙總結果。
  7. vendor v2 只接受 final 94-row 檔與 aliases;未知先未分類。