72 行
3.2 KiB
Markdown
72 行
3.2 KiB
Markdown
---
|
||
schema: "hl-changelog/v2"
|
||
ticket: "8343"
|
||
title: "团单不提供用餐：按订单ID的用餐接口拒绝团单"
|
||
consumer: "admin"
|
||
author: "lc(GIT)"
|
||
change_type: "修改接口"
|
||
backend_status: "deployed"
|
||
gateway_status: "verified"
|
||
frontend_status: "verified"
|
||
frontend_owner: "mmg"
|
||
frontend_ref: "9cec969365fbb6c059cc2d1271dcecd68f49e3e9"
|
||
target_release: "v2.1"
|
||
verified_at: "2026-09-24"
|
||
status_note: "已部署 TEST 并经 Gateway 实测通过。团单（订单详情 main.groupOrder=true）只传 orderId 调用餐查询、生成、保存、重置、套用模版 5 个接口，统一返回 589614「团单不提供用餐」，不写库；散客单不变；只传 groupBatchId 的团期用餐不变。 前端已交付并验证：v3Adapter 透传 main.groupOrder，MealTab isGroupOrderMeal 守卫——订单维度且团单时不发起用餐 1/2/3/4/7 号共 5 接口，页签只渲染空态说明，编辑工具条同隐；团期维度与散客单不变。MealTab spec 27 例全绿（新增 2 例），hl-admin@9cec9693。"
|
||
updated_at: "2026-09-24"
|
||
base: "dev-v3"
|
||
---
|
||
|
||
# order-v3: 团单不提供用餐，按订单ID的用餐接口拒绝团单
|
||
|
||
> **服务**: hl-order-service-v3
|
||
> **PR**: #8347
|
||
> **Issue**: #8343
|
||
> **日期**: 2026-09-24
|
||
> **影响范围**: 管理后台订单用餐（按订单维度）的查询、生成、保存、重置与套用模版
|
||
|
||
---
|
||
|
||
## ⚠️ 关键变化
|
||
|
||
- 🆕 **团单报错**：订单是团单时，下表 5 个接口只传 `orderId` 调用，统一返回业务错误 `589614`「团单不提供用餐」，不写库。**查询也报错，不返回空列表。**
|
||
- ℹ️ **判团字段**：订单详情 `GET /v3/admin/order/{id}` 的 `main.groupOrder`（`true` 为团单），与订单列表「订单类型=团单」同口径；该字段本次不改。
|
||
- ℹ️ **不受影响**：散客单（`main.groupOrder=false`）行为不变；只传 `groupBatchId` 的团期用餐不变；存为模版（4.2）不变。
|
||
- ℹ️ **报错先后**：订单不存在、无权（581045 / 581008）、已完成或已取消（589607）仍按原错误码先报，之后才判团单。
|
||
- 🔁 **与 #8230 不同**：#8230 起团期子订单可按 `orderId` 保存、套用用餐，本次起团单这样调用返回 589614。
|
||
|
||
---
|
||
|
||
## 二、变更接口清单
|
||
|
||
| # | 接口 | 方法 | 路径 | 变更类型 | 说明 |
|
||
|---|---|---|---|---|---|
|
||
| 1 | 查询用餐信息列表（3.1） | GET | `/v3/admin/order/meal-info/list` | 修改 | 只传 `orderId` 且为团单 → 589614 |
|
||
| 2 | 生成用餐信息（3.2） | POST | `/v3/admin/order/meal-info/generate` | 修改 | 同上 |
|
||
| 3 | 保存用餐信息（整单，3.3） | POST | `/v3/admin/order/meal-info/save` | 修改 | 同上 |
|
||
| 4 | 重置用餐信息（3.4） | POST | `/v3/admin/order/meal-info/reset` | 修改 | 同上 |
|
||
| 5 | 套用用餐模版（4.3） | POST | `/v3/admin/order/meal-template/apply` | 修改 | 同上 |
|
||
|
||
入参、出参字段不变。
|
||
|
||
---
|
||
|
||
## 三、错误码
|
||
|
||
| 错误码 | 文案 | 触发 |
|
||
|---|---|---|
|
||
| 589614 | 团单不提供用餐 | 上表 5 个接口只传 `orderId`，该订单是团单 |
|
||
|
||
---
|
||
|
||
## 四、前端动作
|
||
|
||
- 订单详情按 `main.groupOrder=true` 判团单，团单不提供用餐，不调用上表 5 个接口。
|
||
- 收到 589614 时按普通业务错误提示文案。
|
||
|
||
---
|
||
|
||
## 联系人
|
||
|
||
@lc
|