From 655e6b05a1039124aeecd8e22df55de5d9796a0d Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Thu, 28 May 2026 11:11:56 +0800
Subject: [PATCH] =?UTF-8?q?docs(v3):=20=E6=96=B0=E5=BB=BA=E8=AE=A2?=
 =?UTF-8?q?=E5=8D=95=E9=80=89=E4=B8=BB=E9=A2=98=E6=8E=A5=E5=8F=A3=E6=8E=A5?=
 =?UTF-8?q?=E9=80=9A(PR=20#3155=20/=20#3142)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...®¢å�•é€‰ä¸»é¢˜æŽ¥å�£-下å�•é€‰å“�接通真实接å�£_PR3155.md | 70 +++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 changelogs-v2/2026-05/28_3142_新建订�选主题接�-下�选�接通真实接�_PR3155.md

diff --git a/changelogs-v2/2026-05/28_3142_新建订�选主题接�-下�选�接通真实接�_PR3155.md b/changelogs-v2/2026-05/28_3142_新建订�选主题接�-下�选�接通真实接�_PR3155.md
new file mode 100644
index 0000000..406661d
--- /dev/null
+++ b/changelogs-v2/2026-05/28_3142_新建订�选主题接�-下�选�接通真实接�_PR3155.md
@@ -0,0 +1,70 @@
+# 二期 v3：新建订��导「选主题/选产��接通真实接�（替� mockProducts.js）
+
+> **�务**: hl-product-service-v2（+ hl-order-service-v3 内部统计）
+> **PR**: #3155
+> **Issue**: #3142
+> **日期**: 2026-05-28
+> **影�**: 🟡 新建订�页 `order-v2/new` 第 1 步「选主题��改用真接�；第 2 步「选产��用已有接�；地区筛选删除
+
+---
+
+## ⚠� 关键�化（�端 mmg 必读）
+
+`order-v2/new` 第 1�2 步当�用 `src/views/order-v2/new/_shared/mockProducts.js` 写死�数�。现�替�为真实接�。
+
+### 1. 第 1 步「选主题�— 新增接�
+
+```
+GET /admin/product/line/order-picker
+```
+- 无 query �数，**�分页**，按排����返回
+- 仅返回「**�用(ACTIVE) + 在售(该产�线下挂≥1个已上架产�)**�的主题
+- **数���**：和产�管�一致——超管看全部�核心(CORE)/�蒙马(GROUP)主题全员����人定制(CUSTOM)仅创建人本人��。**地区(region)筛选�需�,产�线无此字段,请删掉那排 chips。**
+
+返回结构：
+```jsonc
+{
+  "code": 200,
+  "data": [
+    {
+      "lineId": 2056937785918369794,   // 主题ID(雪花,�端按字符串�传)
+      "name": "测试核心产�",            // 主题�
+      "description": "...",            // �述(原 mock 的 desc/tagline 都用它)
+      "coverImageUrl": "https://...",  // 真实��图(替代 mock 的 emoji cover + coverColor)
+      "productType": "CORE",           // CORE=核心 / GROUP=�蒙马
+      "skuCount": 6,                   // 该主题下已上架产�的档�总数(原 mock 的 skuCount)
+      "fromPrice": 3105.00,            // 起价/人(已上架产�最低�人起价;未设价为 null,请显示 ¥-- 或�)
+      "hot": true                     // 热门标识 = 该主题近90天下��较多(�30%且>0)
+    }
+  ]
+}
+```
+
+字段映射建议（mock → 真接�）：
+- `id` → `lineId`（字符串�传，勿 Number()）
+- `cover`/`coverColor`（emoji 装饰）→ 改用 `coverImageUrl` 真实图；如��色���端按 lineId �色
+- `region`/`regionKey` → **删除**（无�端字段，地区 chips 去掉）
+- `tagline` → 并入 `description` 或�略
+- `skuCount` / `fromPrice` / `hot` → ��直�
+- 顶部统计「在售主题数�= 列表长度；「SKU总数�= Σ`skuCount`；「最低人��= min(`fromPrice`)
+
+### 2. 第 2 步「选产��— 用已有接�（无新增）
+
+```
+GET /admin/product/item/list?lineId={lineId}&status=PUBLISHED
+```
+- 选定主题�传其 `lineId`，��已上架产�；返回 `ProductListRespVO` 分页
+- 已�选�所需全部字段：`productId` / `name` / `subtitle` / `tripDays` / `tripNights` / `tags` / `coverImageUrl` / `startPrice` / `tierPrices[]`
+- `tierPrices[]` �项� `tierSeq` / `tierName` / `tierDescription` / `startPrice` —— 下��交需�的 `tierSeq` 从这里�
+- 数����上（带 @DataScope）
+
+mock 里�张「SKU ��= 一个产�的一个档�；真实是一个产�(`productId`)�多个档�(`tierPrices`)。�端�按产�� + 档�选择，或按产�×档�平铺，�交时带 `productId + tierSeq`。
+（mock 的 `depDates` �团日期文案无�一对应字段，��略或�续走�期接�。）
+
+### 3. �交（��）
+`POST /v3/admin/order`，入� `productId` + `tierSeq` 等，已就绪。
+
+---
+
+## 验�
+测试� `web.test.1814.love:9443` 真 admin token 实测：order-picker 返 9 个在售主题(库内 ACTIVE 29 → 在售 9 精确��)，字段�全，hot 跨�务统计生效。