From d1f183115e50136c7336e8c1b1ce72d095c6fe32 Mon Sep 17 00:00:00 2001
From: lc <liuchang@1814.love>
Date: Mon, 21 Sep 2026 10:34:03 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#8086=20=E9=A4=90=E9=A3=9F?=
 =?UTF-8?q?=E4=B8=8D=E5=85=B3=E8=81=94=E9=A4=90=E5=8E=85=E6=97=B6=E9=A4=90?=
 =?UTF-8?q?=E5=8E=85=E5=90=8D=E8=BF=94=E5=9B=9E=20null=EF=BC=8C=E5=88=86?=
 =?UTF-8?q?=E9=A1=B5=E6=8C=89=E9=A4=90=E5=8E=85=E5=BB=BA=E6=A1=A3=E5=85=88?=
 =?UTF-8?q?=E5=90=8E=E6=8E=92=E5=BA=8F=EF=BC=88=E4=BF=AE=E6=94=B9=E6=8E=A5?=
 =?UTF-8?q?=E5=8F=A3=C2=B7=E7=AE=A1=E7=90=86=E5=90=8E=E5=8F=B0=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 ...�厅返回null与分页按�厅排�-修改接�-管���.md | 361 ++++++++++++++++++
 1 file changed, 361 insertions(+)
 create mode 100644 changelogs-v2/2026-09/21_8086_�食�关��厅返回null与分页按�厅排�-修改接�-管���.md

diff --git a/changelogs-v2/2026-09/21_8086_�食�关��厅返回null与分页按�厅排�-修改接�-管���.md b/changelogs-v2/2026-09/21_8086_�食�关��厅返回null与分页按�厅排�-修改接�-管���.md
new file mode 100644
index 00000000..74362d0c
--- /dev/null
+++ b/changelogs-v2/2026-09/21_8086_�食�关��厅返回null与分页按�厅排�-修改接�-管���.md
@@ -0,0 +1,361 @@
+---
+schema: "hl-changelog/v2"
+ticket: "8086"
+title: "�食�关��厅时�厅�返回 null，分页按�厅排�"
+consumer: "admin"
+author: "lc(GIT)"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "�食出� restaurantName ��对�关��厅的�食返回「全部�，改为 null（分页�下拉�详情一致）；�食分页顺�改为按�厅建档先�归并�组内创建时间倒���关��厅的排最�。�端需按本文对接。"
+updated_at: "2026-09-21"
+base: "dev-v3"
+---
+
+# resource: �食�关��厅时�厅�返回 null，分页按�厅排�
+
+> **�务**: hl-resource-service
+> **PR**: #8090
+> **Issue**: #8086
+> **日期**: 2026-09-21
+> **影�范围**: 管���「�食管��分页�下拉�详情 3 个读接�
+
+---
+
+## ⚠� 关键�化
+
+- � **`restaurantName` ��返回「全部�**：�关��厅的�食，`restaurantName` 由 `"全部"` 改为 `null`；`restaurantId` �为 `null`。分页�下拉�详情三个接��径一致。页�上�显示「全部�由�端在 `restaurantId` 为 `null` 时自行展示。
+- � **分页顺��了**：`GET /admin/dish/items/page` 由「更新时间倒��改为「按�厅建档先�归并 → �一�厅内创建时间倒� → �关��厅的整组排最��。改过的�食��被顶到列表最�。
+
+---
+
+## 二��更接�清�
+
+| # | 接� | 方法 | 路径 | �更类型 | 说明 |
+|---|---|---|---|---|---|
+| 1 | 分页查询�食 | GET | `/admin/dish/items/page` | 修改 | 出� `restaurantName` �值�化；返回顺��化 |
+| 2 | �食下拉列表 | GET | `/admin/dish/items/list` | 修改 | 出� `restaurantName` �值�化；顺��� |
+| 3 | �食详情 | GET | `/admin/dish/items/{dishId}/view` | 修改 | 出� `restaurantName` �值�化 |
+
+---
+
+## 三�接�详情
+
+出� `restaurantName` 的�值�径三个接�完全一致，下表对三处都适用：
+
+| 情况 | `restaurantId` | 改动� `restaurantName` | 改动� `restaurantName` |
+|---|---|---|---|
+| �食�关��厅 | `null` | `"全部"` | `null` |
+| 关��厅，�厅正常 | �厅 ID | �厅�称 | �厅�称（��） |
+| 关��厅，�厅已删除/查�到 | �厅 ID | `null` | `null`（��） |
+
+### 1. 分页查询�食 `GET /admin/dish/items/page`
+
+**VO**: `DishPageReqVO` → `PageResult<DishListItemRespVO>`
+
+#### 使用场景
+
+管���「�食管��列表页。
+
+#### 入�字段表
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| 全部入� | Query | — | — | — | `page`�`pageSize`�`keyword`�`status`�`settleType`�`createdByName` ���，本次�新增��删除入� |
+
+�支�自定义排��数，顺�由�端固定。
+
+#### 出�字段表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| records[].restaurantId | String | �厅 ID；�关��厅为 `null`（��） |
+| records[].restaurantName | String | **�值�化**。按上表：�关��厅由 `"全部"` 改为 `null` |
+| records[] 其余字段 | — | `dishId`�`dishName`�`unitPrice`�`priceUnit`�`imageUrl`�`settleType`�`status`�`remark`�`createdBy`�`createdByName`�`createdAt` ��� |
+| total / page / pageSize | — | �� |
+
+**返回顺��化**，排�键�次为：�关��厅的排最� → �厅建档先�（�厅 ID ��）→ �一�厅内创建时间倒� → �食 ID 倒�。改动�是「更新时间倒���食 ID 倒��。
+
+```
+�厅甲（建档最早）  其下�食按创建时间倒�
+�厅乙              其下�食按创建时间倒�
+…
+�关��厅的�食     按创建时间倒�，整组排在最�
+```
+
+#### 请求示例
+
+```http
+GET /admin/dish/items/page?page=1&pageSize=20
+Authorization: Bearer <admin token>
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "total": 32,
+    "page": 1,
+    "pageSize": 20,
+    "records": [
+      {
+        "dishId": "2100978382416141313",
+        "restaurantId": "2023382100664676353",
+        "restaurantName": "�香园�锅",
+        "dishName": "儿童�",
+        "unitPrice": 25.00,
+        "priceUnit": "person",
+        "settleType": "cash",
+        "status": 1,
+        "createdAt": "2026-09-19 00:00:38"
+      },
+      {
+        "dishId": "2101571815203901441",
+        "restaurantId": null,
+        "restaurantName": null,
+        "dishName": "全顺车队-特供",
+        "unitPrice": 200.00,
+        "priceUnit": "person",
+        "settleType": "cash",
+        "status": 1,
+        "createdAt": "2026-09-20 15:19:01"
+      }
+    ]
+  }
+}
+```
+
+#### 空数� / �级�应
+
+`records` 为 `[]`�`total` 为 `0`：筛选�件没命中任何未删除�食。
+
+#### 错误�应
+
+```json
+{ "code": 400, "message": "�页�数最大为100", "success": false, "data": null }
+```
+
+#### 业务边界
+
+- 翻页按�一顺�切分，�会出现跨页��或��。
+- �厅被删除�，其下�食�按原�厅的�置排�，�会跑到末尾；末尾�放 `restaurantId` 为 `null` 的�食。
+- �一�厅内创建时间相�的�食，按�食 ID 倒�稳定排列。
+- �食被修改���被顶到列表最�（排�基准由更新时间改为创建时间）。
+
+### 2. �食下拉列表 `GET /admin/dish/items/list`
+
+**VO**: `DishListReqVO` → `List<DishListItemRespVO>`
+
+#### 使用场景
+
+�食下拉数��。
+
+#### 入�字段表
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| 全部入� | Query | — | — | — | `restaurantId`�`keyword`�`settleType`�`limit` ���，本次�新增��删除入� |
+
+#### 出�字段表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| [].restaurantName | String | **�值�化**。按上表：�关��厅由 `"全部"` 改为 `null` |
+| [] 其余字段 | — | ��� |
+
+返回顺�（创建时间����食 ID ��）与�数上���。
+
+#### 请求示例
+
+```http
+GET /admin/dish/items/list?limit=50
+Authorization: Bearer <admin token>
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": [
+    {
+      "dishId": "2100767758525329410",
+      "restaurantId": null,
+      "restaurantName": null,
+      "dishName": "GL8车队-特供",
+      "unitPrice": 99999999.99,
+      "priceUnit": "person",
+      "settleType": "company",
+      "status": 1,
+      "createdAt": "2026-09-18 10:03:59"
+    }
+  ]
+}
+```
+
+#### 空数� / �级�应
+
+`data` 为 `[]`：按当��件没有上架�食。
+
+#### 错误�应
+
+```json
+{ "code": 400, "message": "limit最大为200", "success": false, "data": null }
+```
+
+#### 业务边界
+
+- 本次�改 `restaurantName` �值，�改该接�返回哪些行�返回顺�与�数上�。
+- 下架�已删除的�食任何情况下都�返回。
+
+### 3. �食详情 `GET /admin/dish/items/{dishId}/view`
+
+**VO**: `Long dishId` → `DishRespVO`
+
+#### 使用场景
+
+「�食管��列表点开编辑时回显���食。
+
+#### 入�字段表
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| dishId | Path | String | 是 | 雪花 ID | �食 ID（��） |
+
+#### 出�字段表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| restaurantName | String | **�值�化**。按上表：�关��厅由 `"全部"` 改为 `null` |
+| 其余字段 | — | 与分页 `records[]` 相�，��� |
+
+#### 请求示例
+
+```http
+GET /admin/dish/items/2101571815203901441/view
+Authorization: Bearer <admin token>
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "dishId": "2101571815203901441",
+    "restaurantId": null,
+    "restaurantName": null,
+    "dishName": "全顺车队-特供",
+    "unitPrice": 200.00,
+    "priceUnit": "person",
+    "settleType": "cash",
+    "status": 1,
+    "createdAt": "2026-09-20 15:19:01"
+  }
+}
+```
+
+#### 空数� / �级�应
+
+�存在空数�形�；�食�存在或已删除时走错误�应。
+
+#### 错误�应
+
+```json
+{ "code": 340001, "message": "�食�存在", "success": false, "data": null }
+```
+
+#### 业务边界
+
+- 回显时 `restaurantId` 为 `null` �该�食�关�具体�厅；`restaurantName` �为 `null`，��下�「全部�文案。
+
+---
+
+## 四�契约约�与正确调用方�
+
+- 判断一��食「有没有�厅��看 `restaurantId` 是�为 `null`，���用 `restaurantName === "全部"` 判断。
+- 页�需�显示「全部�字样时，�端在 `restaurantId` 为 `null` 时自行渲染；�端��下�该文案。
+- 入���：新建�修改�食时�传 `restaurantId` �表示该�食�关�具体�厅。
+- 分页�支�自定义排��数，顺�由�端固定。
+- 「全部��是业务上的一类（�关�具体�厅的�食），�期 #8087 的�食下拉按�厅�动沿用该语义；本次�是�端��把「全部�作为 `restaurantName` 的值下�。
+
+---
+
+## 六�边界行为
+
+- �厅被删除�，其下�食的 `restaurantName` 为 `null`�`restaurantId` �返回原值；该�食�按原�厅的�置排�，�会跑到末尾（末尾�放 `restaurantId` 为 `null` 的�食）。
+- �一�厅内创建时间相�的�食，按�食 ID 倒�稳定排列。
+
+---
+
+## 六.6�修改��对比
+
+| 项 | 改动� | 改动� |
+|---|---|---|
+| �关��厅的 `restaurantName` | `"全部"` | `null` |
+| 分页排� | `更新时间倒�, �食ID倒�` | `�关��厅排最�, �厅建档先�, 创建时间倒�, �食ID倒�` |
+| 下拉�详情排�与其他字段 | — | �� |
+
+## 六.7�影�评估
+
+- **是�破���兼容**: 是（�赖 `restaurantName === "全部"` 的�端判断会失效；列表顺�改�）
+- **�端是�必须�步上线**: 是，按本文改判断�件与「全部�文案渲染
+- **�端 workaround 清�点**: 去掉对 `restaurantName` �值 `"全部"` 的�赖
+
+## 七��影�范围
+
+- **仅影�**: �食分页�下拉�详情 3 个读接�的 `restaurantName` �值，以�分页返回顺�
+- **零影�**:
+  - �食新建 `POST /admin/dish/items/add`�修改 `PUT /admin/dish/items/{dishId}/update`�上下架�删除接�与其入�校验
+  - �食其余出�字段�分页筛选�件�错误�
+  - 下拉与详情的返回顺�
+  - �厅管�接�与 `restaurant` 表
+
+---
+
+## 八�测试环境已验�
+
+部署�交 `3dcbaabef`，� Gateway 用真实 TEST 身份实测 16 项全部通过：
+
+```
+分页 32 �中 20 ��关��厅            → restaurantName 全为 null ✓
+分页 32 �中 12 �关��厅              → �返回�厅�称 ✓
+分页整体顺�                            → �关��厅排最� + �厅建档先� + 组内创建时间倒� + �食ID倒� ✓
+4 家�厅的分组先�                      → �香园�锅 → �日姥爷蒙���� → 七间房全羊馆 → �牧羊鲜羊�锅 ✓
+�关��厅的 20 �                      → 整组排在最�，组内创建时间倒� ✓
+pageSize=10 �页拼接                    → 与一次�回 50 �的顺�完全一致，������ ✓
+详情（�关��厅 / 关��厅�一�）      → null / �厅�称 ✓
+下拉 9 �                               → restaurantName 全为 null，顺�与本次改动�完全一致 ✓
+```
+
+---
+
+## ��相关文档
+
+- 关� Issue: [wx/HL#8086](https://git.1814.love:8443/wx/HL/issues/8086)
+- 关� PR: [wx/HL#8090](https://git.1814.love:8443/wx/HL/pulls/8090)
+
+## 关� / �系人
+
+### 链接
+
+- **Issue**: [#8086](https://git.1814.love:8443/wx/HL/issues/8086)
+- **PR**: [wx/HL#8090](https://git.1814.love:8443/wx/HL/pulls/8090)
+- **Merge commit**: [3dcbaabef](https://git.1814.love:8443/wx/HL/commit/3dcbaabef8384ec42238b051dbbdd6a8d8e48054)
+
+### �系人
+
+- �端: @lc