Heap

目標:做一個本機優先的產品行為分析工具，自動收集網站事件並提供漏斗、路徑與留存報表。 技術棧建議:TypeScript 前端 SDK、FastAPI 後端、DuckDB 或 ClickHouse 儲存事件、React 管理介面、Docker Compose 執行。 需求: - 提供一段可嵌入網站的 JavaScript SDK，初始化時指定網站名稱 - 自動追蹤頁面瀏覽、點擊、表單送出、輸入框聚焦與自訂事件 - 每筆事件記錄匿名訪客 ID、工作階段 ID、時間、網址、元素文字與裝置資訊 - 支援 data-analytics-name 屬性，讓使用者替按鈕與元件指定穩定名稱 - 提供事件收集 API，接受批次資料並在網路中斷後由 SDK 暫存重送 - 管理介面可依事件名稱、網址、日期、裝置與訪客屬性篩選 - 提供漏斗報表，可自訂最多八個步驟並顯示各步驟轉換率 - 提供路徑報表，顯示某個事件前後最常發生的頁面與事件 - 提供留存報表，依首次事件分組，顯示每日與每週回訪率 - 支援建立自訂訪客屬性與事件屬性，並可查看原始事件內容 - 提供資料保留天數、IP 不儲存、Do Not Track 與 Cookie 同意設定 - 報表可匯出 CSV，所有原始事件可匯出 JSONL - 提供簡單的事件量、儲存量與 API 錯誤監控頁 明確不做(out of scope):多人協作與權限、Session Replay 錄影、跨網站身份合併、行動 App SDK、即時告警、雲端代管與商用等級擴充。 README 要求:說明本機啟動方式、網站 SDK 安裝範例、事件格式、報表使用方式、隱私設定、CSV 與 JSONL 匯出及資料搬移步驟。