From bcc899394c08de15349b916dd291de1f145ec10e Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 13 Apr 2026 09:43:33 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E4=BA=A7=E5=93=81=E5=88=97=E8=A1=A8?=
 =?UTF-8?q?=E6=96=B0=E5=A2=9EtierCount=E5=AD=97=E6=AE=B5=EF=BC=88=E6=A1=A3?=
 =?UTF-8?q?=E4=BD=8D=E6=95=B0=E9=87=8F=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 ...026-04-13_product-v2_list_add_tierCount.md | 63 +++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 changelogs/2026-04/2026-04-13_product-v2_list_add_tierCount.md

diff --git a/changelogs/2026-04/2026-04-13_product-v2_list_add_tierCount.md b/changelogs/2026-04/2026-04-13_product-v2_list_add_tierCount.md
new file mode 100644
index 0000000..93be62e
--- /dev/null
+++ b/changelogs/2026-04/2026-04-13_product-v2_list_add_tierCount.md
@@ -0,0 +1,63 @@
+# 接口变更记录 — 2026-04-13
+
+> **变更类型**：字段新增
+> **影响接口**：`GET /admin/product/item/list`
+> **在线文档**：
+> - 局域网：http://192.168.100.236:8080/doc.html → `1. 管理端 - 产品管理`
+> - 公网：https://api.test.1814.love:9443/doc.html（需认证）
+
+---
+
+## 产品列表新增 `tierCount` 字段
+
+产品分页列表接口响应中**新增 `tierCount` 字段**，表示该产品的档位数量。
+
+### 接口信息
+
+- **方法**：`GET /admin/product/item/list`
+- **用途**：管理端产品分页列表
+
+### 新增字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `tierCount` | `Integer` | 档位数量。单一档位=1，多档=N（如舒适+豪华=2） |
+
+### 响应示例
+
+```json
+{
+  "code": 200,
+  "message": "成功",
+  "data": {
+    "total": 514,
+    "records": [
+      {
+        "productId": 2043246204711550977,
+        "productNo": "C2604121836",
+        "productType": "CORE",
+        "name": "额吉的故乡·亲子版",
+        "coverImageUrl": "https://...",
+        "tripDays": 6,
+        "status": "PUBLISHED",
+        "version": 3,
+        "tierCount": 2,
+        "createBy": 1002,
+        "publishedAt": "2026-04-12T16:33:51",
+        "createTime": "2026-04-12T16:29:40",
+        "updateTime": "2026-04-12T16:33:51"
+      }
+    ]
+  }
+}
+```
+
+### 使用场景
+
+产品列表卡片上展示档位信息，如「2个档位」或档位标签「舒适/豪华」。`tierCount=1` 时可不展示（单一档位无需区分）。
+
+---
+
+## 同步修复：分页问题已修复
+
+之前产品列表 `total` 返回0、一次返回全部数据的问题已修复（PR #325）。现在分页正常：`total` 返回正确总数，`records` 只返回当前页数据。