docs(changelog): 6905 团期看板 4 接口对齐补全-逐接口规范化请求/响应/空数据/错误/业务边界示例顺序

2026-09-01 15:15:47 +08:00
@@ -85,6 +85,19 @@ GET /v3/admin/order/group-batch/products?productType=&keyword=
 }
 ```

+#### 空数据 / 降级响应
+
+```json
+{
+  "code": 200,
+  "message": "成功",
+  "data": []
+}
+```
+
+- 无数据 → 空数组，不报错。
+- 未登录 → 401（网关拦截）。
+
 #### 错误响应

 ```json
@@ -95,11 +108,6 @@ GET /v3/admin/order/group-batch/products?productType=&keyword=
 }
 ```

-#### 空数据 / 降级响应
-
- 无数据 → 空数组，不报错。
- 未登录 → 401（网关拦截）。
-
 #### 业务边界

 - 未传筛选 = 不过滤，等价旧行为；regionText 为 null 时不阻断列表。
@@ -142,6 +150,22 @@ GET /v3/admin/order/group-batch?pageNo=1&pageSize=5&opsStage=FORMED&month=2026-0
 }
 ```

+#### 空数据 / 降级响应
+
+```json
+{
+  "code": 200,
+  "message": "成功",
+  "data": {
+    "records": [],
+    "total": 0
+  }
+}
+```
+
+- 无匹配 → records 空数组 total=0。
+- 排序保持 create_time DESC（向后兼容，未做排序变更）。
+
 #### 错误响应

 ```json
@@ -152,11 +176,6 @@ GET /v3/admin/order/group-batch?pageNo=1&pageSize=5&opsStage=FORMED&month=2026-0
 }
 ```

-#### 空数据 / 降级响应
-
- 无匹配 → records 空数组 total=0。
- 排序保持 create_time DESC（向后兼容，未做排序变更）。
-
 #### 业务边界

 - opsStage 非法/未知 = 不过滤（保守向后兼容）；month 格式非法 → 业务 400。
@@ -195,6 +214,18 @@ GET /v3/admin/order/group-batch/<groupBatchId>
 }
 ```

+#### 空数据 / 降级响应
+
+```json
+{
+  "code": 200,
+  "message": "成功",
+  "data": null
+}
+```
+
+- 团期不存在 → 业务 404。
+
 #### 错误响应

 ```json
@@ -205,10 +236,6 @@ GET /v3/admin/order/group-batch/<groupBatchId>
 }
 ```

-#### 空数据 / 降级响应
-
- 团期不存在 → 业务 404。
-
 #### 业务边界

 - PRIMARY 报道人未配置时两 reporter 字段为 null，不降级不报错。
@@ -254,6 +281,19 @@ GET /v3/admin/order/group-batch/<groupBatchId>/orders?includeTravelers=true&incl
 }
 ```

+#### 空数据 / 降级响应
+
+```json
+{
+  "code": 200,
+  "message": "成功",
+  "data": []
+}
+```
+
+- 无子订单 → 空数组。
+- 证件号/游客手机号永不返回（数据安全边界）。
+
 #### 错误响应

 ```json
@@ -264,11 +304,6 @@ GET /v3/admin/order/group-batch/<groupBatchId>/orders?includeTravelers=true&incl
 }
 ```

-#### 空数据 / 降级响应
-
- 无子订单 → 空数组。
- 证件号/游客手机号永不返回（数据安全边界）。
-
 #### 业务边界

 - include* 参数不传 = 不加载对应数据（零开销，向后兼容）。