本卡為 FR-133 母案：讓每套 Guidant AI 隨產品自帶一個錯誤追蹤站（Bugsink），裝機全自動、只收程式錯誤，共 12 棒（3 repo）。子卡清單在末段。

這系列在做什麼（白話）

客戶拿到產品做驗收測試（UAT）時，出錯了我們要能在客戶自己的機器上看到：錯在哪一行、當下變數是什麼、誰踩到、哪一筆請求。後端『送錯誤報告』的線路早就在產品裡，但出貨包沒有『收報告的站』。這個專案就是把站（Bugsink，一個開源的錯誤追蹤網站）一起裝進安裝包：裝機人員什麼都不用輸入，裝完就有站、有管理員帳號、有專案、有連線字串；使用者打錯密碼這類正常失誤不會灌進站台；前端（瀏覽器）的錯誤經登入後的後端轉送進站；原廠人員要的診斷包也改從這個站撈事件。

為什麼要做

• 收的站：出貨包不含任何錯誤追蹤站，SENTRY_DSN（錯誤報告的送件位址）預設是空的。
• 篩選：一次打錯密碼在站台變三條，ClientError（使用者失誤類，八種）全部會送，UAT 的正常失誤會淹掉真正的 500 並吃光每分鐘 60 筆的節流額度。
• 前端：免登入的 /client-config、/error-tunnel 因資安項 U3-⑤ 已拆，前端 @sentry/vue 一併移除。
• 診斷包：infra/support/diag_event_fetcher.py 對著 GlitchTip 式 API 寫，Bugsink 不是那個形狀。

關鍵設計決策（D1–D8，全數已拍板）

• D1 自動建專案：用 bugsink-manage shell 跑 Django ORM 建 team／project／API token；DSN 用 SQL 從庫讀 project id 與 sentry_key 組出。理由：官方沒有建專案的指令或環境變數，走它自己的資料模型，升版時欄位異動由它吸收。排除：直接 SQL INSERT、要裝機人員進畫面建。
• D2 站台位址：優先 443 子路徑 https://<主機>/bugsink/；B0 實測不通才退 8443。理由：客戶防火牆常只開 443。
• D3 授權：PolyForm Shield 可接受，不過法務（本產品不是錯誤追蹤產品，不構成競爭）。
• D4 前端錯誤：一律經後端登入後轉送端點；DSN 由登入後才拿得到的回應供給；不復活 /client-config、/error-tunnel。代價：登入前的前端錯誤收不到。理由：只依賴 443 與登入狀態、不碰跨網域。
• D5 管理員帳密：帳號 [email protected]；密碼全客戶同一組，build 時從 CI 遮罩變數烙進包內 600 檔，install.sh 讀它建管理員並另存一份到資料目錄。理由：裝機人員不輸入、原廠維護要能直接登入。已知風險：任一客戶安裝目錄外洩則全客戶站台可登入；緩解為站台只在內網可達、guidantai bugsink-set-password 可單台改；升級不改既有密碼。
• D6 資料庫：stack 內 guidant-db 另開 bugsink 庫與獨立帳號。理由：不多起 Postgres、與產品資料權限互不相通。排除：SQLite、另起一顆 Postgres。
• D7 事件保留：預設每專案 1 萬筆（依重要性挑留），不設天數；提供 guidantai bugsink-vacuum 手動清。理由：UAT 價值在看趨勢，筆數上限已封頂磁碟。
• D8 告警：第一版不做（客戶 SMTP 與內網可達性不確定，列下一版）。
• 過濾：兩個環境變數 ERROR_TRACKING_CAPTURE_CLIENT_ERRORS（預設 false）、ERROR_TRACKING_LOG_EVENTS（預設 false），預設只收程式錯誤，可開回全收。

怎麼拆

• A 過濾開關（T-A1 jedi-log、T-A2 後端）— 解掉一次失敗三條的雜訊。