03 資料模型與儲存

主要讀者：DBA、後端研發工程師、測試平台維護者。

1 範圍與責任

本章只描述 Crystal／Sentry／Northstar E2E 測試平台。受測 API 與其業務資料是測試對象，不納入本平台實體字典。Sentry 是共用核心 library，並非另一個獨立資料服務。

圖中的型別是 Java 映射型別。PK 表示映射識別鍵，FK 表示邏輯關聯；實體約束是否已部署尚未查驗。歷史建表雖有部分 PK/FK 宣告，但不足以證明現場 schema 與工作樹一致。完整欄位與歷史／現行差異見 04 資料字典。

1-1 實體對照與資料來源

1-2 定義、結果、業務資料分開

早上供同仁使用及半夜測試，使用同一套 EKS 環境和資料。時間分流本身沒有資料隔離、互斥或每次 Run 還原到同一資料狀態的保證。夜間固定會強制關閉，早上再次啟動後須能查到前一夜的線索；不因測試異常或 Run 尚未結束而持續保留執行環境。關閉時可能仍有 RUNNING 紀錄，須在早上核對最後回報。這是已確認需求，尚未驗證完整持久化及強制關閉實作；目前 17 張表未提供完整環境啟停生命週期欄位，不能將 Run 的完成狀態當作 EKS 已關閉的證據。

2 識別碼、hooks 與結果快照

2-1 必須保留每次執行的識別碼

例如 BeforeEach 會在每個一般 Case 前執行，因此不能將 (runNum, caseNum) 設為所有結果的唯一鍵。結果查詢應沿 run_num → run_suite_num → run_case_num → run_step_num 取得證據。重跑會新增結果，不把第一次失敗改成第二次成功。

2-2 設定記錄的界限

結果列在執行時仍會更新狀態、時間與回應。部分報告仍 JOIN 現行 Case／Step 名稱；修改定義後，舊報告所有顯示內容並不保證不變。因此不能宣稱現況是不可變快照或完整可重播系統。

3 一致性與防呆

完整組合欄位規則見 字典第 6 節，整合錯誤規格見 06 整合與交易時序。

4 索引與並行控制

4-1 索引候選

以下來自現行查詢模式，是待評估的索引設計，不是已部署清單。先查現有索引並使用測試環境的查詢計畫評估，避免重複建立。

4-2 現況與改善邊界

若後續建立環境使用權與固定版本，需新增相應模型及交易設計。這些提案不能填成目前資料庫已存在的表、欄位或狀態。

5 產物、報表與保留

5-1 現有產物與報表

SQL 比對 handler 目前將結果加入 SqlCompareReport_<runNum>.json。Crystal 同時保有 qa_r001／qa_r002 的寫入介面及報告查詢；兩套儲存的資料來源須分別驗證，不能假設每個新 Run 都自動填滿比對表。

Email 一般案例統計只包含已記錄的 NORMAL RunCase：PASSED 為通過，FAILED／ERROR 合併為失敗，其他狀態以餘數歸入略過。零案例現況回傳 100。必須另外核對原定案例與實際結果筆數，才能判斷測試是否完整。

5-2 固定強制關閉與隔日追查

已確認需求：夜間固定強制關閉，但要留下隔天早上啟動後可查的線索。 因此證據應在執行過程持續送出，不能只依靠正常完成、最後一個 after hook 或關閉時的 finally 才保存。

持久化是目標驗收條件，尚未證實部署已達成。 結果資料庫、日誌及產物必須位於不會隨本次執行容器／節點關閉而遺失的儲存；目前只有寫入邏輯及路徑資訊，尚未查驗磁碟掛載、外部儲存、最後寫入完成或停機後讀取。證據未確認保存是需告警與追查的缺口，不將它解讀為可以取消固定強制關閉。

強制關閉可能來不及更新終態。早上先查前一夜 RUNNING 或缺少結束時間的紀錄，對照最後步驟、日誌與關閉事件，再依實際結果補註中斷原因；不能直接把所有殘留 RUNNING 判成正常完成。狀態整理是目標流程，尚未證實已有自動 reconciliation。保留原本結果與狀態修正線索；人工重跑另建新 Run，不用新結果覆寫前一夜的失敗或不完整證據。

5-3 保留政策

結果與產物保留期限若採既有需求的 90 天，應包含關聯結果、比對明細及檔案清理策略；目前未證實排程清理已實作。本文件不執行刪除，清理前應先驗證保留期間及下游引用。

6 DBA 唯讀核對

本次沒有連線查詢實際資料庫。以下 PostgreSQL metadata 查詢可用於確認測試環境的部署事實；不需讀取 config_value 或實際案例內容。

6-1 欄位與實體型別

SELECT table_name, ordinal_position, column_name,
       data_type, udt_name, character_maximum_length,
       numeric_precision, numeric_scale, is_nullable, column_default
FROM information_schema.columns
WHERE table_schema = 'qa'
  AND table_name IN ('qa_c001','qa_c002','qa_c003','qa_c004','qa_c005',
                     'qa_c006','qa_c007','qa_c008','qa_c009','qa_c010',
                     'qa_c011','qa_c012','qa_c013','qa_r001','qa_r002',
                     'qa_u001','qa_z000')
ORDER BY table_name, ordinal_position;

6-2 完整約束與索引

SELECT t.relname AS table_name, c.conname, c.contype,
       pg_get_constraintdef(c.oid) AS definition
FROM pg_constraint c
JOIN pg_class t ON t.oid = c.conrelid
JOIN pg_namespace n ON n.oid = t.relnamespace
WHERE n.nspname = 'qa'
  AND t.relname IN ('qa_c001','qa_c002','qa_c003','qa_c004','qa_c005',
                    'qa_c006','qa_c007','qa_c008','qa_c009','qa_c010',
                    'qa_c011','qa_c012','qa_c013','qa_r001','qa_r002',
                    'qa_u001','qa_z000')
ORDER BY t.relname, c.conname;

SELECT tablename, indexname, indexdef
FROM pg_indexes
WHERE schemaname = 'qa'
  AND tablename IN ('qa_c001','qa_c002','qa_c003','qa_c004','qa_c005',
                    'qa_c006','qa_c007','qa_c008','qa_c009','qa_c010',
                    'qa_c011','qa_c012','qa_c013','qa_r001','qa_r002',
                    'qa_u001','qa_z000')
ORDER BY tablename, indexname;

6-3 組合鍵重複檢查

SELECT plan_num, case_num, count(*) AS duplicate_count
FROM qa.qa_c006
GROUP BY plan_num, case_num
HAVING count(*) > 1;

SELECT env_num, config_key, count(*) AS duplicate_count
FROM qa.qa_c012
GROUP BY env_num, config_key
HAVING count(*) > 1;

不要對 RunCase 執行 (runNum, caseNum) 去重：BeforeEach／AfterEach 的重複結果可能是正確紀錄。物理約束、資料完整性與並行寫入尚待實測，驗收方式見 08 UAT 與驗證。