積分紀錄
「積分紀錄」是所有社群積分事件的流水帳，可篩選會員 / 事件類型 / 時間區間查詢，並支援 admin 手動發放積分（做客訴補償 / 特別獎勵）。
進入路徑
後台左側 社群 & 遊戲化 → 積分紀錄。
列表欄位
| 欄位 | 說明 |
|---|---|
| 會員 | member 姓名 + display_name（LINE 暱稱） |
| 事件類型 | event_type（英文 code） |
| 積分 | 該筆積分變動（正 = 加分、負 = 扣分） |
| 來源 | source_type + source_id（如 post / comment / voucher_redeem） |
| 時間 | created_at |
支援分頁（預設每頁 20 筆），按時間 desc 排序。
22 種事件類型（Phase 1 seed）
| event_type | 觸發 | 預設分數 |
|---|---|---|
post_created | 發新貼文 | +3 |
comment_created | 留新留言 | +1 |
received_like | 被按讚 | +1 |
given_like | 按讚別人 | +0（預設不記分，可在設定調整） |
daily_checkin | 每日打卡 | +2 |
checkin_streak_7 | 連續 7 天打卡 | +10 |
checkin_streak_30 | 連續 30 天打卡 | +50 |
checkin_streak_100 | 連續 100 天打卡 | +200 |
profile_completed | 完成 profile | +5 |
first_post | 首次發文 | +5 |
first_comment | 首次留言 | +2 |
course_completed | 課程完課 | +10 |
voucher_redeemed | 兌換票券 | +2 |
referral_signup | MGM 推薦成功 | +20 |
birthday_month | 生日月份 | +10 |
badge_earned | 拿到勳章 | 依勳章設定 |
achievement_completed | 完成成就 | 依成就設定 |
post_pinned_by_admin | 貼文被 admin 精選置頂 | +5 |
post_featured_by_admin | 貼文被 admin 加精華 | +10 |
report_confirmed_penalty | 被檢舉屬實 | -20 |
admin_manual_grant | admin 手動加分 | 依填 |
cross_module_grant | 跨模組發分（helper） | 依填 |
上表 22 種事件中，發文 / 留言 / 獲讚 / 給讚 / 每日打卡 / 完善個資 / 完成課程加碼這 7 種分數與 3 個每日上限已開放在「模組設定」調整，現在就能改、引擎也真的會讀。其餘 14 種分數目前固定寫死在系統常數裡，尚無後台可調整介面。
篩選
上方 Toolbar 可組合條件：
- 會員 id 精確查詢某會員的所有積分流水
- 事件類型 下拉選 22 種之一
- 開始 / 結束時間 時間區間
篩選後 URL 帶 query，可分享連結給同事看同一份查詢結果。
手動加分
右上角「手動加分」按鈕開 modal：
| 欄位 | 說明 |
|---|---|
| member_id（必填） | 對象會員 id |
| points（必填） | 加分數（可負；不可 0） |
| 原因（必填） | 寫入 detail，未來 audit 追溯用 |
| 來源類型 | 預設 admin_manual |
| 來源 id（選填） | 若對應某筆單據可填 |
送出後：
- 寫入
gc_point_events（event_type =admin_manual_grant） - 更新會員
total_points_earned+current_points - 觸發可能的 Level up（若跨門檻）
- 寫
audit_logsaction =gc.point_events.manual_grant
資料來源
底層表為 gc_point_events，跟 CRM 主檔 points / growth_value 各自獨立。此頁看到的積分不會影響會員的 CRM 主檔積分，反之亦然。
常見問題
Q1 為什麼會員 Level 沒升但積分明明夠了
Level up 用的是 total_points_earned（歷史累計），不是 current_points（當前可用）。若會員累計夠了但沒升等，可能：
- 該 Level 的 min_points 剛好被曲線調過 → 進「Level 曲線」看設定
- Level cache 尚未更新（Phase 1 用 lazy update，會員下次進 LIFF 觸發）
Q2 手動加分能撤回嗎
不能（Phase 1 沒有 delete 該筆紀錄的 UI）。若加錯了要抵銷，直接再手動加一筆負分（例如加錯 +100，補一筆 -100 抵掉）。
Q3 批次匯入積分？
Phase 1 沒有 UI 支援；若有大量補分需求（活動獎勵、系統遷移），請聯繫客服協助 backend 一次寫入。
Q4 積分紀錄要保留多久
永久（沒有 TTL）。用於長期會員行為分析與客訴追溯。若資料量過大可透過 since / until 篩選降低查詢負載。
Q5 跨模組發分（cross_module_grant）是什麼
其他模組（如課程完課、票券兌換、MGM 推薦）透過 backend helper 自動發社群積分。這種紀錄的 source_type 是原模組（如 course_enrollment / voucher / referral），方便追溯來源。
其他問題協助
若遇本說明未涵蓋的問題，請透過後台右下角 LINE 客服 @ugomk 聯繫真人專員協助處理。