hl-api-changelog/changelogs/2026-03/26_1330_safety_item_crud.md
2026-03-26 14:47:54 +08:00

82 行
2.2 KiB
Markdown

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

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

# 安全保障改为逐条管理(废弃模板机制)
**日期**: 2026-03-26
**服务**: hl-product-service
---
## 变更说明
安全保障从模板选择改为**逐条增删**,和"费用不包含"一样的操作方式。
**废弃**`/admin/product/safety-template` 模板接口不再使用。
## 新增接口
| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/admin/product/{productId}/safety-item` | 列表 |
| POST | `/admin/product/{productId}/safety-item` | 添加 |
| PUT | `/admin/product/{productId}/safety-item/{id}` | 更新 |
| DELETE | `/admin/product/{productId}/safety-item/{id}` | 删除 |
**请求体**
```json
{
"category": "INSURANCE",
"name": "保险",
"description": "中国人保50万,含意外医疗",
"icon": "insurance",
"sortOrder": 1
}
```
## 字典
`dict_type = safety_category`(快捷添加用):
| dict_value | dict_label | remark默认描述 |
|------------|------------|-------------------|
| INSURANCE | 保险 | 中国人保50万,含意外医疗 |
| VEHICLE | 车辆 | 营运资质、儿童安全座椅、司机驾龄10年 |
| EMERGENCY | 应急 | 24h客服,医院30分钟可达 |
## 前端改造
产品编辑的"安全保障"区域改为:
1. 顶部快捷按钮从字典 `safety_category` 读取
2. 点击快捷按钮 → 自动填入 category/name/description → 调 POST 添加
3. 已添加列表支持编辑描述、调整排序、删除
4. 去掉模板选择下拉框
## 小程序端
`safetyItems` 返回格式不变,前端无需改动:
```json
[
{ "icon": "insurance", "title": "保险", "description": "中国人保50万,含意外医疗" }
]
```
---
## 补充:快捷添加字典
字典类型:`safety_category`
接口:`GET /admin/dict/data/type/safety_category`
返回数据:
| dict_value | dict_label | remark |
|------------|------------|--------|
| INSURANCE | 保险 | 中国人保50万,含意外医疗 |
| VEHICLE | 车辆 | 营运资质、儿童安全座椅、司机驾龄10年 |
| EMERGENCY | 应急 | 24h客服,医院30分钟可达 |
快捷按钮点击时映射:
- `category``dict_value`
- `name``dict_label`
- `description``remark`(默认值,用户可修改)
- `icon``dict_value` 小写(如 `insurance`