feat(reject-history): ship report page and archive openspec change

docs/reject_history_performance.md

@@ -7,6 +7,7 @@
 - `DWH.DW_MES_LOTREJECTHISTORY`: 不良/報廢事實表（主來源）
 - `DWH.DW_MES_CONTAINER`: 補齊 `PJ_TYPE`、`PRODUCTLINENAME`、`MFGORDERNAME`
 - `DWH.DW_MES_SPEC_WORKCENTER_V`: 對應 `WORKCENTER_GROUP` 與排序欄位
+- `DWH.ERP_PJ_WIP_SCRAP_REASONS_EXCLUDE`: 良率排除政策表（`ENABLE_FLAG='Y'` 代表不納入良率計算）
 
 ## 資料評估重點（2026-02-13，近 30 天樣本）
 - `DW_MES_LOTREJECTHISTORY` 共 `230,074` 筆；`HISTORYMAINLINEID` 僅 `75,683` 個。
@@ -33,12 +34,69 @@
   - `DEFECT_RATE_PCT = DEFECT_QTY / MOVEIN_QTY * 100`
   - `REJECT_SHARE_PCT = REJECT_TOTAL_QTY / (REJECT_TOTAL_QTY + DEFECT_QTY) * 100`
 
+## 排除政策與前端開關
+- 預設模式：排除 `ERP_PJ_WIP_SCRAP_REASONS_EXCLUDE` 中 `ENABLE_FLAG='Y'` 的報廢原因。
+- 可切換模式：提供 `include_excluded_scrap=true|false` 讓使用者決定是否納入。
+- 前端頁面提供「納入不計良率報廢」開關，並同步影響 summary/trend/pareto/list/export。
+- 排除原因清單採全表快取，預設每日刷新一次（Redis 優先、記憶體 fallback）。
+
+## API 與欄位契約
+- `GET /api/reject-history/options`
+  - 回傳 `workcenter_groups`、`reasons` 與政策 `meta`
+- `GET /api/reject-history/summary`
+  - 回傳 `MOVEIN_QTY`、`REJECT_TOTAL_QTY`、`DEFECT_QTY`、`REJECT_RATE_PCT`、`DEFECT_RATE_PCT`、`REJECT_SHARE_PCT`、`AFFECTED_LOT_COUNT`、`AFFECTED_WORKORDER_COUNT`
+- `GET /api/reject-history/trend`
+  - 回傳趨勢 `items[]`，每筆含 `bucket_date`、`REJECT_TOTAL_QTY`、`DEFECT_QTY`、`REJECT_RATE_PCT`、`DEFECT_RATE_PCT`
+- `GET /api/reject-history/reason-pareto`
+  - 支援 `metric_mode=reject_total|defect`
+  - 支援 `pareto_scope=top80|all`（預設 `top80`）
+- `GET /api/reject-history/list`
+  - 分頁回傳 `items[]` 與 `pagination`
+  - 明細保留五個 reject 欄位（`REJECT_QTY`、`STANDBY_QTY`、`QTYTOPROCESS_QTY`、`INPROCESS_QTY`、`PROCESSED_QTY`）與 `DEFECT_QTY`
+- `GET /api/reject-history/export`
+  - CSV 欄位與 list 語義一致，含 `REJECT_TOTAL_QTY` 與 `DEFECT_QTY`
+
+## 前端視覺與互動
+- 主要區塊：
+  - Header（語義 badge + 更新時間）
+  - 篩選區（時間、原因、`WORKCENTER_GROUP`、政策開關、Pareto 前 80% 開關）
+  - KPI（8 張卡，Reject 暖色語義 / Defect 冷色語義）
+  - 趨勢圖（報廢量與報廢率分圖）
+  - Pareto（柱狀 + 累積線）與明細表
+- 互動規則：
+  - Pareto 點選原因後，會套用為 active filter chip 並重查
+  - 再次點選同原因會取消篩選
+  - 預設僅顯示累計前 80%，可切換顯示完整 Pareto
+  - 匯出 CSV 使用目前畫面相同篩選條件
+
 ## 交付檔案
 - 建表 + 刷新 SQL：`docs/reject_history_performance.sql`
 - 可被應用層直接載入的查詢 SQL：`src/mes_dashboard/sql/reject_history/performance_daily.sql`
 
+## 上線與回滾策略
+- 上線策略：
+  - 先維持 `data/page_status.json` 中 `/reject-history` 為 `dev`
+  - 完成 UAT 後再改為 `released`
+- 回滾策略：
+  - 將 `/reject-history` 狀態切回 `dev` 或移除導航入口
+  - 保留 API 與既有頁面，不影響既有報表
+- 快取策略：
+  - 排除政策表每日全表刷新（預設 86400 秒）
+  - Redis 異常時退回記憶體快取，不阻斷查詢
+
+## 驗證紀錄（2026-02-13）
+- 後端/整合測試：
+  - `pytest -q tests/test_reject_history_service.py tests/test_scrap_reason_exclusion_cache.py tests/test_reject_history_routes.py tests/test_reject_history_shell_coverage.py tests/test_portal_shell_wave_b_native_smoke.py::test_reject_history_native_smoke_query_sections_and_export tests/test_app_factory.py::AppFactoryTests::test_routes_registered`
+  - 結果：`22 passed`
+- 前端建置：
+  - `cd frontend && npm run build`
+  - 結果：成功產出 `reject-history.html/js/css`，並完成 dist 複製流程
+
 ## 建議排程
 - 每日跑前一日增量：
   - `:start_date = TRUNC(SYSDATE - 1)`
   - `:end_date = TRUNC(SYSDATE - 1)`
 - 每月第一天補跑前 31 天，避免補數漏失。
+
+## 已知環境備註
+- `tests/test_navigation_contract.py` 需要 `docs/migration/portal-no-iframe/baseline_drawer_visibility.json`。目前工作區缺少此 baseline 檔案，屬既有環境缺口，與本次 reject-history 開發內容無直接耦合。