檔期加速器

「檔期加速器」是全店共同目標型的短期活動：設定一個大家一起衝的目標（例如「本檔期累計簽到 1000 次」），達標門檻分三階解鎖獎勵，也可以開放組隊挑戰。進度由會員的實際行為事件即時累計，後台不提供手動改進度的欄位。

進入路徑

後台左側 社群 & 遊戲化 → 檔期加速器。

目標類型（goal_type）

新增檔期時要選一種累計依據：

建立檔期

點右上 新增檔期，填寫：

• 名稱 / 描述 / 封面圖
• 目標類型（見上表）與目標值（全店要累計到多少次才算達標）
• 狀態：草稿 / 進行中 / 已結束 / 已封存
• 起訖時間
• 三階門檻：每階可設門檻值、名稱、獎勵類型（點數 / 票券 / 額外抽獎次數 / 無）
• 組隊挑戰（選填）：開啟後可設團隊目標值與團隊獎勵

全店進度怎麼算

進度只由系統事件流累計，後台沒有手動改進度的欄位。 會員做出對應目標類型的行為（打卡、答題、抽轉盤、完成任務、消費、成功推薦）時，系統會記一筆事件並累加到檔期的 current_count。列表「全店進度」欄即時顯示目前累計值 / 目標值與進度條。

三階門檻達標時自動解鎖對應獎勵；「已解鎖階」欄顯示目前解鎖了幾階。

進度監看

點任一檔期的 進度監看，可看到：

• 對帳結果：欄位存的進度值 vs. 用事件流重新加總的值，兩者是否一致（consistent），以及有沒有個別會員的貢獻值對不上
• 貢獻榜：各會員的貢獻次數、目前解鎖到第幾階、獲得的額外抽獎次數
• 組隊清單（若開啟組隊）：每隊隊名、隊長、目標、目前貢獻、狀態、加入代碼、成員數 / 上限、獎勵是否已發放

重算與同步

若對帳結果顯示不一致，進度監看頁提供兩個動作：

• 重算：用 gc_campaign_events 事件流重新加總，勾選「寫回」才會把校正後的數字寫回 current_count；不勾只是重新檢查不落地
• 同步：對全體參與者重新計算貢獻，並補發已解鎖但尚未發放的階段獎勵

狀態切換與封存

列表「狀態」欄可直接點擊切換進行中 / 其他狀態。沒有真正的刪除，「封存」動作會先跳確認視窗（「封存後不再累計，歷史事件與進度保留供對帳」），確認後把狀態改為「已封存」，歷史資料不會被清除。預設列表不顯示已封存的檔期，勾選「顯示已封存」才會列出。

常見問題

Q1　可以手動幫某位會員加檔期進度嗎

不行。檔期進度是「事件總和」的對帳不變量，後台沒有直接改數字的入口，避免手改後跟事件流對不起來。若要補進度，請讓會員實際完成對應行為（例如目標類型是簽到，就補一次簽到事件），或聯繫工程協助用事件寫入。

Q2　封存的檔期資料還在嗎

在。封存只是改狀態、預設從列表隱藏，歷史事件、進度、組隊紀錄都保留，供事後對帳查詢。

Q3　會員在哪裡參加檔期

LIFF 端「社群」頁面有對應的檔期加速器入口，會員可查看目標進度、加入或建立隊伍（若該檔期開啟組隊）。