+ 新增品項
在這裡新增菜單。名稱、分類、價格填好按「新增品項」,前台立刻看得到。公關價預設 0 元(招待用);要收多少自己填,留空也是 0 元。所屬分類設過規格範本時,新品項會自動帶入。
若這台電腦之前存過舊菜單、還看到「公關 30 元」,按右邊這顆一次歸零(要連按兩次)。定價、規格、加料都不會被改到。
菜單(可修改/刪除)
直接改格子裡的字或價格,按該列「存檔」。按「加料與規格」可管理這個品項的加料與規格選項。刪除要連按兩次。
加料與規格選項(單項微調)
整批套用後,若某一項要例外,在上面「菜單」表格按該列的「加料與規格」,這裡就會出現可以新增/改/刪的加料與規格。整類一起改請到「2 規格範本」。
一次套用到一整個分類
飲料每一項都要「冰熱/甜度」?選分類 → 勾範本 → 按一次就全部設好,不用一項一項改。換到別的分類再按一次,就能比照辦理。套用後仍可在「1 菜單管理」單獨微調某一項。
① 選分類
② 勾常用範本(可複選,再點一次取消)
這些範本來自下面「範本管理」,可以自己新增、改名、改選項或刪除,不是寫死的。
③ 自己加規格或加料(可略過)
④ 待套用清單
範本管理(自己新增/修改/刪除/改加價)
上面「② 勾常用範本」的按鈕就是從這裡來的。每一個選項都能填加價(元):規格可填負數(例如小杯 −5 元),加料不能為負。改完按該張卡的「存檔」,上面按鈕與套用結果會立刻更新。刪掉範本不會動到已經套用到品項的規格。
+ 新增一個範本
現有範本(逐項改名字與加價)
分類管理
可新增分類、改名字、刪除沒有品項的分類。
前台折扣選項
前台「這一單 → 優惠」會出現這些折數。可自行增減,例如加 75 折。
接單方式
自動:新單直接接,不怕年長店員漏按。手動:出現大字「接單」與倒數,時間到仍會自動接單,避免被平台取消。
帳號與 PIN
出廠帳號:店長 boss(PIN 0000)、店員 clerk(PIN 1234)。 第一次使用請把 PIN 改掉——改過之後,登入畫面就不再提示預設密碼。
外送平台 / Telegram 串接設定
本版只收錄憑證,不實際呼叫 API(屬 Phase 2)。欄位只存在這台平板的 localStorage;正式雲端版才會用這組設定接單與推播。密碼欄位存檔後只顯示「已儲存」,不會把明文放回畫面。
Uber Eats
foodpanda
Telegram 群組推播(看廚單)
開啟後,正式版會把每張新單推到這個 TG 群組做看廚單。本版不實際推播,只存憑證與開關。
示範資料導覽(給測試用)
第一次開啟會自動放 10 筆今日示範單,不用先自己點一輪。
- 待做佇列已有單可點:已接單、備餐中、做好了,還有一張 熊貓待接單(點下去可測接單)。
- 前台「模擬 Uber 新單」→ 自動接單;「模擬熊貓新單」→ 手動接單+30 秒倒數。
- 示範單含 招待(公關價 0 元)與 9 折,今日報表看得到讓利。
- 菜單裡「咖啡」已設為賣完了,前台看得到灰色卡片。
玩亂了按右上「回復示範資料」重來;要測試乾淨開機流程按「清空成空白」。兩顆都要連按兩次確認。
期間報表(日/週/月/季/年)
選「看哪一天」+週期,看該期營收、讓利、折扣、取消與各來源。依店內時間 UTC+8 切期。
區間查帳
選起訖日期查帳,現金/非現金分開算,並列出各來源營收。留空表示全部。可導出對帳單 CSV,或按「PDF」開列印後在目的地選「另存為 PDF」。
銷售排行榜
同一個區間內,依品項彙總「賣幾份、營收多少」,營收高到低。
本機狀態
使用說明與本版範圍
啟動(最簡單):在專案目錄雙擊 啟動POS.bat,會自動開 Chrome 到 http://127.0.0.1:8787/。那個黑色視窗要留著,關掉就等於關閉本機伺服器。
手動啟動:在 C:\Users\zfstr\WorkBuddy\POS自研 執行 node serve.mjs(或 npm start);不想自動開瀏覽器就設 POS_NO_BROWSER=1。測試用 npm test。
為什麼不能直接雙擊 HTML:前台用瀏覽器原生 ES 模組,file:// 會被瀏覽器安全規則擋下,一定要走本機 http://。
後台五個分頁:1 菜單管理(新增/改價/單項加料規格)、2 規格範本(整批套用/範本增改刪)、3 分類與設定、4 報表資料、5 使用說明。
本版可以做:
- 現場客(內用/外帶)點餐:分類 → 規格 → 加料 → 備註 → 結帳找零
- 「這一單」與「待做」一列一項直式排列、編號 1 2 3 4、顯示共幾項,放不下用下一頁,不捲動
- 公關價(單項或全單,預設 0 元=招待)、打折/折讓金額,兩者可疊加並分開記帳
- 客人取消:選白話原因 → 再確認 → 不算營收、日報可查取消筆數
- 後台新增/改/刪品項、分類、加料、規格選項,可改定價與公關價
- 規格範本自己管:新增/改名/改選項/刪除/回復出廠,不再寫死
- 整批套用分類規格:一次套到整個分類,新增品項自動帶入,也可沿用別的分類設定
- 待做訂單佇列、狀態推進、廚單預覽與列印(瀏覽器列印成 80mm)
- 廚房看板(看廚單)獨立畫面:店內另一台螢幕開
kitchen.html即時顯示待做;TG 群組憑證先收錄在「分類與設定」(推播屬正式版) - 模擬 Uber Eats / foodpanda 新單,自動/手動接單與倒數兜底
- 國語語音播報、大字三檔、滿版分頁自適應、訓練模式、上一步/復原
本版刻意不做(需要憑證或雲端,屬 Phase 2):
- 真實外送平台 API、簽章驗證、狀態回推、售罄回推
- Telegram 群組實際推播(憑證已可於後台收錄,正式雲端版才推播)、真印表機 ESC/POS、錢箱、電子發票(本版已有店內廚房看板畫面)
- 雲端 D1、Queues、多人多機、帳號權限(正式版取消需店長權限)
資料:全部存在這台瀏覽器的 localStorage,不上傳、不連外部服務。第一次開啟自動載入示範資料;「回復示範資料」重來、「清空成空白」只留菜單,兩者都需連按兩次確認。換瀏覽器或改埠號會是另一份資料。