changelog(团期看板): 6904/6905 复审补充知会-排序口径/008 opsStage预告/chips空判/demandStatus与totalPrice待补(管理后台)
changelog-filename-gate / validate (push) Successful in 2s

这个提交包含在:
API Changelog Bot
2026-09-01 10:01:41 +00:00
父节点 6c1d11d40f
当前提交 c66a28b43f
共修改 2 个文件,包含 29 行新增和 1 行删除
@@ -317,6 +317,14 @@ GET /v3/admin/order/group-batch/export?month=2026-06 → 200 size=98(0
- 关联 PR: [wx/HL#6917](https://git.1814.love:8443/wx/HL/pulls/6917)(合并至 dev-v3 @9f689354e)
- 共享地基: #6902(七桶/聚合/权限)、#6915/#6916(契约修正)
## 十一、复审补充知会(2026-09-01)
> 复审轮对现行行为的口径确认,无新接口、无字段结构变更。
1. **排序口径不一致(暂行,待拍板)**:001 看板列表按 `create_time` **倒序**(既有行为未变),009 统计条 / 008 导出按 `depart_date` **升序**——「导出件顺序 ≠ 列表页顺序」当前属预期;001 是否改 `depart_date ASC` 待 wx 确认(决策点③),确认后另行通知对齐。
2. **008 当前忽略 `opsStage`**:本期 008 只收 productId/month/keyword,契约卡的 opsStage 筛选由返工 #6926 补上。**#6926 上线后:桶筛选态点「导出表格」必须带上当前 `opsStage`**,否则导出为全量(当前行为:传了也被静默忽略)。
3. 同随 #6926 上线:009 自校验日志修正(内部可观测性,前端无感)、month 非法值容错跳过(不再 500)。
## 关联 / 联系人
### 链接
@@ -65,7 +65,7 @@ base: "dev-v3"
| 字段 | 位置 | 类型 | 必填 | 约束 | 说明 |
|------|------|------|------|------|------|
| productType | Query | String | 否 | - | 产品类型筛选;不传=不限(向后兼容) |
| productType | Query | String | 否 | - | 产品类型筛选;不传=只看团期产品(上游恒定 GROUP 范围,详见「十一、复审补充知会」第 2 条勘误) |
| keyword | Query | String | 否 | - | 产品名关键词(原有行为不变) |
#### 出参 `Result<GroupBatchProductItemRespVO>`
@@ -432,6 +432,26 @@ GET /v3/admin/order/group-batch/<groupBatchId>/orders?includeTravelers=true&incl
- 合并落点: [wx/HL commit 47aaff0be](https://git.1814.love:8443/wx/HL/commit/47aaff0be)(dev-v3)
- 后续计划: regionText 上游 product-v2 补齐 + 前端展示验收(另行交接)
## 十一、复审补充知会(2026-09-01)
> 复审轮对 #6903/#6904/#6905 已上线行为的口径确认与勘误,无新接口、无字段结构变更;其中 2 项已开返工(见文末表)。
### 联调口径(现行行为,按此开发)
1. **【001】无活跃子订单的团期 `chips` 整体为 `null`**(不是六键全「待办」)。有单团期六键全在(聚合态四值:待办/处理中/已完成/异常;个别键可为 null)。渲染芯片前判 `chips != null`,null 时按「未开始」占位。
2. **【000】`productType` 实际只能看团期产品**:上游产品域只返回 GROUP 产品,传非 GROUP 值得空列表;「不限类型查普通产品」是面向隐式团的规划能力,当前不可达。§三.1 入参表原「不传=不限」描述有误,已就地勘误,以本条为准。
3. **【003】`demandStatus`(本户需求态 SUBMITTED/CONFIRMED/REJECTED)不下发**:契约卡 GB-ADM-003 有该字段但本期未实现,响应中不存在;原型名单表「打回 / 已重提」列暂无数据源,请先隐藏或恒占位,勿依赖。
4. **【003】`totalPrice`(本户应收)暂缺**:「预计毛利 = totalPrice − estimatedCost」在返工 #6929 上线前算不了(`estimatedCost` 已可用)。**请勿用 `paidAmount + balanceAmount` 自算应收**(含退款场景口径不对)。#6929 上线后 `totalPrice` 为 JSON 字符串,取消单返 `"0"`。
5. **【003】`include*=false` 时扩展字段「键在、值为 null」**:`travelers / roomCount / roomType / specialNeeds` 键仍存在、值为 `null`,判 `null` 即可,勿用 `key in obj` 判断。
6. **【003】`birthdayInTrip` 跨年行程可能漏报**:跨年团(12 月~1 月)里 1 月生日的出行人可能误判 `false`,返工 #6929 修复;上线前领队生日提醒在跨年团上可能漏报,知悉即可。
### 在途返工(上线后另行同步)
| 工单 | 内容 | 前端影响 |
|------|------|----------|
| #6926 | 008 导出补 `opsStage`;009 自校验修正;month 非法值容错 | 见 `01_6904_*` 第十一节 |
| #6929 | 003 补 `totalPrice`;`birthdayInTrip` 跨年修正;内部双包装收敛 | 上线后可用 `totalPrice − estimatedCost` 算预计毛利;其余无感 |
## 关联 / 联系人
### 链接