異體字落地替換 S9：文件收尾（API／openapi／CHANGELOG／計畫狀態）

[sudoghut]

這是什麼

docs/CHAR_VARIANT_MAP_TEXT_COLUMN_ROLLOUT_PLAN.md 的 S9（最後一步）：文件收尾。純文件，無程式碼改動。

內容

• API.md：v1 舊版 operations 通道補三條事實——json 的文本值先替換才存進 resource_data（resource 需精確拼寫，否則整包不替換）；resource_original 是寫入前的既有列快照、刻意不替換（因此審核 diff 會多出「字形被改寫」那幾行，是預期現象）；眾包核准回填會再替換一次（舊提案可能早於本次上線，依 D8 幂等）。
• docs/openapi/openapi.yaml：原本完全沒有 notices。補 Notices schema 並掛到 MutationSuccessResponse 與 ErrorResponse（成功與 409／422 都會帶），info.description 補一段落地替換說明。example 用真實訊息格式，並註明一次請求只有一則通知、不逐欄歸屬。
• CHANGELOG.md：記一則，明確標為行為擴張而非修 bug。含使用者最需要知道的三件事：所有文本欄（含 c_notes）都會被改寫；不做回溯校正所以「兩形並存」是常態、精確比對一律要兩形都探；以及 D9——搜尋端完全沒有歸一，新舊資料互相搜不到。
• 計畫文件補「執行狀態」表（S0～S9 的 commit）與與原計畫的偏差逐條記錄。
• 第二階段文件的「未涵蓋其他文本錄入入口」改為指向本階段（已完成），並標明其下三小點記錄的是當時狀態。

驗證

• review agent 與 codex 各一輪。修掉的錯誤陳述：resource_original 不是「使用者送出的字形」而是既有列快照（且 add 不寫、部分 delete 分支寫 null）、核准回填其實會再替換一次、拼音歸一是 v→ü 不是 ue、通知格式不含欄位名、排除清單與涵蓋路徑清單原本是不完整的列舉卻寫得像完整。
• 全量測試：2955 tests / 15539 assertions 綠。
• openapi.yaml 通過 YAML 與 OpenAPI 3.1 解析。

🤖 Generated with Claude Code