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