From 8e1e77e6ca3752e3a433ed71c03eff4f63432cfe Mon Sep 17 00:00:00 2001
From: lc <liuchang@1814.love>
Date: Mon, 21 Sep 2026 10:26:27 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#8087=20=E9=A4=90=E9=A3=9F?=
 =?UTF-8?q?=E4=B8=8B=E6=8B=89=E6=8C=89=E9=A4=90=E5=8E=85=E8=81=94=E5=8A=A8?=
 =?UTF-8?q?=EF=BC=8C=E6=9C=AA=E9=80=89=E9=A4=90=E5=8E=85=E5=8F=AA=E7=BB=99?=
 =?UTF-8?q?=E3=80=8C=E5=85=A8=E9=83=A8=E3=80=8D=E9=A4=90=E9=A3=9F=EF=BC=88?=
 =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=8E=A5=E5=8F=A3=C2=B7=E7=AE=A1=E7=90=86?=
 =?UTF-8?q?=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>
---
 ...Œ‰é¤�厅è�”动未选é¤�厅å�ªç»™å…¨éƒ¨-修改接å�£-管ç�†å�Žå�°.md | 244 ++++++++++++++++++
 1 file changed, 244 insertions(+)
 create mode 100644 changelogs-v2/2026-09/21_8087_�食下拉按�厅�动未选�厅�给全部-修改接�-管���.md

diff --git a/changelogs-v2/2026-09/21_8087_�食下拉按�厅�动未选�厅�给全部-修改接�-管���.md b/changelogs-v2/2026-09/21_8087_�食下拉按�厅�动未选�厅�给全部-修改接�-管���.md
new file mode 100644
index 00000000..5d566b58
--- /dev/null
+++ b/changelogs-v2/2026-09/21_8087_�食下拉按�厅�动未选�厅�给全部-修改接�-管���.md
@@ -0,0 +1,244 @@
+---
+schema: "hl-changelog/v2"
+ticket: "8087"
+title: "�食下拉按�厅�动：未选�厅�给「全部��食"
+consumer: "admin"
+author: "lc(GIT)"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: "2026-09-21"
+status_note: "�食下拉 GET /admin/dish/items/list 新增�选入� restaurantId，并改�默认�径：�传�返回�厅为「全部�（restaurantId 为 null）的上架�食，传了�返回该�厅的上架�食。�端在订�详情「用��页签的�食下拉需按该行选中的�厅传 restaurantId；没选�厅时�传。出�字段�排�与�数上���。"
+updated_at: "2026-09-21"
+base: "dev-v3"
+---
+
+# resource: �食下拉按�厅�动，未选�厅�给「全部��食
+
+> **�务**: hl-resource-service
+> **PR**: #8089
+> **Issue**: #8087
+> **日期**: 2026-09-21
+> **影�范围**: 管����食下拉接� `GET /admin/dish/items/list`
+
+---
+
+## ⚠� 关键�化
+
+� **默认返回�径�了**：�传 `restaurantId` 时，`GET /admin/dish/items/list` �返回�厅为「全部�（`restaurantId` 为 `null`）的上架�食，��返回所有上架�食。
+
+🆕 **新增�选入� `restaurantId`**：传了�返回该�厅的上架�食。
+
+**�端需�改**：订�详情「用��页签的�食下拉，按该行当�选中的�厅传 `restaurantId`；没选�厅时�传该�数。切��厅��新调用本接���拿到�动�的候选。
+
+---
+
+## 一�背景
+
+订�详情「用��页签的�厅��食都是下拉选择，�食下拉�本接�。此�接��按�厅过滤，�论有没有选�厅，下拉都列出全部上架�食，与「�食按�厅维护��厅为空表示全部�（#7947）的数��径对�上。
+
+---
+
+## 二��更接�清�
+
+| # | 接� | 方法 | 路径 | �更类型 | 说明 |
+|---|------|------|------|----------|------|
+| 1 | 查询�食列表 | GET | `/admin/dish/items/list` | 入�新增 + 行为�化 | 新增�选 `restaurantId`；�传�返回�厅为「全部�的上架�食 |
+
+---
+
+## 三�接�详情
+
+### 1. 查询�食列表 `GET /admin/dish/items/list`
+
+**VO**: `DishListReqVO` → `List<DishListItemRespVO>`
+
+#### 使用场景
+
+�食下拉数��。订�详情「用��页签按行选�厅�选�食，�食候选跟�该行选中的�厅走。
+
+#### 入�字段表
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| restaurantId | Query | Long | � | 正整数 | **新增**。�传�返回�厅为「全部�的�食；传了�返回该�厅的�食。0 与负数返回 400「�厅ID必须为正数� |
+| keyword | Query | String | � | 去首尾空格� ≤64 | 模糊匹��称（��） |
+| settleType | Query | String | � | cash / sign / company | 结算方�（��） |
+| limit | Query | Integer | � | 1–200，默认 50 | 最大返回�数（��） |
+
+四个�件之间是「并且�，并且固定�返回上架（`status=1`）�未删除的�食。
+
+#### 出�字段表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| [].dishId | String | �食 ID（��） |
+| [].restaurantId | String | �厅 ID，「全部�为 `null`（��） |
+| [].restaurantName | String | �厅�称，「全部�返回「全部�（��） |
+| [].dishName | String | �食�称（��） |
+| [].unitPrice | Number | �价（元），两��数（��） |
+| [].priceUnit | String | 桌/人：`person` 按人 / `table` 按桌（��） |
+| [] 其余字段 | — | `imageUrl`�`settleType`�`status`�`remark`�`createdBy`�`createdByName`�`createdAt` ��� |
+
+出�字段�排�（创建时间����食 ID ��）与�数上�都没有�化，�是返回哪些行�了。
+
+#### 请求示例
+
+```http
+GET /admin/dish/items/list?restaurantId=2023382108491247617&limit=50
+Authorization: Bearer <admin token>
+```
+
+没选�厅时：
+
+```http
+GET /admin/dish/items/list?limit=50
+Authorization: Bearer <admin token>
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": [
+    {
+      "dishId": "2100978380923863042",
+      "restaurantId": "2023382108491247617",
+      "restaurantName": "七间房全羊馆",
+      "dishName": "团队标准�（八�一汤）",
+      "unitPrice": 35.00,
+      "priceUnit": "person",
+      "imageUrl": null,
+      "settleType": "cash",
+      "status": 1,
+      "remark": null,
+      "createdBy": "1900000000000000001",
+      "createdByName": "张三",
+      "createdAt": "2026-09-19 14:20:03"
+    }
+  ]
+}
+```
+
+#### 空数� / �级�应
+
+`data` 为 `[]`：没选�厅且没有「全部�类上架�食，或所选�厅下没有上架�食（例如该�厅的�食都被下架）。
+
+#### 错误�应
+
+```json
+{ "code": 400, "message": "�厅ID必须为正数", "success": false, "data": null }
+```
+
+```json
+{ "code": 400, "message": "limit最大为200", "success": false, "data": null }
+```
+
+#### 业务边界
+
+- 「全部�的�食�在�传 `restaurantId` 时出现；传了��厅就�有该�厅自己的�食。
+- 下架�已删除的�食任何情况下都�返回。
+- 本接��决定下拉候选，�影�订�用�的�存：订��按页�传的�厅��食原样存。
+
+---
+
+## 四�契约约�与正确调用方�
+
+| 场景 | 调用 |
+|------|------|
+| ✅ 该行没选�厅 | `GET /admin/dish/items/list?limit=50`（�带 `restaurantId`） |
+| ✅ 该行选了�厅 | `GET /admin/dish/items/list?restaurantId=<�厅ID>&limit=50` |
+| ✅ �了�厅 | 用新�厅 ID �新调用本接��候选 |
+| � 用 `restaurantId=0` 表示「全部� | 400「�厅ID必须为正数�；表示「全部���略该�数 |
+| � 用 `restaurantId=-1` | 400「�厅ID必须为正数� |
+
+---
+
+## 五�数�库行为
+
+�读查询，�写库。过滤�件对应 `dish.restaurant_id`：�传时按 `restaurant_id IS NULL` 查，传了按等值查。�食数�本身没有任何改动。
+
+---
+
+## 六�边界行为
+
+- 未登录 → 401（网关拦截），��。
+- 所选�厅�存在或已删除：�报错，返回 `[]`（接��回查�厅表）。
+- `restaurantId` 与 `keyword`�`settleType`�`limit` 是「并且�关系。
+
+---
+
+## 六.6�修改��对比
+
+### 字段级对比
+
+| 字段 | 改� | 改� |
+|------|------|------|
+| 入� `restaurantId` | 无 | 新增，�选，正整数 |
+| 入� `keyword` / `settleType` / `limit` | — | �� |
+| 出�全部字段 | — | �� |
+
+### 行为级对比
+
+| 行为 | 改� | 改� |
+|------|------|------|
+| �传 `restaurantId` | 返回所有上架�食 | �返回�厅为「全部�的上架�食 |
+| 传 `restaurantId` | �数被忽略，返回所有上架�食 | �返回该�厅的上架�食 |
+| 排���数上���查上架 | — | �� |
+
+## 六.7�影�评估
+
+- **是�破���兼容**: 是。�调用方�传 `restaurantId` 时，拿到的候选会收窄为「全部�类�食。
+- **�端是�必须�步上线**: 是。�食下拉需按选中的�厅传 `restaurantId`，�则选了�厅也�能看到「全部�类�食。
+- **�端 workaround 清�点**: 无。
+
+## 七��影�范围
+
+- **仅影�**: �食下拉 `GET /admin/dish/items/list` 返回哪些行
+- **零影�**:
+  - �食分页 `GET /admin/dish/items/page`�详情 `GET /admin/dish/items/{dishId}/view`
+  - �食新建 `POST /admin/dish/items/add`�修改 `PUT /admin/dish/items/{dishId}/update`�上下架 `PUT /admin/dish/items/{dishId}/status/update`�删除 `DELETE /admin/dish/items/{dishId}/del`
+  - �厅接�与订�用�信��用�模版接�
+  - 已有�食数�
+
+---
+
+## 八�测试环境已验�
+
+部署�交 `79722aef1`，部署���抓一次本接�返回�比对：
+
+```
+�传 restaurantId                        → 12 �收窄为 9 �，全部是 restaurantId 为 null 的上架�食 ✓
+�传 restaurantId 的行出�                → 与部署��字段一致 ✓
+restaurantId=2023382108491247617（七间房全羊馆） → �返回该�厅上架的 2 �，出��字段一致 ✓
+restaurantId=2023382111074938881（�牧羊鲜羊�锅） → �返回该�厅上架的 1 � ✓
+restaurantId=2023382100664676353（�香园�锅，�食全下架） → 返回 [] ✓
+restaurantId=0 / -1                       → 400「�厅ID必须为正数� ✓
+```
+
+---
+
+## ��相关文档
+
+- 关� Issue: [wx/HL#8087](https://git.1814.love:8443/wx/HL/issues/8087)
+- 关� PR: [wx/HL#8089](https://git.1814.love:8443/wx/HL/pulls/8089)
+- �食按�厅维护的由�: [#7947 Changelog](19_7947_�食删除编�关��厅增加桌人-修改接�-管���.md)
+
+## 关� / �系人
+
+### 链接
+
+- **Issue**: [#8087](https://git.1814.love:8443/wx/HL/issues/8087)
+- **PR**: [#8089](https://git.1814.love:8443/wx/HL/pulls/8089)
+- **Merge commit**: [79722aef1](https://git.1814.love:8443/wx/HL/commit/79722aef18000ec004f85262bbfc64c1b33b8201)
+
+### �系人
+
+- **�端负责人**: @lc