專案導覽
主要讀者：平台負責人、系統分析師、開發工程師、QA 與維運人員。
1 平台要解決的問題
將反覆進行的人工檢查整理成可執行的測試案例。平台依計畫與排程執行操作、比對預期結果，並保留每次執行的案例、步驟與錯誤，讓維護者能找到問題，再交由對應開發人員處理。
本套規格以 Crystal、Northstar、Sentry 為主。OMS、WMS 等業務系統只作為可能的受測系統，不是本套文件的業務流程主角。案例內容原本存於資料庫，目前未取得實際案例資料，因此不把程式支援能力寫成已導入案例或驗收成果。
| 元件 | 簡單說明 | 責任 |
|---|---|---|
| Crystal | 管理平台 | 管理專案、環境、群組、案例、步驟、計畫與觸發器；保存及查詢結果、組合報告 |
| Northstar | 執行服務 | 提供排程及即時觸發入口，承載測試執行 |
| Sentry | 共用測試核心 | 由應用程式引用的程式庫，負責執行流程、步驟處理、資料比對與 Crystal 介接；不是第三個獨立 HTTP 服務 |
2 已確認的使用方式
早上上班時間啟用 EKS 測試環境供同仁使用；半夜啟用環境跑一輪所有測試案例，正常跑完後自動關閉；若失敗、中斷或卡住，到了固定截止時間仍會強制關閉，保留線索供早上啟用後調查。兩個時段共用同一套環境及資料，目前沒有特別隔離。
案例與固定測試資料由開發人員事先準備，維護者確認後套用。測試結果有問題時，維護者先初判，再協調修正；需要重跑時，重跑整個 Plan，建立新的 Run 並保留原結果，不自動只重跑失敗案例。
「全量測試」如何對應 Plan／Trigger、EKS 實際啟停層級，以及固定關閉時間的設定值尚未完整確認。已確認的運作方式不代表三個專案內已具備完整環境控制程式。流程圖會保留這些邊界，不將未知處畫成已完成的功能。
3 文件目錄
| 文件 | 閱讀目的 |
|---|---|
| 專案導覽 | 確認系統定位、分工與文件入口 |
| 01 業務流程與範疇 | 確認操作流程、責任與狀態 |
| 02 BPMN 流程圖集 | 閱讀準備、環境、執行、報告與重跑六張圖 |
| 03 資料模型與儲存 | 確認定義、執行結果與資料責任 |
| 04 資料字典 | 查閱核心表與步驟設定欄位 |
| 05 OPENAPI | 供介接工具使用的 OpenAPI 3.1 規格 |
| 06 整合與交易時序 | 查閱實際 API、防呆、逾時與冪等目標 |
| 07 BDD 規格案例 | 閱讀中文行為例子、現況與目標標籤，以及 feature 原檔 |
| 08 UAT 與驗證 | 區分驗收目標、實際檢查及尚未驗證事項 |
| 09 故障排除手冊 | 查找未啟動、初始化、結果與通知問題 |
開啟 HTML 閱讀版：桌面以左側列表欄切換文件，手機提供可收合目錄；採用簡潔的 Bootstrap 灰藍版型。表格可橫向捲動；點擊流程圖可放大、縮小、符合視窗或關閉，亦可按 Esc 關閉。
4 如何判讀現況與需求
| 標示 | 意義 |
|---|---|
| 程式現況 | 靜態程式可支持的行為，尚不代表部署服務已實測 |
| 使用者確認 | 本次討論確認的操作安排或需求，不以缺少部署程式否定這些安排 |
| 目標設計 | 要達成需求仍須補強或驗證的行為，例如可靠排隊、執行範圍內的相依檢查與安全關閉 |
| 待確認 | 尚未取得規則、設定或資料；不自行補造 |
Run 的 FINISHED 表示執行主流程正常結束，不表示所有案例通過。發起執行回應成功，也不表示已產生 Run；必須查詢實際執行紀錄。現有環境與資料是共用的，不假定已有編輯鎖、完整版本快照、資料隔離或全域環境互斥。
六份 BPMN 都是 isExecutable=false 的分析模型，未配置流程引擎。完整圖集、API 與欄位檢查結果見 驗證紀錄。業務驗收與部署控制須另行驗證，不以文件檢查通過代表平台實際運作已通過。