新增 PChome compact controlled apply readback
Some checks failed
CD Pipeline / deploy (push) Has been cancelled

This commit is contained in:
ogt
2026-07-02 13:28:40 +08:00
parent 99df3b9a76
commit f1795e555d
5 changed files with 376 additions and 4 deletions

View File

@@ -86,6 +86,7 @@
- 2026-07-02 起 PChome AI 自動化主線工作順序以 `docs/guides/pchome_ai_automation_priority_backlog.md` 為可執行 backlog使用者中途插入的 production truth、版本不得錯、GitHub freeze、推版到 Gitea/正式環境、AI 自動化取代人工主流程、外部專業 benchmark、主流專業產品網站、實作結果與完整優先順序要求都必須列入 backlog 並依 P0/P1/P2/P3/P4 推進。未在 backlog 的支線不得蓋過 P0 runtime truth / controlled apply closure。
- 2026-07-02 起 AI automation smoke 必須例行執行 PChome controlled-apply drift monitor`PChome 受控落地 drift monitor` 會以 read-only 方式重放 receipt replay + drift verifier將 drift detected 或 verifier write-risk 升為 `critical`,並在 `/api/ai-automation/smoke` 與每日 smoke 摘要中回報 selector/readback/drift/artifact hash 狀態。
- 2026-07-02 起 PChome controlled-apply drift 必須提供 read-only rollback / re-apply recommendation package`/api/ai/pchome-growth/mapping-backlog/direct-mapping-retry-candidate-exception-controlled-apply-drift-recovery-package` 會輸出 drift recovery actions、controlled re-apply SQL shape、rollback SQL shape、selector bindings、acceptance gates 與 artifact hash verifier。此 package 不執行 SQL、不寫 DB0 drift 時必須產生 no-op evidencedrift detected 時才輸出 ready_for_controlled_reapply actions。
- 2026-07-02 起 PChome controlled-apply 必須提供 compact latest readback endpoint`/api/ai/pchome-growth/mapping-backlog/direct-mapping-retry-candidate-exception-controlled-apply-compact-readback-package` 會收斂 apply、receipt replay、drift verifier、drift recovery 四段 receipt輸出 product status、next machine action、selector readback、drift count、recovery action count 與 artifact hash 狀態。此 endpoint 是後續產品 UI 的主要資料來源,不執行 SQL、不寫 DB。
- V10.644 起 `/ai_intelligence` 的商品明細列不得只用句子描述比價;每列必須顯示 PChome 價格、MOMO 參考價、差距、可信度四格價格證據,並保留下一步按鈕。單位價候選需顯示單位價與單位,候選待確認或缺資料則以「待補 / 候選待確認」呈現,不得捏造價格。
- V10.645 起 `/ai_intelligence` 的商品明細分流切換後,必須顯示「這類商品怎麼處理」的行動摘要,包含件數、近 7 天業績、平均可信度、最大價差、代表商品與主按鈕;使用者不得只能看到商品列表而不知道下一步。
- V10.646 起 `/ai_intelligence` 的商品明細必須提供搜尋與排序;搜尋至少涵蓋商品、分類、商品編號與 MOMO 候選資訊,排序至少支援優先級、近 7 天業績、價差、下滑幅度與可信度。搜尋/排序後的行動摘要與明細列表必須使用同一批結果。

View File

@@ -70,6 +70,10 @@
- `direct-mapping-retry-candidate-exception-controlled-apply-drift-recovery-package` 可輸出 read-only recovery package
- drift detected 時會產生 controlled re-apply SQL shape、rollback SQL shape、selector bindings 與 acceptance gates
- 0 drift 時會產生 no-op evidence避免把正常狀態誤報成人工審核
- Compact latest apply / replay / drift / recovery readback endpoint 已完成:
- `direct-mapping-retry-candidate-exception-controlled-apply-compact-readback-package` 會回傳 apply、replay、drift、recovery 四段 compact receipt
- 產品面可直接讀取 `product_status``next_machine_action`、selector readback、drift count 與 artifact hash 狀態
- compact readback 自身也可 materialize artifact 並驗證 hash
- AI debt scanner 顯示產品面清空:
- `PRODUCT_SURFACE_CLEAR`
- `finding_count=0`
@@ -77,8 +81,7 @@
進行中 / 下一步,必須照順序:
1. 建立正式環境 compact readback endpoint回傳最新 apply / replay / drift / recovery receipts
2. 建立 PChome controlled-apply artifacts retention policy讓 evidence 可追蹤但不無限制膨脹。
1. 建立 PChome controlled-apply artifacts retention policy讓 evidence 可追蹤但不無限制膨脹
完成標準:
@@ -192,8 +195,9 @@
| P0.6 | Drift verifier artifact | 已完成 | drift artifact hash match `1` | 增加 latest compact readback |
| P0.7 | Automated drift monitor | 已完成 | smoke check `PChome 受控落地 drift monitor` | 納入每日 smoke 與 runtime readback |
| P0.8 | Drift rollback / re-apply package | 已完成 | drift recovery package route + focused tests | 接入 compact readback |
| P0.9 | Compact latest apply / replay / drift / recovery readback endpoint | 未開始 | apply/replay/drift/recovery packages exist | 下一個實作 |
| P1.1 | Dashboard AI automation first-viewport surface | 未開始 | API readiness exists | P0 compact readback 後實作 |
| P0.9 | Compact latest apply / replay / drift / recovery readback endpoint | 已完成 | compact readback route + focused tests | 接入 product dashboard first viewport |
| P0.10 | Controlled-apply artifact retention policy | 未開始 | compact artifacts exist | 下一個實作 |
| P1.1 | Dashboard AI automation first-viewport surface | 未開始 | API readiness + compact readback exist | P0 retention policy 後實作 |
| P1.2 | UI wording guard for no raw engineering terms | 未開始 | existing guardrails only | 為新 automation surface 補 tests |
| P2.1 | External benchmark encoded into requirements | 未開始 | benchmark guide exists | 更新 guardrails / tests |
| P3.1 | Extend receipt / replay / drift pattern to more lanes | 未開始 | current retry lane complete | P1 後選下一條 safe lane |