hl-api-changelog/changelogs/2026-04/2026-04-16_product-v2_daily-duration-and-menu.md

44 行
1.3 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 每日驾车时长自动计算 + 行程保障菜单
- **日期**: 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中说明