派工單範本

派工單 = 服務後的內部紀錄表。每筆預約做完，由設計師自己用 LINE 打開 LIFF 填寫，記錄客戶狀況、用料、技術細節，累積成顧客檔案供下次參考。

完整流程

[路徑 A] 顧客預約 → 店員 POS 結帳 → 系統自動建工單 → push LINE 給設計師
[路徑 B] POS 臨時開單（無預約，但指定設計師）→ 結帳 → 系統自動建工單 → push LINE 給設計師
   → 設計師 LINE 內點開連結 → 填表（系統欄位自動帶入）→ 完成

1. 顧客做完服務：店員在 POS 開單結帳（/pos/beauty/checkout 或結桌帳）
2. 系統自動建工單：結帳完成的同時，依該服務綁定的範本建一張 pending 派工單

- 有對應預約 → 工單綁 reservation_id，5 個系統欄位從 reservation 帶入 - 無預約但有指定設計師 → 工單綁 pos_order_id，欄位從 pos_order + 第一個品項帶入 - 沒指定設計師的散客快結單 → 不建工單（沒人可派）

1. 推播設計師：staff.line_id 收到 LINE 文字「{客戶} 已結帳完成，請填寫派工單：{LIFF URL}」
2. 設計師打開 LIFF：自動帶入 LINE 內，看到「派工單列表」（也可從會員中心派工單 進入）
3. 填寫：5 個系統欄位已自動帶入鎖定；剩下自填欄位填完按「✓ 完成派工單」

範本編輯（後台）

進 美業預約 → 派工單 / 範本 → 切「範本管理」tab → 新增範本

兩種欄位類型

範本欄位分兩類，從兩個下拉按鈕新增：

+ 加自動帶入欄位（綠色）

從 5 個固定選項任選（每個只能加一次）：

加入後：

• 設計師打開派工單時自動帶入最新值 + 灰底唯讀
• 無法修改（避免設計師誤改客戶資料 / 跟預約紀錄不一致）
• 預設「必填」
• 欄位的 key、type、label 都由系統管，後台不顯示也不可改

+ 加設計師填寫欄位（紫色）

選 6 種類型任一：

• 單行文字 — 短文字輸入
• 多行文字 — 長段文字（如服務備註）
• 數字 — 數值輸入
• 日期 — 日期 picker
• 下拉選單 — 預設選項擇一
• 勾選框 — 是/否

每個欄位設定：

• 題目名稱（中文，必填）：如「使用染劑色號」「冰量」「肌膚敏感情況」
• 必填：是否強制填
• 提示文字（選填）：input placeholder
• 下拉選項（type=select 才有）：手動加每個選項

提示：題目名稱填好按儲存即可 — 系統會自動產生唯一識別碼（如 field_kx9z2p）。不需理會也不會顯示「key」這個程式概念。

關聯服務

範本建好後，到 服務項目 編輯任一服務 → 派工單範本欄選擇剛建的範本。當訂單包含該服務項目時，系統自動以該範本產生派工單。一筆預約一張派工單（即使多項目也只一張）。

多服務共用一張範本：建議直接綁同一個範本到所有服務，系統會自動沿用。例如某美業租戶全部服務項目都用同一張「通用派工單」範本。

設計師看到的填寫畫面

當服務員 LINE 收到推播打開派工單填寫頁，會看到：

[自動帶入區（綠色邊框，灰底唯讀）]
客戶姓名:    王小華（自動）
客戶電話:    0912345678（自動）
服務日期:    2026-06-15（自動）
服務人員:    張設計師（自動）

[設計師填寫區（白底可編輯）]
今日皮膚狀況 *：____________ （必填，多行文字）
使用染劑色號：____________
頭髮受損程度：[輕度▾]
過敏反應：____________

底部「✓ 完成派工單」+「暫存（不完成）」兩鈕。

設計師如何進入

兩種入口：

A. 結帳推播後直接點 LINE 連結（最快）— 訊息附帶 LIFF URL，直接 jump 到該筆工單

B. 會員中心 → 派工單（設計師身份才會顯示按鈕）— 進入派工單列表頁，可：

• 狀態過濾：全部 / 待填寫 / 已完成
• 日期過濾（只對「已完成」生效）：起始日 / 結束日 picker（預設近 7 天）

- 「待填寫」一律全顯示不分日期 — 避免未來預約已建單但設計師看不到的情境（如先收結帳款）

• 卡片顯示：訂單編號 / 客戶姓名 / 電話 / 服務 / 預約時間 / 狀態 chip
• 點卡片進填寫頁

注意：要有 LIFF 派工單入口，該 LINE 帳號的 user_id 必須綁到 `beauty_staff.line_id`。後台「服務人員」頁可手動填，或會員首次與 staff 同手機自動匹配（記憶提到 [reference_staff_line_backfill]）。沒綁的設計師看不到會員中心的派工單按鈕。

完成後

• status 從 pending 變 completed
• completed_at 寫入時間
• lock_after_days 設定內仍可編輯（預設 7 天，於 beauty_settings.work_order_config）
• 後台 派工單列表 顯示已完成 + 設計師填的所有內容
• 點開 modal 看 form_data 內容（含自填欄位）
• 可從顧客檔案查看該顧客的歷史派工單（累積服務記錄）

兩種建議範本（內建可參考）

通用美容類（多家美業租戶在用）

• 客戶姓名 / 電話 / 日期 / 設計師
• 服務內容說明（多行）
• 客戶狀況問題說明（多行）
• 先前是否客訴過（勾選）
• 客訴處理人 / 經過（多行）
• 難處理客戶 · 注意事項（多行）

美髮類

• 客戶姓名 / 電話 / 日期 / 設計師
• 使用染劑品牌與色號（單行）
• 停留時間（數字，分鐘）
• 頭髮受損程度（下拉：輕度/中度/嚴重）
• 建議回補時間（單行）
• 顧客備註（多行）

接睫毛類

• 客戶姓名 / 電話 / 日期 / 設計師
• 膠水品牌（下拉）
• 睫毛款式（下拉：濃密/自然/混合）
• 彎度（下拉：J/B/C/D）
• 根數（數字）
• 過敏史（多行）

常見問答

Q1　設計師沒填派工單會怎樣？

訂單可以完成、客人仍可結帳，派工單保持「待填寫」狀態。後台主管可在「派工單列表」filter pending 看誰沒填。建議跟設計師約 SOP「每張單必填」+ 主管查核。

Q2　一個服務可以對應多個派工單範本嗎？

不行，1 對 1。同服務有不同情境（短髮 vs 長髮）建議拆成兩個服務項目，分別綁不同範本。

Q3　客戶可以看到派工單內容嗎？

不可。派工單純後台內部記錄。客戶端不顯示任何派工單。要讓客戶看細節請透過訂單備註或 LINE 訊息手動說明。

Q4　完成的派工單可以改嗎？

完成日起 7 天內可編輯（lock_after_days 預設 7，在 beauty_settings.work_order_config 調）。超過鎖死。

Q5　設計師沒看到「派工單」按鈕？

該 LINE 帳號還沒綁到 beauty_staff.line_id。請進「服務人員」頁手動把該 staff 的 line_id 設好（從會員列表找到該人的 LINE UID 複製過去），或讓該設計師用註冊手機在 LIFF 簽到自動匹配。

Q6　散客 POS 結帳沒綁預約，會建派工單嗎？

有指定設計師就會建（2026-06-16 起）。

• POS 開單時下拉選了「服務人員」→ 結帳完成同時建一張綁 pos_order_id 的派工單 + 推 LINE
• 沒指定設計師（純散客快結） → 沒人可派工，不建工單
• LIFF 顯示時，客戶姓名/電話/服務名稱會自動從 pos_order + 第一個品項帶入（取代 reservation 來源）

Q7　範本欄位 key 在哪？為什麼看不到？

系統自動管理。自動帶入欄位用固定 key（customer_name / customer_phone / service_date / service_staff / service_name）對應 reservation 資料；設計師填寫欄位用隨機 field_<random> 確保唯一。後台不顯示也不可改 — 你只需要設「題目名稱」（中文 label），系統幫你產 key。