diff --git a/changelogs/2026-04/2026-04-16_product-v2_daily-duration-and-menu.md b/changelogs/2026-04/2026-04-16_product-v2_daily-duration-and-menu.md new file mode 100644 index 0000000..9fedd26 --- /dev/null +++ b/changelogs/2026-04/2026-04-16_product-v2_daily-duration-and-menu.md @@ -0,0 +1,43 @@ +# 每日驾车时长自动计算 + 行程保障菜单 + +- **日期**: 2026-04-16 +- **服务**: hl-product-service-v2 +- **PR**: #615 +- **类型**: feat + +## 1. 每日驾车时长自动计算 + +保存行程(Step2)时,自动通过高德API计算每天的**里程(km)** 和 **驾车时长(分钟)**,写入行程天表。 + +### 行程天新增字段 + +| 字段 | 类型 | 说明 | +|------|------|------| +| `dailyMileage` | BigDecimal | 当日驾车里程(km),自动计算 | +| `dailyDuration` | Integer | 当日驾车时长(分钟),自动计算 | + +- 保存行程后自动触发,无需前端额外调用 +- `mileageManualOverride=true` 的天不会被自动覆盖 +- 计算失败不影响行程保存 + +### 前端展示 + +小程序端每日行程可展示如:`290km · 约3.5小时` + +换算规则:`dailyDuration` 是分钟,前端自行格式化(如 151分钟 → "约2.5小时") + +### GET /admin/product/item/{id}/daily-mileage 响应更新 + +```json +[ + {"dayNumber": 1, "mileage": 166.3, "duration": 151}, + {"dayNumber": 2, "mileage": 314.2, "duration": 276}, + {"dayNumber": 3, "mileage": 700.0, "duration": 579} +] +``` + +## 2. 行程保障菜单 + +后台「产品管理」下新增「行程保障」菜单,排在「温馨提示」之后。 + +对应接口:`/admin/travel-guarantee-template/**`(CRUD已在之前的changelog中说明)