後台首次設定

一、建立共用資料庫

1. 登入 Cloudflare，左側開啟 Storage & databases → D1 SQL database。
2. 按 Create database，名稱填 swtxg-cellar-db。
3. 建立即可，這一版首次登入會自動建立需要的資料表。

二、連接目前的網站

1. 開啟 Workers & Pages → sw-taichung-wine → Settings → Bindings。
2. 在 Production 新增 D1 database binding。
3. Variable name 填 DB（必須使用這兩個大寫字母）。
4. 選擇剛才的 swtxg-cellar-db，儲存。

三、設定登入帳號與密碼

1. 同一個 Pages 專案，開啟 Settings → Variables and Secrets，設定 Production。
2. 新增 ADMIN_USERNAME，值填你想使用的帳號；未設定時預設為 admin。
3. 新增 ADMIN_PASSWORD，值填自己選的密碼，至少 4 個字元。請選 Encrypt／Secret 後儲存。
4. 密碼直接在 Cloudflare 輸入即可，不需要提供給其他人。日後改密碼，請在這裡更新並重新部署，舊的登入會失效。

原本管理帳號可管理同事帳號；同事可從後台登入頁自行註冊。新帳號可編輯、匯入及備份共用資料。

四、上傳這份網站更新包

1. 回到 sw-taichung-wine → Deployments → Create deployment。
2. 選擇 Production，將 SW-Cellar-Index-Admin.zip 拖入上傳區。
3. 確認檔案全部上傳後，按 Save and deploy。
4. 開啟原本網站，點左側書脊底部的 後台登入；手機版入口也在左側書脊底部。
5. 用剛設定的帳號密碼登入，會自動載入 20261015 工作表的 485 筆酒款、41 個欄位。

這份更新包包含伺服器程式 _worker.js，Cloudflare Pages 的拖曳上傳支援這個格式。請保留整份 ZIP 一起上傳；先完成資料庫綁定與密碼，再部署。

之後如何更新資料

• 修改一筆：搜尋酒款 → 編輯 → 修改欄位 → 儲存變更。A–I 欄直接顯示，J–AO 欄在「每日紀錄與其他欄位」展開。
• 新增酒款：按「新增酒款」，酒名與容量必填。H 欄為 0 時，前台自動顯示反灰與 SOLD OUT 印章；空白數量不會標示售完。
• 匯入 Excel：按「匯入資料」→ 選 .xlsx → 選工作表 → 預覽 → 確認匯入。系統會預選名稱為 8 碼日期的最新工作表，但仍可改選。
• 匯入會取代整份資料：它也會取代你先前在後台改過的內容。匯入前先按「下載備份」，可選 Excel（.xlsx）或 JSON。Excel 保留目前資料表的所有欄位與數值，不含原始檔的歷史分頁、公式與格式；JSON 可完整還原系統資料。
• 公式：Excel 的公式匯入為已儲存的數值，後台不會執行 Excel 公式。修改每日紀錄、Inventory 或 Total 時，請同時確認 H 欄「目前數量」。
• 自動登出：回到索引後，5 分鐘沒有操作即登出後台；搜尋、點選及捲動會延長計時，資料自動更新不會延長。
• 其他裝置：儲存後重新整理查詢頁就能看到新資料；開著的頁面每分鐘更新一次。網站更新不會寫回原始 Excel 或 Google Sheet。

遇到問題時

• 「尚未連接共用資料庫」：確認 Production 的 D1 綁定名稱為 DB，並重新部署。
• 「尚未設定登入密碼」：確認 Production 有 ADMIN_PASSWORD，長度至少 4 個字元，並重新部署。
• 「資料已被其他操作更新」：按「重新載入」，再進入該筆酒款編輯；系統會避免直接覆蓋較新的修改。
• 「H 欄公式缺少儲存結果」：在 Excel 或 Google Sheets 重新計算後儲存／匯出，再匯入。
• Safari 無法直接讀取 Excel：更新 Safari／Chrome，或將同一張工作表另存 UTF-8 CSV 匯入；欄位顺序維持 A–AO。
• 管理帳號忘記密碼：在 Cloudflare 更新 ADMIN_PASSWORD 並重新部署。同事帳號不使用這組密碼；忘記時可請管理者停用舊帳號，另註冊新帳號。