LAVA 鵬灣騎行 · LINE LIFF 系統

🔴 PRD · 正式站

真實客戶正在使用，含真實綁定用戶、真實券與抽獎資料。在 PRD 操作（尤其後台發獎 / 兌換）= 真的會發生，請謹慎。

🟢 STG · 測試站

測試環境，不影響正式資料。第一次驗收、試用各功能、跑假抽獎請在這裡，放心點、放心測。

Step 1 — 取得入口

兩個角色 · 兩套環境

用戶端走 LINE（加官方帳號 → 開 LIFF）；管理端是獨立後台網站。下方分 STG / PRD 各給一組連結。打開測試網頁後，掃 QR / 點連結加官方帳號，就能以客戶身分開始走整個 LINE LIFF 流程。

📱

前台 · 用戶端（LINE LIFF）

加 LINE 官方帳號 → 點圖文選單「鵬灣騎行」→ 授權登入 → 進入 LIFF

STG 測試站官方帳號

加 STG 官方帳號（連結待補）

👉 光裕補：STG OA「加好友」連結 / QR（OA：TT-LIFF-APP-DEV）

PRD 正式站官方帳號

加 PRD 官方帳號（連結待補）

👉 光裕補：PRD OA「加好友」連結 / QR（OA：@fcq9974s）

用戶端能做什麼

世界自行車日：任務一（任意地點騎乘認證）＋任務二（路線打卡）
集章護照 / 勳章牆 / 選手證
抽獎券、我的獎品（中獎序號）
運動友善店家 + 兌換券核銷 QR
友善地圖 / 賽事資訊 / LAVA 社群

🛠️

後台 · 管理端（網站）

電腦瀏覽器開後台網址 → 帳密登入

STG 測試站後台

開啟 STG 後台

http://35.238.195.6/admin/

PRD 正式站後台

開啟 PRD 後台（網址待補）

👉 光裕補：PRD 後台網址（tunnel）

登入帳號

帳號 admin ／密碼 請向開發者索取

＊為安全考量，後台密碼不公開於本頁，由窗口私下提供。

後台能做什麼

獎品 / 序號、抽獎活動（模擬 + 正式抽獎）
測試群組 + 指定發獎（新）
用戶管理、運動友善店家、推播測試
自行車世界整合健康度、系統事件 / 失敗打卡

焦點功能

🚴 世界自行車日 · 兩個任務

進前台首頁點「世界自行車日」進入路線頁，頁面清楚分成兩個任務。兩個任務的勳章與抽獎券都是「每天可重複領」（台北 00:00 重置）。

任務一

任意地點騎乘認證

6/1–6/30 期間，不限地點完成 5 公里以上騎乘，用「馬拉松世界 App」收錄 GPS 軌跡後，在路線頁點「馬上利用馬拉松世界 App 收錄 GPS 軌跡」→ 挑一筆騎乘紀錄 → 認證。

🎖️ 每日 1 枚勳章＝ 5 張抽獎券

任務二

12.5K 路線打卡

實際騎到鵬灣 12.5K 路線，沿途 7 個打卡點用手機 GPS 打卡。每個打卡點每天可打一次。

🎟️ 每點 +1 抽獎券，集滿發勳章

🔎

檢查機制（防弊）：任務一的軌跡會檢查「運動類型為自行車、距離 ≥ 5K、最大瞬時速度 ≤ 55 km/h、時間連續」；同一筆騎乘紀錄只能認證一次。任務二打卡會用 GPS 距離判斷是否在打卡點半徑內（300m）。

Step 2 — 跟著故事走

⭐ 核心驗收劇本 · 集章 → 發獎 → 兌換閉環

下面不是各自獨立的功能，而是「同一位用戶、同一張券、同一個咖啡券」從累積、中獎、到兌換的完整生命週期。標注前後台聯動的幕，前台一動、後台同步出現。

💡 建議方式：一支手機（LINE，扮用戶）＋一台電腦（開後台）。先在前台累積抽獎券，再到後台用「指定發獎 / 抽獎活動」發獎，回到手機 LINE 看中獎通知，最後走咖啡券兌換。

用戶集章拿券→ 後台發獎 / 抽獎→ LINE 收中獎通知→ 我的獎品看序號→ 店家核銷咖啡券

用戶累積抽獎券

用戶

做什麼

加官方帳號 → 點圖文選單「鵬灣騎行」→ 授權登入 → 進入 LIFF 首頁
點「世界自行車日」→ 完成任務一（馬拉松世界 5K 認證）或任務二（路線打卡）
回首頁點「抽獎券」看累積張數

✅ 該看到抽獎券張數增加；任務一每日得 1 勳章 + 5 券，任務二每打一點 +1 券。

🔎 檢查後台「用戶」可查到該用戶的有效券數；「系統事件」會記錄發券事件。

後台發獎（兩種方式）

管理員

做什麼

方式 A — 指定發獎（測試 / 點名發）：後台「測試群組 / 發獎」→ 先建一個群組（搜尋名稱勾選用戶）→ 對群組點「指定發獎」→ 選獎品（咖啡券）→ 確認。系統直接配序號、建中獎紀錄、推 LINE，不經隨機抽。
方式 B — 正式抽獎：後台「抽獎活動列表」→ 進活動 → 先「模擬抽獎」預覽名單（不寫 DB）→ 確認後「執行抽獎」（需二次輸入密碼）→ 從有效券隨機抽出中獎者。

✅ 該看到指定發獎後跳出每位收獎者的序號與「已推播 / 略過」狀態；抽獎結果頁出現新中獎紀錄。

🔎 檢查獎品「剩餘」數量同步扣減；序號從序號池配出且不重複。

用戶在 LINE 收中獎通知

用戶前後台聯動

做什麼

後台一發獎，中獎用戶的 LINE 立即收到一張「🎉 恭喜中獎」卡片
卡片含獎品名稱與大字序號，底部「查看我的獎品」按鈕回 LIFF

✅ 該看到LINE 聊天室出現中獎 Flex 卡，序號清楚可讀。

🔎 檢查未綁定 LINE 的用戶會「略過推播」但中獎紀錄仍建立（可事後補通知）。

我的獎品 · 看序號

用戶

做什麼

LIFF 首頁點「抽獎券」→ 切到「我的獎品」（或點中獎卡的按鈕）
看到中獎獎品 + 大字序號；點整張卡可一鍵複製序號

✅ 該看到咖啡券的序號（全家中杯美式）＋兌換說明（若有設定）。

🔎 檢查序號即為兌換憑證，憑序號至全家 Let's Café 兌換。

兌換券核銷（運動友善店家）

店家端

做什麼

另一類「兌換券」走店家核銷：用戶在「運動友善店家 / 兌換券」出示券 QR
店家用手機掃 QR → 開啟核銷頁 → 輸入店家代碼 → 核銷

✅ 該看到核銷頁先顯示「客人要核銷的券」內容，輸對代碼後顯示「兌換成功」。

🔎 檢查後台「運動友善店家」可看每店的領取數 / 核銷數 / 明細；誤核銷可在後台「撤銷」。

前台 · 用戶端

📱 前台功能總覽

每個功能 = 怎麼進去（入口）＋做什麼＋檢查重點。入口多由 LINE 圖文選單（Rich Menu）或 LIFF 首頁功能格進入。

🎫綁定帳號 + 歡迎訊息Rich Menu → 鵬灣騎行

首次點「鵬灣騎行」→ LINE 授權 → 進 LIFF → LINE 收到歡迎 Flex。

🔎 聊天室收到橘色「歡迎加入」卡 + 活動亮點。

🚴世界自行車日 · 任務一 / 任務二首頁 → 世界自行車日

路線頁清楚分任務一（任意地點 5K 騎乘認證，串馬拉松世界）與任務二（7 點路線打卡）。兩者勳章/券每日可重複。

🔎 任務一挑紀錄認證可選裝置上傳的軌跡（含 Garmin TCX）；任務二每點每日一次。

📖集章護照 / 勳章牆首頁 → 集章護照

分區呈現各類勳章與路線進度；右上「勳章展示牆」看已收集 / 未收集。

🔎 已獲得勳章彩色、未獲得灰階。

🪪選手證Rich Menu → 選手證

個人選手證卡：頭像、名稱、累計勳章 / 抽獎券 / 完騎場次。可複製自己的 LINE ID（畫面不顯示 ID 本體）。

🔎 「複製 LINE ID」灰字鈕 → 複製「名稱｜Uxxxx」格式。

🎟️抽獎券 + 我的獎品首頁 → 抽獎券

抽獎券 Tab 看有效/中獎/總計與來源；獎品 Tab 看抽獎活動與名額；「我的獎品」看中獎序號（點卡複製）。

🔎 產品內不主動推播抽獎券，用戶自進 LIFF 看；唯一主動推 LINE 的是中獎通知。

🏪運動友善店家 + 兌換券Rich Menu → 特約店家

16 家合作店家清單（可分類）；兌換券可出示 QR 給店家核銷。

🔎 店家優惠內容待 LAVA 補；QR 有時效避免外流。

🗺️友善地圖 / 賽事資訊 / LAVA 社群Rich Menu

友善地圖（補給站/友善店家/淋浴）含定位與導航；賽事資訊嵌官網；社群為各品牌連結。

🔎 友善地圖 Pin 為範例，待 LAVA 提供正式清單。

後台 · 管理端

🛠️ 後台功能總覽

登入後台後，左側選單進入各功能。重點操作（抽獎 / 指定發獎 / 核銷撤銷）下方都標了步驟。

📊儀表板首頁

總用戶 / 抽獎券 / 勳章 / 活動數即時統計。

🎁獎品 + 序號獎品

新增 / 編輯獎品、填兌換說明；電子券類獎品點「序號管理」批次匯入序號（咖啡券 100 組已入庫）。

🎯測試群組 / 指定發獎（新）測試群組 / 發獎

用途：把固定測試用戶存成一組，對整組「指定發獎」直接發券（配序號 + 推 LINE），不經隨機抽，用於上線前驗證咖啡券發放與兌換。

🔎 步驟：① 建立群組（搜尋名稱勾選）→ ② 群組卡點「指定發獎」→ ③ 選咖啡券 → ④ 確認發給整組 → 跳出每人序號與推播狀態。

🎰抽獎活動（正式抽獎）抽獎活動列表

進活動 → 設定獎品組合與條件 → 「模擬抽獎」預覽（不寫 DB）→ 「執行抽獎」（二次密碼）→ 隨機抽出中獎並推 LINE。

🔎 執行抽獎不可復原；先用「模擬」確認名單再正式抽。

🏆抽獎結果抽獎結果

列出所有中獎紀錄（用戶 / 獎品 / 序號 / 時間），可依活動篩選。

👤用戶管理用戶

用戶列表 + 搜尋；看個別用戶的勳章 / 打卡 / 中獎 / 綁定狀態；可逐項清除用戶資料（測試用）。

🏪運動友善店家運動友善店家

16 家店家管理、改驗證碼、看兌換明細與統計（領取 / 核銷 / 剩餘）；兌換券誤核銷可在此撤銷。

📣推播測試推播測試

選用戶（搜尋 + 勾選 modal）→ 推測試訊息：歡迎 / 店家兌換 / 全部兌換券 / 全部獎品 / 抽獎券情境，供檢視長相。

🚲自行車世界整合 + 系統事件 / 失敗打卡自行車世界整合 / 系統事件

馬拉松世界同步健康度（最後拉取、累積紀錄、FAIL 分布）；系統事件 = 全站關鍵事件總覽；失敗打卡 = 打卡失敗細看（誰 / 哪 / 漂多遠）。

測試站已預建

營運中的示範數據（STG）

測試站已備妥獎品 / 序號 / 店家等資料，登入即見一個運作中的系統。

6 項

獎品（含咖啡券）

100 組

咖啡券序號（全家中杯美式）

16 家

運動友善店家

7 點

世界自行車日打卡點

＊以上為測試站預建數據，操作後即時變動；需重設回乾淨示範狀態告知開發者即可。

交付前 · 待 LAVA 補齊

📋 上線前還需要的素材 / 設定

補齊以下即可規劃正式上線。

項目	影響功能	說明
前台 LINE 連結（STG / PRD）	加官方帳號入口	本頁上方兩個「待補」按鈕
店家正式優惠內容	運動友善店家	16 家的折扣 / 贈品 / 條件
友善地圖正式 Pin	友善地圖	補給站 / 友善店家 / 淋浴座標
雲嘉南完騎證書範本 + 名單	完騎證書	範本圖 + 報名名單
正式 domain	全系統	上線前同步更新 LINE Developers Console endpoint

🟢

先在 STG 測試站驗收——所有操作不影響正式資料，可放心點、放心發假抽獎。確認沒問題後，再到 PRD 正式站對真實用戶操作。

⚠️

PRD 是正式站、有真實客戶。在 PRD 發獎 / 抽獎 / 核銷都是真的會發生（會扣序號、推真實 LINE 通知），請確認後再執行。