fix release rollback guards and sync api docs

This commit is contained in:
Chris
2026-03-23 22:56:19 +08:00
parent 752d7aba4d
commit 9a43563d45
5 changed files with 73 additions and 41 deletions

View File

@@ -201,8 +201,9 @@
- Path 必填:`release_id`
- 業務行為:
- 目標 release 先降為 `draft`
- 嘗試把同 experiment版本號較小、最新的一筆 `draft` 升為 `published`
- 只允許 rollback 目前 `published` 的 release否則 `409`
- 會找同 experiment 中「版本號較小且非 archived」的最新 release 升為 `published`
- rollback 完成後,會強制同 experiment 僅保留一個 `published`
### `POST /api/admin/releases/{release_id}/archive`
@@ -379,6 +380,11 @@
1. 同一 experiment 下,所有 variant 的 `traffic_weight` 加總不等於 `100`
### `rollback` 回 `409` 常見原因
1. 你指定的 release 目前不是 `published`
2. 該 release 沒有更早的非 archived 版本可回退。
### `editor PUT changes` 看起來「少資料」的常見原因
1. 你沒有把舊 change id 一起送回去,會被 full-replace 刪掉。