燈座管理

燈座管理是宮廟管理模組的核心功能。建立各類「燈位類別」（光明燈、太歲燈、文昌燈、財神燈…），每個類別下再批量產生固定編號的座位，信眾透過 LIFF 端選燈位、填申請資料完成認購，後台即時看到每一座的占用狀態。

進入路徑

後台左側 宮廟管理 → 燈座管理。

新增燈位類別

點擊右上角 + 新增燈位類別 → 填入：

類別名稱　顯示於信眾端認購頁面，例如「光明燈」「太歲燈」「文昌燈」。

描述　說明點此燈的功德或祈求事項，會顯示在 LIFF 燈位卡片下方。

單座價格 (NT$)　每一座燈位的認購金額。

期間（月）　此燈位一次認購可保佑的月數（預設 12 個月）。系統依此自動算到期日。

座位編號前綴（可選）　設定後批量產生時會自動補零，例如設定 A- 會產生 A-001、A-002…。

封面圖網址（可選）　貼一張燈位類別的代表圖網址，會顯示為卡片大圖。

排序　數字越小排越前面。

啟用（LIFF 顯示）　關閉後 LIFF 端不會出現這個類別，但既有認購紀錄仍保留。

卡片資訊與進度條

每個燈位類別卡片顯示：類別名稱、單價 / 期間月數、啟用狀態，以及一條 已認購進度條（已認購 N / 總座位 + 百分比）。一目了然看出哪一類燈剩多少。

LIFF 端注意：信眾在 LIFF 看到的燈位選擇頁，目前公開端 API 只回傳各類別的 available_seats（可認購剩餘數量），不包含總座位數。「已認購 N / 共 Y 座」的完整進度條只顯示於後台 admin，LIFF 端顯示剩餘可認購數量。

管理座位

點擊卡片上的 管理座位 進入單一類別的座位管理頁，再用右上角 + 批量產生座位 一次建立 60 個或 100 個座位：

編號前綴（可空）　可繼承類別設定，也可改寫（例如分區 B區-）。

起始編號　通常從 1 開始；若要續編現有，填現有最大號 + 1。

產生數量　一次最多 2000 個。

自動補零　產生的座位編號會自動補三位數補零（A-001 ~ A-060），編號已存在會自動跳過（可重複執行不重複建立）。

座位狀態與配色

座位以方格網格顯示，實際共有 4 種狀態，但畫面上只用 3 種顏色區分：

可認購（主色系淺底）　空位，可被信眾從 LIFF 認購；hover 時右上角會出現紅色 × 可單獨刪除空位。

已認購（玫瑰紅）　已被認購，卡片上會顯示申請人姓名，滑鼠移上可看到到期日。

已過期（灰色）　超過期間的座位，會在認購名單退款 / 取消後自動釋放回 available。

頁面頂部會顯示：共 N 座（可認購 N / 已認購 N），並可點 可認購 / 已認購 / 全部 篩選 chip 過濾。

常見問題

Q1　燈位類別額滿後還有信眾想認購怎麼辦

回該類別的「管理座位」頁，點 + 批量產生座位 並用「起始編號 = 現有最大號 + 1」續編，新增的空座位會立刻在 LIFF 端可被認購。

Q2　如何刪除已有認購紀錄的燈座

已認購（occupied）的座位不能直接刪除，必須先到「認購名單」把該筆認購標為取消或退款，座位才會釋放回 available，才能在座位網格按 × 刪除。整個類別若要停用，建議改成「停用」狀態而非刪除，可保留歷史紀錄。

Q3　不同神明的燈座需要分開建立嗎

建議依神明或祈求目的分開建立燈位類別，方便信眾選擇，也便於後台依類別統計進度條與認購情況。