集合地/解散地迁移到每日行程

日期: 2026-04-16
服务: hl-product-service-v2
PR: #617
类型: refactor (破坏性变更)

⚠️ 破坏性变更

gatherPlace 和 dismissalPlace 从产品级迁移到每日行程天级。

之前（已废弃）

PUT /admin/product/item/{id}/itinerary
{
  "gatherPlace": "海拉尔",     ← 产品级，已删除
  "dismissalPlace": "海拉尔",  ← 产品级，已删除
  "days": [...]
}

现在

⚠️ 字段类型改为JSON对象（存高德行政区搜索返回的完整数据）

PUT /admin/product/item/{id}/itinerary
{
  "days": [{
    "dayNumber": 1,
    "gatherPlace": {
      "name": "海拉尔区",
      "adcode": "150702",
      "center": "119.736279,49.212189",
      "level": "district"
    },
    "dismissalPlace": {
      "name": "额尔古纳市",
      "adcode": "150784",
      "center": "120.180506,50.243102",
      "level": "city"
    },
    "dayTitle": "D1",
    "nodes": [...]
  }, {
    "dayNumber": 2,
    "gatherPlace": {"name": "额尔古纳市", "adcode": "150784", "center": "120.18,50.24", "level": "city"},
    "dismissalPlace": {"name": "满洲里市", "adcode": "150781", "center": "117.45,49.59", "level": "city"},
    ...
  }]
}

管理端详情响应

GET /admin/product/item/{id} 的 itinerary[] 中每天包含：

字段	类型	说明
`gatherPlace`	Object	当日集合地 `{name, adcode, center, level}`
`dismissalPlace`	Object	当日解散地 `{name, adcode, center, level}`
`dailyMileage`	BigDecimal	当日里程(km)，自动计算
`dailyDuration`	Integer	当日驾车时长(分钟)，自动计算

小程序端详情响应

GET /mp/product/{id} 的 itinerary[] 中每天同样包含 gatherPlace/dismissalPlace/dailyMileage/dailyDuration。

产品级不再有这两个字段。

Step3路线与备品

PUT /admin/product/item/{id}/route 也不再有 gatherPlace/dismissalPlace。

途经路线自动生成

每天的途经路线格式：当天集合地 → 景区/活动节点 → 当天解散地

2.1 KiB 原始文件 Blame 文件历史