From fce41720c6e26dd85c9e87a297565adec7ca405e Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Thu, 16 Apr 2026 11:35:48 +0800 Subject: [PATCH] refactor: gatherPlace/dismissalPlace moved to per-day changelog --- ...04-16_product-v2_gather-dismiss-per-day.md | 66 +++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 changelogs/2026-04/2026-04-16_product-v2_gather-dismiss-per-day.md diff --git a/changelogs/2026-04/2026-04-16_product-v2_gather-dismiss-per-day.md b/changelogs/2026-04/2026-04-16_product-v2_gather-dismiss-per-day.md new file mode 100644 index 0000000..be0991f --- /dev/null +++ b/changelogs/2026-04/2026-04-16_product-v2_gather-dismiss-per-day.md @@ -0,0 +1,66 @@ +# 集合地/解散地迁移到每日行程 + +- **日期**: 2026-04-16 +- **服务**: hl-product-service-v2 +- **PR**: #617 +- **类型**: refactor (破坏性变更) + +## ⚠️ 破坏性变更 + +`gatherPlace` 和 `dismissalPlace` 从**产品级**迁移到**每日行程天级**。 + +### 之前(已废弃) + +``` +PUT /admin/product/item/{id}/itinerary +{ + "gatherPlace": "海拉尔", ← 产品级,已删除 + "dismissalPlace": "海拉尔", ← 产品级,已删除 + "days": [...] +} +``` + +### 现在 + +``` +PUT /admin/product/item/{id}/itinerary +{ + "days": [{ + "dayNumber": 1, + "gatherPlace": "海拉尔", ← 每天独立 + "dismissalPlace": "额尔古纳", ← 每天独立 + "dayTitle": "D1", + "nodes": [...] + }, { + "dayNumber": 2, + "gatherPlace": "额尔古纳", + "dismissalPlace": "满洲里", + ... + }] +} +``` + +### 管理端详情响应 + +`GET /admin/product/item/{id}` 的 `itinerary[]` 中每天包含: + +| 字段 | 类型 | 说明 | +|------|------|------| +| `gatherPlace` | String | 当日集合地 | +| `dismissalPlace` | String | 当日解散地 | +| `dailyMileage` | BigDecimal | 当日里程(km),自动计算 | +| `dailyDuration` | Integer | 当日驾车时长(分钟),自动计算 | + +### 小程序端详情响应 + +`GET /mp/product/{id}` 的 `itinerary[]` 中每天同样包含 `gatherPlace`/`dismissalPlace`/`dailyMileage`/`dailyDuration`。 + +**产品级不再有这两个字段。** + +### Step3路线与备品 + +`PUT /admin/product/item/{id}/route` 也不再有 `gatherPlace`/`dismissalPlace`。 + +### 途经路线自动生成 + +每天的途经路线格式:`当天集合地 → 景区/活动节点 → 当天解散地`