籤詩庫管理

籤詩庫管理維護宮廟的電子籤詩內容。可建立多個籤詩庫（如「天上聖母六十甲子籤」「觀音 100 籤」「月老籤」），LIFF 端讓信眾切換選擇後抽籤。每首籤詩含籤號、吉凶等級、籤詩內容、籤解、典故故事與分類解讀。

進入路徑

後台左側 宮廟管理 → 籤詩庫管理。

新增籤詩庫

點擊右上角 + 新增籤詩庫 → 填入：

名稱　例「天上聖母六十甲子籤」。

神明（可選）　例「天上聖母」「觀世音菩薩」「月下老人」，顯示於卡片副標。

描述（可選）　給信眾的籤詩庫簡介。

籤數　此籤詩庫預期的總籤數（如 60、100），用於進度顯示「已建 N / 預期 N 首」。

封面圖網址（可選）　籤詩庫卡片大圖。

排序　數字越小排越前面。

啟用（LIFF 端顯示）　關閉後 LIFF 不會出現此籤詩庫。

每張籤詩庫卡片顯示：名稱、神明、啟用狀態、描述、「已建 N / 預期 N 首」進度，以及進入「管理籤詩」按鈕與「編輯」按鈕。

管理籤詩

點卡片上的 管理籤詩 進入該籤詩庫詳情頁，可逐首新增或批量匯入。

新增單首籤詩

點右上角 + 新增籤詩 → 填入：

籤號　籤的編號（如 1、2、3）。新增時會自動帶入「現有最大號 + 1」。編輯時鎖定不可改。

吉凶等級　下拉選單，七選一：上上吉 / 上吉 / 中吉 / 中平 / 下吉 / 下下 / 凶。LIFF 顯示時會依等級套不同顏色 badge。

籤詩內容（必填）　籤的詩文內容（通常為四句詩偈），使用宋體字呈現。

籤解　以白話文解釋籤詩含意，這是對信眾最有參考價值的部分。

典故 / 故事　籤詩對應的歷史故事典故。

分類解讀　針對 8 種常見問題類別分別填寫該籤的解讀：事業、姻緣、財運、健康、學業、訴訟、出行、家運。每項可填一段簡短評語（如「諸事順利」）。

圖片網址（可選）　籤詩配圖。

批量匯入

點右上角 批量匯入，在文字框貼上 JSON 陣列，每一筆物件對應一首籤詩，欄位與單筆新增相同（slip_no / grade / poem / interpretation / story / image_url / categories），其中 slip_no 與 poem 為必填，其餘欄位可省略（grade 省略時預設「中吉」）。按送出後系統逐筆處理，完成後會顯示「匯入完成：成功 N 首，失敗 M 首」。

常見問題

Q1　信眾可以重複抽籤嗎

抽籤次數限制目前由 LIFF 端控制，搭配「模組設定 → 抽籤設定」的擲筊次數參數（預設要求擲筊 3 次以上才能抽出一籤）來控制取得門檻。

Q2　如何修改已存在的籤詩

直接點擊該籤卡片即會開啟編輯視窗。籤號為鎖定不可改，其他欄位（吉凶、籤詩、籤解、典故、分類解讀、圖片）皆可修改後儲存。

Q3　籤詩庫可以建立幾個

不限數量。常見作法是同一宮廟建立多套：主祀神明的籤、月老籤、財神籤等，LIFF 端讓信眾依求問內容自行選擇。

刪除籤詩庫 / 單支籤

建錯的籤詩庫或匯錯的籤可以刪除，但只限還沒有人抽過：

• 籤詩庫底下只要有任何一筆抽籤紀錄，刪除會被擋下（訊息：此籤詩庫已有抽籤紀錄，無法刪除）。這是為了不讓信眾的求問歷史變成對不到籤詩內容的孤兒資料——這種情況請改為「停用」，信眾端就看不到了。
• 沒有任何抽籤紀錄的籤詩庫，刪除時會連同底下的籤一起刪。
• 單支籤同理：被抽過的那一支不能刪。