diff --git a/changelogs-v2/2026-09/01_6904_团期看板统计条与导出-GB-ADM-009-008-新增接口-管理后台.md b/changelogs-v2/2026-09/01_6904_团期看板统计条与导出-GB-ADM-009-008-新增接口-管理后台.md index bbbf32c7..daf64c4a 100644 --- a/changelogs-v2/2026-09/01_6904_团期看板统计条与导出-GB-ADM-009-008-新增接口-管理后台.md +++ b/changelogs-v2/2026-09/01_6904_团期看板统计条与导出-GB-ADM-009-008-新增接口-管理后台.md @@ -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)。 + ## 关联 / 联系人 ### 链接 diff --git a/changelogs-v2/2026-09/01_6905_团期看板-4-接口对齐补全-GB-ADM-000-001-002-003-修改接口-管理后台.md b/changelogs-v2/2026-09/01_6905_团期看板-4-接口对齐补全-GB-ADM-000-001-002-003-修改接口-管理后台.md index ad71b764..1e028849 100644 --- a/changelogs-v2/2026-09/01_6905_团期看板-4-接口对齐补全-GB-ADM-000-001-002-003-修改接口-管理后台.md +++ b/changelogs-v2/2026-09/01_6905_团期看板-4-接口对齐补全-GB-ADM-000-001-002-003-修改接口-管理后台.md @@ -65,7 +65,7 @@ base: "dev-v3" | 字段 | 位置 | 类型 | 必填 | 约束 | 说明 | |------|------|------|------|------|------| -| productType | Query | String | 否 | - | 产品类型筛选;不传=不限(向后兼容) | +| productType | Query | String | 否 | - | 产品类型筛选;不传=只看团期产品(上游恒定 GROUP 范围,详见「十一、复审补充知会」第 2 条勘误) | | keyword | Query | String | 否 | - | 产品名关键词(原有行为不变) | #### 出参 `Result` @@ -432,6 +432,26 @@ GET /v3/admin/order/group-batch//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` 算预计毛利;其余无感 | + ## 关联 / 联系人 ### 链接