# Idea file：四週打造萬人等級的進香 GPS 打卡與碳足跡系統

> 這是一份 idea file：只寫目標、約束、取捨與驗收標準，不含實作。把它餵給你的 coding agent，讓 agent 為你的活動場景重建這個系統。
> This is an idea file: goal, constraints, tradeoffs and acceptance criteria, no implementation. Feed it to your coding agent to rebuild the system for your own event.

- 源文章（完整六天時程與設計細節）：https://paulkuo.tw/articles/formosa-esg-2026-low-carbon-pilgrimage/
- 源文章 raw Markdown：https://paulkuo.tw/articles/formosa-esg-2026-low-carbon-pilgrimage.md
- 作者：Paul Kuo（paulkuo.tw）
- 整理日期：2026-10-08。

## 一句話目標

四週內從零打造白沙屯媽祖進香的 GPS 打卡與碳足跡追蹤系統：萬人等級流量、參與者不用裝 App。

## 核心約束

- 使用情境是徒步移動中、手機訊號不穩：要求極低延遲與極高可用性，所以全邊緣架構（Astro 前端加 Cloudflare Workers、D1、KV）。
- 不裝 App：網頁加 LINE 整合，掃 QR Code 就能用。對萬人等級、背景各異的參與者，要求裝 App 不現實。
- 計算要有方法論依據：排放係數用環境部公告值 0.21 kg CO₂/km；方法論框架與背書由合作的科學減碳組織提供（原專案與 SSBTi 合作，對方出方法論、Paul 出技術）。
- 估算必須明示假設邊界：減碳數字建立在「徒步取代開車」的行為轉換假設上，對外溝通時講清楚。

## 量級刻度（原專案估算與壓測）

- 碳帳估算：假設三十萬人平均各走 100 公里（保守值），約 6,300 噸 CO₂ 避免排放，約等於 16 座大安森林公園一年的碳吸收量。
- 壓測：四輪，最高 5,000 虛擬使用者同時在線，成功率 99.99%。

## 時程拆解（可複製的節奏）

- D1 技術可行性：手機 GPS 擷取座標、確認精度。
- D2 後端骨架：打卡 API、碳計算公式、LINE Bot、D1 資料表結構、Worker 部署。
- D3 前端 UX：13 題卡片式問卷、線性進度條、九級香客等級。
- D4 Dashboard 與安全：伺服器端地圖聚類、速率限制、活動啟停控制。
- D5 到 D6 壓測：四輪，最高推到 5,000 虛擬使用者同時在線。

## 已做的取捨（與理由）

- 遊戲化用九級修行等級（煉氣到飛升），每級有專屬公仔圖：把長途徒步的心理歷程轉成參與者看得懂的敘事，不是純粹的數字儀表板。
- 安全機制（速率限制、活動啟停、伺服器端地圖聚類）當成獨立的一天工作項做完，不是事後補。

## 驗收標準

- 壓測成功率 99.99%（5,000 虛擬使用者同時在線）。
- 香客掃 QR Code 能看到自己走到哪、等級多少、減了多少碳。
- 主辦方能隨時啟停活動，速率限制有效。

## 刻意不做的事

- 不做原生 App。
- 不宣稱精確減碳量：只給「假設行為轉換成立」前提下的估算，假設邊界寫在明處。