append hotfix #2881 (#2880) AdminOrderStatusLogController 路径回滚: PR #2864 引入 Ambiguous handler 500 回归已闭环

这个提交包含在:
API Changelog Bot 2026-05-22 14:19:58 +08:00
父节点 b80f575fae
当前提交 c434ef5743

查看文件

@ -118,10 +118,25 @@ order.tags[0].color // 用于显示标签底色
---
## 五、关联
## 五、hotfix #2881(回滚 PR #2864 引入的回归)
- 工单: #2863 / #2865(全部 closed)
- PR: #2864 / #2866(全部 squash merged)
QA 真测验证 PR #2864 时发现 `/v3/admin/order/{id}/status-log` 返 500 Ambiguous handler。PR #2864 误把 wx 故意写的 `AdminOrderStatusLogController @RequestMapping("/admin/order")`(被 v2 抢截 404,设计上的"隐藏入口",PRP § 9 R13)改成 `/v3/admin/order`,反而与 OrderController 早就存在的同 URL 端点撞冲突。
**hotfix PR #2881 (#2880)**:
- AdminOrderStatusLogController 路径回滚 `/v3/admin/order``/admin/order`(故意 404 设计)
- AdminOrderStatusLogControllerTest 3 处 mockMvc 同步回滚
- javadoc 加大量警告注释 + 历史教训("严禁改 v3 前缀,会与 OrderController 撞 URL")
**保留 PR #2864 其他改动**:gateway 5 路由追加(complaint/review/internal-review/internal-mp-review/internal-house)是真 bug 修复,保留。
**最终验证**(部署后):
- `/v3/admin/order/{id}/status-log` code=200,真返 `List<LogTimelineVO>` 1 条(occurredAt/operator/action/fromStatus/toStatus/amount 6 字段)
- `/admin/order/{id}/status-log` code=404 维持设计
## 六、关联
- 工单: #2863 / #2865 / #2880(全部 closed)
- PR: #2864 / #2866 / #2881(全部 squash merged)
- QA 报告:
- `.tmp/qa-house-report.txt`(QA-A 46 项)
- `.tmp/qa-ord-report.txt`(QA-B 53 项)