連線與員工登入
僅使用 Project URL 和 Publishable key。不要輸入 Secret / service_role key。管理員可維護客戶、商品及批價；正式訂單只能經過安全 RPC 建立；取消、入庫及出貨均透過安全 RPC；請先使用測試資料驗證。
管理中心
此頁讀取的是 Supabase 真實資料；資料表若為空，會顯示空表，不會偷偷帶入示範客戶或訂單。一般員工是否可寫入，仍由 RLS 政策決定，不依賴畫面隱藏按鈕。
雲端資料概況
營運儀表板 v8
統計僅依目前登入帳號有權讀取、且每張表最多 500 筆的資料計算；不是全公司完整報表。銷售額以 completed 訂單的明細單價 × 數量計算，不包含運費、折扣、退款或成本。若資料超過載入上限，請勿用此頁數字結帳。
銷售與庫存概覽
熱銷商品（已完成訂單）
| 商品 | 售出件數 | 銷售金額 |
|---|
庫存與預購提醒
| 商品 | 現貨 | 已保留 | 可用 | 等待預購 |
|---|
訂單查詢與客戶歷史 v8
| 訂單編號 | 建立時間 | 客戶 | 狀態 | 品項／數量 | 訂單金額 |
|---|
歷史訂單的「已分配」表示該訂單當時獲配現貨的件數，並非目前仍佔用的商品庫存；目前庫存請查看商品資料。
客戶管理與交易紀錄 v14
可查詢客戶聯絡資料與歷史訂單。統計僅依目前帳號可讀取的資料計算（每張表最多 500 筆），不代表完整帳務；交易金額僅計算 completed 訂單的商品數量 × 單價，不含運費、折扣、退款及成本。客戶新增／修改請使用下方管理員編輯區。
客戶歷史訂單
| 訂單編號 | 建立時間（台灣） | 訂單狀態 | 商品與數量 | 商品總件數 | 訂單金額 | 物流狀態 |
|---|---|---|---|---|---|---|
| 請先選擇客戶 | ||||||
提醒：已取消訂單不列入完成交易額；所有歷史訂單仍會列出。客戶資料與訂單資料由 Supabase 讀取，不會自動新增分級或客戶專屬價格。
訂單物流管理 v11
選擇訂單後，可讀取及儲存收件人、電話、地址、物流商、追蹤碼、物流狀態與備註。按「儲存物流資料」會呼叫 Supabase 的 chuanxu_update_shipping RPC，真正修改訂單物流欄位；不會自動出貨、扣庫存或更改訂單完成狀態。請先用測試訂單確認權限及結果。
物流狀態顯示中文，儲存時使用資料庫代碼；只有管理員可透過 RPC 更新。標記已出貨、運送中或已送達時，請先填寫物流商及追蹤碼。
物流追蹤與出貨提醒 v12.1
依目前帳號可讀取的訂單顯示物流進度、出貨與送達時間。物流狀態更新使用現有 chuanxu_update_shipping RPC，不會扣庫存、正式出貨或變更訂單完成狀態。物流時間軸只顯示目前狀態，並非完整歷史紀錄；每表最多載入 500 筆。
請從中文選單選擇物流狀態；系統會傳送對應英文代碼給資料庫。已出貨、運送中、已送達需先在「物流資料編輯」填妥物流商與追蹤碼。出貨及送達時間由後端函式決定。
物流訂單查詢
| 訂單 | 客戶 | 物流狀態 | 物流商／追蹤碼 | 出貨時間 | 送達時間 | 提醒 | 操作 |
|---|
物流歷程紀錄 v13
本區僅讀取 Supabase 的 shipping_history 歷史紀錄，不會修改物流、訂單或庫存。時間以台灣時間顯示。僅顯示目前登入員工有權讀取的紀錄；最多載入最新 500 筆，並非完整歷史備份。先前未留下紀錄的狀態變更無法回補。
登入後即可讀取物流歷程。
請先選擇訂單。
報價單・訂單明細・出貨單 v11.1
此區只產生可列印的單據預覽，不會建立訂單、出貨或修改資料庫。報價單是目前試算快照，價格與庫存須於正式下單時重新確認；出貨單僅提供已完成訂單。所有資料依登入權限與每表最多 500 筆的載入限制顯示；缺少明細時禁止列印，以免產生不完整單據。
v10｜商業單據資訊
以下資料只用於這次預覽及列印，不會寫入 Supabase；重新整理或關閉頁面後不保留。收件人、電話及地址可從客戶資料帶入，仍請人工確認。預覽資料不會自動寫回客戶資料庫。
客戶・商品・階梯批價管理
只有已通過管理員驗證的帳號會顯示編輯工具。實際新增、修改、刪除仍由 Supabase RLS 決定；訂單及庫存不在此處寫入。
商品現有庫存與已保留庫存不可在此編輯，以避免破壞庫存紀錄。請先建立客戶與商品，才能建立階梯批價。
訂單試算・現貨／預購預覽 建立前預覽
此功能僅用於試算與匯出報價草稿，不會建立訂單、不會保留或扣除庫存。價格與庫存可能在其他員工操作後改變，正式接單仍須使用後端交易重新驗證。
請先建立客戶、商品及需要的階梯批價，再加入試算。
| 商品 | 數量 | 單價 | 小計 | 可用現貨估計 | 預購估計 | 操作 |
|---|---|---|---|---|---|---|
| 尚未加入商品 | ||||||
正式建立訂單 v7
先在 Supabase SQL Editor 執行隨附的 01_create_order_rpc.sql。按下建立後會真正寫入訂單與明細，並保留現貨；缺貨記錄為預購。此版已提供取消及整單出貨功能；修改請使用「訂單修改」區；尚未提供部分出貨功能；預購分配請使用下方管理員工具，請先使用測試資料。
尚未建立
訂單修改 v15 測試版
僅可修改 draft／confirmed 訂單。按下儲存會真正呼叫 chuanxu_update_order，更新明細、備註及相關庫存保留數。單純改價或備註時，後端應保留原本現貨／預購分配（規則 A）。請先以測試訂單驗證。僅管理員可手動指定單價，最終以後端權限檢查為準。
請先選擇訂單。
| 商品 | 數量 | 成交單價（NT$） | 小計 | 原現貨／預購 | 操作 |
|---|---|---|---|---|---|
| 請先選擇訂單 | |||||
尚未修改
訂單修改歷程
讀取 order_edit_history 最新 500 筆中的此訂單紀錄；若沒有讀取權限或紀錄超出範圍會提示。
商品入庫 v6・管理員
此功能會真正增加實際庫存並寫入庫存異動紀錄。僅限管理員，請先用測試商品驗證。新入庫商品不會自動分配給原有預購訂單；請在下方手動確認分配。
尚未操作
入庫函式的備註參數目前不會永久儲存，因此本頁暫不提供入庫備註欄位。
預購到貨分配 v7・管理員
此功能會真實修改訂單明細的保留／預購數量，並增加商品已保留庫存；不會扣除實際庫存。依照建立時間分配給未取消、未完成的預購訂單。請先確認商品、庫存與等待訂單；此操作目前沒有反向取消分配功能。僅限管理員操作。資料表目前最多載入 500 筆，若資料量超過此範圍，預覽可能不完整。
請選擇商品以預覽可用庫存與待分配數量。
尚未操作
訂單列表・取消／出貨 v7
此區顯示目前讀取的訂單（最多 500 筆）。取消會真實修改資料庫，並釋放該訂單已保留的現貨；無法復原。僅允許取消 draft 或 confirmed 訂單，請先使用測試訂單驗證。正式出貨僅限所有商品已全數保留現貨、預購數量為 0 的訂單。出貨不可復原，請先用測試訂單。
| 訂單編號 | 客戶 | 狀態 | 明細 | 建立時間 | 操作 |
|---|---|---|---|---|---|
| 尚未載入 | |||||
RLS 寫入驗證
使用目前登入身分嘗試新增一筆帶有隨機標記的測試客戶。若成功會立即刪除；若被拒絕會顯示錯誤。測試可能留下資料（例如新增成功但刪除失敗），請留意結果。
尚未執行
RLS 讀取診斷
尚未執行
HTTP 查詢成功不代表能看到所有資料。RLS 實際寫入測試請使用隨附的 SQL 測試腳本，測試後會 ROLLBACK。