每次更新「路線打卡點」或「合作店家」清單並重新部署後，版本碼會自動變動（內容雜湊）；可據此確認線上用的是哪一版資料。
載入中…載入中…載入中…載入中…Step 1 — 取得入口
兩個角色 · 兩套環境
用戶端走 LINE（加官方帳號 → 開 LIFF）；管理端是獨立後台網站。下方分 STG / PRD 各給一組連結。打開測試網頁後，掃 QR / 點連結加官方帳號，就能以客戶身分開始走整個 LINE LIFF 流程。
前台 · 用戶端（LINE LIFF）
加 LINE 官方帳號 → 點圖文選單「鵬灣騎行」→ 授權登入 → 進入 LIFF
- 世界自行車日：任務一（任意地點騎乘認證）＋ 任務二（路線打卡）
- 集章護照 / 勳章牆 / 選手證
- （10/2 新增）選手綁定（真實姓名＋身分證字號後五碼）、我報名的賽事、兌換券夾（每場賽事一個資料夾）
- 抽獎券、我的獎品（中獎序號）
- 特約店家 + 兌換券核銷 QR
- 友善地圖 / 賽事資訊 / LAVA 社群
- （8/15 新增）COMBO 身分認證頁 + 儲值型折價券（純餘額，店家輸入金額扣款）
- （8/15 新增）系列禮進度與兌換 QR
- （8/15 新增）海洋騎士淨灘照片上傳 + 限額 20 好禮
後台 · 管理端（網站）
電腦瀏覽器開後台網址 → 帳密登入
admin ／ 密碼 請向開發者索取＊ 為安全考量，後台密碼不公開於本頁，由窗口私下提供。
- 獎品 / 序號、抽獎活動（建立 / 試抽 / 開獎）、🎲 抽獎演練
- 測試群組 + 指定發獎
- 用戶管理、特約店家、推播測試
- 馬拉松世界整合健康度、系統事件 / 失敗打卡
- （8/15 新增）COMBO 組合價：設定 / 匯入 / 發放 / 統計 / 核銷明細
- （8/15 新增）系列禮統計、海洋騎士上傳明細
- （10/2 新增）選手實名與賽事名單（建場次、匯入名單、兌換券配置與發放、核銷統計）、實名綁定總表；兌換券分三種券型
焦點功能
🪪 選手證 × 兌換券
選手在 LINE 以真實姓名＋身分證字號後五碼完成一次「選手綁定」，之後各場賽事的名單匯入後會自動配對；主辦單位在後台發放後，兌換券自動進入選手的兌換券夾，並以 LINE 通知。店家掃選手出示的 QR、輸入核銷碼即完成核銷，後台再依店家與券型統計應付金額。以下為正式站（v2，2026-10-02 上線）的做法。
兌換券分三種券型，建券時選定、建立後不可變更：
選手拿到：每人一筆金額，可分次使用；不找零，餘額不兌換現金。
店家核銷：掃 QR → 填「本次扣款金額」→ 輸入核銷碼 →〔確認扣款 N 元〕，從餘額扣除。
結算：依扣款金額計入應付店家金額。
例：LAVA COMBO 鐵人優惠券（報名任 2 場 400 元、3 場 600 元）。
選手拿到：一張標示面額的券（例如「面額 NT$100」）。
店家核銷：掃 QR → 輸入核銷碼 →〔確認核銷〕，一次用完，不用填金額。
結算：依張數 × 面額計入應付店家金額。
例：賽事餐券 50 元、100 元（每位選手各一張）。
選手拿到：一張換一份餐點或物品的券，不標面額。
店家核銷：掃 QR → 輸入核銷碼 →〔確認核銷〕，一次用完。
結算：只計份數，依與店家的約定另行結算。
建立不標面額的一般兌換券時，也選這一型。
入口有兩個：主選單「選手證」→〔立即綁定〕，或主辦單位寄給選手的選手信連結。輸入真實姓名與身分證字號後五碼（外籍選手勾選「外籍選手」，改輸入護照／居留證號碼後五碼）→〔確認綁定〕。比對成功即列出已配對的賽事，LINE 同時收到「選手綁定完成」通知（場次開啟推播時）。綁定一次即可，之後新匯入的賽事名單會自動配對，不必再綁。
列出已配對的每一場賽事（日期、選手編號、組別）與兌換券狀態，例如「券已發放 2 項・未使用 1 項」；點場次會開啟兌換券夾，只顯示該場的券。
由上而下分區：🏁 賽事兌換券（每場賽事一個資料夾，只放該場發的券，並標示日期與使用狀況）→ 儲值型折價券（例如 COMBO 券：餘額大字、效期、使用明細）→ 🎁 系列禮 → 🌊 海洋騎士專屬好禮 → 其他兌換券。可使用的券按〔出示核銷 QR〕給店家掃描（系列禮為〔出示兌換 QR〕）。
店家用手機相機或 LINE 掃選手出示的 QR，免安裝、免登入即開啟核銷頁：先確認「客人要核銷的券」（券名、面額或持券選手）→ 儲值型折價券另填「本次扣款金額」→ 在核銷碼欄輸入本店核銷碼 → 送出。面額餐券、一券一餐顯示「核銷成功！」；儲值型折價券顯示「扣款成功！」，持券人同時收到 LINE 扣款通知（含扣款後餘額）。
一場賽事＝一份名單＋一組兌換券。按〔＋ 新建場次〕後，進場次頁的四個分頁：
- 名單：上傳報名名單（CSV 或 Excel，需有選手編號、姓名、身分證字號，可加組別；可重複匯入，與既有名單合併），並檢視每位選手的「綁定」「發券」狀態。身分證字號只在上傳當下換算成驗證碼，系統不保存明文。
- 兌換券配置：本場要發的券。券在「兌換券」頁新增：選「所屬賽事場次」與券型，儲值型折價券填每人儲值金額、面額餐券填面額；名單上已綁定的選手，每張券各發一份。
- 兌換券發放：先看預覽（預計新發幾項兌換券、其中儲值型合計金額），按〔開放發放〕一次發給已綁定的選手；之後才綁定的選手會自動補發，開放後才新增的券按〔重跑補發〕。
- 核銷統計：依店家列出儲值型扣款金額、面額餐券張數與金額、一券一餐份數，以及應付店家金額；可選起訖日期、匯出 CSV。
後台代綁與解除集中在會員管理：「用戶管理」搜尋選手的 LINE 名稱，按〔選手綁定〕或〔解除選手綁定〕；「實名綁定總表」列出所有綁定，可按〔＋ 手動綁定〕（預設以姓名＋身分證後五碼查找，查無或重複時改從名單挑選）或對單列〔解除綁定〕。每位 LINE 會員最多綁一位選手，每位選手只能綁一個 LINE。
- 完騎證書改為名單制：名單上且已完成選手綁定的選手，賽事當天起可領，證書印名單上的姓名；世界自行車日、極點慢旅的完騎證書停止領取；雲嘉南目前沒有可套印姓名的證書底圖，也一併停止領取。
- 分享騎乘照片每人 1 次，只開放 Light One Bike（自 10/3 起算）。
- Light One Bike 10/3、10/4、10/25 三場各一枚完騎勳章；任兩場完騎即可兌換系列禮帆布袋（原門檻之外的另一條路徑）。
- COMBO：認證／解綁紀錄、發放預覽與名單匯入回報不再顯示身分證末 4 碼（有個資匯出權限者查看的資格名單與扣款明細匯出仍保留，供人工比對）；折價券過期或下架時不會發放。
焦點功能
🚴 四大系列賽事 · 任務一 ＋ 任務二
每個系列賽事底下是「一條一條路線」，每條路線都有兩個任務：任務一·騎乘認證、任務二·沿線打卡。勳章與抽獎券「每條路線每天可各領一次」（台北 00:00 重置）。下表是四大賽事目前的開放狀態與任務內容。
| 賽事 | 狀態 | 任務一·騎乘認證 | 任務二·沿線打卡 |
|---|---|---|---|
| 世界自行車日 | 開放中 | 不限地點完成 5 公里以上騎乘 ＝ 每日 1 枚認證勳章（5 券） | 12.5K 路線沿途 7 點 GPS 打卡（每點 +1 券） |
| 極點慢旅 A / B / C 三條路線 |
開放中 | 騎乘軌跡覆蓋該路線打卡點 ≥ 50% ＝ 該路線每日 1 枚認證勳章（5 券） | 沿該路線打卡點 GPS 打卡（每點 +1 券） |
| Light One Bike A / B / C 三條路線 |
開放中 8/3 起開放 8/11 換新主視覺 |
同上（覆蓋率認證，每路線每日 1 枚） | 沿該路線打卡點 GPS 打卡 |
| 彩虹自行車道 12 條具名路線 |
開放中 | 同上（每條路線覆蓋率認證，每路線每日 1 枚） | 沿該條路線打卡點 GPS 打卡 |
以「世界自行車日」為例，前台路線頁清楚分成兩個任務卡：
任意地點騎乘認證
不限地點完成 5 公里以上騎乘，用「馬拉松世界 App」收錄 GPS 軌跡後，在路線頁點認證按鈕 → 挑一筆騎乘紀錄 → 認證。
🎖️ 每日 1 枚勳章 ＝ 5 張抽獎券路線打卡
實際騎到路線上，沿途打卡點用手機 GPS 打卡。每個打卡點每天可打一次。
🎟️ 每點 +1 抽獎券，集滿發勳章Step 2 — 跟著故事走
⭐ 核心驗收劇本 · 集章 → 發獎 → 兌換閉環
下面不是各自獨立的功能，而是「同一位用戶、同一張券、同一個咖啡券」從累積、中獎、到兌換的完整生命週期。標注 前後台聯動 的幕，前台一動、後台同步出現。
用戶累積抽獎券
用戶做什麼
- 加官方帳號 → 點圖文選單「鵬灣騎行」→ 授權登入 → 進入 LIFF 首頁
- 點「世界自行車日」→ 完成任務一（馬拉松世界 5K 認證）或任務二（路線打卡）
- 回首頁點「抽獎券」看累積張數
後台發獎（兩種方式）
管理員做什麼
- 方式 A — 指定發獎（測試 / 點名發）：後台「測試群組 / 指定發獎」→ 先建一個群組（搜尋名稱勾選用戶）→ 對群組點「指定發獎」→ 選獎項（咖啡券）→ 輸入管理密碼確認。系統直接配序號、建中獎紀錄、推 LINE，不經隨機抽。
- 方式 B — 正式開獎：後台「抽獎活動列表」→ 進活動 → 先「試抽」看每個獎項的「可中獎人數 / 序號夠不夠」預檢（試抽判定＝正式判定，不寫入資料）→ 預檢沒問題後「執行開獎」（需輸入管理密碼）→ 從有效券隨機抽出中獎者，中獎者自動收 LINE 中獎卡（序號直接在卡上）。
用戶在 LINE 收中獎通知
用戶前後台聯動做什麼
- 後台一發獎，中獎用戶的 LINE 立即收到一張「🎉 恭喜中獎」卡片
- 卡片含獎品名稱與大字序號，底部「查看我的獎品」按鈕直達 LIFF「我的獎品」頁
我的獎品 · 看序號
用戶做什麼
- LIFF 首頁點「抽獎券」→ 切到「我的獎品」（或點中獎卡的按鈕）
- 看到中獎獎品 + 大字序號；點整張卡可一鍵複製序號
兌換券核銷（特約店家）
店家端做什麼
- 另一類「兌換券」走店家核銷：用戶在「選手證 → 兌換券夾」按〔出示核銷 QR〕
- 店家用手機掃 QR → 開啟核銷頁 → 輸入核銷碼 → 送出
以下三條劇本對應選手證 × 兌換券（正式站 10/2 上線）、COMBO 折價券（9/29 週會定案改為純餘額）與系列禮。步驟以正式站（v2）的畫面描述；測試站目前已是 v3 P0，畫面不同之處在各幕以「測試站 v3 將改為」標示。測試站已預建可演練的示範資料；操作所需的示範身分、服務處與攤位核銷碼、後台密碼請向開發窗口索取（基於安全考量不公開於本頁）。
選手證 × 兌換券 · 選手綁定 → 發放 → 兌換券夾 → 店家核銷
用戶 ＋ 管理員 ＋ 店家端前後台聯動做什麼
- （後台）進「選手實名與賽事名單」→ 點一場示範場次 → 看〈名單〉的示範名單與〈兌換券配置〉的本場券（測試站已預建示範場次、假名單與三種示範券，可直接進下一步）。
- （手機）主選單「選手證」→〔立即綁定〕→ 輸入示範身分的真實姓名與身分證字號後五碼 →〔確認綁定〕。
- （後台）回該場〈兌換券發放〉→ 確認預覽（預計新發幾項兌換券、其中儲值型合計金額）→ 按〔開放發放〕→ 輸入管理密碼確認（僅限超級管理員）。
- （手機）LINE 收到「兌換券已發放」通知 →「選手證」→「我報名的賽事」：該場顯示「券已發放 N 項」→ 點進去，或開「兌換券夾」看「🏁 賽事兌換券」裡這一場的資料夾。
- （店家端）另一支手機掃面額餐券或一券一餐的 QR → 在核銷碼欄輸入核銷點的核銷碼 →〔確認核銷〕。儲值型折價券的扣款流程同幕七。
COMBO 折價券 · 認證 → 發放 → 掃碼扣款
用戶 ＋ 管理員 ＋ 店家端前後台聯動做什麼
- （後台）進「COMBO 組合價」→「② 名單匯入」上傳報名名單 CSV，看匯入回報（成功筆數 / 各場命中人數 / 需人工處理清單）。測試站已預建假名單，也可直接跳到下一步。
- （手機）開啟 COMBO 身分認證頁 → 輸入姓名與身分證字號 → 送出。已完成選手綁定、且在 COMBO 名單上的選手，綁定時已自動認領，可略過這一步。
- （後台）回「④ 各場發放批次」→ 按該場次〔執行發放〕→ 確認預覽的發放人數與金額合計（N 人／NT$M）→ 輸入場次代碼與管理密碼送出。
- （手機）回兌換券夾，儲值型折價券已入券夾，大字顯示餘額（例如「餘額 NT$400」）與效期（至 2026/12/06）→ 出示券 QR。
- （店家端）另一支手機掃 QR → 開啟核銷頁（顯示目前餘額）→ 在「本次扣款金額」輸入要以券支付的金額（例如 120）→ 在核銷碼欄輸入店家 / 攤位的核銷碼 → 按〔確認扣款 120 元〕送出。
系列禮 · 集章 → 出示 QR → 掃碼驗資格 → 核銷
用戶 ＋ 店家端做什麼
- （後台，僅測試站）「系列禮」頁下方的測試工具可為指定帳號補發 / 收回完騎勳章，快速湊到 2 枚或 4 枚來驗證。
- （手機）開兌換券夾的「系列禮」區：看到四個系列的完成標籤；未達門檻是灰卡，直接寫「還差 N 枚」。
- 達 2 枚 → 帆布袋卡可按「出示兌換 QR」；達 4 枚 → 帆布袋與露營椅組兩張都可領。
- （工作人員）手機掃 QR → 核銷頁自動列出這位選手的資格明細與是否符合 → 輸入服務處的核銷碼完成。
前台 · 用戶端
📱 前台功能總覽
每個功能 = 怎麼進去（入口）＋ 做什麼 ＋ 檢查重點。入口多由 LINE 圖文選單（Rich Menu）或 LIFF 首頁功能格進入。
首次點「鵬灣騎行」→ LINE 授權 → 進 LIFF → LINE 收到歡迎 Flex。
路線頁清楚分任務一（任意地點 5K 騎乘認證，串馬拉松世界）與任務二（7 點路線打卡）。兩者勳章/券每日可重複。
分區呈現各類勳章與路線進度；右上「勳章展示牆」看已收集 / 未收集。
主選單第一格。個人選手證卡：頭像、名稱、累計勳章 / 抽獎券 / 完騎場次，以及選手綁定狀態（已綁定顯示姓名，未綁定有〔立即綁定〕）；卡片下方兩個入口「我報名的賽事」「兌換券夾」（見上方「選手證 × 兌換券」）。可複製自己的 LINE ID（畫面不顯示 ID 本體）。
抽獎券 Tab 看有效/中獎/總計與來源；獎品 Tab 看抽獎活動與名額；「我的獎品」看中獎序號（點卡複製）。
合作店家清單（家數以後台設定為準，可依分類篩選；8/11 起新增「飲料」分類，並補上「住宿」分類的顯示）；到店時按店家卡片上的「兌換」出示 QR，由店家掃碼並輸入核銷碼即享優惠。兌換券則在「選手證 → 兌換券夾」出示 QR 核銷。
由上而下分區：🏁 賽事兌換券（10/2 新增，每場賽事一個資料夾）、儲值型折價券（COMBO 等；餘額大字、效期、使用明細）、系列禮（兩張禮卡與四系列進度）、海洋騎士專屬好禮（未領 / 已領 QR / 已兌 / 額滿四種狀態，常駐顯示剩餘 N/20），最下方是其他兌換券。券夾內容按活動分流：鵬灣入口顯示 LAVA 系列的券，墾丁騎遇的券只出現在墾丁入口。
（8/15 新增）跨賽事通用的組合價入口，不掛在鵬灣騎行主頁下。選手輸入姓名與身分證字號完成認證；認證成功即發 LINE 通知，該場開放發放後自動入券。已完成選手綁定、且在 COMBO 名單上的選手，綁定時已自動認領，不必再認證。
（8/15 新增）頁內含 9/19 淨灘活動說明與報名連結按鈕；上傳淨灘照片後系統自動判讀是否為海灘 / 海岸場景，通過即發海洋騎士勳章 1 枚＋抽獎券 5 張（每人限 1 次）。頁面同時顯示專屬好禮剩餘數。
友善地圖已改為「友善商家名錄」：100+ 家友善商家，依「食/宿/遊/購/行」分類，可搜尋（店名/地區）＋分類篩選，每家一鍵開 Google 地圖導航、可直接撥打。賽事資訊嵌官網；社群為各品牌連結。
後台 · 管理端
🛠️ 後台功能總覽
登入後台後，左側選單進入各功能。重點操作（試抽 / 開獎 / 指定發獎 / 沖銷 / 核銷撤銷）下方都標了步驟。
總用戶 / 抽獎券 / 勳章 / 活動數即時統計。
新增 / 編輯獎項、填兌換說明；電子券類獎項點「序號管理」批次匯入序號（咖啡券序號已入庫）。
用途：把固定測試用戶存成一組，對整組「指定發獎」直接發券（配序號 + 推 LINE），不經隨機抽；也用於「沖銷」後補發給正確人選。
活動可在後台建立 / 編輯（名稱 / 日期 / 資格）。進活動 → 開獎前先「試抽」：列出每個獎項的「可中獎人數 / 序號夠不夠」預檢（試抽判定＝正式判定，不寫入資料）→ 預檢沒問題後「執行開獎」（需輸入管理密碼）→ 中獎者自動收 LINE 中獎卡，序號直接在卡上。每人每活動最多中一獎。
列出所有中獎紀錄（用戶 / 獎項 / 序號 / 通知狀態 / 時間），可依活動篩選、匯出 CSV、補發通知。
用戶列表 + 搜尋；看個別用戶的勳章 / 打卡 / 中獎 / 綁定狀態；可逐項清除用戶資料（測試用）。（10/2 新增）列表多「實名」欄，並可對單一會員〔選手綁定〕〔解除選手綁定〕（僅限超級管理員，理由必填）。
店家管理（公開店家與核銷點）、設定核銷碼、逐店產生「核銷教學頁」連結、看兌換明細與統計（領取 / 核銷 / 剩餘）；兌換券誤核銷可在此撤銷。分類新增「飲料」，並補上「住宿」。
新增 / 編輯兌換券：券型三選一（儲值型折價券 / 面額餐券 / 一券一餐，建立後不可變更）、所屬賽事場次（不選＝一般券）、可使用店家（不選＝所有店家皆可）、效期與總量。每張券可看領取明細；儲值型折價券可逐筆撤銷扣款，面額餐券、一券一餐可撤銷核銷。
（10/2 新增）建賽事場次 → 名單匯入 → 兌換券配置 → 兌換券發放 → 核銷統計，詳見上方「選手證 × 兌換券」。
（10/2 新增）列出所有選手綁定，可〔＋ 手動綁定〕或逐列〔解除綁定〕（僅限超級管理員，理由必填）。
（8/15 新增）依操作順序分五區：① 活動設定（組合場次與回饋級距；級距以金額設定，例如 2 場 400 元、3 場 600 元，明年換賽事可直接改）② 名單匯入（CSV，回報成功筆數 / 各場命中 / 需人工處理）③ 統計（2 場 / 3 場人數、已認證 / 已發放人數、已發金額 / 已使用金額）④ 各場發放（先看預覽人數與金額合計，需輸入場次代碼＋管理密碼）⑤ 核銷明細（每筆扣款金額與扣後餘額；依店家或券篩選、單筆撤銷＝金額加回餘額、CSV 匯出對帳）。
（8/15 新增）統計達 2 枚 / 4 枚人數與各級已兌換數，列出已兌名單並可匯出 CSV 供備貨。測試站另有「測試工具」可為指定帳號補發 / 收回完騎勳章，方便驗收時湊門檻（正式站不提供）。
（8/15 新增）逐筆列出淨灘照片上傳紀錄：照片縮圖、用戶、時間、判定結果與是否發放，供人工抽查；退件的紀錄也會保留。
選用戶（搜尋 + 勾選 modal）→ 推測試訊息：歡迎 / 店家兌換 / 全部兌換券 / 全部獎品 / 抽獎券情境，供檢視長相。
馬拉松世界同步健康度（最後拉取、累積紀錄、FAIL 分布）；系統事件 = 全站關鍵事件總覽；失敗打卡 = 打卡失敗細看（誰 / 哪 / 漂多遠）。
測試站已預建
測試站示範資料（STG）
測試站已備妥下列示範資料，登入即見一個運作中的系統。各項數量以測試站示範資料為準，操作後即時變動；路線與店家清單的筆數見本頁上方「目前使用的資料版本」。
- 獎品與抽獎：示範獎品（含全家咖啡券）與咖啡券序號，可練習試抽、開獎、指定發獎與抽獎演練。
- 特約店家與核銷點：特約店家，以及大會服務處、EXPO 鐵人市集攤位等核銷點（假資料）。
- 選手證 × 兌換券：Light One Bike 10/3、10/4、10/25 三個示範場次與假名單；10/3 場備有三種示範券（儲值型折價券、面額餐券、一券一餐，不限店家）。
- COMBO 組合價：三場次（花蓮 / 大鵬灣 / QUEEN）＋兩級距（2 場 400 元、3 場 600 元）與可直接演練的假資格名單；COMBO 儲值型折價券效期至 2026/12/06。
- 系列禮與海洋騎士：系列禮·帆布袋（門檻 2 枚）、系列禮·露營椅＋在地伴手禮（門檻 4 枚）、海洋騎士專屬好禮（限額 20 份）。
＊ 示範用的身分資料、核銷碼與後台密碼請向開發窗口索取；需重設回乾淨示範狀態，告知開發者即可。