docs: 要求订单详情增加作废记录入口

这个提交包含在:
API Changelog Bot 2026-07-20 17:43:23 +08:00
父节点 364828e5ee
当前提交 fcb002f662

查看文件

@ -98,6 +98,23 @@ GET /admin/house/orders/2078739922130243586/requirement-history
4. 详情只要 `voided=true``historicalRequirement=true`,前端必须再次强制只读并隐藏全部业务操作,不能只依赖某一个按钮字段。 4. 详情只要 `voided=true``historicalRequirement=true`,前端必须再次强制只读并隐藏全部业务操作,不能只依赖某一个按钮字段。
5. 人数调整提醒直接展示后端 `changeItems`;按通知 70,人数仅显示“总人数 4 → 3”,不显示成人/儿童等具体人员类型变化。 5. 人数调整提醒直接展示后端 `changeItems`;按通知 70,人数仅显示“总人数 4 → 3”,不显示成人/儿童等具体人员类型变化。
### 当前订单详情增加“作废记录”入口
在当前有效订单的房务详情中增加按钮:`作废记录N`,让房务不必返回列表寻找红色卡片。
- `N` 为该订单历史需求中 `voided=true` 的数量;没有作废记录时可隐藏按钮或显示禁用的 `作废记录0`
- 按钮建议放在详情标题区或需求信息区,与普通业务写操作分开,避免误认为可以恢复作废需求。
- 点击后打开只读抽屉/弹窗,列出该订单全部作废需求,至少展示:需求版本、提交/作废时间、作废原因、原状态。
- 列表数据可使用详情响应的 `requirement.history[]`,按 `voided=true` 过滤;每项必须使用自身 `requirementId`
- 点击某条“查看详情”时调用:
```text
GET /admin/house/orders/{orderId}?requirementId={该条requirementId}
```
- 历史详情继续执行严格只读规则,只能关闭/返回,不能联系、转单、配房、清空、驳回、最终确认或执行其他业务操作。
- 作废记录列表按 `voidedAt DESC` 展示,最新作废记录在前;本入口不改变“我的订单”主列表中作废卡片统一置底的规则。
## 验收 ## 验收
- 同一订单的作废旧行与当前有效行能明确区分,旧行标红并显示原因。 - 同一订单的作废旧行与当前有效行能明确区分,旧行标红并显示原因。
@ -105,5 +122,6 @@ GET /admin/house/orders/2078739922130243586/requirement-history
- 打开旧行后 `viewedRequirementId` 等于该行 `id`,内容为旧需求快照,不出现当前配房。 - 打开旧行后 `viewedRequirementId` 等于该行 `id`,内容为旧需求快照,不出现当前配房。
- 作废详情仅可阅读,所有动作均隐藏或禁用。 - 作废详情仅可阅读,所有动作均隐藏或禁用。
- 删除一名出行人后,调整提醒显示“总人数 4 → 3”。 - 删除一名出行人后,调整提醒显示“总人数 4 → 3”。
- 当前有效订单详情显示“作废记录1”;点击可看到该订单的作废需求列表,并能打开对应只读历史详情。
后端关联:`wx/HL#5092` 后端关联:`wx/HL#5092`