TW DATA PIPELINE QA PACK
台股資料管線 QA 測試包
給台股量化/資料團隊的 20 個靜默失敗案例 + 可機器讀取檢查規則。
這些坑有一個共同點：API 全部回傳成功，沒有任何 exception。 錯的不是程式，是資料的時間、覆蓋、日曆 —— 只有 invariant 檢查抓得到。 每個案例固定八節：真實症狀 / 為什麼不會報錯 / 受影響結果（量化）/ 最小重現樣本 / 檢查條件（invariant）/ 建議重試回補策略 / 驗收標準 / 已知例外。
免費樣本：3 個完整案例
「延遲 / 完整性 / 日曆」三類各抽一個，內容與付費版同規格，先看再決定。
延遲與 stale ｜ Critical
API 回傳成功，但資料不是今天的
—— 盤中拿昨收當即時價，篩出來的 strike 區間整段位移 70-90 元
閱讀完整案例 → 完整性與筆數 ｜ Critical明明 App 看得到 339 檔，我的資料庫說 0 檔
—— 只拉 TWSE 的「全市場」主檔，靜默漏掉 23.7%
閱讀完整案例 → 回補與自癒 ｜ High颱風假那天，我的策略照樣「產生了 47 筆訊號」
—— 排程只認星期幾，不認交易所日曆
閱讀完整案例 →完整版預告：20 個付費案例
免費 3 案例只是「延遲 / 完整性 / 日曆」三類各抽一個。完整版覆蓋五大類、20 個案例， 每個都配 invariant、檢查規則與合成測試資料：
A. 延遲與 stale
- API 回空被當「還沒公布」
中介源查無資料就推論官方沒公布，實際官方介面早已入庫，白等一天。 - 當日資料是盤後批次上架，不是流式
分 K 約 16:00 後、日 K 約 18:30 後才齊；排程吃到空檔照樣回報成功。 - 低流動股報價回的是數天前的價格
報價欄位看起來正常，timestamp 沒人檢查，stale 好幾天照樣進計算。 - 拿日盤收盤冒充夜盤行情
指數收 -1.33% 被當夜盤狀態，實際期貨夜盤 -6.62%，隔日開盤全盤誤判。 - 長連線快取未刷新，清單看似合理實漏新掛牌
30 檔的清單「數量正常」，實際漏了 4 檔新商品。
B. 完整性與筆數
- 即時 snapshot 成交量欄位回 0
298 檔商品 total_volume 全 0，流動性過濾器把候選靜默殺光。 - 分頁抓取提早停止
資料庫筆數只有實際的 1/3，但數字「看似合理」沒人起疑。 - 上游腳本從未被排程，下游吃陳舊 fallback 一週
每天照常產出，沒人發現餵進來的是舊檔。 - 停牌股 stale price 混入損益
停牌半年的最後成交價被當即時價，帳面浮賺是幻覺。
C. Schema 與型別
- 日期雙格式未補零
'2026-6-9' 與 '2026-06-09' 並存，排序錯亂＋重複加總，-3% 被報成 -63% 假警報。 - 民國年格式＋自算門檻誤判
'115.06.02' 需轉換；用近似門檻自算官方判定條件，狀態誤判。 - 自算漲停價 tick 檔位取錯
×1.1 = 117.15，實際漲停 117.0（tick 0.5），系統不知道標的已鎖死。 - 衍生指標換算漏乘行使比例
顯示 -35%/日、實際 -0.36%/日，差 100 倍的數字推播了好幾週。 - 「最近發布日期」被誤解成「該日有無公布」
欄位語意誤讀，把正常空窗判成資料異常。 - 股名子字串比對誤判標的
「南亞」匹配到南亞科、「長榮」匹配到長榮航，訊號掛錯股票。
D. 跨來源一致性
- 券商 API 的處置股清單與官方名單不一致
券商端漏判/滯後，官方確實在列，風控形同虛設。
E. 回補與自癒
- Token 過期回 401，「零筆結果」被當「今天沒標的」
認證失敗與空結果混為一談，靜默空轉。 - 排程時間早於資料上架
60 份報告全空、checkpoint 全綠，假成功跑了很久。 - 程式啟動成功但訂閱從未完成
進程活著、log 正常開頭，4 小時零訊號無人知；heartbeat 是唯一解。 - 回補的冪等邊界
「已歸檔跳過」與「限流錯誤需強制重補」混用同一條路徑，洞永遠補不滿。
定價
免費樣本
NT$0
3 個完整案例＋ 8 條檢查規則＋合成 fixtures，本頁直接下載。
限前 10 份
創始預購
NT$1,490
完整版全部內容，與個人正式版相同交付。
個人正式版
NT$2,980
完整版全部內容，個人使用授權。
小團隊版
NT$8,800
完整版全部內容，5 人以內團隊使用授權。
創始預購即將開放
交付內容與邊界
完整版為一次性數位交付，內容固定：
- 20 案例 playbook — 每案例八節完整文件（症狀 → invariant → 重現 → 驗收）
- checks.yaml — 機器可讀檢查規則，可落地成 pandera / great_expectations / 自寫 assert
- 合成 fixtures — 每案例「壞資料 vs 好資料」測試樣本，可直接餵給案例內程式碼
- daily_checklist — 每日資料健康檢查清單
邊界聲明（購買前請讀）
- 一次性購買、固定交付物，不承諾永久更新。
- 不含即時監控服務、客製整合、一對一客服或 debug 服務。
- 不含任何原始行情資料轉售；所有 fixtures 均為合成資料，數字場景取自真實事故。