changelog: 0a38703 - feat: 路径图环形布局 + 定制产品详情完整返回 + 手机号查定制产品

2026-03-19 15:32:23 +08:00 · 2026-03-19 15:32:23 +08:00 · 2b4213e0f4
--- a/.swagger/hl-order-service.json
+++ b/.swagger/hl-order-service.json
--- a/.swagger/hl-product-service.json
+++ b/.swagger/hl-product-service.json
@ -4839,7 +4839,7 @@
          "行程管理"
        ],
        "summary": "添加行程节点",
-        "description": "在指定天添加一个行程节点。节点是行程的最小单元，可关联资源服务中的景区、酒店、活动等。\n\n**节点类型**：TRANSPORT(交通)/SCENIC(景区)/RESTAURANT(餐厅)/ACTIVITY(活动)/PHOTOGRAPHY(摄影)/HOTEL(酒店)/FREE(自由活动)/CUSTOM(自定义)\n\n**CUSTOM 定制产品特有**：可通过 familyIds 指定节点所属的家庭分组，实现按家庭分配行程。\n新建节点自动追加到当天最后位置，可通过排序接口调整顺序。\n\n**关联字典**：\n- city（城市，资源面板筛选用）：用于在添加节点时按城市筛选可选资源",
+        "description": "在指定天添加一个行程节点。节点是行程的最小单元，可关联资源服务中的景区、酒店、活动等。\n\n**节点类型**：TRANSPORT(交通)/SCENIC(景区)/RESTAURANT(餐厅)/ACTIVITY(活动)/PHOTOGRAPHY(摄影)/HOTEL(酒店)/FREE(自由活动)/CUSTOM(自定义)/SERVICE(服务)/NOTE(备注)\n\n**CUSTOM 定制产品特有**：可通过 familyIds 指定节点所属的家庭分组，实现按家庭分配行程。\n新建节点自动追加到当天最后位置，可通过排序接口调整顺序。\n\n**关联字典**：\n- city（城市，资源面板筛选用）：用于在添加节点时按城市筛选可选资源",
        "operationId": "createNodeUsingPOST",
        "consumes": [
          "application/json"
@ -9688,6 +9688,10 @@
          "format": "int32",
          "description": "儿童人数"
        },
+        "contactPhone": {
+          "type": "string",
+          "description": "联系电话（定制产品）"
+        },
        "costItems": {
          "type": "array",
          "description": "成本项列表",
@ -9725,6 +9729,10 @@
            "originalRef": "产品自定义费用项VO"
          }
        },
+        "customerName": {
+          "type": "string",
+          "description": "客户姓名（定制产品）"
+        },
        "customizerId": {
          "type": "string",
          "description": "定制师ID"
@ -9733,6 +9741,11 @@
          "type": "string",
          "description": "出发城市"
        },
+        "departureDate": {
+          "type": "string",
+          "format": "date",
+          "description": "出发日期（定制产品）"
+        },
        "destinationCities": {
          "type": "array",
          "description": "途经城市列表（从行程节点资源去重提取）",
@ -9839,11 +9852,18 @@
        },
        "refundPolicyId": {
          "type": "string",
-          "description": "退款政策ID"
+          "description": "退款政策ID（已废弃，用refundPolicyIds替代）"
+        },
+        "refundPolicyIds": {
+          "type": "object",
+          "description": "退款政策映射（按退款类型绑定不同政策）。key=退款类型(FULL/DEPOSIT/BALANCE), value=政策ID",
+          "additionalProperties": {
+            "type": "string"
+          }
        },
        "refundPolicyName": {
          "type": "string",
-          "description": "退款政策名称"
+          "description": "退款政策名称（已废弃）"
        },
        "routeMapUrl": {
          "type": "string",
@ -10163,6 +10183,11 @@
          "example": 1,
          "description": "儿童人数"
        },
+        "contactPhone": {
+          "type": "string",
+          "example": 13800138000,
+          "description": "联系电话（定制产品）"
+        },
        "coverImageUrl": {
          "type": "string",
          "example": "https://oss.example.com/cover.jpg",
@ -10178,6 +10203,11 @@
          "example": "带你体验最地道的丽江风情",
          "description": "创作者寄语"
        },
+        "customerName": {
+          "type": "string",
+          "example": "张三",
+          "description": "客户姓名（定制产品）"
+        },
        "customizerId": {
          "type": "string",
          "example": 1893012345678901234,
@ -10188,6 +10218,12 @@
          "example": "昆明",
          "description": "出发城市"
        },
+        "departureDate": {
+          "type": "string",
+          "format": "date",
+          "example": "2026-07-01",
+          "description": "出发日期（定制产品）"
+        },
        "destinationCity": {
          "type": "string",
          "example": "丽江",
@ -10264,7 +10300,18 @@
        "refundPolicyId": {
          "type": "string",
          "example": 1893012345678901234,
-          "description": "退款政策ID（关联退款政策模板）"
+          "description": "退款政策ID（已废弃，用refundPolicyIds替代）"
+        },
+        "refundPolicyIds": {
+          "type": "object",
+          "example": {
+            "FULL": "1893012345678901234",
+            "DEPOSIT": "1893012345678901235"
+          },
+          "description": "退款政策映射（按退款类型绑定不同政策）。key=退款类型(FULL/DEPOSIT/BALANCE), value=政策ID",
+          "additionalProperties": {
+            "type": "string"
+          }
        },
        "seasons": {
          "type": "array",
@ -10900,6 +10947,11 @@
          "example": 1,
          "description": "儿童人数"
        },
+        "contactPhone": {
+          "type": "string",
+          "example": 13800138000,
+          "description": "联系电话（定制产品）"
+        },
        "creatorAvatarUrl": {
          "type": "string",
          "example": "https://oss.example.com/avatar.jpg",
@ -10910,6 +10962,11 @@
          "example": "带你体验最地道的丽江风情",
          "description": "创作者寄语"
        },
+        "customerName": {
+          "type": "string",
+          "example": "张三",
+          "description": "客户姓名（定制产品）"
+        },
        "customizerId": {
          "type": "string",
          "example": 1893012345678901234,
@ -10920,6 +10977,12 @@
          "example": "昆明",
          "description": "出发城市"
        },
+        "departureDate": {
+          "type": "string",
+          "format": "date",
+          "example": "2026-07-01",
+          "description": "出发日期（定制产品）"
+        },
        "destinationCity": {
          "type": "string",
          "example": "丽江",
@ -10985,7 +11048,18 @@
        "refundPolicyId": {
          "type": "string",
          "example": 1893012345678901234,
-          "description": "退款政策ID（关联退款政策模板）"
+          "description": "退款政策ID（已废弃，用refundPolicyIds替代）"
+        },
+        "refundPolicyIds": {
+          "type": "object",
+          "example": {
+            "FULL": "1893012345678901234",
+            "DEPOSIT": "1893012345678901235"
+          },
+          "description": "退款政策映射（按退款类型绑定不同政策）。key=退款类型(FULL/DEPOSIT/BALANCE), value=政策ID",
+          "additionalProperties": {
+            "type": "string"
+          }
        },
        "seasons": {
          "type": "array",
@ -11200,7 +11274,7 @@
        "nodeType": {
          "type": "string",
          "example": "SCENIC",
-          "description": "节点类型：TRANSPORT(交通)/SCENIC(景区)/RESTAURANT(餐厅)/ACTIVITY(活动)/PHOTOGRAPHY(摄影)/HOTEL(酒店)/FREE(自由活动)/CUSTOM(自定义)"
+          "description": "节点类型：TRANSPORT(交通)/SCENIC(景区)/RESTAURANT(餐厅)/ACTIVITY(活动)/PHOTOGRAPHY(摄影)/HOTEL(酒店)/FREE(自由活动)/CUSTOM(自定义)/SERVICE(服务)/NOTE(备注)"
        },
        "quantity": {
          "type": "integer",
@ -12326,6 +12400,11 @@
          "example": 1,
          "description": "儿童人数"
        },
+        "contactPhone": {
+          "type": "string",
+          "example": 13800138000,
+          "description": "联系电话（定制产品）"
+        },
        "creatorAvatarUrl": {
          "type": "string",
          "example": "https://oss.example.com/avatar.jpg",
@ -12336,6 +12415,11 @@
          "example": "带你体验最地道的丽江风情",
          "description": "创作者寄语"
        },
+        "customerName": {
+          "type": "string",
+          "example": "张三",
+          "description": "客户姓名（定制产品）"
+        },
        "customizerId": {
          "type": "string",
          "example": 1893012345678901234,
@ -12346,6 +12430,12 @@
          "example": "昆明",
          "description": "出发城市"
        },
+        "departureDate": {
+          "type": "string",
+          "format": "date",
+          "example": "2026-07-01",
+          "description": "出发日期（定制产品）"
+        },
        "destinationCity": {
          "type": "string",
          "example": "丽江",
@ -12411,7 +12501,18 @@
        "refundPolicyId": {
          "type": "string",
          "example": 1893012345678901234,
-          "description": "退款政策ID（关联退款政策模板）"
+          "description": "退款政策ID（已废弃，用refundPolicyIds替代）"
+        },
+        "refundPolicyIds": {
+          "type": "object",
+          "example": {
+            "FULL": "1893012345678901234",
+            "DEPOSIT": "1893012345678901235"
+          },
+          "description": "退款政策映射（按退款类型绑定不同政策）。key=退款类型(FULL/DEPOSIT/BALANCE), value=政策ID",
+          "additionalProperties": {
+            "type": "string"
+          }
        },
        "seasons": {
          "type": "array",
@ -12617,7 +12718,7 @@
        "nodeType": {
          "type": "string",
          "example": "SCENIC",
-          "description": "节点类型：TRANSPORT(交通)/SCENIC(景区)/RESTAURANT(餐厅)/ACTIVITY(活动)/PHOTOGRAPHY(摄影)/HOTEL(酒店)/FREE(自由活动)/CUSTOM(自定义)"
+          "description": "节点类型：TRANSPORT(交通)/SCENIC(景区)/RESTAURANT(餐厅)/ACTIVITY(活动)/PHOTOGRAPHY(摄影)/HOTEL(酒店)/FREE(自由活动)/CUSTOM(自定义)/SERVICE(服务)/NOTE(备注)"
        },
        "quantity": {
          "type": "integer",
@ -14696,7 +14797,7 @@
        },
        "nodeType": {
          "type": "string",
-          "description": "节点类型：TRANSPORT(交通)/SCENIC(景区)/RESTAURANT(餐厅)/ACTIVITY(活动)/PHOTOGRAPHY(摄影)/HOTEL(酒店)/FREE(自由活动)/CUSTOM(自定义)"
+          "description": "节点类型：TRANSPORT(交通)/SCENIC(景区)/RESTAURANT(餐厅)/ACTIVITY(活动)/PHOTOGRAPHY(摄影)/HOTEL(酒店)/FREE(自由活动)/CUSTOM(自定义)/SERVICE(服务)/NOTE(备注)"
        },
        "quantity": {
          "type": "integer",
--- a/changelogs/2026-03/2026-03-19_1532_0a38703_feat.md
+++ b/changelogs/2026-03/2026-03-19_1532_0a38703_feat.md
@ -0,0 +1,69 @@
+# 接口变更记录 — 2026-03-19 15:32
+
+> **提交** `0a38703` · **作者** wx · **时间** 2026-03-19 15:32:23 +0800
+>
+> feat: 路径图环形布局 + 定制产品详情完整返回 + 手机号查定制产品
+
+## 变更总览
+
+- **产品服务**
+  - InternalMpProduct (+1)
+
+---
+
+## 产品服务
+
+### InternalMpProduct
+
+> 📖 **接口文档**: [http://192.168.100.236:8085/doc.html](http://192.168.100.236:8085/doc.html) → 标签 **「【内部接口】小程序产品（Feign调用）」**
+
+### 🆕 `GET` /internal/mp/product/custom-by-phone — 按联系电话查询定制产品列表
+
+> 根据手机号查询已完成（COMPLETED/ORDERED）的定制产品。
+
+**参数**
+
+  - `phone` (`String`) — 查询参数
+
+**响应** `Result<List<MpProductListVO>>`
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `productId` | `String` | 产品ID |
+| `productType` | `String` | 产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团 |
+| `name` | `String` | 产品名称 |
+| `subtitle` | `String` | 副标题 |
+| `tripDays` | `Integer` | 行程天数 |
+| `tripNights` | `Integer` | 行程晚数 |
+| `departureCity` | `String` | 出发城市 |
+| `destinationCity` | `String` | 目的地城市 |
+| `tags` | `List<String>` | 产品标签列表 |
+| `seasons` | `List<String>` | 适用季节列表(编码) |
+| `seasonLabels` | `List<String>` | 适用季节列表(中文) |
+| `coverImageUrl` | `String` | 封面图URL |
+| `lineName` | `String` | 产品线名称 |
+| `startPrice` | `BigDecimal` | 起步价（来自定价配置） |
+| `paymentMode` | `String` | 支付模式：FULL=全款 DEPOSIT=定金+尾款 |
+| `routeMapUrl` | `String` | 路径图URL |
+| `creatorAvatarUrl` | `String` | 定制师头像URL |
+
+**关联字典**
+
+- `product_type`（产品类型）：CUSTOM=定制产品
+- `product_status`（产品状态）：COMPLETED=已完成, ORDERED=已下单
+
+---
+
+<details>
+<summary>📁 全部变更文件 (点击展开)</summary>
+
+```
+M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpCustomizeController.java
+M	hl-mp-service/src/main/java/com/hulalv/mp/feign/MpProductFeignClient.java
+M	hl-mp-service/src/main/java/com/hulalv/mp/feign/MpProductFeignFallbackFactory.java
+M	hl-product-service/src/main/java/com/hulalv/product/controller/InternalMpProductController.java
+M	hl-product-service/src/main/java/com/hulalv/product/service/ProductService.java
+M	hl-product-service/src/main/java/com/hulalv/product/service/RouteMapGenerator.java
+M	hl-product-service/src/main/java/com/hulalv/product/service/RouteMapService.java
+```
+</details>